diff --git a/doc/404.html b/doc/404.html
index 34e20e9..523e2d5 100644
--- a/doc/404.html
+++ b/doc/404.html
@@ -12,7 +12,7 @@
       
       
       <link rel="icon" href="/assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.21">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.24">
     
     
       
@@ -20,7 +20,7 @@
       
     
     
-      <link rel="stylesheet" href="/assets/stylesheets/main.66ac8b77.min.css">
+      <link rel="stylesheet" href="/assets/stylesheets/main.6543a935.min.css">
       
       
 
@@ -327,7 +327,7 @@ <h1>404 - Not found</h1>
     <script id="__config" type="application/json">{"base": "/", "features": [], "search": "/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="/assets/javascripts/bundle.a7c05c9e.min.js"></script>
+      <script src="/assets/javascripts/bundle.081f42fc.min.js"></script>
       
     
   </body>
diff --git a/doc/CHANGES.html b/doc/CHANGES.html
index 5fc9d67..8fce750 100644
--- a/doc/CHANGES.html
+++ b/doc/CHANGES.html
@@ -16,7 +16,7 @@
       
       
       <link rel="icon" href="assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.21">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.24">
     
     
       
@@ -24,7 +24,7 @@
       
     
     
-      <link rel="stylesheet" href="assets/stylesheets/main.66ac8b77.min.css">
+      <link rel="stylesheet" href="assets/stylesheets/main.6543a935.min.css">
       
       
 
@@ -282,6 +282,39 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#3711-2024-05-25" class="md-nav__link">
+    <span class="md-ellipsis">
+      [3.7.11] - 2024-05-25
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="[3.7.11] - 2024-05-25">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#added" class="md-nav__link">
+    <span class="md-ellipsis">
+      Added
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#changed" class="md-nav__link">
+    <span class="md-ellipsis">
+      Changed
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#3710-2024-05-4" class="md-nav__link">
     <span class="md-ellipsis">
@@ -293,7 +326,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added" class="md-nav__link">
+  <a href="#added_1" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -317,7 +350,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_1" class="md-nav__link">
+  <a href="#added_2" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -341,7 +374,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_2" class="md-nav__link">
+  <a href="#added_3" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -350,7 +383,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed" class="md-nav__link">
+  <a href="#changed_1" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -383,7 +416,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_3" class="md-nav__link">
+  <a href="#added_4" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -392,7 +425,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_1" class="md-nav__link">
+  <a href="#changed_2" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -449,7 +482,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_4" class="md-nav__link">
+  <a href="#added_5" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -467,7 +500,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_2" class="md-nav__link">
+  <a href="#changed_3" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -491,7 +524,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_5" class="md-nav__link">
+  <a href="#added_6" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -500,7 +533,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_3" class="md-nav__link">
+  <a href="#changed_4" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -533,7 +566,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_4" class="md-nav__link">
+  <a href="#changed_5" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -557,7 +590,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_5" class="md-nav__link">
+  <a href="#changed_6" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -581,7 +614,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_6" class="md-nav__link">
+  <a href="#changed_7" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -605,7 +638,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_6" class="md-nav__link">
+  <a href="#added_7" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -614,7 +647,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_7" class="md-nav__link">
+  <a href="#changed_8" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -638,7 +671,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_7" class="md-nav__link">
+  <a href="#added_8" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -647,7 +680,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_8" class="md-nav__link">
+  <a href="#changed_9" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -671,7 +704,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_8" class="md-nav__link">
+  <a href="#added_9" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -680,7 +713,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_9" class="md-nav__link">
+  <a href="#changed_10" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -704,7 +737,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_10" class="md-nav__link">
+  <a href="#changed_11" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -728,7 +761,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_11" class="md-nav__link">
+  <a href="#changed_12" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -761,7 +794,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_12" class="md-nav__link">
+  <a href="#changed_13" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -785,7 +818,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_9" class="md-nav__link">
+  <a href="#added_10" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -794,7 +827,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_13" class="md-nav__link">
+  <a href="#changed_14" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -861,6 +894,39 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#3711-2024-05-25" class="md-nav__link">
+    <span class="md-ellipsis">
+      [3.7.11] - 2024-05-25
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="[3.7.11] - 2024-05-25">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#added" class="md-nav__link">
+    <span class="md-ellipsis">
+      Added
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#changed" class="md-nav__link">
+    <span class="md-ellipsis">
+      Changed
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#3710-2024-05-4" class="md-nav__link">
     <span class="md-ellipsis">
@@ -872,7 +938,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added" class="md-nav__link">
+  <a href="#added_1" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -896,7 +962,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_1" class="md-nav__link">
+  <a href="#added_2" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -920,7 +986,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_2" class="md-nav__link">
+  <a href="#added_3" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -929,7 +995,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed" class="md-nav__link">
+  <a href="#changed_1" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -962,7 +1028,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_3" class="md-nav__link">
+  <a href="#added_4" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -971,7 +1037,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_1" class="md-nav__link">
+  <a href="#changed_2" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1028,7 +1094,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_4" class="md-nav__link">
+  <a href="#added_5" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -1046,7 +1112,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_2" class="md-nav__link">
+  <a href="#changed_3" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1070,7 +1136,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_5" class="md-nav__link">
+  <a href="#added_6" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -1079,7 +1145,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_3" class="md-nav__link">
+  <a href="#changed_4" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1112,7 +1178,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_4" class="md-nav__link">
+  <a href="#changed_5" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1136,7 +1202,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_5" class="md-nav__link">
+  <a href="#changed_6" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1160,7 +1226,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_6" class="md-nav__link">
+  <a href="#changed_7" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1184,7 +1250,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_6" class="md-nav__link">
+  <a href="#added_7" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -1193,7 +1259,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_7" class="md-nav__link">
+  <a href="#changed_8" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1217,7 +1283,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_7" class="md-nav__link">
+  <a href="#added_8" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -1226,7 +1292,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_8" class="md-nav__link">
+  <a href="#changed_9" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1250,7 +1316,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_8" class="md-nav__link">
+  <a href="#added_9" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -1259,7 +1325,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_9" class="md-nav__link">
+  <a href="#changed_10" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1283,7 +1349,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_10" class="md-nav__link">
+  <a href="#changed_11" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1307,7 +1373,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#changed_11" class="md-nav__link">
+  <a href="#changed_12" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1340,7 +1406,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_12" class="md-nav__link">
+  <a href="#changed_13" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1364,7 +1430,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#added_9" class="md-nav__link">
+  <a href="#added_10" class="md-nav__link">
     <span class="md-ellipsis">
       Added
     </span>
@@ -1373,7 +1439,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#changed_13" class="md-nav__link">
+  <a href="#changed_14" class="md-nav__link">
     <span class="md-ellipsis">
       Changed
     </span>
@@ -1405,6 +1471,18 @@
 
 
 <h1 id="odfdo-release-notes">Odfdo Release Notes</h1>
+<h2 id="3711-2024-05-25">[3.7.11] - 2024-05-25</h2>
+<ul>
+<li>New script <code>odfdo-userfield</code> to show or set the user-field content in an ODF file.</li>
+</ul>
+<h3 id="added">Added</h3>
+<ul>
+<li>Add script <code>odfdo-userfield</code>.</li>
+</ul>
+<h3 id="changed">Changed</h3>
+<ul>
+<li>Updating dependency versions.</li>
+</ul>
 <h2 id="3710-2024-05-4">[3.7.10] - 2024-05-4</h2>
 <ul>
 <li>
@@ -1438,7 +1516,7 @@ <h2 id="3710-2024-05-4">[3.7.10] - 2024-05-4</h2>
 </code></pre>
 </li>
 </ul>
-<h3 id="added">Added</h3>
+<h3 id="added_1">Added</h3>
 <ul>
 <li>Added <code>Body.tables</code></li>
 <li>Added <code>Element.tocs</code></li>
@@ -1472,7 +1550,7 @@ <h2 id="379-2024-05-3">[3.7.9] - 2024-05-3</h2>
 <p>Added a few metadata elements from the ODF standard (hyperlink-behaviour, auto-reload, template, print-dateprinted-by)</p>
 </li>
 </ul>
-<h3 id="added_1">Added</h3>
+<h3 id="added_2">Added</h3>
 <ul>
 <li>Added <code>MetaAutoReload</code> class</li>
 <li>Added <code>MetaHyperlinkBehaviour</code> class</li>
@@ -1490,11 +1568,11 @@ <h3 id="added_1">Added</h3>
 </ul>
 <h2 id="378-2024-05-2">[3.7.8] - 2024-05-2</h2>
 <p>Fix embedded chart analysis in documents, see recipe <code>change_values_of_a_chart_inside_a_document.py</code>.</p>
-<h3 id="added_2">Added</h3>
+<h3 id="added_3">Added</h3>
 <ul>
 <li>Added <code>change_values_of_a_chart_inside_a_document.py</code> recipe</li>
 </ul>
-<h3 id="changed">Changed</h3>
+<h3 id="changed_1">Changed</h3>
 <ul>
 <li>
 <p>The &ldquo;pretty&rdquo; setting when saving the file always defaults to False. This setting should only be used for debugging purposes</p>
@@ -1520,7 +1598,7 @@ <h3 id="fixed">Fixed</h3>
 </ul>
 <h2 id="377-2024-04-1">[3.7.7] - 2024-04-1</h2>
 <p>Improvement of the <code>lxml</code> dependency support.</p>
-<h3 id="added_3">Added</h3>
+<h3 id="added_4">Added</h3>
 <ul>
 <li>
 <p>Added a <code>CHANGES.md</code> file</p>
@@ -1529,7 +1607,7 @@ <h3 id="added_3">Added</h3>
 <p>Automatic tests for ubuntu-latest, macos-latest, windows-latest</p>
 </li>
 </ul>
-<h3 id="changed_1">Changed</h3>
+<h3 id="changed_2">Changed</h3>
 <ul>
 <li>
 <p>Now supports a wider range of <code>lxml</code> versions:</p>
@@ -1568,7 +1646,7 @@ <h3 id="fixed_2">Fixed</h3>
 </code></pre>
 <h2 id="375-2024-03-23">[3.7.5] - 2024-03-23</h2>
 <p>Add the method <code>get_cell_background_color</code> to retrieve the background color of a cell in a table.</p>
-<h3 id="added_4">Added</h3>
+<h3 id="added_5">Added</h3>
 <ul>
 <li>
 <p>Tables: some users need to easily access the background color of cells, including cells without &ldquo;value&rdquo; content. That was requiring a complex parsing of styles. So a new method: <code>Document.get_cell_background_color(sheet_id, cell_coords)</code>.</p>
@@ -1593,7 +1671,7 @@ <h3 id="fixed_3">Fixed</h3>
 <ul>
 <li><code>Document(path)</code> now accepts a <code>str</code> path starting with <code>~</code> as the path relative to the user home.</li>
 </ul>
-<h3 id="changed_2">Changed</h3>
+<h3 id="changed_3">Changed</h3>
 <ul>
 <li>
 <p>Tables: (related to previous), change the <code>Cell.is_empty()</code> test. A cell is now considered as not empty if part of a <code>span</code> (a cell spanned on several rows or columns). This may induce some changes for parsing scripts. Before that, only the first cell of the span (which actually contains the value) was considered as non empty. Now other cells of the span are not empty (but contain a null value).</p>
@@ -1604,7 +1682,7 @@ <h3 id="changed_2">Changed</h3>
 </ul>
 <h2 id="374-2024-03-17">[3.7.4] - 2024-03-17</h2>
 <p>Add a recipe as example of programmatically setting text styles for headers and paragraphs, with basic font and color properties.</p>
-<h3 id="added_5">Added</h3>
+<h3 id="added_6">Added</h3>
 <ul>
 <li>
 <p>Add recipe <code>create_basic_text_styles</code>.</p>
@@ -1613,7 +1691,7 @@ <h3 id="added_5">Added</h3>
 <p>All style fields related to color accept a color name from the CSS list of color.</p>
 </li>
 </ul>
-<h3 id="changed_3">Changed</h3>
+<h3 id="changed_4">Changed</h3>
 <ul>
 <li>Updating dependency versions.</li>
 </ul>
@@ -1623,7 +1701,7 @@ <h3 id="fixed_4">Fixed</h3>
 <ul>
 <li>Fix logo link on <code>Pypi</code> page.</li>
 </ul>
-<h3 id="changed_4">Changed</h3>
+<h3 id="changed_5">Changed</h3>
 <ul>
 <li>
 <p>Technical updates from <code>optparse</code> to <code>argparse</code>.</p>
@@ -1634,7 +1712,7 @@ <h3 id="changed_4">Changed</h3>
 </ul>
 <h2 id="372-2024-03-9">[3.7.2] - 2024-03-9</h2>
 <p>Internal maintenance release.</p>
-<h3 id="changed_5">Changed</h3>
+<h3 id="changed_6">Changed</h3>
 <ul>
 <li>
 <p>Use <code>pdoc</code> for autogenerated documentation.</p>
@@ -1648,37 +1726,37 @@ <h3 id="changed_5">Changed</h3>
 </ul>
 <h2 id="371-2024-03-3">[3.7.1] - 2024-03-3</h2>
 <p>Minor performance improvement of script <code>odfdo-headers</code>.</p>
-<h3 id="changed_6">Changed</h3>
+<h3 id="changed_7">Changed</h3>
 <ul>
 <li>Use better algorithm for script <code>odfdo-headers</code>.</li>
 </ul>
 <h2 id="370-2024-03-2">[3.7.0] - 2024-03-2</h2>
 <p>New script <code>odfdo-headers</code> to print the headers of a <code>ODF</code> file.</p>
-<h3 id="added_6">Added</h3>
+<h3 id="added_7">Added</h3>
 <ul>
 <li>Add script <code>odfdo-headers</code>.</li>
 </ul>
-<h3 id="changed_7">Changed</h3>
+<h3 id="changed_8">Changed</h3>
 <ul>
 <li>Updating dependency versions.</li>
 </ul>
 <h2 id="360-2024-02-25">[3.6.0] - 2024-02-25</h2>
 <p>New script <code>odfdo-highlight</code> to highlight the text matching a pattern (regex) in a <code>ODF</code> file.</p>
-<h3 id="added_7">Added</h3>
+<h3 id="added_8">Added</h3>
 <ul>
 <li>Add script <code>odfdo-highlight</code>.</li>
 </ul>
-<h3 id="changed_8">Changed</h3>
+<h3 id="changed_9">Changed</h3>
 <ul>
 <li>Updating dependency versions.</li>
 </ul>
 <h2 id="351-2024-02-20">[3.5.1] - 2024-02-20</h2>
 <p>Fix the update method of <code>Table of Content</code> and add a recipe to show how to update a <code>TOC</code>.</p>
-<h3 id="added_8">Added</h3>
+<h3 id="added_9">Added</h3>
 <ul>
 <li>Add recipe <code>update_a_text_document_with_a_table_of_content</code>.</li>
 </ul>
-<h3 id="changed_9">Changed</h3>
+<h3 id="changed_10">Changed</h3>
 <ul>
 <li>
 <p>Refactor of TOC related code.</p>
@@ -1689,7 +1767,7 @@ <h3 id="changed_9">Changed</h3>
 </ul>
 <h2 id="350-2024-01-27">[3.5.0] - 2024-01-27</h2>
 <p>2024 release, updated ODF templates and better test suit.</p>
-<h3 id="changed_10">Changed</h3>
+<h3 id="changed_11">Changed</h3>
 <ul>
 <li>
 <p>Update <code>ODF</code> templates.</p>
@@ -1703,7 +1781,7 @@ <h3 id="changed_10">Changed</h3>
 </ul>
 <h2 id="347-2024-01-15">[3.4.7] - 2024-01-15</h2>
 <p>Updade to <code>lxml</code> version 5.</p>
-<h3 id="changed_11">Changed</h3>
+<h3 id="changed_12">Changed</h3>
 <pre><code>- Update `lxml` from version 4 to 5.
 </code></pre>
 <h2 id="346-2023-12-25">[3.4.6] - 2023-12-25</h2>
@@ -1712,17 +1790,17 @@ <h3 id="fixed_5">Fixed</h3>
 <ul>
 <li>Fix reading content from a <code>BytesIO</code>.</li>
 </ul>
-<h3 id="changed_12">Changed</h3>
+<h3 id="changed_13">Changed</h3>
 <ul>
 <li>Add script <code>odfdo-replace</code>.</li>
 </ul>
 <h2 id="345-2023-12-24">[3.4.5] - 2023-12-24</h2>
 <p>Add recipes showing how to save/read document from <code>io.BytesIO</code>.</p>
-<h3 id="added_9">Added</h3>
+<h3 id="added_10">Added</h3>
 <ul>
 <li>Add recipes <code>read_document_from_bytesio.py</code> and <code>save_document_as_bytesio.py</code>.</li>
 </ul>
-<h3 id="changed_13">Changed</h3>
+<h3 id="changed_14">Changed</h3>
 <ul>
 <li>Refactoring of code.</li>
 </ul>
@@ -1775,7 +1853,7 @@ <h3 id="changed_13">Changed</h3>
     <script id="__config" type="application/json">{"base": ".", "features": [], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="assets/javascripts/bundle.a7c05c9e.min.js"></script>
+      <script src="assets/javascripts/bundle.081f42fc.min.js"></script>
       
     
   </body>
diff --git a/doc/assets/_mkdocstrings.css b/doc/assets/_mkdocstrings.css
index 4b7d98b..85449ec 100644
--- a/doc/assets/_mkdocstrings.css
+++ b/doc/assets/_mkdocstrings.css
@@ -26,6 +26,11 @@
   float: right;
 }
 
+/* Backward-compatibility: docstring section titles in bold. */
+.doc-section-title {
+  font-weight: bold;
+}
+
 /* Symbols in Navigation and ToC. */
 :root,
 [data-md-color-scheme="default"] {
@@ -106,4 +111,9 @@ code.doc-symbol-module {
 
 code.doc-symbol-module::after {
   content: "mod";
-}
\ No newline at end of file
+}
+
+.doc-signature .autorefs {
+  color: inherit;
+  border-bottom: 1px dotted currentcolor;
+}
diff --git a/doc/assets/javascripts/bundle.a7c05c9e.min.js b/doc/assets/javascripts/bundle.a7c05c9e.min.js
deleted file mode 100644
index 31d7407..0000000
--- a/doc/assets/javascripts/bundle.a7c05c9e.min.js
+++ /dev/null
@@ -1,29 +0,0 @@
-"use strict";(()=>{var Fi=Object.create;var gr=Object.defineProperty;var ji=Object.getOwnPropertyDescriptor;var Wi=Object.getOwnPropertyNames,Dt=Object.getOwnPropertySymbols,Ui=Object.getPrototypeOf,xr=Object.prototype.hasOwnProperty,no=Object.prototype.propertyIsEnumerable;var oo=(e,t,r)=>t in e?gr(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,R=(e,t)=>{for(var r in t||(t={}))xr.call(t,r)&&oo(e,r,t[r]);if(Dt)for(var r of Dt(t))no.call(t,r)&&oo(e,r,t[r]);return e};var io=(e,t)=>{var r={};for(var o in e)xr.call(e,o)&&t.indexOf(o)<0&&(r[o]=e[o]);if(e!=null&&Dt)for(var o of Dt(e))t.indexOf(o)<0&&no.call(e,o)&&(r[o]=e[o]);return r};var yr=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var Di=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Wi(t))!xr.call(e,n)&&n!==r&&gr(e,n,{get:()=>t[n],enumerable:!(o=ji(t,n))||o.enumerable});return e};var Vt=(e,t,r)=>(r=e!=null?Fi(Ui(e)):{},Di(t||!e||!e.__esModule?gr(r,"default",{value:e,enumerable:!0}):r,e));var ao=(e,t,r)=>new Promise((o,n)=>{var i=p=>{try{s(r.next(p))}catch(c){n(c)}},a=p=>{try{s(r.throw(p))}catch(c){n(c)}},s=p=>p.done?o(p.value):Promise.resolve(p.value).then(i,a);s((r=r.apply(e,t)).next())});var co=yr((Er,so)=>{(function(e,t){typeof Er=="object"&&typeof so!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(Er,function(){"use strict";function e(r){var o=!0,n=!1,i=null,a={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function s(H){return!!(H&&H!==document&&H.nodeName!=="HTML"&&H.nodeName!=="BODY"&&"classList"in H&&"contains"in H.classList)}function p(H){var mt=H.type,ze=H.tagName;return!!(ze==="INPUT"&&a[mt]&&!H.readOnly||ze==="TEXTAREA"&&!H.readOnly||H.isContentEditable)}function c(H){H.classList.contains("focus-visible")||(H.classList.add("focus-visible"),H.setAttribute("data-focus-visible-added",""))}function l(H){H.hasAttribute("data-focus-visible-added")&&(H.classList.remove("focus-visible"),H.removeAttribute("data-focus-visible-added"))}function f(H){H.metaKey||H.altKey||H.ctrlKey||(s(r.activeElement)&&c(r.activeElement),o=!0)}function u(H){o=!1}function h(H){s(H.target)&&(o||p(H.target))&&c(H.target)}function w(H){s(H.target)&&(H.target.classList.contains("focus-visible")||H.target.hasAttribute("data-focus-visible-added"))&&(n=!0,window.clearTimeout(i),i=window.setTimeout(function(){n=!1},100),l(H.target))}function A(H){document.visibilityState==="hidden"&&(n&&(o=!0),te())}function te(){document.addEventListener("mousemove",J),document.addEventListener("mousedown",J),document.addEventListener("mouseup",J),document.addEventListener("pointermove",J),document.addEventListener("pointerdown",J),document.addEventListener("pointerup",J),document.addEventListener("touchmove",J),document.addEventListener("touchstart",J),document.addEventListener("touchend",J)}function ie(){document.removeEventListener("mousemove",J),document.removeEventListener("mousedown",J),document.removeEventListener("mouseup",J),document.removeEventListener("pointermove",J),document.removeEventListener("pointerdown",J),document.removeEventListener("pointerup",J),document.removeEventListener("touchmove",J),document.removeEventListener("touchstart",J),document.removeEventListener("touchend",J)}function J(H){H.target.nodeName&&H.target.nodeName.toLowerCase()==="html"||(o=!1,ie())}document.addEventListener("keydown",f,!0),document.addEventListener("mousedown",u,!0),document.addEventListener("pointerdown",u,!0),document.addEventListener("touchstart",u,!0),document.addEventListener("visibilitychange",A,!0),te(),r.addEventListener("focus",h,!0),r.addEventListener("blur",w,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var Yr=yr((Rt,Kr)=>{/*!
- * clipboard.js v2.0.11
- * https://clipboardjs.com/
- *
- * Licensed MIT © Zeno Rocha
- */(function(t,r){typeof Rt=="object"&&typeof Kr=="object"?Kr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof Rt=="object"?Rt.ClipboardJS=r():t.ClipboardJS=r()})(Rt,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return Ii}});var a=i(279),s=i.n(a),p=i(370),c=i.n(p),l=i(817),f=i.n(l);function u(V){try{return document.execCommand(V)}catch(_){return!1}}var h=function(_){var O=f()(_);return u("cut"),O},w=h;function A(V){var _=document.documentElement.getAttribute("dir")==="rtl",O=document.createElement("textarea");O.style.fontSize="12pt",O.style.border="0",O.style.padding="0",O.style.margin="0",O.style.position="absolute",O.style[_?"right":"left"]="-9999px";var j=window.pageYOffset||document.documentElement.scrollTop;return O.style.top="".concat(j,"px"),O.setAttribute("readonly",""),O.value=V,O}var te=function(_,O){var j=A(_);O.container.appendChild(j);var D=f()(j);return u("copy"),j.remove(),D},ie=function(_){var O=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},j="";return typeof _=="string"?j=te(_,O):_ instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(_==null?void 0:_.type)?j=te(_.value,O):(j=f()(_),u("copy")),j},J=ie;function H(V){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?H=function(O){return typeof O}:H=function(O){return O&&typeof Symbol=="function"&&O.constructor===Symbol&&O!==Symbol.prototype?"symbol":typeof O},H(V)}var mt=function(){var _=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},O=_.action,j=O===void 0?"copy":O,D=_.container,Y=_.target,ke=_.text;if(j!=="copy"&&j!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(Y!==void 0)if(Y&&H(Y)==="object"&&Y.nodeType===1){if(j==="copy"&&Y.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(j==="cut"&&(Y.hasAttribute("readonly")||Y.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(ke)return J(ke,{container:D});if(Y)return j==="cut"?w(Y):J(Y,{container:D})},ze=mt;function Ie(V){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?Ie=function(O){return typeof O}:Ie=function(O){return O&&typeof Symbol=="function"&&O.constructor===Symbol&&O!==Symbol.prototype?"symbol":typeof O},Ie(V)}function _i(V,_){if(!(V instanceof _))throw new TypeError("Cannot call a class as a function")}function ro(V,_){for(var O=0;O<_.length;O++){var j=_[O];j.enumerable=j.enumerable||!1,j.configurable=!0,"value"in j&&(j.writable=!0),Object.defineProperty(V,j.key,j)}}function Ai(V,_,O){return _&&ro(V.prototype,_),O&&ro(V,O),V}function Ci(V,_){if(typeof _!="function"&&_!==null)throw new TypeError("Super expression must either be null or a function");V.prototype=Object.create(_&&_.prototype,{constructor:{value:V,writable:!0,configurable:!0}}),_&&br(V,_)}function br(V,_){return br=Object.setPrototypeOf||function(j,D){return j.__proto__=D,j},br(V,_)}function Hi(V){var _=Pi();return function(){var j=Wt(V),D;if(_){var Y=Wt(this).constructor;D=Reflect.construct(j,arguments,Y)}else D=j.apply(this,arguments);return ki(this,D)}}function ki(V,_){return _&&(Ie(_)==="object"||typeof _=="function")?_:$i(V)}function $i(V){if(V===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return V}function Pi(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(V){return!1}}function Wt(V){return Wt=Object.setPrototypeOf?Object.getPrototypeOf:function(O){return O.__proto__||Object.getPrototypeOf(O)},Wt(V)}function vr(V,_){var O="data-clipboard-".concat(V);if(_.hasAttribute(O))return _.getAttribute(O)}var Ri=function(V){Ci(O,V);var _=Hi(O);function O(j,D){var Y;return _i(this,O),Y=_.call(this),Y.resolveOptions(D),Y.listenClick(j),Y}return Ai(O,[{key:"resolveOptions",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof D.action=="function"?D.action:this.defaultAction,this.target=typeof D.target=="function"?D.target:this.defaultTarget,this.text=typeof D.text=="function"?D.text:this.defaultText,this.container=Ie(D.container)==="object"?D.container:document.body}},{key:"listenClick",value:function(D){var Y=this;this.listener=c()(D,"click",function(ke){return Y.onClick(ke)})}},{key:"onClick",value:function(D){var Y=D.delegateTarget||D.currentTarget,ke=this.action(Y)||"copy",Ut=ze({action:ke,container:this.container,target:this.target(Y),text:this.text(Y)});this.emit(Ut?"success":"error",{action:ke,text:Ut,trigger:Y,clearSelection:function(){Y&&Y.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(D){return vr("action",D)}},{key:"defaultTarget",value:function(D){var Y=vr("target",D);if(Y)return document.querySelector(Y)}},{key:"defaultText",value:function(D){return vr("text",D)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(D){var Y=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return J(D,Y)}},{key:"cut",value:function(D){return w(D)}},{key:"isSupported",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],Y=typeof D=="string"?[D]:D,ke=!!document.queryCommandSupported;return Y.forEach(function(Ut){ke=ke&&!!document.queryCommandSupported(Ut)}),ke}}]),O}(s()),Ii=Ri},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function a(s,p){for(;s&&s.nodeType!==n;){if(typeof s.matches=="function"&&s.matches(p))return s;s=s.parentNode}}o.exports=a},438:function(o,n,i){var a=i(828);function s(l,f,u,h,w){var A=c.apply(this,arguments);return l.addEventListener(u,A,w),{destroy:function(){l.removeEventListener(u,A,w)}}}function p(l,f,u,h,w){return typeof l.addEventListener=="function"?s.apply(null,arguments):typeof u=="function"?s.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(A){return s(A,f,u,h,w)}))}function c(l,f,u,h){return function(w){w.delegateTarget=a(w.target,f),w.delegateTarget&&h.call(l,w)}}o.exports=p},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var a=Object.prototype.toString.call(i);return i!==void 0&&(a==="[object NodeList]"||a==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var a=Object.prototype.toString.call(i);return a==="[object Function]"}},370:function(o,n,i){var a=i(879),s=i(438);function p(u,h,w){if(!u&&!h&&!w)throw new Error("Missing required arguments");if(!a.string(h))throw new TypeError("Second argument must be a String");if(!a.fn(w))throw new TypeError("Third argument must be a Function");if(a.node(u))return c(u,h,w);if(a.nodeList(u))return l(u,h,w);if(a.string(u))return f(u,h,w);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function c(u,h,w){return u.addEventListener(h,w),{destroy:function(){u.removeEventListener(h,w)}}}function l(u,h,w){return Array.prototype.forEach.call(u,function(A){A.addEventListener(h,w)}),{destroy:function(){Array.prototype.forEach.call(u,function(A){A.removeEventListener(h,w)})}}}function f(u,h,w){return s(document.body,u,h,w)}o.exports=p},817:function(o){function n(i){var a;if(i.nodeName==="SELECT")i.focus(),a=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var s=i.hasAttribute("readonly");s||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),s||i.removeAttribute("readonly"),a=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var p=window.getSelection(),c=document.createRange();c.selectNodeContents(i),p.removeAllRanges(),p.addRange(c),a=p.toString()}return a}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,a,s){var p=this.e||(this.e={});return(p[i]||(p[i]=[])).push({fn:a,ctx:s}),this},once:function(i,a,s){var p=this;function c(){p.off(i,c),a.apply(s,arguments)}return c._=a,this.on(i,c,s)},emit:function(i){var a=[].slice.call(arguments,1),s=((this.e||(this.e={}))[i]||[]).slice(),p=0,c=s.length;for(p;p<c;p++)s[p].fn.apply(s[p].ctx,a);return this},off:function(i,a){var s=this.e||(this.e={}),p=s[i],c=[];if(p&&a)for(var l=0,f=p.length;l<f;l++)p[l].fn!==a&&p[l].fn._!==a&&c.push(p[l]);return c.length?s[i]=c:delete s[i],this}},o.exports=n,o.exports.TinyEmitter=n}},t={};function r(o){if(t[o])return t[o].exports;var n=t[o]={exports:{}};return e[o](n,n.exports,r),n.exports}return function(){r.n=function(o){var n=o&&o.__esModule?function(){return o.default}:function(){return o};return r.d(n,{a:n}),n}}(),function(){r.d=function(o,n){for(var i in n)r.o(n,i)&&!r.o(o,i)&&Object.defineProperty(o,i,{enumerable:!0,get:n[i]})}}(),function(){r.o=function(o,n){return Object.prototype.hasOwnProperty.call(o,n)}}(),r(686)}().default})});var ti=yr((gT,ei)=>{"use strict";/*!
- * escape-html
- * Copyright(c) 2012-2013 TJ Holowaychuk
- * Copyright(c) 2015 Andreas Lubbe
- * Copyright(c) 2015 Tiancheng "Timothy" Gu
- * MIT Licensed
- */var ts=/["'&<>]/;ei.exports=rs;function rs(e){var t=""+e,r=ts.exec(t);if(!r)return t;var o,n="",i=0,a=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}a!==i&&(n+=t.substring(a,i)),a=i+1,n+=o}return a!==i?n+t.substring(a,i):n}});var e0=Vt(co());/*! *****************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */var wr=function(e,t){return wr=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},wr(e,t)};function re(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");wr(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function po(e,t,r,o){function n(i){return i instanceof r?i:new r(function(a){a(i)})}return new(r||(r=Promise))(function(i,a){function s(l){try{c(o.next(l))}catch(f){a(f)}}function p(l){try{c(o.throw(l))}catch(f){a(f)}}function c(l){l.done?i(l.value):n(l.value).then(s,p)}c((o=o.apply(e,t||[])).next())})}function Nt(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,a;return a={next:s(0),throw:s(1),return:s(2)},typeof Symbol=="function"&&(a[Symbol.iterator]=function(){return this}),a;function s(c){return function(l){return p([c,l])}}function p(c){if(o)throw new TypeError("Generator is already executing.");for(;r;)try{if(o=1,n&&(i=c[0]&2?n.return:c[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,c[1])).done)return i;switch(n=0,i&&(c=[c[0]&2,i.value]),c[0]){case 0:case 1:i=c;break;case 4:return r.label++,{value:c[1],done:!1};case 5:r.label++,n=c[1],c=[0];continue;case 7:c=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(c[0]===6||c[0]===2)){r=0;continue}if(c[0]===3&&(!i||c[1]>i[0]&&c[1]<i[3])){r.label=c[1];break}if(c[0]===6&&r.label<i[1]){r.label=i[1],i=c;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(c);break}i[2]&&r.ops.pop(),r.trys.pop();continue}c=t.call(e,r)}catch(l){c=[6,l],n=0}finally{o=i=0}if(c[0]&5)throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}}function de(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function N(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],a;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(s){a={error:s}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(a)throw a.error}}return i}function q(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function nt(e){return this instanceof nt?(this.v=e,this):new nt(e)}function lo(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n={},a("next"),a("throw"),a("return"),n[Symbol.asyncIterator]=function(){return this},n;function a(u){o[u]&&(n[u]=function(h){return new Promise(function(w,A){i.push([u,h,w,A])>1||s(u,h)})})}function s(u,h){try{p(o[u](h))}catch(w){f(i[0][3],w)}}function p(u){u.value instanceof nt?Promise.resolve(u.value.v).then(c,l):f(i[0][2],u)}function c(u){s("next",u)}function l(u){s("throw",u)}function f(u,h){u(h),i.shift(),i.length&&s(i[0][0],i[0][1])}}function mo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof de=="function"?de(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(a){return new Promise(function(s,p){a=e[i](a),n(s,p,a.done,a.value)})}}function n(i,a,s,p){Promise.resolve(p).then(function(c){i({value:c,done:s})},a)}}function k(e){return typeof e=="function"}function ft(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var zt=ft(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
-`+r.map(function(o,n){return n+1+") "+o.toString()}).join(`
-  `):"",this.name="UnsubscriptionError",this.errors=r}});function qe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Fe=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=de(a),p=s.next();!p.done;p=s.next()){var c=p.value;c.remove(this)}}catch(A){t={error:A}}finally{try{p&&!p.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(k(l))try{l()}catch(A){i=A instanceof zt?A.errors:[A]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=de(f),h=u.next();!h.done;h=u.next()){var w=h.value;try{fo(w)}catch(A){i=i!=null?i:[],A instanceof zt?i=q(q([],N(i)),N(A.errors)):i.push(A)}}}catch(A){o={error:A}}finally{try{h&&!h.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new zt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)fo(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&qe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&qe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Tr=Fe.EMPTY;function qt(e){return e instanceof Fe||e&&"closed"in e&&k(e.remove)&&k(e.add)&&k(e.unsubscribe)}function fo(e){k(e)?e():e.unsubscribe()}var $e={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var ut={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=ut.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,q([e,t],N(r))):setTimeout.apply(void 0,q([e,t],N(r)))},clearTimeout:function(e){var t=ut.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Qt(e){ut.setTimeout(function(){var t=$e.onUnhandledError;if(t)t(e);else throw e})}function he(){}var uo=function(){return Sr("C",void 0,void 0)}();function ho(e){return Sr("E",void 0,e)}function bo(e){return Sr("N",e,void 0)}function Sr(e,t,r){return{kind:e,value:t,error:r}}var it=null;function dt(e){if($e.useDeprecatedSynchronousErrorHandling){var t=!it;if(t&&(it={errorThrown:!1,error:null}),e(),t){var r=it,o=r.errorThrown,n=r.error;if(it=null,o)throw n}}else e()}function vo(e){$e.useDeprecatedSynchronousErrorHandling&&it&&(it.errorThrown=!0,it.error=e)}var Mt=function(e){re(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,qt(r)&&r.add(o)):o.destination=qi,o}return t.create=function(r,o,n){return new at(r,o,n)},t.prototype.next=function(r){this.isStopped?Mr(bo(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Mr(ho(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Mr(uo,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Fe);var Vi=Function.prototype.bind;function Or(e,t){return Vi.call(e,t)}var Ni=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Kt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Kt(o)}else Kt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Kt(r)}},e}(),at=function(e){re(t,e);function t(r,o,n){var i=e.call(this)||this,a;if(k(r)||!r)a={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var s;i&&$e.useDeprecatedNextContext?(s=Object.create(r),s.unsubscribe=function(){return i.unsubscribe()},a={next:r.next&&Or(r.next,s),error:r.error&&Or(r.error,s),complete:r.complete&&Or(r.complete,s)}):a=r}return i.destination=new Ni(a),i}return t}(Mt);function Kt(e){$e.useDeprecatedSynchronousErrorHandling?vo(e):Qt(e)}function zi(e){throw e}function Mr(e,t){var r=$e.onStoppedNotification;r&&ut.setTimeout(function(){return r(e,t)})}var qi={closed:!0,next:he,error:zi,complete:he};var ht=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function le(e){return e}function go(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Lr(e)}function Lr(e){return e.length===0?le:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var F=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=Ki(t)?t:new at(t,r,o);return dt(function(){var a=n,s=a.operator,p=a.source;i.add(s?s.call(i,p):p?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=xo(r),new r(function(n,i){var a=new at({next:function(s){try{t(s)}catch(p){i(p),a.unsubscribe()}},error:i,complete:n});o.subscribe(a)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[ht]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Lr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=xo(t),new t(function(o,n){var i;r.subscribe(function(a){return i=a},function(a){return n(a)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function xo(e){var t;return(t=e!=null?e:$e.Promise)!==null&&t!==void 0?t:Promise}function Qi(e){return e&&k(e.next)&&k(e.error)&&k(e.complete)}function Ki(e){return e&&e instanceof Mt||Qi(e)&&qt(e)}function Yi(e){return k(e==null?void 0:e.lift)}function x(e){return function(t){if(Yi(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function T(e,t,r,o,n){return new Bi(e,t,r,o,n)}var Bi=function(e){re(t,e);function t(r,o,n,i,a,s){var p=e.call(this,r)||this;return p.onFinalize=a,p.shouldUnsubscribe=s,p._next=o?function(c){try{o(c)}catch(l){r.error(l)}}:e.prototype._next,p._error=i?function(c){try{i(c)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,p._complete=n?function(){try{n()}catch(c){r.error(c)}finally{this.unsubscribe()}}:e.prototype._complete,p}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(Mt);var bt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=bt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Fe(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=bt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,q([],N(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=bt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,q([],N(e)))},delegate:void 0};var yo=ft(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var g=function(e){re(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new Eo(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new yo},t.prototype.next=function(r){var o=this;dt(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var a=de(o.currentObservers),s=a.next();!s.done;s=a.next()){var p=s.value;p.next(r)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;dt(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;dt(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Tr:(this.currentObservers=null,s.push(r),new Fe(function(){o.currentObservers=null,qe(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new F;return r.source=this,r},t.create=function(r,o){return new Eo(r,o)},t}(F);var Eo=function(e){re(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Tr},t}(g);var _r=function(e){re(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(g);var Lt={now:function(){return(Lt.delegate||Date).now()},delegate:void 0};var _t=function(e){re(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=Lt);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,p=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+p)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),p=0;p<s.length&&!r.closed;p+=i?1:2)r.next(s[p]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,a=r._infiniteTimeWindow,s=(a?1:2)*o;if(o<1/0&&s<i.length&&i.splice(0,i.length-s),!a){for(var p=n.now(),c=0,l=1;l<i.length&&i[l]<=p;l+=2)c=l;c&&i.splice(0,c+1)}},t}(g);var wo=function(e){re(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Fe);var At={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=At.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,q([e,t],N(r))):setInterval.apply(void 0,q([e,t],N(r)))},clearInterval:function(e){var t=At.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var vt=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,a=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(a,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(a,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),At.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&At.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(a){n=!0,i=a||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,qe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(wo);var Ar=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=Lt.now,e}();var gt=function(e){re(t,e);function t(r,o){o===void 0&&(o=Ar.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ar);var se=new gt(vt),Cr=se;var To=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(vt);var So=function(e){re(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(gt);var Hr=new So(To);var Oo=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=bt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(bt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(vt);var Mo=function(e){re(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(gt);var me=new Mo(Oo);var M=new F(function(e){return e.complete()});function Yt(e){return e&&k(e.schedule)}function kr(e){return e[e.length-1]}function Xe(e){return k(kr(e))?e.pop():void 0}function He(e){return Yt(kr(e))?e.pop():void 0}function Bt(e,t){return typeof kr(e)=="number"?e.pop():t}var xt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Gt(e){return k(e==null?void 0:e.then)}function Jt(e){return k(e[ht])}function Xt(e){return Symbol.asyncIterator&&k(e==null?void 0:e[Symbol.asyncIterator])}function Zt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Gi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var er=Gi();function tr(e){return k(e==null?void 0:e[er])}function rr(e){return lo(this,arguments,function(){var r,o,n,i;return Nt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,nt(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,nt(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,nt(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function or(e){return k(e==null?void 0:e.getReader)}function W(e){if(e instanceof F)return e;if(e!=null){if(Jt(e))return Ji(e);if(xt(e))return Xi(e);if(Gt(e))return Zi(e);if(Xt(e))return Lo(e);if(tr(e))return ea(e);if(or(e))return ta(e)}throw Zt(e)}function Ji(e){return new F(function(t){var r=e[ht]();if(k(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Xi(e){return new F(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function Zi(e){return new F(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Qt)})}function ea(e){return new F(function(t){var r,o;try{for(var n=de(e),i=n.next();!i.done;i=n.next()){var a=i.value;if(t.next(a),t.closed)return}}catch(s){r={error:s}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Lo(e){return new F(function(t){ra(e,t).catch(function(r){return t.error(r)})})}function ta(e){return Lo(rr(e))}function ra(e,t){var r,o,n,i;return po(this,void 0,void 0,function(){var a,s;return Nt(this,function(p){switch(p.label){case 0:p.trys.push([0,5,6,11]),r=mo(e),p.label=1;case 1:return[4,r.next()];case 2:if(o=p.sent(),!!o.done)return[3,4];if(a=o.value,t.next(a),t.closed)return[2];p.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return s=p.sent(),n={error:s},[3,11];case 6:return p.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:p.sent(),p.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function Ee(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function be(e,t){return t===void 0&&(t=0),x(function(r,o){r.subscribe(T(o,function(n){return Ee(o,e,function(){return o.next(n)},t)},function(){return Ee(o,e,function(){return o.complete()},t)},function(n){return Ee(o,e,function(){return o.error(n)},t)}))})}function Qe(e,t){return t===void 0&&(t=0),x(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function _o(e,t){return W(e).pipe(Qe(t),be(t))}function Ao(e,t){return W(e).pipe(Qe(t),be(t))}function Co(e,t){return new F(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function Ho(e,t){return new F(function(r){var o;return Ee(r,t,function(){o=e[er](),Ee(r,t,function(){var n,i,a;try{n=o.next(),i=n.value,a=n.done}catch(s){r.error(s);return}a?r.complete():r.next(i)},0,!0)}),function(){return k(o==null?void 0:o.return)&&o.return()}})}function nr(e,t){if(!e)throw new Error("Iterable cannot be null");return new F(function(r){Ee(r,t,function(){var o=e[Symbol.asyncIterator]();Ee(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function ko(e,t){return nr(rr(e),t)}function $o(e,t){if(e!=null){if(Jt(e))return _o(e,t);if(xt(e))return Co(e,t);if(Gt(e))return Ao(e,t);if(Xt(e))return nr(e,t);if(tr(e))return Ho(e,t);if(or(e))return ko(e,t)}throw Zt(e)}function ue(e,t){return t?$o(e,t):W(e)}function I(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e);return ue(e,r)}function $r(e,t){var r=k(e)?e:function(){return e},o=function(n){return n.error(r())};return new F(t?function(n){return t.schedule(o,0,n)}:o)}var ir=ft(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Po(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return x(function(r,o){var n=0;r.subscribe(T(o,function(i){o.next(e.call(t,i,n++))}))})}var oa=Array.isArray;function na(e,t){return oa(t)?e.apply(void 0,q([],N(t))):e(t)}function Ze(e){return m(function(t){return na(e,t)})}var ia=Array.isArray,aa=Object.getPrototypeOf,sa=Object.prototype,ca=Object.keys;function Ro(e){if(e.length===1){var t=e[0];if(ia(t))return{args:t,keys:null};if(pa(t)){var r=ca(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function pa(e){return e&&typeof e=="object"&&aa(e)===sa}function Io(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Xe(e),n=Ro(e),i=n.args,a=n.keys;if(i.length===0)return ue([],r);var s=new F(Pr(i,r,a?function(p){return Io(a,p)}:le));return o?s.pipe(Ze(o)):s}function Pr(e,t,r){return r===void 0&&(r=le),function(o){Fo(t,function(){for(var n=e.length,i=new Array(n),a=n,s=n,p=function(l){Fo(t,function(){var f=ue(e[l],t),u=!1;f.subscribe(T(o,function(h){i[l]=h,u||(u=!0,s--),s||o.next(r(i.slice()))},function(){--a||o.complete()}))},o)},c=0;c<n;c++)p(c)},o)}}function Fo(e,t,r){e?Ee(r,e,t):t()}function jo(e,t,r,o,n,i,a,s){var p=[],c=0,l=0,f=!1,u=function(){f&&!p.length&&!c&&t.complete()},h=function(A){return c<o?w(A):p.push(A)},w=function(A){i&&t.next(A),c++;var te=!1;W(r(A,l++)).subscribe(T(t,function(ie){n==null||n(ie),i?h(ie):t.next(ie)},function(){te=!0},void 0,function(){if(te)try{c--;for(var ie=function(){var J=p.shift();a?Ee(t,a,function(){return w(J)}):w(J)};p.length&&c<o;)ie();u()}catch(J){t.error(J)}}))};return e.subscribe(T(t,h,function(){f=!0,u()})),function(){s==null||s()}}function oe(e,t,r){return r===void 0&&(r=1/0),k(t)?oe(function(o,n){return m(function(i,a){return t(o,i,n,a)})(W(e(o,n)))},r):(typeof t=="number"&&(r=t),x(function(o,n){return jo(o,n,e,r)}))}function yt(e){return e===void 0&&(e=1/0),oe(le,e)}function Wo(){return yt(1)}function je(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Wo()(ue(e,He(e)))}function C(e){return new F(function(t){W(e()).subscribe(t)})}var la=["addListener","removeListener"],ma=["addEventListener","removeEventListener"],fa=["on","off"];function d(e,t,r,o){if(k(r)&&(o=r,r=void 0),o)return d(e,t,r).pipe(Ze(o));var n=N(ha(e)?ma.map(function(s){return function(p){return e[s](t,p,r)}}):ua(e)?la.map(Uo(e,t)):da(e)?fa.map(Uo(e,t)):[],2),i=n[0],a=n[1];if(!i&&xt(e))return oe(function(s){return d(s,t,r)})(W(e));if(!i)throw new TypeError("Invalid event target");return new F(function(s){var p=function(){for(var c=[],l=0;l<arguments.length;l++)c[l]=arguments[l];return s.next(1<c.length?c:c[0])};return i(p),function(){return a(p)}})}function Uo(e,t){return function(r){return function(o){return e[r](t,o)}}}function ua(e){return k(e.addListener)&&k(e.removeListener)}function da(e){return k(e.on)&&k(e.off)}function ha(e){return k(e.addEventListener)&&k(e.removeEventListener)}function ar(e,t,r){return r?ar(e,t).pipe(Ze(r)):new F(function(o){var n=function(){for(var a=[],s=0;s<arguments.length;s++)a[s]=arguments[s];return o.next(a.length===1?a[0]:a)},i=e(n);return k(t)?function(){return t(n,i)}:void 0})}function Me(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Cr);var o=-1;return t!=null&&(Yt(t)?r=t:o=t),new F(function(n){var i=Po(e)?+e-r.now():e;i<0&&(i=0);var a=0;return r.schedule(function(){n.closed||(n.next(a++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function S(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Bt(e,1/0),n=e;return n.length?n.length===1?W(n[0]):yt(o)(ue(n,r)):M}var Ke=new F(he);var ba=Array.isArray;function Et(e){return e.length===1&&ba(e[0])?e[0]:e}function b(e,t){return x(function(r,o){var n=0;r.subscribe(T(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function Ct(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e),o=Et(e);return o.length?new F(function(n){var i=o.map(function(){return[]}),a=o.map(function(){return!1});n.add(function(){i=a=null});for(var s=function(c){W(o[c]).subscribe(T(n,function(l){if(i[c].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,q([],N(f))):f),i.some(function(u,h){return!u.length&&a[h]})&&n.complete()}},function(){a[c]=!0,!i[c].length&&n.complete()}))},p=0;!n.closed&&p<o.length;p++)s(p);return function(){i=a=null}}):M}function Do(e){return x(function(t,r){var o=!1,n=null,i=null,a=!1,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var c=n;n=null,r.next(c)}a&&r.complete()},p=function(){i=null,a&&r.complete()};t.subscribe(T(r,function(c){o=!0,n=c,i||W(e(c)).subscribe(i=T(r,s,p))},function(){a=!0,(!o||!i||i.closed)&&r.complete()}))})}function Le(e,t){return t===void 0&&(t=se),Do(function(){return Me(e,t)})}function Ye(e,t){return t===void 0&&(t=null),t=t!=null?t:e,x(function(r,o){var n=[],i=0;r.subscribe(T(o,function(a){var s,p,c,l,f=null;i++%t===0&&n.push([]);try{for(var u=de(n),h=u.next();!h.done;h=u.next()){var w=h.value;w.push(a),e<=w.length&&(f=f!=null?f:[],f.push(w))}}catch(ie){s={error:ie}}finally{try{h&&!h.done&&(p=u.return)&&p.call(u)}finally{if(s)throw s.error}}if(f)try{for(var A=de(f),te=A.next();!te.done;te=A.next()){var w=te.value;qe(n,w),o.next(w)}}catch(ie){c={error:ie}}finally{try{te&&!te.done&&(l=A.return)&&l.call(A)}finally{if(c)throw c.error}}},function(){var a,s;try{for(var p=de(n),c=p.next();!c.done;c=p.next()){var l=c.value;o.next(l)}}catch(f){a={error:f}}finally{try{c&&!c.done&&(s=p.return)&&s.call(p)}finally{if(a)throw a.error}}o.complete()},void 0,function(){n=null}))})}function ve(e){return x(function(t,r){var o=null,n=!1,i;o=t.subscribe(T(r,void 0,void 0,function(a){i=W(e(a,ve(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function Vo(e,t,r,o,n){return function(i,a){var s=r,p=t,c=0;i.subscribe(T(a,function(l){var f=c++;p=s?e(p,l,f):(s=!0,l),o&&a.next(p)},n&&function(){s&&a.next(p),a.complete()}))}}function Rr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return r?go(Rr.apply(void 0,q([],N(e))),Ze(r)):x(function(o,n){Pr(q([o],N(Et(e))))(n)})}function We(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Rr.apply(void 0,q([],N(e)))}function Ht(e){return x(function(t,r){var o=!1,n=null,i=null,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var s=n;n=null,r.next(s)}};t.subscribe(T(r,function(s){i==null||i.unsubscribe(),o=!0,n=s,i=T(r,a,he),W(e(s)).subscribe(i)},function(){a(),r.complete()},void 0,function(){n=i=null}))})}function _e(e,t){return t===void 0&&(t=se),x(function(r,o){var n=null,i=null,a=null,s=function(){if(n){n.unsubscribe(),n=null;var c=i;i=null,o.next(c)}};function p(){var c=a+e,l=t.now();if(l<c){n=this.schedule(void 0,c-l),o.add(n);return}s()}r.subscribe(T(o,function(c){i=c,a=t.now(),n||(n=t.schedule(p,e),o.add(n))},function(){s(),o.complete()},void 0,function(){i=n=null}))})}function Be(e){return x(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function we(e){return e<=0?function(){return M}:x(function(t,r){var o=0;t.subscribe(T(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function X(){return x(function(e,t){e.subscribe(T(t,he))})}function No(e){return m(function(){return e})}function Ir(e,t){return t?function(r){return je(t.pipe(we(1),X()),r.pipe(Ir(e)))}:oe(function(r,o){return W(e(r,o)).pipe(we(1),No(r))})}function Ge(e,t){t===void 0&&(t=se);var r=Me(e,t);return Ir(function(){return r})}function K(e,t){return t===void 0&&(t=le),e=e!=null?e:va,x(function(r,o){var n,i=!0;r.subscribe(T(o,function(a){var s=t(a);(i||!e(n,s))&&(i=!1,n=s,o.next(a))}))})}function va(e,t){return e===t}function Z(e,t){return K(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function zo(e){return e===void 0&&(e=ga),x(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function ga(){return new ir}function ne(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return je(r,I.apply(void 0,q([],N(e))))}}function L(e){return x(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Ae(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?b(function(n,i){return e(n,i,o)}):le,we(1),r?Be(t):zo(function(){return new ir}))}}function Fr(e){return e<=0?function(){return M}:x(function(t,r){var o=[];t.subscribe(T(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var a=de(o),s=a.next();!s.done;s=a.next()){var p=s.value;r.next(p)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function qo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Bt(e,1/0);return e=Et(e),x(function(n,i){yt(o)(ue(q([n],N(e)),r)).subscribe(i)})}function Pe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return qo.apply(void 0,q([],N(e)))}function st(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return M}:x(function(n,i){var a=0,s,p=function(){if(s==null||s.unsubscribe(),s=null,o!=null){var l=typeof o=="number"?Me(o):W(o(a)),f=T(i,function(){f.unsubscribe(),c()});l.subscribe(f)}else c()},c=function(){var l=!1;s=n.subscribe(T(i,void 0,function(){++a<r?s?p():l=!0:i.complete()})),l&&p()};c()})}function jr(e,t){return x(Vo(e,t,arguments.length>=2,!0))}function pe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new g}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,p=s===void 0?!0:s;return function(c){var l,f,u,h=0,w=!1,A=!1,te=function(){f==null||f.unsubscribe(),f=void 0},ie=function(){te(),l=u=void 0,w=A=!1},J=function(){var H=l;ie(),H==null||H.unsubscribe()};return x(function(H,mt){h++,!A&&!w&&te();var ze=u=u!=null?u:r();mt.add(function(){h--,h===0&&!A&&!w&&(f=Wr(J,p))}),ze.subscribe(mt),!l&&h>0&&(l=new at({next:function(Ie){return ze.next(Ie)},error:function(Ie){A=!0,te(),f=Wr(ie,n,Ie),ze.error(Ie)},complete:function(){w=!0,te(),f=Wr(ie,a),ze.complete()}}),W(H).subscribe(l))})(c)}}function Wr(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new at({next:function(){n.unsubscribe(),e()}});return W(t.apply(void 0,q([],N(r)))).subscribe(n)}}function B(e,t,r){var o,n,i,a,s=!1;return e&&typeof e=="object"?(o=e.bufferSize,a=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,s=i===void 0?!1:i,r=e.scheduler):a=e!=null?e:1/0,pe({connector:function(){return new _t(a,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:s})}function Ce(e){return b(function(t,r){return e<=r})}function Ur(e){return x(function(t,r){var o=!1,n=T(r,function(){n==null||n.unsubscribe(),o=!0},he);W(e).subscribe(n),t.subscribe(T(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e);return x(function(o,n){(r?je(e,o,r):je(e,o)).subscribe(n)})}function v(e,t){return x(function(r,o){var n=null,i=0,a=!1,s=function(){return a&&!n&&o.complete()};r.subscribe(T(o,function(p){n==null||n.unsubscribe();var c=0,l=i++;W(e(p,l)).subscribe(n=T(o,function(f){return o.next(t?t(p,f,l,c++):f)},function(){n=null,s()}))},function(){a=!0,s()}))})}function U(e){return x(function(t,r){W(e).subscribe(T(r,function(){return r.complete()},he)),!r.closed&&t.subscribe(r)})}function Dr(e,t){return t===void 0&&(t=!1),x(function(r,o){var n=0;r.subscribe(T(o,function(i){var a=e(i,n++);(a||t)&&o.next(i),!a&&o.complete()}))})}function y(e,t,r){var o=k(e)||t||r?{next:e,error:t,complete:r}:e;return o?x(function(n,i){var a;(a=o.subscribe)===null||a===void 0||a.call(o);var s=!0;n.subscribe(T(i,function(p){var c;(c=o.next)===null||c===void 0||c.call(o,p),i.next(p)},function(){var p;s=!1,(p=o.complete)===null||p===void 0||p.call(o),i.complete()},function(p){var c;s=!1,(c=o.error)===null||c===void 0||c.call(o,p),i.error(p)},function(){var p,c;s&&((p=o.unsubscribe)===null||p===void 0||p.call(o)),(c=o.finalize)===null||c===void 0||c.call(o)}))}):le}function Qo(e,t){return x(function(r,o){var n=t!=null?t:{},i=n.leading,a=i===void 0?!0:i,s=n.trailing,p=s===void 0?!1:s,c=!1,l=null,f=null,u=!1,h=function(){f==null||f.unsubscribe(),f=null,p&&(te(),u&&o.complete())},w=function(){f=null,u&&o.complete()},A=function(ie){return f=W(e(ie)).subscribe(T(o,h,w))},te=function(){if(c){c=!1;var ie=l;l=null,o.next(ie),!u&&A(ie)}};r.subscribe(T(o,function(ie){c=!0,l=ie,!(f&&!f.closed)&&(a?te():A(ie))},function(){u=!0,!(p&&c&&f&&!f.closed)&&o.complete()}))})}function ct(e,t,r){t===void 0&&(t=se);var o=Me(e,t);return Qo(function(){return o},r)}function ee(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return x(function(o,n){for(var i=e.length,a=new Array(i),s=e.map(function(){return!1}),p=!1,c=function(f){W(e[f]).subscribe(T(n,function(u){a[f]=u,!p&&!s[f]&&(s[f]=!0,(p=s.every(le))&&(s=null))},he))},l=0;l<i;l++)c(l);o.subscribe(T(n,function(f){if(p){var u=q([f],N(a));n.next(r?r.apply(void 0,q([],N(u))):u)}}))})}function Ko(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return x(function(r,o){Ct.apply(void 0,q([r],N(e))).subscribe(o)})}function Vr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Ko.apply(void 0,q([],N(e)))}function Yo(){let e=new _t(1);return d(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function $(e,t=document){return Array.from(t.querySelectorAll(e))}function P(e,t=document){let r=fe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function fe(e,t=document){return t.querySelector(e)||void 0}function Re(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var xa=S(d(document.body,"focusin"),d(document.body,"focusout")).pipe(_e(1),Q(void 0),m(()=>Re()||document.body),B(1));function et(e){return xa.pipe(m(t=>e.contains(t)),K())}function kt(e,t){return C(()=>S(d(e,"mouseenter").pipe(m(()=>!0)),d(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ht(r=>Me(+!r*t)):le,Q(e.matches(":hover"))))}function Bo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Bo(e,r)}function E(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Bo(o,n);return o}function sr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function wt(e){let t=E("script",{src:e});return C(()=>(document.head.appendChild(t),S(d(t,"load"),d(t,"error").pipe(v(()=>$r(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),L(()=>document.head.removeChild(t)),we(1))))}var Go=new g,ya=C(()=>typeof ResizeObserver=="undefined"?wt("https://unpkg.com/resize-observer-polyfill"):I(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>Go.next(t)))),v(e=>S(Ke,I(e)).pipe(L(()=>e.disconnect()))),B(1));function ce(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return ya.pipe(y(r=>r.observe(t)),v(r=>Go.pipe(b(o=>o.target===t),L(()=>r.unobserve(t)))),m(()=>ce(e)),Q(ce(e)))}function Tt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function Jo(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Ue(e){return{x:e.offsetLeft,y:e.offsetTop}}function Xo(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function Zo(e){return S(d(window,"load"),d(window,"resize")).pipe(Le(0,me),m(()=>Ue(e)),Q(Ue(e)))}function pr(e){return{x:e.scrollLeft,y:e.scrollTop}}function De(e){return S(d(e,"scroll"),d(window,"scroll"),d(window,"resize")).pipe(Le(0,me),m(()=>pr(e)),Q(pr(e)))}var en=new g,Ea=C(()=>I(new IntersectionObserver(e=>{for(let t of e)en.next(t)},{threshold:0}))).pipe(v(e=>S(Ke,I(e)).pipe(L(()=>e.disconnect()))),B(1));function tt(e){return Ea.pipe(y(t=>t.observe(e)),v(t=>en.pipe(b(({target:r})=>r===e),L(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function tn(e,t=16){return De(e).pipe(m(({y:r})=>{let o=ce(e),n=Tt(e);return r>=n.height-o.height-t}),K())}var lr={drawer:P("[data-md-toggle=drawer]"),search:P("[data-md-toggle=search]")};function rn(e){return lr[e].checked}function Je(e,t){lr[e].checked!==t&&lr[e].click()}function Ve(e){let t=lr[e];return d(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function wa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Ta(){return S(d(window,"compositionstart").pipe(m(()=>!0)),d(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function on(){let e=d(window,"keydown").pipe(b(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:rn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),b(({mode:t,type:r})=>{if(t==="global"){let o=Re();if(typeof o!="undefined")return!wa(o,r)}return!0}),pe());return Ta().pipe(v(t=>t?M:e))}function xe(){return new URL(location.href)}function pt(e,t=!1){if(G("navigation.instant")&&!t){let r=E("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function nn(){return new g}function an(){return location.hash.slice(1)}function sn(e){let t=E("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Sa(e){return S(d(window,"hashchange"),e).pipe(m(an),Q(an()),b(t=>t.length>0),B(1))}function cn(e){return Sa(e).pipe(m(t=>fe(`[id="${t}"]`)),b(t=>typeof t!="undefined"))}function $t(e){let t=matchMedia(e);return ar(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function pn(){let e=matchMedia("print");return S(d(window,"beforeprint").pipe(m(()=>!0)),d(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function Nr(e,t){return e.pipe(v(r=>r?t():M))}function zr(e,t){return new F(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let a=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+a*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function Ne(e,t){return zr(e,t).pipe(v(r=>r.text()),m(r=>JSON.parse(r)),B(1))}function ln(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),B(1))}function mn(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),B(1))}function fn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function un(){return S(d(window,"scroll",{passive:!0}),d(window,"resize",{passive:!0})).pipe(m(fn),Q(fn()))}function dn(){return{width:innerWidth,height:innerHeight}}function hn(){return d(window,"resize",{passive:!0}).pipe(m(dn),Q(dn()))}function bn(){return z([un(),hn()]).pipe(m(([e,t])=>({offset:e,size:t})),B(1))}function mr(e,{viewport$:t,header$:r}){let o=t.pipe(Z("size")),n=z([o,r]).pipe(m(()=>Ue(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:p,y:c}])=>({offset:{x:a.x-p,y:a.y-c+i},size:s})))}function Oa(e){return d(e,"message",t=>t.data)}function Ma(e){let t=new g;return t.subscribe(r=>e.postMessage(r)),t}function vn(e,t=new Worker(e)){let r=Oa(t),o=Ma(t),n=new g;n.subscribe(o);let i=o.pipe(X(),ne(!0));return n.pipe(X(),Pe(r.pipe(U(i))),pe())}var La=P("#__config"),St=JSON.parse(La.textContent);St.base=`${new URL(St.base,xe())}`;function Te(){return St}function G(e){return St.features.includes(e)}function ye(e,t){return typeof t!="undefined"?St.translations[e].replace("#",t.toString()):St.translations[e]}function Se(e,t=document){return P(`[data-md-component=${e}]`,t)}function ae(e,t=document){return $(`[data-md-component=${e}]`,t)}function _a(e){let t=P(".md-typeset > :first-child",e);return d(t,"click",{once:!0}).pipe(m(()=>P(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function gn(e){if(!G("announce.dismiss")||!e.childElementCount)return M;if(!e.hidden){let t=P(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return C(()=>{let t=new g;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),_a(e).pipe(y(r=>t.next(r)),L(()=>t.complete()),m(r=>R({ref:e},r)))})}function Aa(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function xn(e,t){let r=new g;return r.subscribe(({hidden:o})=>{e.hidden=o}),Aa(e,t).pipe(y(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))}function Pt(e,t){return t==="inline"?E("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},E("div",{class:"md-tooltip__inner md-typeset"})):E("div",{class:"md-tooltip",id:e,role:"tooltip"},E("div",{class:"md-tooltip__inner md-typeset"}))}function yn(...e){return E("div",{class:"md-tooltip2",role:"tooltip"},E("div",{class:"md-tooltip2__inner md-typeset"},e))}function En(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return E("aside",{class:"md-annotation",tabIndex:0},Pt(t),E("a",{href:r,class:"md-annotation__index",tabIndex:-1},E("span",{"data-md-annotation-id":e})))}else return E("aside",{class:"md-annotation",tabIndex:0},Pt(t),E("span",{class:"md-annotation__index",tabIndex:-1},E("span",{"data-md-annotation-id":e})))}function wn(e){return E("button",{class:"md-clipboard md-icon",title:ye("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}function qr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(p=>!e.terms[p]).reduce((p,c)=>[...p,E("del",null,c)," "],[]).slice(0,-1),i=Te(),a=new URL(e.location,i.base);G("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,p])=>p).reduce((p,[c])=>`${p} ${c}`.trim(),""));let{tags:s}=Te();return E("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},E("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&E("div",{class:"md-search-result__icon md-icon"}),r>0&&E("h1",null,e.title),r<=0&&E("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(p=>{let c=s?p in s?`md-tag-icon md-tag--${s[p]}`:"md-tag-icon":"";return E("span",{class:`md-tag ${c}`},p)}),o>0&&n.length>0&&E("p",{class:"md-search-result__terms"},ye("search.result.term.missing"),": ",...n)))}function Tn(e){let t=e[0].score,r=[...e],o=Te(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.score<t);a===-1&&(a=r.length);let s=r.slice(0,a),p=r.slice(a),c=[qr(i,2|+(!n&&a===0)),...s.map(l=>qr(l,1)),...p.length?[E("details",{class:"md-search-result__more"},E("summary",{tabIndex:-1},E("div",null,p.length>0&&p.length===1?ye("search.result.more.one"):ye("search.result.more.other",p.length))),...p.map(l=>qr(l,1)))]:[]];return E("li",{class:"md-search-result__item"},c)}function Sn(e){return E("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>E("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?sr(r):r)))}function Qr(e){let t=`tabbed-control tabbed-control--${e}`;return E("div",{class:t,hidden:!0},E("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function On(e){return E("div",{class:"md-typeset__scrollwrap"},E("div",{class:"md-typeset__table"},e))}function Ca(e){let t=Te(),r=new URL(`../${e.version}/`,t.base);return E("li",{class:"md-version__item"},E("a",{href:`${r}`,class:"md-version__link"},e.title))}function Mn(e,t){return e=e.filter(r=>{var o;return!((o=r.properties)!=null&&o.hidden)}),E("div",{class:"md-version"},E("button",{class:"md-version__current","aria-label":ye("select.version")},t.title),E("ul",{class:"md-version__list"},e.map(Ca)))}var Ha=0;function ka(e){let t=z([et(e),kt(e)]).pipe(m(([o,n])=>o||n),K()),r=C(()=>Jo(e)).pipe(oe(De),ct(1),m(()=>Xo(e)));return t.pipe(Ae(o=>o),v(()=>z([t,r])),m(([o,n])=>({active:o,offset:n})),pe())}function $a(e,t){let{content$:r,viewport$:o}=t,n=`__tooltip2_${Ha++}`;return C(()=>{let i=new g,a=new _r(!1);i.pipe(X(),ne(!1)).subscribe(a);let s=a.pipe(Ht(c=>Me(+!c*250,Hr)),K(),v(c=>c?r:M),y(c=>c.id=n),pe());z([i.pipe(m(({active:c})=>c)),s.pipe(v(c=>kt(c,250)),Q(!1))]).pipe(m(c=>c.some(l=>l))).subscribe(a);let p=a.pipe(b(c=>c),ee(s,o),m(([c,l,{size:f}])=>{let u=e.getBoundingClientRect(),h=u.width/2;if(l.role==="tooltip")return{x:h,y:8+u.height};if(u.y>=f.height/2){let{height:w}=ce(l);return{x:h,y:-16-w}}else return{x:h,y:16+u.height}}));return z([s,i,p]).subscribe(([c,{offset:l},f])=>{c.style.setProperty("--md-tooltip-host-x",`${l.x}px`),c.style.setProperty("--md-tooltip-host-y",`${l.y}px`),c.style.setProperty("--md-tooltip-x",`${f.x}px`),c.style.setProperty("--md-tooltip-y",`${f.y}px`),c.classList.toggle("md-tooltip2--top",f.y<0),c.classList.toggle("md-tooltip2--bottom",f.y>=0)}),a.pipe(b(c=>c),ee(s,(c,l)=>l),b(c=>c.role==="tooltip")).subscribe(c=>{let l=ce(P(":scope > *",c));c.style.setProperty("--md-tooltip-width",`${l.width}px`),c.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(K(),be(me),ee(s)).subscribe(([c,l])=>{l.classList.toggle("md-tooltip2--active",c)}),z([a.pipe(b(c=>c)),s]).subscribe(([c,l])=>{l.role==="dialog"?(e.setAttribute("aria-controls",n),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",n)}),a.pipe(b(c=>!c)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),ka(e).pipe(y(c=>i.next(c)),L(()=>i.complete()),m(c=>R({ref:e},c)))})}function lt(e,{viewport$:t},r=document.body){return $a(e,{content$:new F(o=>{let n=e.title,i=yn(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t})}function Pa(e,t){let r=C(()=>z([Zo(e),De(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ce(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return et(e).pipe(v(o=>r.pipe(m(n=>({active:o,offset:n})),we(+!o||1/0))))}function Ln(e,t,{target$:r}){let[o,n]=Array.from(e.children);return C(()=>{let i=new g,a=i.pipe(X(),ne(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),tt(e).pipe(U(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),S(i.pipe(b(({active:s})=>s)),i.pipe(_e(250),b(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Le(16,me)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(ct(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),d(n,"click").pipe(U(a),b(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),d(n,"mousedown").pipe(U(a),ee(i)).subscribe(([s,{active:p}])=>{var c;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(p){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(c=Re())==null||c.blur()}}),r.pipe(U(a),b(s=>s===o),Ge(125)).subscribe(()=>e.focus()),Pa(e,t).pipe(y(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))})}function Ra(e){return e.tagName==="CODE"?$(".c, .c1, .cm",e):[e]}function Ia(e){let t=[];for(let r of Ra(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,p]=a;if(typeof p=="undefined"){let c=i.splitText(a.index);i=c.splitText(s.length),t.push(c)}else{i.textContent=s,t.push(i);break}}}}return t}function _n(e,t){t.append(...Array.from(e.childNodes))}function fr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Ia(t)){let[,p]=s.textContent.match(/\((\d+)\)/);fe(`:scope > li:nth-child(${p})`,e)&&(a.set(p,En(p,i)),s.replaceWith(a.get(p)))}return a.size===0?M:C(()=>{let s=new g,p=s.pipe(X(),ne(!0)),c=[];for(let[l,f]of a)c.push([P(".md-typeset",f),P(`:scope > li:nth-child(${l})`,e)]);return o.pipe(U(p)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of c)l?_n(f,u):_n(u,f)}),S(...[...a].map(([,l])=>Ln(l,t,{target$:r}))).pipe(L(()=>s.complete()),pe())})}function An(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return An(t)}}function Cn(e,t){return C(()=>{let r=An(e);return typeof r!="undefined"?fr(r,e,t):M})}var Hn=Vt(Yr());var Fa=0;function kn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return kn(t)}}function ja(e){return ge(e).pipe(m(({width:t})=>({scrollable:Tt(e).width>t})),Z("scrollable"))}function $n(e,t){let{matches:r}=matchMedia("(hover)"),o=C(()=>{let n=new g,i=n.pipe(Fr(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=[];if(Hn.default.isSupported()&&(e.closest(".copy")||G("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${Fa++}`;let l=wn(c.id);c.insertBefore(l,e),G("content.tooltips")&&a.push(lt(l,{viewport$}))}let s=e.closest(".highlight");if(s instanceof HTMLElement){let c=kn(s);if(typeof c!="undefined"&&(s.classList.contains("annotate")||G("content.code.annotate"))){let l=fr(c,e,t);a.push(ge(s).pipe(U(i),m(({width:f,height:u})=>f&&u),K(),v(f=>f?l:M)))}}return $(":scope > span[id]",e).length&&e.classList.add("md-code__content"),ja(e).pipe(y(c=>n.next(c)),L(()=>n.complete()),m(c=>R({ref:e},c)),Pe(...a))});return G("content.lazy")?tt(e).pipe(b(n=>n),we(1),v(()=>o)):o}function Wa(e,{target$:t,print$:r}){let o=!0;return S(t.pipe(m(n=>n.closest("details:not([open])")),b(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(b(n=>n||!o),y(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Pn(e,t){return C(()=>{let r=new g;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Wa(e,t).pipe(y(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}var Rn=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var Br,Da=0;function Va(){return typeof mermaid=="undefined"||mermaid instanceof Element?wt("https://unpkg.com/mermaid@10/dist/mermaid.min.js"):I(void 0)}function In(e){return e.classList.remove("mermaid"),Br||(Br=Va().pipe(y(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Rn,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),B(1))),Br.subscribe(()=>ao(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Da++}`,r=E("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})),Br.pipe(m(()=>({ref:e})))}var Fn=E("table");function jn(e){return e.replaceWith(Fn),Fn.replaceWith(On(e)),I({ref:e})}function Na(e){let t=e.find(r=>r.checked)||e[0];return S(...e.map(r=>d(r,"change").pipe(m(()=>P(`label[for="${r.id}"]`))))).pipe(Q(P(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Wn(e,{viewport$:t,target$:r}){let o=P(".tabbed-labels",e),n=$(":scope > input",e),i=Qr("prev");e.append(i);let a=Qr("next");return e.append(a),C(()=>{let s=new g,p=s.pipe(X(),ne(!0));z([s,ge(e)]).pipe(U(p),Le(1,me)).subscribe({next([{active:c},l]){let f=Ue(c),{width:u}=ce(c);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let h=pr(o);(f.x<h.x||f.x+u>h.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([De(o),ge(o)]).pipe(U(p)).subscribe(([c,l])=>{let f=Tt(o);i.hidden=c.x<16,a.hidden=c.x>f.width-l.width-16}),S(d(i,"click").pipe(m(()=>-1)),d(a,"click").pipe(m(()=>1))).pipe(U(p)).subscribe(c=>{let{width:l}=ce(o);o.scrollBy({left:l*c,behavior:"smooth"})}),r.pipe(U(p),b(c=>n.includes(c))).subscribe(c=>c.click()),o.classList.add("tabbed-labels--linked");for(let c of n){let l=P(`label[for="${c.id}"]`);l.replaceChildren(E("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),d(l.firstElementChild,"click").pipe(U(p),b(f=>!(f.metaKey||f.ctrlKey)),y(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return G("content.tabs.link")&&s.pipe(Ce(1),ee(t)).subscribe(([{active:c},{offset:l}])=>{let f=c.innerText.trim();if(c.hasAttribute("data-md-switching"))c.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let w of $("[data-tabs]"))for(let A of $(":scope > input",w)){let te=P(`label[for="${A.id}"]`);if(te!==c&&te.innerText.trim()===f){te.setAttribute("data-md-switching",""),A.click();break}}window.scrollTo({top:e.offsetTop-u});let h=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...h])])}}),s.pipe(U(p)).subscribe(()=>{for(let c of $("audio, video",e))c.pause()}),tt(e).pipe(v(()=>Na(n)),y(c=>s.next(c)),L(()=>s.complete()),m(c=>R({ref:e},c)))}).pipe(Qe(se))}function Un(e,{viewport$:t,target$:r,print$:o}){return S(...$(".annotate:not(.highlight)",e).map(n=>Cn(n,{target$:r,print$:o})),...$("pre:not(.mermaid) > code",e).map(n=>$n(n,{target$:r,print$:o})),...$("pre.mermaid",e).map(n=>In(n)),...$("table:not([class])",e).map(n=>jn(n)),...$("details",e).map(n=>Pn(n,{target$:r,print$:o})),...$("[data-tabs]",e).map(n=>Wn(n,{viewport$:t,target$:r})),...$("[title]",e).filter(()=>G("content.tooltips")).map(n=>lt(n,{viewport$:t})))}function za(e,{alert$:t}){return t.pipe(v(r=>S(I(!0),I(!1).pipe(Ge(2e3))).pipe(m(o=>({message:r,active:o})))))}function Dn(e,t){let r=P(".md-typeset",e);return C(()=>{let o=new g;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),za(e,t).pipe(y(n=>o.next(n)),L(()=>o.complete()),m(n=>R({ref:e},n)))})}var qa=0;function Qa(e,t){document.body.append(e);let{width:r}=ce(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=cr(t),n=typeof o!="undefined"?De(o):I({x:0,y:0}),i=S(et(t),kt(t)).pipe(K());return z([i,n]).pipe(m(([a,s])=>{let{x:p,y:c}=Ue(t),l=ce(t),f=t.closest("table");return f&&t.parentElement&&(p+=f.offsetLeft+t.parentElement.offsetLeft,c+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:p-s.x+l.width/2-r/2,y:c-s.y+l.height+8}}}))}function Vn(e){let t=e.title;if(!t.length)return M;let r=`__tooltip_${qa++}`,o=Pt(r,"inline"),n=P(".md-typeset",o);return n.innerHTML=t,C(()=>{let i=new g;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),S(i.pipe(b(({active:a})=>a)),i.pipe(_e(250),b(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Le(16,me)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(ct(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Qa(o,e).pipe(y(a=>i.next(a)),L(()=>i.complete()),m(a=>R({ref:e},a)))}).pipe(Qe(se))}function Ka({viewport$:e}){if(!G("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Ye(2,1),m(([n,i])=>[n<i,i]),Z(0)),r=z([e,t]).pipe(b(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),K()),o=Ve("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),K(),v(n=>n?r:I(!1)),Q(!1))}function Nn(e,t){return C(()=>z([ge(e),Ka(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),K((r,o)=>r.height===o.height&&r.hidden===o.hidden),B(1))}function zn(e,{header$:t,main$:r}){return C(()=>{let o=new g,n=o.pipe(X(),ne(!0));o.pipe(Z("active"),We(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=ue($("[title]",e)).pipe(b(()=>G("content.tooltips")),oe(a=>Vn(a)));return r.subscribe(o),t.pipe(U(n),m(a=>R({ref:e},a)),Pe(i.pipe(U(n))))})}function Ya(e,{viewport$:t,header$:r}){return mr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ce(e);return{active:o>=n}}),Z("active"))}function qn(e,t){return C(()=>{let r=new g;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=fe(".md-content h1");return typeof o=="undefined"?M:Ya(o,t).pipe(y(n=>r.next(n)),L(()=>r.complete()),m(n=>R({ref:e},n)))})}function Qn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),K()),n=o.pipe(v(()=>ge(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),Z("bottom"))));return z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:p},size:{height:c}}])=>(c=Math.max(0,c-Math.max(0,a-p,i)-Math.max(0,c+p-s)),{offset:a-i,height:c,active:a-i<=p})),K((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function Ba(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return I(...e).pipe(oe(o=>d(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),B(1))}function Kn(e){let t=$("input",e),r=E("meta",{name:"theme-color"});document.head.appendChild(r);let o=E("meta",{name:"color-scheme"});document.head.appendChild(o);let n=$t("(prefers-color-scheme: light)");return C(()=>{let i=new g;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),p=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=p.getAttribute("data-md-color-scheme"),a.color.primary=p.getAttribute("data-md-color-primary"),a.color.accent=p.getAttribute("data-md-color-accent")}for(let[s,p]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,p);for(let s=0;s<t.length;s++){let p=t[s].nextElementSibling;p instanceof HTMLElement&&(p.hidden=a.index!==s)}__md_set("__palette",a)}),d(e,"keydown").pipe(b(a=>a.key==="Enter"),ee(i,(a,s)=>s)).subscribe(({index:a})=>{a=(a+1)%t.length,t[a].click(),t[a].focus()}),i.pipe(m(()=>{let a=Se("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(p=>(+p).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(be(se)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),Ba(t).pipe(U(n.pipe(Ce(1))),st(),y(a=>i.next(a)),L(()=>i.complete()),m(a=>R({ref:e},a)))})}function Yn(e,{progress$:t}){return C(()=>{let r=new g;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(y(o=>r.next({value:o})),L(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Gr=Vt(Yr());function Ga(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Bn({alert$:e}){Gr.default.isSupported()&&new F(t=>{new Gr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||Ga(P(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(y(t=>{t.trigger.focus()}),m(()=>ye("clipboard.copied"))).subscribe(e)}function Gn(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function Ja(e,t){let r=new Map;for(let o of $("url",e)){let n=P("loc",o),i=[Gn(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let a of $("[rel=alternate]",o)){let s=a.getAttribute("href");s!=null&&i.push(Gn(new URL(s),t))}}return r}function ur(e){return mn(new URL("sitemap.xml",e)).pipe(m(t=>Ja(t,new URL(e))),ve(()=>I(new Map)))}function Xa(e,t){if(!(e.target instanceof Element))return M;let r=e.target.closest("a");if(r===null)return M;if(r.target||e.metaKey||e.ctrlKey)return M;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),I(new URL(r.href))):M}function Jn(e){let t=new Map;for(let r of $(":scope > *",e.head))t.set(r.outerHTML,r);return t}function Xn(e){for(let t of $("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return I(e)}function Za(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...G("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=fe(o),i=fe(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=Jn(document);for(let[o,n]of Jn(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Se("container");return je($("script",r)).pipe(v(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new F(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),M}),X(),ne(document))}function Zn({location$:e,viewport$:t,progress$:r}){let o=Te();if(location.protocol==="file:")return M;let n=ur(o.base);I(document).subscribe(Xn);let i=d(document.body,"click").pipe(We(n),v(([p,c])=>Xa(p,c)),pe()),a=d(window,"popstate").pipe(m(xe),pe());i.pipe(ee(t)).subscribe(([p,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",p)}),S(i,a).subscribe(e);let s=e.pipe(Z("pathname"),v(p=>ln(p,{progress$:r}).pipe(ve(()=>(pt(p,!0),M)))),v(Xn),v(Za),pe());return S(s.pipe(ee(e,(p,c)=>c)),e.pipe(Z("pathname"),v(()=>e),Z("hash")),e.pipe(K((p,c)=>p.pathname===c.pathname&&p.hash===c.hash),v(()=>i),y(()=>history.back()))).subscribe(p=>{var c,l;history.state!==null||!p.hash?window.scrollTo(0,(l=(c=history.state)==null?void 0:c.y)!=null?l:0):(history.scrollRestoration="auto",sn(p.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),d(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(Z("offset"),_e(100)).subscribe(({offset:p})=>{history.replaceState(p,"")}),s}var ri=Vt(ti());function oi(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}<mark data-md-highlight>${a}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ri.default)(a).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function It(e){return e.type===1}function dr(e){return e.type===3}function ni(e,t){let r=vn(e);return S(I(location.protocol!=="file:"),Ve("search")).pipe(Ae(o=>o),v(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:G("search.suggest")}}})),r}function ii({document$:e}){let t=Te(),r=Ne(new URL("../versions.json",t.base)).pipe(ve(()=>M)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),v(n=>d(document.body,"click").pipe(b(i=>!i.metaKey&&!i.ctrlKey),ee(o),v(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let p=s.href;return!i.target.closest(".md-version")&&n.get(p)===a?M:(i.preventDefault(),I(p))}}return M}),v(i=>{let{version:a}=n.get(i);return ur(new URL(i)).pipe(m(s=>{let c=xe().href.replace(t.base,"");return s.has(c.split("#")[0])?new URL(`../${a}/${c}`,t.base):new URL(i)}))})))).subscribe(n=>pt(n,!0)),z([r,o]).subscribe(([n,i])=>{P(".md-header__topic").appendChild(Mn(n,i))}),e.pipe(v(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let p of s)for(let c of n.aliases.concat(n.version))if(new RegExp(p,"i").test(c)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of ae("outdated"))s.hidden=!1})}function ns(e,{worker$:t}){let{searchParams:r}=xe();r.has("q")&&(Je("search",!0),e.value=r.get("q"),e.focus(),Ve("search").pipe(Ae(i=>!i)).subscribe(()=>{let i=xe();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=et(e),n=S(t.pipe(Ae(It)),d(e,"keyup"),o).pipe(m(()=>e.value),K());return z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),B(1))}function ai(e,{worker$:t}){let r=new g,o=r.pipe(X(),ne(!0));z([t.pipe(Ae(It)),r],(i,a)=>a).pipe(Z("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(Z("focus")).subscribe(({focus:i})=>{i&&Je("search",i)}),d(e.form,"reset").pipe(U(o)).subscribe(()=>e.focus());let n=P("header [for=__search]");return d(n,"click").subscribe(()=>e.focus()),ns(e,{worker$:t}).pipe(y(i=>r.next(i)),L(()=>r.complete()),m(i=>R({ref:e},i)),B(1))}function si(e,{worker$:t,query$:r}){let o=new g,n=tn(e.parentElement).pipe(b(Boolean)),i=e.parentElement,a=P(":scope > :first-child",e),s=P(":scope > :last-child",e);Ve("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(ee(r),Ur(t.pipe(Ae(It)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?ye("search.result.none"):ye("search.result.placeholder");break;case 1:a.textContent=ye("search.result.one");break;default:let u=sr(l.length);a.textContent=ye("search.result.other",u)}});let p=o.pipe(y(()=>s.innerHTML=""),v(({items:l})=>S(I(...l.slice(0,10)),I(...l.slice(10)).pipe(Ye(4),Vr(n),v(([f])=>f)))),m(Tn),pe());return p.subscribe(l=>s.appendChild(l)),p.pipe(oe(l=>{let f=fe("details",l);return typeof f=="undefined"?M:d(f,"toggle").pipe(U(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(b(dr),m(({data:l})=>l)).pipe(y(l=>o.next(l)),L(()=>o.complete()),m(l=>R({ref:e},l)))}function is(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=xe();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function ci(e,t){let r=new g,o=r.pipe(X(),ne(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),d(e,"click").pipe(U(o)).subscribe(n=>n.preventDefault()),is(e,t).pipe(y(n=>r.next(n)),L(()=>r.complete()),m(n=>R({ref:e},n)))}function pi(e,{worker$:t,keyboard$:r}){let o=new g,n=Se("search-query"),i=S(d(n,"keydown"),d(n,"focus")).pipe(be(se),m(()=>n.value),K());return o.pipe(We(i),m(([{suggest:s},p])=>{let c=p.split(/([\s-]+)/);if(s!=null&&s.length&&c[c.length-1]){let l=s[s.length-1];l.startsWith(c[c.length-1])&&(c[c.length-1]=l)}else c.length=0;return c})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g,"&nbsp;")),r.pipe(b(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(b(dr),m(({data:s})=>s)).pipe(y(s=>o.next(s)),L(()=>o.complete()),m(()=>({ref:e})))}function li(e,{index$:t,keyboard$:r}){let o=Te();try{let n=ni(o.search,t),i=Se("search-query",e),a=Se("search-result",e);d(e,"click").pipe(b(({target:p})=>p instanceof Element&&!!p.closest("a"))).subscribe(()=>Je("search",!1)),r.pipe(b(({mode:p})=>p==="search")).subscribe(p=>{let c=Re();switch(p.type){case"Enter":if(c===i){let l=new Map;for(let f of $(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,h])=>h-u);f.click()}p.claim()}break;case"Escape":case"Tab":Je("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof c=="undefined")i.focus();else{let l=[i,...$(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(c))+l.length+(p.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}p.claim();break;default:i!==Re()&&i.focus()}}),r.pipe(b(({mode:p})=>p==="global")).subscribe(p=>{switch(p.type){case"f":case"s":case"/":i.focus(),i.select(),p.claim();break}});let s=ai(i,{worker$:n});return S(s,si(a,{worker$:n,query$:s})).pipe(Pe(...ae("search-share",e).map(p=>ci(p,{query$:s})),...ae("search-suggest",e).map(p=>pi(p,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Ke}}function mi(e,{index$:t,location$:r}){return z([t,r.pipe(Q(xe()),b(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>oi(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let p=s.textContent,c=o(p);c.length>p.length&&n.set(s,c)}for(let[s,p]of n){let{childNodes:c}=E("span",null,p);s.replaceWith(...Array.from(c))}return{ref:e,nodes:n}}))}function as(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),K((i,a)=>i.height===a.height&&i.locked===a.locked))}function Jr(e,o){var n=o,{header$:t}=n,r=io(n,["header$"]);let i=P(".md-sidebar__scrollwrap",e),{y:a}=Ue(i);return C(()=>{let s=new g,p=s.pipe(X(),ne(!0)),c=s.pipe(Le(0,me));return c.pipe(ee(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),c.pipe(Ae()).subscribe(()=>{for(let l of $(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ce(f);f.scrollTo({top:u-h/2})}}}),ue($("label[tabindex]",e)).pipe(oe(l=>d(l,"click").pipe(be(se),m(()=>l),U(p)))).subscribe(l=>{let f=P(`[id="${l.htmlFor}"]`);P(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),as(e,r).pipe(y(l=>s.next(l)),L(()=>s.complete()),m(l=>R({ref:e},l)))})}function fi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return Ct(Ne(`${r}/releases/latest`).pipe(ve(()=>M),m(o=>({version:o.tag_name})),Be({})),Ne(r).pipe(ve(()=>M),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),Be({}))).pipe(m(([o,n])=>R(R({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return Ne(r).pipe(m(o=>({repositories:o.public_repos})),Be({}))}}function ui(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Ne(r).pipe(ve(()=>M),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),Be({}))}function di(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return fi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return ui(r,o)}return M}var ss;function cs(e){return ss||(ss=C(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(ae("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return M}return di(e.href).pipe(y(o=>__md_set("__source",o,sessionStorage)))}).pipe(ve(()=>M),b(t=>Object.keys(t).length>0),m(t=>({facts:t})),B(1)))}function hi(e){let t=P(":scope > :last-child",e);return C(()=>{let r=new g;return r.subscribe(({facts:o})=>{t.appendChild(Sn(o)),t.classList.add("md-source__repository--active")}),cs(e).pipe(y(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}function ps(e,{viewport$:t,header$:r}){return ge(document.body).pipe(v(()=>mr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),Z("hidden"))}function bi(e,t){return C(()=>{let r=new g;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(G("navigation.tabs.sticky")?I({hidden:!1}):ps(e,t)).pipe(y(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}function ls(e,{viewport$:t,header$:r}){let o=new Map,n=$(".md-nav__link",e);for(let s of n){let p=decodeURIComponent(s.hash.substring(1)),c=fe(`[id="${p}"]`);typeof c!="undefined"&&o.set(s,c)}let i=r.pipe(Z("height"),m(({height:s})=>{let p=Se("main"),c=P(":scope > :first-child",p);return s+.8*(c.offsetTop-p.offsetTop)}),pe());return ge(document.body).pipe(Z("height"),v(s=>C(()=>{let p=[];return I([...o].reduce((c,[l,f])=>{for(;p.length&&o.get(p[p.length-1]).tagName>=f.tagName;)p.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let h=f.offsetParent;for(;h;h=h.offsetParent)u+=h.offsetTop;return c.set([...p=[...p,l]].reverse(),u)},new Map))}).pipe(m(p=>new Map([...p].sort(([,c],[,l])=>c-l))),We(i),v(([p,c])=>t.pipe(jr(([l,f],{offset:{y:u},size:h})=>{let w=u+h.height>=Math.floor(s.height);for(;f.length;){let[,A]=f[0];if(A-c<u||w)l=[...l,f.shift()];else break}for(;l.length;){let[,A]=l[l.length-1];if(A-c>=u&&!w)f=[l.pop(),...f];else break}return[l,f]},[[],[...p]]),K((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,p])=>({prev:s.map(([c])=>c),next:p.map(([c])=>c)})),Q({prev:[],next:[]}),Ye(2,1),m(([s,p])=>s.prev.length<p.prev.length?{prev:p.prev.slice(Math.max(0,s.prev.length-1),p.prev.length),next:[]}:{prev:p.prev.slice(-1),next:p.next.slice(0,p.next.length-s.next.length)}))}function vi(e,{viewport$:t,header$:r,main$:o,target$:n}){return C(()=>{let i=new g,a=i.pipe(X(),ne(!0));if(i.subscribe(({prev:s,next:p})=>{for(let[c]of p)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",c===s.length-1)}),G("toc.follow")){let s=S(t.pipe(_e(1),m(()=>{})),t.pipe(_e(250),m(()=>"smooth")));i.pipe(b(({prev:p})=>p.length>0),We(o.pipe(be(se))),ee(s)).subscribe(([[{prev:p}],c])=>{let[l]=p[p.length-1];if(l.offsetHeight){let f=cr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ce(f);f.scrollTo({top:u-h/2,behavior:c})}}})}return G("navigation.tracking")&&t.pipe(U(a),Z("offset"),_e(250),Ce(1),U(n.pipe(Ce(1))),st({delay:250}),ee(i)).subscribe(([,{prev:s}])=>{let p=xe(),c=s[s.length-1];if(c&&c.length){let[l]=c,{hash:f}=new URL(l.href);p.hash!==f&&(p.hash=f,history.replaceState({},"",`${p}`))}else p.hash="",history.replaceState({},"",`${p}`)}),ls(e,{viewport$:t,header$:r}).pipe(y(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))})}function ms(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Ye(2,1),m(([a,s])=>a>s&&s>0),K()),i=r.pipe(m(({active:a})=>a));return z([i,n]).pipe(m(([a,s])=>!(a&&s)),K(),U(o.pipe(Ce(1))),ne(!0),st({delay:250}),m(a=>({hidden:a})))}function gi(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new g,a=i.pipe(X(),ne(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(U(a),Z("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),d(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),ms(e,{viewport$:t,main$:o,target$:n}).pipe(y(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))}function xi({document$:e,viewport$:t}){e.pipe(v(()=>$(".md-ellipsis")),oe(r=>tt(r).pipe(U(e.pipe(Ce(1))),b(o=>o),m(()=>r),we(1))),b(r=>r.offsetWidth<r.scrollWidth),oe(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,lt(n,{viewport$:t}).pipe(U(e.pipe(Ce(1))),L(()=>n.removeAttribute("title")))})).subscribe(),e.pipe(v(()=>$(".md-status")),oe(r=>lt(r,{viewport$:t}))).subscribe()}function yi({document$:e,tablet$:t}){e.pipe(v(()=>$(".md-toggle--indeterminate")),y(r=>{r.indeterminate=!0,r.checked=!1}),oe(r=>d(r,"change").pipe(Dr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),ee(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function fs(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Ei({document$:e}){e.pipe(v(()=>$("[data-md-scrollfix]")),y(t=>t.removeAttribute("data-md-scrollfix")),b(fs),oe(t=>d(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function wi({viewport$:e,tablet$:t}){z([Ve("search"),t]).pipe(m(([r,o])=>r&&!o),v(r=>I(r).pipe(Ge(r?400:100))),ee(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function us(){return location.protocol==="file:"?wt(`${new URL("search/search_index.js",Xr.base)}`).pipe(m(()=>__index),B(1)):Ne(new URL("search/search_index.json",Xr.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ot=Yo(),jt=nn(),Ot=cn(jt),Zr=on(),Oe=bn(),hr=$t("(min-width: 960px)"),Si=$t("(min-width: 1220px)"),Oi=pn(),Xr=Te(),Mi=document.forms.namedItem("search")?us():Ke,eo=new g;Bn({alert$:eo});var to=new g;G("navigation.instant")&&Zn({location$:jt,viewport$:Oe,progress$:to}).subscribe(ot);var Ti;((Ti=Xr.version)==null?void 0:Ti.provider)==="mike"&&ii({document$:ot});S(jt,Ot).pipe(Ge(125)).subscribe(()=>{Je("drawer",!1),Je("search",!1)});Zr.pipe(b(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=fe("link[rel=prev]");typeof t!="undefined"&&pt(t);break;case"n":case".":let r=fe("link[rel=next]");typeof r!="undefined"&&pt(r);break;case"Enter":let o=Re();o instanceof HTMLLabelElement&&o.click()}});xi({viewport$:Oe,document$:ot});yi({document$:ot,tablet$:hr});Ei({document$:ot});wi({viewport$:Oe,tablet$:hr});var rt=Nn(Se("header"),{viewport$:Oe}),Ft=ot.pipe(m(()=>Se("main")),v(e=>Qn(e,{viewport$:Oe,header$:rt})),B(1)),ds=S(...ae("consent").map(e=>xn(e,{target$:Ot})),...ae("dialog").map(e=>Dn(e,{alert$:eo})),...ae("header").map(e=>zn(e,{viewport$:Oe,header$:rt,main$:Ft})),...ae("palette").map(e=>Kn(e)),...ae("progress").map(e=>Yn(e,{progress$:to})),...ae("search").map(e=>li(e,{index$:Mi,keyboard$:Zr})),...ae("source").map(e=>hi(e))),hs=C(()=>S(...ae("announce").map(e=>gn(e)),...ae("content").map(e=>Un(e,{viewport$:Oe,target$:Ot,print$:Oi})),...ae("content").map(e=>G("search.highlight")?mi(e,{index$:Mi,location$:jt}):M),...ae("header-title").map(e=>qn(e,{viewport$:Oe,header$:rt})),...ae("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Nr(Si,()=>Jr(e,{viewport$:Oe,header$:rt,main$:Ft})):Nr(hr,()=>Jr(e,{viewport$:Oe,header$:rt,main$:Ft}))),...ae("tabs").map(e=>bi(e,{viewport$:Oe,header$:rt})),...ae("toc").map(e=>vi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Ot})),...ae("top").map(e=>gi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Ot})))),Li=ot.pipe(v(()=>hs),Pe(ds),B(1));Li.subscribe();window.document$=ot;window.location$=jt;window.target$=Ot;window.keyboard$=Zr;window.viewport$=Oe;window.tablet$=hr;window.screen$=Si;window.print$=Oi;window.alert$=eo;window.progress$=to;window.component$=Li;})();
-//# sourceMappingURL=bundle.a7c05c9e.min.js.map
-
diff --git a/doc/assets/javascripts/bundle.a7c05c9e.min.js.map b/doc/assets/javascripts/bundle.a7c05c9e.min.js.map
deleted file mode 100644
index 99cdca1..0000000
--- a/doc/assets/javascripts/bundle.a7c05c9e.min.js.map
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/clipboard/dist/clipboard.js", "node_modules/escape-html/index.js", "src/templates/assets/javascripts/bundle.ts", "node_modules/rxjs/node_modules/tslib/tslib.es6.js", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/BehaviorSubject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/QueueAction.ts", "node_modules/rxjs/src/internal/scheduler/QueueScheduler.ts", "node_modules/rxjs/src/internal/scheduler/queue.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/observable/throwError.ts", "node_modules/rxjs/src/internal/util/EmptyError.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/debounce.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/throwIfEmpty.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/first.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/repeat.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/templates/assets/javascripts/browser/document/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/browser/element/focus/index.ts", "src/templates/assets/javascripts/browser/element/hover/index.ts", "src/templates/assets/javascripts/utilities/h/index.ts", "src/templates/assets/javascripts/utilities/round/index.ts", "src/templates/assets/javascripts/browser/script/index.ts", "src/templates/assets/javascripts/browser/element/size/_/index.ts", "src/templates/assets/javascripts/browser/element/size/content/index.ts", "src/templates/assets/javascripts/browser/element/offset/_/index.ts", "src/templates/assets/javascripts/browser/element/offset/content/index.ts", "src/templates/assets/javascripts/browser/element/visibility/index.ts", "src/templates/assets/javascripts/browser/toggle/index.ts", "src/templates/assets/javascripts/browser/keyboard/index.ts", "src/templates/assets/javascripts/browser/location/_/index.ts", "src/templates/assets/javascripts/browser/location/hash/index.ts", "src/templates/assets/javascripts/browser/media/index.ts", "src/templates/assets/javascripts/browser/request/index.ts", "src/templates/assets/javascripts/browser/viewport/offset/index.ts", "src/templates/assets/javascripts/browser/viewport/size/index.ts", "src/templates/assets/javascripts/browser/viewport/_/index.ts", "src/templates/assets/javascripts/browser/viewport/at/index.ts", "src/templates/assets/javascripts/browser/worker/index.ts", "src/templates/assets/javascripts/_/index.ts", "src/templates/assets/javascripts/components/_/index.ts", "src/templates/assets/javascripts/components/announce/index.ts", "src/templates/assets/javascripts/components/consent/index.ts", "src/templates/assets/javascripts/templates/tooltip/index.tsx", "src/templates/assets/javascripts/templates/annotation/index.tsx", "src/templates/assets/javascripts/templates/clipboard/index.tsx", "src/templates/assets/javascripts/templates/search/index.tsx", "src/templates/assets/javascripts/templates/source/index.tsx", "src/templates/assets/javascripts/templates/tabbed/index.tsx", "src/templates/assets/javascripts/templates/table/index.tsx", "src/templates/assets/javascripts/templates/version/index.tsx", "src/templates/assets/javascripts/components/tooltip2/index.ts", "src/templates/assets/javascripts/components/content/annotation/_/index.ts", "src/templates/assets/javascripts/components/content/annotation/list/index.ts", "src/templates/assets/javascripts/components/content/annotation/block/index.ts", "src/templates/assets/javascripts/components/content/code/_/index.ts", "src/templates/assets/javascripts/components/content/details/index.ts", "src/templates/assets/javascripts/components/content/mermaid/index.css", "src/templates/assets/javascripts/components/content/mermaid/index.ts", "src/templates/assets/javascripts/components/content/table/index.ts", "src/templates/assets/javascripts/components/content/tabs/index.ts", "src/templates/assets/javascripts/components/content/_/index.ts", "src/templates/assets/javascripts/components/dialog/index.ts", "src/templates/assets/javascripts/components/tooltip/index.ts", "src/templates/assets/javascripts/components/header/_/index.ts", "src/templates/assets/javascripts/components/header/title/index.ts", "src/templates/assets/javascripts/components/main/index.ts", "src/templates/assets/javascripts/components/palette/index.ts", "src/templates/assets/javascripts/components/progress/index.ts", "src/templates/assets/javascripts/integrations/clipboard/index.ts", "src/templates/assets/javascripts/integrations/sitemap/index.ts", "src/templates/assets/javascripts/integrations/instant/index.ts", "src/templates/assets/javascripts/integrations/search/highlighter/index.ts", "src/templates/assets/javascripts/integrations/search/worker/message/index.ts", "src/templates/assets/javascripts/integrations/search/worker/_/index.ts", "src/templates/assets/javascripts/integrations/version/index.ts", "src/templates/assets/javascripts/components/search/query/index.ts", "src/templates/assets/javascripts/components/search/result/index.ts", "src/templates/assets/javascripts/components/search/share/index.ts", "src/templates/assets/javascripts/components/search/suggest/index.ts", "src/templates/assets/javascripts/components/search/_/index.ts", "src/templates/assets/javascripts/components/search/highlight/index.ts", "src/templates/assets/javascripts/components/sidebar/index.ts", "src/templates/assets/javascripts/components/source/facts/github/index.ts", "src/templates/assets/javascripts/components/source/facts/gitlab/index.ts", "src/templates/assets/javascripts/components/source/facts/_/index.ts", "src/templates/assets/javascripts/components/source/_/index.ts", "src/templates/assets/javascripts/components/tabs/index.ts", "src/templates/assets/javascripts/components/toc/index.ts", "src/templates/assets/javascripts/components/top/index.ts", "src/templates/assets/javascripts/patches/ellipsis/index.ts", "src/templates/assets/javascripts/patches/indeterminate/index.ts", "src/templates/assets/javascripts/patches/scrollfix/index.ts", "src/templates/assets/javascripts/patches/scrolllock/index.ts", "src/templates/assets/javascripts/polyfills/index.ts"],
-  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ viewport$, document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { Subject } from './Subject';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\n\n/**\n * A variant of Subject that requires an initial value and emits its current\n * value whenever it is subscribed to.\n *\n * @class BehaviorSubject<T>\n */\nexport class BehaviorSubject<T> extends Subject<T> {\n  constructor(private _value: T) {\n    super();\n  }\n\n  get value(): T {\n    return this.getValue();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    const subscription = super._subscribe(subscriber);\n    !subscription.closed && subscriber.next(this._value);\n    return subscription;\n  }\n\n  getValue(): T {\n    const { hasError, thrownError, _value } = this;\n    if (hasError) {\n      throw thrownError;\n    }\n    this._throwIfClosed();\n    return _value;\n  }\n\n  next(value: T): void {\n    super.next((this._value = value));\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { Subscription } from '../Subscription';\nimport { QueueScheduler } from './QueueScheduler';\nimport { SchedulerAction } from '../types';\nimport { TimerHandle } from './timerHandle';\n\nexport class QueueAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: QueueScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (delay > 0) {\n      return super.schedule(state, delay);\n    }\n    this.delay = delay;\n    this.state = state;\n    this.scheduler.flush(this);\n    return this;\n  }\n\n  public execute(state: T, delay: number): any {\n    return delay > 0 || this.closed ? super.execute(state, delay) : this._execute(state, delay);\n  }\n\n  protected requestAsyncId(scheduler: QueueScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n\n    if ((delay != null && delay > 0) || (delay == null && this.delay > 0)) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n\n    // Otherwise flush the scheduler starting with this action.\n    scheduler.flush(this);\n\n    // HACK: In the past, this was returning `void`. However, `void` isn't a valid\n    // `TimerHandle`, and generally the return value here isn't really used. So the\n    // compromise is to return `0` which is both \"falsy\" and a valid `TimerHandle`,\n    // as opposed to refactoring every other instanceo of `requestAsyncId`.\n    return 0;\n  }\n}\n", "import { AsyncScheduler } from './AsyncScheduler';\n\nexport class QueueScheduler extends AsyncScheduler {\n}\n", "import { QueueAction } from './QueueAction';\nimport { QueueScheduler } from './QueueScheduler';\n\n/**\n *\n * Queue Scheduler\n *\n * <span class=\"informal\">Put every next task on a queue, instead of executing it immediately</span>\n *\n * `queue` scheduler, when used with delay, behaves the same as {@link asyncScheduler} scheduler.\n *\n * When used without delay, it schedules given task synchronously - executes it right when\n * it is scheduled. However when called recursively, that is when inside the scheduled task,\n * another task is scheduled with queue scheduler, instead of executing immediately as well,\n * that task will be put on a queue and wait for current one to finish.\n *\n * This means that when you execute task with `queue` scheduler, you are sure it will end\n * before any other task scheduled with that scheduler will start.\n *\n * ## Examples\n * Schedule recursively first, then do something\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(() => {\n *   queueScheduler.schedule(() => console.log('second')); // will not happen now, but will be put on a queue\n *\n *   console.log('first');\n * });\n *\n * // Logs:\n * // \"first\"\n * // \"second\"\n * ```\n *\n * Reschedule itself recursively\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(function(state) {\n *   if (state !== 0) {\n *     console.log('before', state);\n *     this.schedule(state - 1); // `this` references currently executing Action,\n *                               // which we reschedule with new state\n *     console.log('after', state);\n *   }\n * }, 0, 3);\n *\n * // In scheduler that runs recursively, you would expect:\n * // \"before\", 3\n * // \"before\", 2\n * // \"before\", 1\n * // \"after\", 1\n * // \"after\", 2\n * // \"after\", 3\n *\n * // But with queue it logs:\n * // \"before\", 3\n * // \"after\", 3\n * // \"before\", 2\n * // \"after\", 2\n * // \"before\", 1\n * // \"after\", 1\n * ```\n */\n\nexport const queueScheduler = new QueueScheduler(QueueAction);\n\n/**\n * @deprecated Renamed to {@link queueScheduler}. Will be removed in v8.\n */\nexport const queue = queueScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { noop } from '../util/noop';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * determined by another Observable has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link debounceTime}, but the time span of\n * emission silence is determined by a second Observable.</span>\n *\n * ![](debounce.svg)\n *\n * `debounce` delays notifications emitted by the source Observable, but drops previous\n * pending delayed emissions if a new notification arrives on the source Observable.\n * This operator keeps track of the most recent notification from the source\n * Observable, and spawns a duration Observable by calling the\n * `durationSelector` function. The notification is emitted only when the duration\n * Observable emits a next notification, and if no other notification was emitted on\n * the source Observable since the duration Observable was spawned. If a new\n * notification appears before the duration Observable emits, the previous notification will\n * not be emitted and a new duration is scheduled from `durationSelector` is scheduled.\n * If the completing event happens during the scheduled duration the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during the scheduled duration or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * Like {@link debounceTime}, this is a rate-limiting operator, and also a\n * delay-like operator since output emissions do not necessarily occur at the\n * same time as they did on the source Observable.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, scan, debounce, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(\n *   scan(i => ++i, 1),\n *   debounce(i => interval(200 * i))\n * );\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the timeout\n * duration for each source value, returned as an Observable or a Promise.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified duration Observable returned by\n * `durationSelector`, and may drop some values if they occur too frequently.\n */\nexport function debounce<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    // The subscriber/subscription for the current debounce, if there is one.\n    let durationSubscriber: Subscriber<any> | null = null;\n\n    const emit = () => {\n      // Unsubscribe any current debounce subscription we have,\n      // we only cared about the first notification from it, and we\n      // want to clean that subscription up as soon as possible.\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        // We have a value! Free up memory first, then emit the value.\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          // Cancel any pending debounce duration. We don't\n          // need to null it out here yet tho, because we're just going\n          // to create another one in a few lines.\n          durationSubscriber?.unsubscribe();\n          hasValue = true;\n          lastValue = value;\n          // Capture our duration subscriber, so we can unsubscribe it when we're notified\n          // and we're going to emit the value.\n          durationSubscriber = createOperatorSubscriber(subscriber, emit, noop);\n          // Subscribe to the duration.\n          innerFrom(durationSelector(value)).subscribe(durationSubscriber);\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = durationSubscriber = null;\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounce,\n  defer,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith,\n  timer\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * The second parameter allows to specify a timeout in milliseconds after which\n * the hover state will be reset to `false`. This is useful for tooltips which\n * should disappear after a certain amount of time, in order to allow the user\n * to move the cursor from the host to the tooltip.\n *\n * @param el - Element\n * @param timeout - Timeout\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, timeout?: number\n): Observable<boolean> {\n  return defer(() => merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      timeout ? debounce(active => timer(+!active * timeout)) : identity,\n      startWith(el.matches(\":hover\"))\n    )\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => (\n      entries.forEach(entry => entry$.next(entry))\n    ))),\n    switchMap(observer => merge(NEVER, of(observer)).pipe(\n      finalize(() => observer.disconnect())\n    )),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n\n  // Compute target element - since inline elements cannot be observed by the\n  // current `ResizeObserver` implementation as provided by browsers, we need\n  // to determine the first containing parent element and use that one as a\n  // target, while we always compute the actual size from the element.\n  let target = el\n  while (target.clientWidth === 0)\n    if (target.parentElement)\n      target = target.parentElement\n    else\n      break\n\n  // Observe target element and recompute element size on resize - as described\n  // above, the target element is not necessarily the element of interest\n  return observer$.pipe(\n    tap(observer => observer.observe(target)),\n    switchMap(observer => entry$.pipe(\n      filter(entry => entry.target === target),\n      finalize(() => observer.unobserve(target))\n    )),\n    map(() => getElementSize(el)),\n    startWith(getElementSize(el))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n\n/**\n * Retrieve all overflowing containers of an element, if any\n *\n * Note that this function has a slightly different behavior, so we should at\n * some point consider refactoring how overflowing containers are handled.\n *\n * @param el - Element\n *\n * @returns Overflowing containers\n */\nexport function getElementContainers(\n  el: HTMLElement\n): HTMLElement[] {\n  const containers: HTMLElement[] = []\n\n  // Walk up the DOM tree until we find an overflowing container\n  let parent = el.parentElement\n  while (parent) {\n    if (\n      el.clientWidth  > parent.clientWidth ||\n      el.clientHeight > parent.clientHeight\n    )\n      containers.push(parent)\n\n    // Continue with parent element\n    parent = (el = parent).parentElement\n  }\n\n  // If the page is short, the body might not be overflowing and there might be\n  // no other containers, which is why we need to make sure the body is present\n  if (containers.length === 0)\n    containers.push(document.documentElement)\n\n  // Return overflowing containers\n  return containers\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { watchElementSize } from \"../../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/**\n * Retrieve absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffsetAbsolute(\n  el: HTMLElement\n): ElementOffset {\n  const rect = el.getBoundingClientRect()\n  return {\n    x: rect.x + window.scrollX,\n    y: rect.y + window.scrollY\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n\n/**\n * Watch absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffsetAbsolute(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    watchElementOffset(el),\n    watchElementSize(document.body) // @todo find a better way for this\n  )\n    .pipe(\n      map(() => getElementOffsetAbsolute(el)),\n      startWith(getElementOffsetAbsolute(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n\n// @todo: rename\nexport function renderInlineTooltip2(\n  ...children: ComponentChild[]\n): HTMLElement {\n  return (\n    <div class=\"md-tooltip2\" role=\"tooltip\">\n      <div class=\"md-tooltip2__inner md-typeset\">\n        {children}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{key}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && document.tags.map(tag => {\n          const type = tags\n            ? tag in tags\n              ? `md-tag-icon md-tag--${tags[tag]}`\n              : \"md-tag-icon\"\n            : \"\"\n          return (\n            <span class={`md-tag ${type}`}>{tag}</span>\n          )\n        })}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  BehaviorSubject,\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  combineLatest,\n  debounce,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  filter,\n  finalize,\n  first,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  queueScheduler,\n  share,\n  startWith,\n  switchMap,\n  tap,\n  throttleTime,\n  timer,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  Viewport,\n  getElement,\n  getElementContainers,\n  getElementOffsetAbsolute,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderInlineTooltip2 } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      // Tooltip is active\n  offset: ElementOffset                // Tooltip offset\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dependencies\n */\ninterface Dependencies {\n  content$: Observable<HTMLElement>    // Tooltip content observable\n  viewport$: Observable<Viewport>      // Viewport observable\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function tracks the tooltip host element, and deduces the active state\n * and offset of the tooltip from it. The active state is determined by whether\n * the host element is focused or hovered, and the offset is determined by the\n * host element's absolute position in the document.\n *\n * @param el - Tooltip host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip2(\n  el: HTMLElement\n): Observable<Tooltip> {\n\n  // Compute whether tooltip should be shown - we need to watch both focus and\n  // hover events on the host element and emit if one of them is active. In case\n  // of a hover event, we keep the element visible for a short amount of time\n  // after the pointer left the host element for a better user experience.\n  const active$ =\n    combineLatest([\n      watchElementFocus(el),\n      watchElementHover(el)\n    ])\n      .pipe(\n        map(([focus, hover]) => focus || hover),\n        distinctUntilChanged()\n      )\n\n  // We need to determine all parent elements of the host element that are\n  // currently scrollable, as they might affect the position of the tooltip\n  // depending on their horizontal of vertical offset. We must track all of\n  // them and recompute the position of the tooltip if they change.\n  const offset$ =\n    defer(() => getElementContainers(el)).pipe(\n      mergeMap(watchElementContentOffset),\n      throttleTime(1),\n      map(() => getElementOffsetAbsolute(el))\n    )\n\n  // Only track parent elements and compute offset of the tooltip host if the\n  // tooltip should be shown - we defer the computation of the offset until the\n  // tooltip becomes active for the first time. This is necessary, because we\n  // must also keep the tooltip active as long as it is focused or hovered.\n  return active$.pipe(\n    first(active => active),\n    switchMap(() => combineLatest([active$, offset$])),\n    map(([active, offset]) => ({ active, offset })),\n    share()\n  )\n}\n\n/**\n * Mount tooltip\n *\n * This function renders a tooltip with the content from the provided `content$`\n * observable as passed via the dependencies. If the returned element has a role\n * of type `dialog`, the tooltip is considered to be interactive, and rendered\n * either above or below the host element, depending on the available space.\n *\n * If the returned element has a role of type `tooltip`, the tooltip is always\n * rendered below the host element and considered to be non-interactive. This\n * allows us to reuse the same positioning logic for both interactive and\n * non-interactive tooltips, as it is largely the same.\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip2(\n  el: HTMLElement, dependencies: Dependencies\n): Observable<Component<Tooltip>> {\n  const { content$, viewport$ } = dependencies\n\n  // Compute unique tooltip id - this is necessary to associate the tooltip host\n  // element with the tooltip element for ARIA purposes\n  const id = `__tooltip2_${sequence++}`\n\n  // Create component on subscription\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n\n    // Create subject to track tooltip presence and visibility - we use another\n    // purely internal subject to track the tooltip's presence and visibility,\n    // as the tooltip should be visible if the host element or tooltip itself\n    // is focused or hovered to allow for smooth pointer migration\n    const show$ = new BehaviorSubject(false)\n    push$.pipe(ignoreElements(), endWith(false))\n      .subscribe(show$)\n\n    // Create observable controlling tooltip element - we create and attach the\n    // tooltip only if it is actually present, in order to keep the number of\n    // elements low. We need to keep the tooltip visible for a short time after\n    // the pointer left the host element or tooltip itself. For this, we use an\n    // inner subscription to the tooltip observable, which we terminate when the\n    // tooltip should not be shown, automatically removing the element. Moreover\n    // we use the queue scheduler, which will schedule synchronously in case the\n    // tooltip should be shown, and asynchronously if it should be hidden.\n    const node$ = show$.pipe(\n      debounce(active => timer(+!active * 250, queueScheduler)),\n      distinctUntilChanged(),\n      switchMap(active => active ? content$ : EMPTY),\n      tap(node => node.id = id),\n      share()\n    )\n\n    // Compute tooltip presence and visibility - the tooltip should be shown if\n    // the host element or the tooltip itself is focused or hovered\n    combineLatest([\n      push$.pipe(map(({ active }) => active)),\n      node$.pipe(\n        switchMap(node => watchElementHover(node, 250)),\n        startWith(false)\n      )\n    ])\n      .pipe(map(states => states.some(active => active)))\n      .subscribe(show$)\n\n    // Compute tooltip origin - we need to compute the tooltip origin depending\n    // on the position of the host element, the viewport size, as well as the\n    // actual size of the tooltip, if positioned above. The tooltip must about\n    // to be rendered for this to be correct, which is why we do it here.\n    const origin$ = show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, viewport$),\n      map(([_, node, { size }]) => {\n        const host = el.getBoundingClientRect()\n        const x = host.width / 2\n\n        // If the tooltip is non-interactive, we always render it below the\n        // actual element because all operating systems do it that way\n        if (node.role === \"tooltip\") {\n          return { x, y: 8 + host.height }\n\n        // Otherwise, we determine where there is more space, and render the\n        // tooltip either above or below the host element\n        } else if (host.y >= size.height / 2) {\n          const { height } = getElementSize(node)\n          return { x, y: -16 - height }\n        } else {\n          return { x, y: +16 + host.height }\n        }\n      })\n    )\n\n    // Update tooltip position - we always need to update the position of the\n    // tooltip, as it might change depending on the viewport offset of the host\n    combineLatest([node$, push$, origin$])\n      .subscribe(([node, { offset }, origin]) => {\n        node.style.setProperty(\"--md-tooltip-host-x\", `${offset.x}px`)\n        node.style.setProperty(\"--md-tooltip-host-y\", `${offset.y}px`)\n\n        // Update tooltip origin - this is mainly set to determine the position\n        // of the tooltip tail, to show the direction it is originating from\n        node.style.setProperty(\"--md-tooltip-x\", `${origin.x}px`)\n        node.style.setProperty(\"--md-tooltip-y\", `${origin.y}px`)\n\n        // Update tooltip render location, i.e., whether the tooltip is shown\n        // above or below the host element, depending on the available space\n        node.classList.toggle(\"md-tooltip2--top\",    origin.y <  0)\n        node.classList.toggle(\"md-tooltip2--bottom\", origin.y >= 0)\n      })\n\n    // Update tooltip width - we only explicitly set the width of the tooltip\n    // if it is non-interactive, in case it should always be rendered centered\n    show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, (_, node) => node),\n      filter(node => node.role === \"tooltip\")\n    )\n      .subscribe(node => {\n        const size = getElementSize(getElement(\":scope > *\", node))\n\n        // Set tooltip width and remove tail by setting it to a width of zero -\n        // if authors want to keep the tail, we can move this to CSS later\n        node.style.setProperty(\"--md-tooltip-width\", `${size.width}px`)\n        node.style.setProperty(\"--md-tooltip-tail\",  `${0}px`)\n      })\n\n    // Update tooltip visibility - we defer to the next animation frame, because\n    // the tooltip must first be added to the document before we make it appear,\n    // or it will appear instantly without delay. Additionally, we need to keep\n    // the tooltip visible for a short time after the pointer left the host.\n    show$.pipe(\n      distinctUntilChanged(),\n      observeOn(animationFrameScheduler),\n      withLatestFrom(node$)\n    )\n      .subscribe(([active, node]) => {\n        node.classList.toggle(\"md-tooltip2--active\", active)\n      })\n\n    // Set up ARIA attributes when tooltip is visible\n    combineLatest([\n      show$.pipe(filter(active => active)),\n      node$\n    ])\n      .subscribe(([_, node]) => {\n        if (node.role === \"dialog\") {\n          el.setAttribute(\"aria-controls\", id)\n          el.setAttribute(\"aria-haspopup\", \"dialog\")\n        } else {\n          el.setAttribute(\"aria-describedby\", id)\n        }\n      })\n\n    // Remove ARIA attributes when tooltip is hidden\n    show$.pipe(filter(active => !active))\n      .subscribe(() => {\n        el.removeAttribute(\"aria-controls\")\n        el.removeAttribute(\"aria-describedby\")\n        el.removeAttribute(\"aria-haspopup\")\n      })\n\n    // Create and return component\n    return watchTooltip2(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n\n// ----------------------------------------------------------------------------\n\n/**\n * Mount inline tooltip\n *\n * @todo refactor this function\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n * @param container - Container\n *\n * @returns Tooltip component observable\n */\nexport function mountInlineTooltip2(\n  el: HTMLElement, { viewport$ }: { viewport$: Observable<Viewport> },\n  container = document.body\n): Observable<Component<Tooltip>> {\n  return mountTooltip2(el, {\n    content$: new Observable<HTMLElement>(observer => {\n      const title = el.title\n      const node = renderInlineTooltip2(title)\n      observer.next(node)\n      el.removeAttribute(\"title\")\n      // Append tooltip and remove on unsubscription\n      container.append(node)\n      return () => {\n        node.remove()\n        el.setAttribute(\"title\", title)\n      }\n    }),\n    viewport$\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  getElements,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"~/components/tooltip2\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountInlineTooltip2(button, { viewport$ }))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    // If the code block has line spans, we can add this additional class to\n    // the code block element, which fixes the problem for highlighted code\n    // lines not stretching to the entirety of the screen when the code block\n    // overflows, e.g., on mobile - see\n    const spans = getElements(\":scope > span[id]\", el)\n    if (spans.length)\n      el.classList.add(\"md-code__content\")\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@10/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchElementVisibility(el)\n      .pipe(\n        switchMap(() => watchContentTabs(inputs)),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"../../tooltip2\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountInlineTooltip2(child, { viewport$ }))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    // Handle color switch on Enter or Space - see https://t.ly/YIhVj\n    fromEvent<KeyboardEvent>(el, \"keydown\").pipe(\n      filter(ev => ev.key === \"Enter\"),\n      withLatestFrom(push$, (_, palette) => palette)\n    )\n      .subscribe(({ index }) => {\n        index = (index + 1) % inputs.length\n        inputs[index].click()\n        inputs[index].focus()\n      })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\"),\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. It is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(url)\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(url => {\n            const { version } = urls.get(url)!\n            return fetchSitemap(new URL(url))\n              .pipe(\n                map(sitemap => {\n                  const location = getLocation()\n                  const path = location.href.replace(config.base, \"\")\n                  return sitemap.has(path.split(\"#\")[0])\n                    ? new URL(`../${version}/${path}`, config.base)\n                    : new URL(url)\n                })\n              )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return requestJSON<ProjectSchema>(url)\n    .pipe(\n      catchError(() => EMPTY), // @todo refactor instant loading\n      map(({ star_count, forks_count }) => ({\n        stars: star_count,\n        forks: forks_count\n      })),\n      defaultIfEmpty({})\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountInlineTooltip2 } from \"~/components/tooltip2\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$, viewport$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        /* Mount tooltip */\n        return mountInlineTooltip2(host, { viewport$ })\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-status\")),\n      mergeMap(el => mountInlineTooltip2(el, { viewport$ }))\n    )\n      .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
-  "mappings": "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",
-  "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "import_focus_visible", "extendStatics", "d", "b", "p", "__extends", "__", "__awaiter", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "e", "rejected", "result", "__generator", "body", "_", "t", "f", "y", "g", "verb", "n", "v", "op", "__values", "o", "s", "m", "i", "__read", "n", "r", "ar", "e", "error", "__spreadArray", "to", "from", "pack", "i", "l", "ar", "__await", "v", "__asyncGenerator", "thisArg", "_arguments", "generator", "g", "q", "verb", "n", "a", "b", "resume", "step", "e", "settle", "r", "fulfill", "reject", "value", "f", "__asyncValues", "o", "m", "i", "__values", "verb", "n", "v", "resolve", "reject", "settle", "d", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "BehaviorSubject", "_super", "__extends", "_value", "_this", "subscriber", "subscription", "_a", "hasError", "thrownError", "value", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "QueueAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "AsyncAction", "QueueScheduler", "_super", "__extends", "AsyncScheduler", "queueScheduler", "QueueScheduler", "QueueAction", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "EmptyError", "createErrorClass", "_super", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "debounce", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "emit", "value", "createOperatorSubscriber", "noop", "innerFrom", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "innerFrom", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "throwIfEmpty", "errorFactory", "defaultErrorFactory", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "EmptyError", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "first", "predicate", "defaultValue", "hasDefaultValue", "source", "filter", "v", "identity", "take", "defaultIfEmpty", "throwIfEmpty", "EmptyError", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "_a", "_b", "leading", "_c", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "_a", "_b", "_c", "_d", "observer$", "merge", "fromEvent", "debounceTime", "startWith", "map", "getActiveElement", "shareReplay", "watchElementFocus", "el", "active", "distinctUntilChanged", "watchElementHover", "el", "timeout", "defer", "merge", "fromEvent", "map", "debounce", "active", "timer", "identity", "startWith", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "round", "value", "digits", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "entry$", "Subject", "observer$", "defer", "watchScript", "of", "map", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "target", "tap", "filter", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "getElementContainers", "containers", "getElementOffset", "el", "getElementOffsetAbsolute", "rect", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchComposition", "merge", "fromEvent", "map", "startWith", "watchKeyboard", "keyboard$", "filter", "ev", "getToggle", "mode", "active", "getActiveElement", "share", "switchMap", "EMPTY", "getLocation", "setLocation", "url", "navigate", "feature", "el", "h", "watchLocation", "Subject", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "location$", "merge", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "Observable", "observer", "req", "event", "_a", "length", "requestJSON", "switchMap", "res", "map", "body", "shareReplay", "requestHTML", "dom", "requestXML", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "recv", "worker", "fromEvent", "ev", "send", "send$", "Subject", "data", "watchWorker", "url", "recv$", "worker$", "done$", "ignoreElements", "endWith", "mergeWith", "takeUntil", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "hash", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "renderTooltip", "id", "style", "h", "renderInlineTooltip2", "children", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "config", "configuration", "url", "feature", "match", "highlight", "value", "tags", "tag", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "_a", "translation", "sequence", "watchTooltip2", "el", "active$", "combineLatest", "watchElementFocus", "watchElementHover", "map", "focus", "hover", "distinctUntilChanged", "offset$", "defer", "getElementContainers", "mergeMap", "watchElementContentOffset", "throttleTime", "getElementOffsetAbsolute", "first", "active", "switchMap", "offset", "share", "mountTooltip2", "dependencies", "content$", "viewport$", "id", "push$", "Subject", "show$", "BehaviorSubject", "ignoreElements", "endWith", "node$", "debounce", "timer", "queueScheduler", "EMPTY", "tap", "node", "startWith", "states", "origin$", "filter", "withLatestFrom", "_", "size", "host", "x", "height", "getElementSize", "origin", "getElement", "observeOn", "animationFrameScheduler", "state", "finalize", "__spreadValues", "mountInlineTooltip2", "container", "Observable", "observer", "title", "renderInlineTooltip2", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "ignoreElements", "endWith", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findHosts", "container", "getElements", "findMarkers", "markers", "el", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "pairs", "annotation", "getElement", "takeUntil", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "findList", "el", "sibling", "mountAnnotationBlock", "options", "defer", "list", "mountAnnotationList", "EMPTY", "import_clipboard", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "done$", "takeLast", "scrollable", "content$", "ClipboardJS", "feature", "parent", "button", "renderClipboardButton", "mountInlineTooltip2", "container", "list", "annotations$", "mountAnnotationList", "takeUntil", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "getElements", "tap", "state", "finalize", "__spreadValues", "mergeWith", "watchElementVisibility", "filter", "visible", "take", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "mermaid_default", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "__async", "id", "host", "h", "text", "svg", "fn", "shadow", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "inputs", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "el", "viewport$", "target$", "container", "getElements", "prev", "renderTabbedControl", "next", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatest", "watchElementSize", "takeUntil", "auditTime", "animationFrameScheduler", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "filter", "label", "h", "ev", "tap", "feature", "skip", "withLatestFrom", "tab", "y", "set", "tabs", "media", "watchElementVisibility", "switchMap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountAnnotationBlock", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "feature", "mountInlineTooltip2", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "sequence", "watchTooltip", "el", "host", "width", "getElementSize", "container", "getElementContainer", "scroll$", "watchElementContentOffset", "of", "active$", "merge", "watchElementFocus", "watchElementHover", "distinctUntilChanged", "combineLatest", "map", "active", "scroll", "x", "y", "getElementOffset", "size", "table", "mountTooltip", "title", "EMPTY", "id", "tooltip", "renderTooltip", "typeset", "getElement", "defer", "push$", "Subject", "offset", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatestWith", "tooltips", "from", "getElements", "mergeMap", "child", "mountTooltip", "takeUntil", "state", "__spreadValues", "mergeWith", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "index", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "getElements", "meta", "h", "scheme", "media$", "watchMedia", "defer", "push$", "Subject", "palette", "media", "key", "value", "label", "filter", "ev", "withLatestFrom", "_", "header", "getComponentElement", "style", "color", "observeOn", "asyncScheduler", "takeUntil", "skip", "repeat", "tap", "state", "finalize", "__spreadValues", "mountProgress", "el", "progress$", "defer", "push$", "Subject", "value", "tap", "finalize", "map", "import_clipboard", "extract", "el", "copy", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "resolve", "url", "base", "extract", "document", "sitemap", "el", "getElements", "getElement", "links", "link", "href", "fetchSitemap", "requestXML", "map", "catchError", "of", "handle", "ev", "sitemap", "EMPTY", "el", "url", "of", "head", "document", "tags", "getElements", "resolve", "key", "value", "inject", "next", "selector", "feature", "source", "getOptionalElement", "target", "html", "name", "container", "getComponentElement", "concat", "switchMap", "script", "Observable", "observer", "ignoreElements", "endWith", "setupInstantNavigation", "location$", "viewport$", "progress$", "config", "configuration", "sitemap$", "fetchSitemap", "instant$", "fromEvent", "combineLatestWith", "share", "history$", "map", "getLocation", "withLatestFrom", "offset", "merge", "document$", "distinctUntilKeyChanged", "requestHTML", "catchError", "setLocation", "_", "distinctUntilChanged", "a", "b", "tap", "_a", "_b", "setLocationHash", "debounceTime", "import_escape_html", "setupSearchHighlighter", "config", "regex", "term", "separator", "highlight", "_", "data", "query", "match", "value", "escapeHTML", "isSearchReadyMessage", "message", "isSearchResultMessage", "setupSearchWorker", "url", "index$", "worker$", "watchWorker", "merge", "of", "watchToggle", "first", "active", "switchMap", "config", "docs", "feature", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "fetchSitemap", "sitemap", "path", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "_a", "outdated", "ignored", "main", "ignore", "warning", "getComponentElements", "watchSearchQuery", "el", "worker$", "searchParams", "getLocation", "setToggle", "watchToggle", "first", "active", "url", "focus$", "watchElementFocus", "value$", "merge", "isSearchReadyMessage", "fromEvent", "map", "distinctUntilChanged", "combineLatest", "value", "focus", "shareReplay", "mountSearchQuery", "push$", "Subject", "done$", "ignoreElements", "endWith", "_", "query", "distinctUntilKeyChanged", "takeUntil", "label", "getElement", "tap", "state", "finalize", "__spreadValues", "mountSearchResult", "el", "worker$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "container", "meta", "getElement", "list", "watchToggle", "active", "withLatestFrom", "skipUntil", "first", "isSearchReadyMessage", "items", "value", "translation", "count", "round", "render$", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "map", "renderSearchResultItem", "share", "item", "mergeMap", "details", "getOptionalElement", "EMPTY", "fromEvent", "takeUntil", "isSearchResultMessage", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "done$", "ignoreElements", "endWith", "fromEvent", "takeUntil", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "worker$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggest", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "worker$", "setupSearchWorker", "query", "getComponentElement", "result", "fromEvent", "filter", "target", "setToggle", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "els", "i", "query$", "mountSearchQuery", "merge", "mountSearchResult", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "next$", "auditTime", "animationFrameScheduler", "withLatestFrom", "first", "item", "getElements", "container", "getElementSize", "from", "mergeMap", "label", "fromEvent", "observeOn", "asyncScheduler", "takeUntil", "input", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "requestJSON", "catchError", "EMPTY", "map", "star_count", "forks_count", "defaultIfEmpty", "fetchSourceFacts", "url", "match", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "parent", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "main$", "target$", "push$", "Subject", "done$", "ignoreElements", "endWith", "feature", "smooth$", "merge", "debounceTime", "filter", "observeOn", "asyncScheduler", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "ignoreElements", "distinctUntilKeyChanged", "height", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "patchEllipsis", "document$", "viewport$", "switchMap", "getElements", "mergeMap", "el", "watchElementVisibility", "takeUntil", "skip", "filter", "visible", "map", "take", "text", "host", "mountInlineTooltip2", "finalize", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "fetchSearchIndex", "watchScript", "config", "map", "shareReplay", "requestJSON", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "configuration", "index$", "NEVER", "alert$", "Subject", "setupClipboardJS", "progress$", "feature", "setupInstantNavigation", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "setLocation", "next", "active", "getActiveElement", "patchEllipsis", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "switchMap", "el", "watchMain", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountHeader", "mountPalette", "mountProgress", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"]
-}
diff --git a/doc/assets/stylesheets/main.66ac8b77.min.css b/doc/assets/stylesheets/main.66ac8b77.min.css
deleted file mode 100644
index da13c22..0000000
--- a/doc/assets/stylesheets/main.66ac8b77.min.css
+++ /dev/null
@@ -1 +0,0 @@
-@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2H2Z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{border-radius:100%;filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .md-code__content{display:grid}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3v2m0 4h14v-2H3v2m0 4h14v-2H3v2m16 0h2v-2h-2v2m0-10v2h2V7h-2m0 6h2v-2h-2v2Z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8l-6-6m6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22l-3.08-3.1m-3.81.1a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5Z"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.495 2.495 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.486 2.486 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.249.249 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Zm0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41L8 2.694Z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.752 1.752 0 0 1 1 7.775Zm1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2Z"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2v6Z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68L23 12m-10 5h-2v-2h2v2m0-4h-2V7h2v6Z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3H9m0 5h2v9H9V8m4 0h2v9h-2V8Z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5l-9-4m0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3Z"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4h-2M9.53 9l-1.06 6h6l1.06-6h-6Z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>')}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-weight:400;outline:none;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}:root{--md-tooltip-width:20rem;--md-tooltip-tail:0.3rem}.md-tooltip2{-webkit-backface-visibility:hidden;backface-visibility:hidden;color:var(--md-default-fg-color);font-family:var(--md-text-font-family);opacity:0;pointer-events:none;position:absolute;top:calc(var(--md-tooltip-host-y) + var(--md-tooltip-y));transform:translateY(-.4rem);transform-origin:calc(var(--md-tooltip-host-x) + var(--md-tooltip-x)) 0;transition:transform 0ms .25s,opacity .25s,z-index .25s;width:100%;z-index:0}.md-tooltip2:before{border-left:var(--md-tooltip-tail) solid #0000;border-right:var(--md-tooltip-tail) solid #0000;content:"";display:block;left:clamp(1.5 * .8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-tail),100vw - 2 * var(--md-tooltip-tail) - 1.5 * .8rem);position:absolute;z-index:1}.md-tooltip2--top:before{border-top:var(--md-tooltip-tail) solid var(--md-default-bg-color);bottom:calc(var(--md-tooltip-tail)*-1 + .025rem);filter:drop-shadow(0 1px 0 hsla(0,0%,0%,.05))}.md-tooltip2--bottom:before{border-bottom:var(--md-tooltip-tail) solid var(--md-default-bg-color);filter:drop-shadow(0 -1px 0 hsla(0,0%,0%,.05));top:calc(var(--md-tooltip-tail)*-1 + .025rem)}.md-tooltip2--active{opacity:1;transform:translateY(0);transition:transform .4s cubic-bezier(0,1,.5,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip2__inner{scrollbar-gutter:stable;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);left:clamp(.8rem,var(--md-tooltip-host-x) - .8rem,100vw - var(--md-tooltip-width) - .8rem);max-height:40vh;max-width:calc(100vw - 1.6rem);position:relative;scrollbar-width:thin}.md-tooltip2__inner::-webkit-scrollbar{height:.2rem;width:.2rem}.md-tooltip2__inner::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-tooltip2__inner::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}[role=tooltip]>.md-tooltip2__inner{font-size:.5rem;font-weight:700;left:clamp(.8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-width)/2,100vw - var(--md-tooltip-width) - .8rem);max-width:min(100vw - 2 * .8rem,400px);padding:.2rem .4rem;-webkit-user-select:none;user-select:none;width:-moz-fit-content;width:fit-content}.md-tooltip2__inner.md-typeset>:first-child{margin-top:0}.md-tooltip2__inner.md-typeset>:last-child{margin-bottom:0}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06l6.06-6.06Z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1c-1.3 0-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2Z"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.58.58 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27Z"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59 21 7Z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10Z"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2 1 21Z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5V20M12 2c2.75 0 5.1 1 7.05 2.95C21 6.9 22 9.25 22 12s-1 5.1-2.95 7.05C17.1 21 14.75 22 12 22s-5.1-1-7.05-2.95C3 17.1 2 14.75 2 12s1-5.1 2.95-7.05C6.9 3 9.25 2 12 2Z"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2v-1m10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4 9 4m-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2v-1m-6 2h2v-1h-2v1Z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2H7m4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4v3Z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3l-2 4Z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7h-2Z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6 1.41-1.42Z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
diff --git a/doc/assets/stylesheets/main.66ac8b77.min.css.map b/doc/assets/stylesheets/main.66ac8b77.min.css.map
deleted file mode 100644
index 315eaed..0000000
--- a/doc/assets/stylesheets/main.66ac8b77.min.css.map
+++ /dev/null
@@ -1 +0,0 @@
-{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_code.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_tooltip2.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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","file":"main.css"}
\ No newline at end of file
diff --git a/doc/index.html b/doc/index.html
index 25202f6..12099be 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -14,7 +14,7 @@
       
       
       <link rel="icon" href="assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.21">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.24">
     
     
       
@@ -22,7 +22,7 @@
       
     
     
-      <link rel="stylesheet" href="assets/stylesheets/main.66ac8b77.min.css">
+      <link rel="stylesheet" href="assets/stylesheets/main.6543a935.min.css">
       
       
 
@@ -359,6 +359,7 @@ <h1 id="documentation">Documentation</h1>
 <li><code>odfdo-show</code>: dump text from an ODF file to the standard output, and optionally styles and meta informations.</li>
 <li><code>odfdo-styles</code>: command line interface tool to manipulate styles of ODF files.</li>
 <li><code>odfdo-replace</code>: find a pattern (regex) in an ODF file and replace by some string.</li>
+<li><code>odfdo-userfield</code>: Show or set the user-field content in an ODF file.</li>
 <li><code>odfdo-highlight</code>: highlight the text matching a pattern (regex) in an ODF file.</li>
 <li><code>odfdo-headers</code>: print the headers of an ODF file.</li>
 <li><code>odfdo-table-shrink</code>: shrink tables to optimize width and height.</li>
@@ -439,7 +440,7 @@ <h1 id="changes-from-former-lpod-library">Changes from former lpod library</h1>
     <script id="__config" type="application/json">{"base": ".", "features": [], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="assets/javascripts/bundle.a7c05c9e.min.js"></script>
+      <script src="assets/javascripts/bundle.081f42fc.min.js"></script>
       
     
   </body>
diff --git a/doc/reference.html b/doc/reference.html
index 269c7d4..dd0914f 100644
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -14,7 +14,7 @@
       
       
       <link rel="icon" href="assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.21">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.24">
     
     
       
@@ -22,7 +22,7 @@
       
     
     
-      <link rel="stylesheet" href="assets/stylesheets/main.66ac8b77.min.css">
+      <link rel="stylesheet" href="assets/stylesheets/main.6543a935.min.css">
       
       
 
@@ -9918,9 +9918,9 @@ <h1 id="reference">Reference</h1>
 
 
 <a id="odfdo"></a>
-  <div class="doc doc-contents first">
+    <div class="doc doc-contents first">
+
 
-  
 
   <div class="doc doc-children">
 
@@ -9936,17 +9936,17 @@ <h1 id="reference">Reference</h1>
 
 
 <h2 id="odfdo.AnimPar" class="doc doc-heading">
-          <code>AnimPar</code>
+            <code>AnimPar</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>A container for SMIL Presentation Animations.</p>
 <p>Arguments:</p>
 <pre><code>presentation_node_type -- default, on-click, with-previous,
@@ -9956,9 +9956,9 @@ <h2 id="odfdo.AnimPar" class="doc doc-heading">
 smil_begin -- indefinite, 10s, [id].click, [id].begin
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/smil.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">31</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/smil.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
@@ -10018,12 +10018,11 @@ <h2 id="odfdo.AnimPar" class="doc doc-heading">
             <span class="k">if</span> <span class="n">smil_begin</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">smil_begin</span> <span class="o">=</span> <span class="n">smil_begin</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -10034,10 +10033,10 @@ <h2 id="odfdo.AnimPar" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -10046,17 +10045,17 @@ <h2 id="odfdo.AnimPar" class="doc doc-heading">
 
 
 <h2 id="odfdo.AnimSeq" class="doc doc-heading">
-          <code>AnimSeq</code>
+            <code>AnimSeq</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>TA container for SMIL Presentation Animations. Animations
 inside this block are executed after the slide has executed its initial
 transition.</p>
@@ -10066,9 +10065,9 @@ <h2 id="odfdo.AnimSeq" class="doc doc-heading">
                           and interactive-sequence
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/smil.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">66</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/smil.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">66</span>
 <span class="normal">67</span>
 <span class="normal">68</span>
 <span class="normal">69</span>
@@ -10114,12 +10113,11 @@ <h2 id="odfdo.AnimSeq" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span> <span class="ow">and</span> <span class="n">presentation_node_type</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">presentation_node_type</span> <span class="o">=</span> <span class="n">presentation_node_type</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -10130,10 +10128,10 @@ <h2 id="odfdo.AnimSeq" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -10142,54 +10140,53 @@ <h2 id="odfdo.AnimSeq" class="doc doc-heading">
 
 
 <h2 id="odfdo.AnimTransFilter" class="doc doc-heading">
-          <code>AnimTransFilter</code>
+            <code>AnimTransFilter</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
-  
-      <p>Class to make a beautiful transition between two frames.</p>
 
+      <p>Class to make a beautiful transition between two frames.</p>
 
 
-  <p><strong>Parameters:</strong></p>
-  <table>
-    <thead>
-      <tr>
-        <th>Name</th>
-        <th>Type</th>
-        <th>Description</th>
-        <th>Default</th>
-      </tr>
-    </thead>
-    <tbody>
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
         <tr>
-          <td><code>smil_type</code></td>
-          <td>
-                <code>and smil_subtype -- see http</code>
-          </td>
-          <td>
-            <div class="doc-md-description">
-              <p>//www.w3.org/TR/SMIL20/
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>smil_type</code></td>
+            <td>
+                  <code>and smil_subtype -- see http</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>//www.w3.org/TR/SMIL20/
             smil-transitions.html#TransitionEffects-Appendix
                             to get a list of all types/subtypes</p>
-            </div>
-          </td>
-          <td>
-                <code>None</code>
-          </td>
-        </tr>
-    </tbody>
-  </table>
-
-            <details class="quote">
-              <summary>Source code in <code>odfdo/smil.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 94</span>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+              <details class="quote">
+                <summary>Source code in <code>odfdo/smil.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 94</span>
 <span class="normal"> 95</span>
 <span class="normal"> 96</span>
 <span class="normal"> 97</span>
@@ -10293,12 +10290,11 @@ <h2 id="odfdo.AnimTransFilter" class="doc doc-heading">
             <span class="k">if</span> <span class="n">smil_mode</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">smil_mode</span> <span class="o">=</span> <span class="n">smil_mode</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -10309,10 +10305,10 @@ <h2 id="odfdo.AnimTransFilter" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -10321,17 +10317,17 @@ <h2 id="odfdo.AnimTransFilter" class="doc doc-heading">
 
 
 <h2 id="odfdo.Annotation" class="doc doc-heading">
-          <code>Annotation</code>
+            <code>Annotation</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.mixin_dc_creator.DcCreatorMixin">DcCreatorMixin</span></code>, <code><span title="odfdo.mixin_dc_date.DcDateMixin">DcDateMixin</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.mixin_dc_creator.DcCreatorMixin">DcCreatorMixin</span></code>, <code><span title="odfdo.mixin_dc_date.DcDateMixin">DcDateMixin</span></code></p>
+
 
-  
       <p>Annotation element credited to the given creator with the
 given text, optionally dated (current date by default).
 If name not provided and some parent is provided, the name is
@@ -10348,9 +10344,9 @@ <h2 id="odfdo.Annotation" class="doc doc-heading">
 parent -- Element
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/note.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">148</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/note.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">148</span>
 <span class="normal">149</span>
 <span class="normal">150</span>
 <span class="normal">151</span>
@@ -10678,9 +10674,9 @@ <h2 id="odfdo.Annotation" class="doc doc-heading">
         <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">dc_date</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">dc_date</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -10695,8 +10691,8 @@ <h2 id="odfdo.Annotation" class="doc doc-heading">
 
 
 <h3 id="odfdo.Annotation.dc_creator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">dc_creator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">dc_creator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -10705,10 +10701,10 @@ <h3 id="odfdo.Annotation.dc_creator" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Alias for self.creator property.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -10717,8 +10713,8 @@ <h3 id="odfdo.Annotation.dc_creator" class="doc doc-heading">
 
 
 <h3 id="odfdo.Annotation.dc_date" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">dc_date</span><span class="p">:</span> <span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">dc_date</span><span class="p">:</span> <span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -10727,10 +10723,10 @@ <h3 id="odfdo.Annotation.dc_date" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Alias for self.date property.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -10739,8 +10735,8 @@ <h3 id="odfdo.Annotation.dc_date" class="doc doc-heading">
 
 
 <h3 id="odfdo.Annotation.end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">end</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">end</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -10748,10 +10744,10 @@ <h3 id="odfdo.Annotation.end" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the corresponding annotation-end tag or None.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -10760,8 +10756,8 @@ <h3 id="odfdo.Annotation.end" class="doc doc-heading">
 
 
 <h3 id="odfdo.Annotation.start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">start</span><span class="p">:</span> <span class="n">Element</span></code>
-  
+            <code class="highlight language-python"><span class="n">start</span><span class="p">:</span> <span class="n">Element</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -10769,28 +10765,26 @@ <h3 id="odfdo.Annotation.start" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return self.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Annotation.delete" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the given element from the XML tree. If no element is given,
 &ldquo;self&rdquo; is deleted. The XML library may allow to continue to use an
 element now &ldquo;orphan&rdquo; as long as you have a reference to it.</p>
@@ -10799,9 +10793,9 @@ <h3 id="odfdo.Annotation.delete" class="doc doc-heading">
 <pre><code>child -- Element or None
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/note.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">285</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/note.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">285</span>
 <span class="normal">286</span>
 <span class="normal">287</span>
 <span class="normal">288</span>
@@ -10839,24 +10833,22 @@ <h3 id="odfdo.Annotation.delete" class="doc doc-heading">
     <span class="c1"># act like normal delete</span>
     <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Annotation.get_annotated" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_annotated</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_annotated</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Returns the annotated content from an annotation.</p>
 <p>If no content exists (single position annotation or annotation-end not
 found), returns [] (or &ldquo;&rdquo; if text flag is True).
@@ -10873,9 +10865,9 @@ <h3 id="odfdo.Annotation.get_annotated" class="doc doc-heading">
 </code></pre>
 <p>Return: list or Element or text or None</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/note.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">248</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/note.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">248</span>
 <span class="normal">249</span>
 <span class="normal">250</span>
 <span class="normal">251</span>
@@ -10947,8 +10939,8 @@ <h3 id="odfdo.Annotation.get_annotated" class="doc doc-heading">
         <span class="bp">self</span><span class="p">,</span> <span class="n">end</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="n">as_text</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="n">no_header</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="n">clean</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -10956,8 +10948,7 @@ <h3 id="odfdo.Annotation.get_annotated" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -10966,17 +10957,17 @@ <h3 id="odfdo.Annotation.get_annotated" class="doc doc-heading">
 
 
 <h2 id="odfdo.AnnotationEnd" class="doc doc-heading">
-          <code>AnnotationEnd</code>
+            <code>AnnotationEnd</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>AnnotationEnd: the &ldquo;office:annotation-end&rdquo; element may be used to
 define the end of a text range of document content that spans element
 boundaries. In that case, an &ldquo;office:annotation&rdquo; element shall precede
@@ -10987,9 +10978,9 @@ <h2 id="odfdo.AnnotationEnd" class="doc doc-heading">
 element. An &ldquo;office:annotation-end&rdquo; element without a preceding
 &ldquo;office:annotation&rdquo; element that has the same name assigned is ignored.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/note.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">317</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/note.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">317</span>
 <span class="normal">318</span>
 <span class="normal">319</span>
 <span class="normal">320</span>
@@ -11101,9 +11092,9 @@ <h2 id="odfdo.AnnotationEnd" class="doc doc-heading">
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Return self.&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="bp">self</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -11118,8 +11109,8 @@ <h2 id="odfdo.AnnotationEnd" class="doc doc-heading">
 
 
 <h3 id="odfdo.AnnotationEnd.end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">end</span><span class="p">:</span> <span class="n">Element</span></code>
-  
+            <code class="highlight language-python"><span class="n">end</span><span class="p">:</span> <span class="n">Element</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -11127,10 +11118,10 @@ <h3 id="odfdo.AnnotationEnd.end" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return self.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -11139,8 +11130,8 @@ <h3 id="odfdo.AnnotationEnd.end" class="doc doc-heading">
 
 
 <h3 id="odfdo.AnnotationEnd.start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">start</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">start</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -11148,28 +11139,26 @@ <h3 id="odfdo.AnnotationEnd.start" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the corresponding annotation starting tag or None.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.AnnotationEnd.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">annotation</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">annotation</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Initialize an AnnotationEnd element. Either annotation or name must be
 provided to have proper reference for the annotation-end.</p>
 <p>Arguments:</p>
@@ -11178,9 +11167,9 @@ <h3 id="odfdo.AnnotationEnd.__init__" class="doc doc-heading">
 name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/note.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">332</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/note.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">332</span>
 <span class="normal">333</span>
 <span class="normal">334</span>
 <span class="normal">335</span>
@@ -11228,8 +11217,8 @@ <h3 id="odfdo.AnnotationEnd.__init__" class="doc doc-heading">
             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Annotation-end must have a name&quot;</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -11237,8 +11226,7 @@ <h3 id="odfdo.AnnotationEnd.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -11247,23 +11235,23 @@ <h3 id="odfdo.AnnotationEnd.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Body" class="doc doc-heading">
-          <code>Body</code>
+            <code>Body</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>Body, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">27</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">27</span>
 <span class="normal">28</span>
 <span class="normal">29</span>
 <span class="normal">30</span>
@@ -11391,9 +11379,9 @@ <h2 id="odfdo.Body" class="doc doc-heading">
             <span class="p">)</span>
         <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -11408,8 +11396,8 @@ <h2 id="odfdo.Body" class="doc doc-heading">
 
 
 <h3 id="odfdo.Body.tables" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">tables</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">tables</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -11417,29 +11405,27 @@ <h3 id="odfdo.Body.tables" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the tables.</p>
 <p>Return: list of Table</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Body.get_table" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_table</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_table</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the table that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -11450,9 +11436,9 @@ <h3 id="odfdo.Body.get_table" class="doc doc-heading">
 </code></pre>
 <p>Return: Table or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/body.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">63</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/body.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">63</span>
 <span class="normal">64</span>
 <span class="normal">65</span>
 <span class="normal">66</span>
@@ -11508,24 +11494,22 @@ <h3 id="odfdo.Body.get_table" class="doc doc-heading">
         <span class="p">)</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Body.get_tables" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_tables</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_tables</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the tables that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -11534,9 +11518,9 @@ <h3 id="odfdo.Body.get_tables" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Table</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/body.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">36</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/body.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">36</span>
 <span class="normal">37</span>
 <span class="normal">38</span>
 <span class="normal">39</span>
@@ -11572,8 +11556,8 @@ <h3 id="odfdo.Body.get_tables" class="doc doc-heading">
         <span class="s2">&quot;descendant::table:table&quot;</span><span class="p">,</span> <span class="n">table_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -11581,8 +11565,7 @@ <h3 id="odfdo.Body.get_tables" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -11591,25 +11574,25 @@ <h3 id="odfdo.Body.get_tables" class="doc doc-heading">
 
 
 <h2 id="odfdo.Bookmark" class="doc doc-heading">
-          <code>Bookmark</code>
+            <code>Bookmark</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>Bookmark class for ODF &ldquo;text:bookmark&rdquo;</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/bookmark.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/bookmark.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
 <span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
@@ -11641,12 +11624,11 @@ <h2 id="odfdo.Bookmark" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -11657,10 +11639,10 @@ <h2 id="odfdo.Bookmark" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -11669,25 +11651,25 @@ <h2 id="odfdo.Bookmark" class="doc doc-heading">
 
 
 <h2 id="odfdo.BookmarkEnd" class="doc doc-heading">
-          <code>BookmarkEnd</code>
+            <code>BookmarkEnd</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>BookmarkEnd class for ODF &ldquo;text:bookmark-end&rdquo;</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/bookmark.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">72</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/bookmark.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">72</span>
 <span class="normal">73</span>
 <span class="normal">74</span>
 <span class="normal">75</span>
@@ -11719,12 +11701,11 @@ <h2 id="odfdo.BookmarkEnd" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -11735,10 +11716,10 @@ <h2 id="odfdo.BookmarkEnd" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -11747,25 +11728,25 @@ <h2 id="odfdo.BookmarkEnd" class="doc doc-heading">
 
 
 <h2 id="odfdo.BookmarkStart" class="doc doc-heading">
-          <code>BookmarkStart</code>
+            <code>BookmarkStart</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>BookmarkStart class for ODF &ldquo;text:bookmark-start&rdquo;</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/bookmark.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">51</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/bookmark.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">51</span>
 <span class="normal">52</span>
 <span class="normal">53</span>
 <span class="normal">54</span>
@@ -11797,12 +11778,11 @@ <h2 id="odfdo.BookmarkStart" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -11813,10 +11793,10 @@ <h2 id="odfdo.BookmarkStart" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -11825,22 +11805,22 @@ <h2 id="odfdo.BookmarkStart" class="doc doc-heading">
 
 
 <h2 id="odfdo.Cell" class="doc doc-heading">
-          <code>Cell</code>
+            <code>Cell</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element_typed.ElementTyped" href="#odfdo.ElementTyped">ElementTyped</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element_typed.ElementTyped" href="#odfdo.ElementTyped">ElementTyped</a></code></p>
+
 
-  
       <p>&ldquo;table:table-cell&rdquo; table cell element.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/cell.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 43</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/cell.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 43</span>
 <span class="normal"> 44</span>
 <span class="normal"> 45</span>
 <span class="normal"> 46</span>
@@ -12540,9 +12520,9 @@ <h2 id="odfdo.Cell" class="doc doc-heading">
 
     <span class="n">_is_spanned</span> <span class="o">=</span> <span class="n">is_spanned</span>  <span class="c1"># compatibility</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -12557,8 +12537,8 @@ <h2 id="odfdo.Cell" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.currency" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">currency</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">currency</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12567,11 +12547,11 @@ <h3 id="odfdo.Cell.currency" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the currency used for monetary values.</p>
 <p>Return: str | None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12580,8 +12560,8 @@ <h3 id="odfdo.Cell.currency" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.float" class="doc doc-heading">
-          <code class="highlight language-python"><span class="nb">float</span><span class="p">:</span> <span class="n">Float</span></code>
-  
+            <code class="highlight language-python"><span class="nb">float</span><span class="p">:</span> <span class="n">Float</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12590,10 +12570,10 @@ <h3 id="odfdo.Cell.float" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set / get the value of the cell as a float (or 0.0).</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12602,8 +12582,8 @@ <h3 id="odfdo.Cell.float" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.formula" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">formula</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">formula</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12612,12 +12592,12 @@ <h3 id="odfdo.Cell.formula" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the formula of the cell, or None if undefined.</p>
 <p>The formula is not interpreted in any way.</p>
 <p>Return: str | None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12626,8 +12606,8 @@ <h3 id="odfdo.Cell.formula" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.repeated" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">repeated</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">repeated</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12636,12 +12616,12 @@ <h3 id="odfdo.Cell.repeated" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the number of times the cell is repeated.</p>
 <p>Always None when using the table API.</p>
 <p>Return: int or None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12650,8 +12630,8 @@ <h3 id="odfdo.Cell.repeated" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.string" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">string</span><span class="p">:</span> <span class="nb">str</span></code>
-  
+            <code class="highlight language-python"><span class="n">string</span><span class="p">:</span> <span class="nb">str</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12660,10 +12640,10 @@ <h3 id="odfdo.Cell.string" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set / get the value of the cell as a string (or &lsquo;&rsquo;).</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12672,8 +12652,8 @@ <h3 id="odfdo.Cell.string" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12682,11 +12662,11 @@ <h3 id="odfdo.Cell.style" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the style of the cell itself.</p>
 <p>Return: str | None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12695,8 +12675,8 @@ <h3 id="odfdo.Cell.style" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.type" class="doc doc-heading">
-          <code class="highlight language-python"><span class="nb">type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="nb">type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12705,12 +12685,12 @@ <h3 id="odfdo.Cell.type" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the type of the cell: boolean, float, date, string
 or time.</p>
 <p>Return: str | None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -12719,8 +12699,8 @@ <h3 id="odfdo.Cell.type" class="doc doc-heading">
 
 
 <h3 id="odfdo.Cell.value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">value</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="nb">bool</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="n">Float</span> <span class="o">|</span> <span class="n">Decimal</span> <span class="o">|</span> <span class="n">date</span> <span class="o">|</span> <span class="n">datetime</span> <span class="o">|</span> <span class="n">timedelta</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">value</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="nb">bool</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="n">Float</span> <span class="o">|</span> <span class="n">Decimal</span> <span class="o">|</span> <span class="n">date</span> <span class="o">|</span> <span class="n">datetime</span> <span class="o">|</span> <span class="n">timedelta</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -12729,31 +12709,29 @@ <h3 id="odfdo.Cell.value" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set / get the value of the cell. The type is read from the
 &lsquo;office:value-type&rsquo; attribute of the cell. When setting the value,
 the type of the value will determine the new value_type of the cell.</p>
 <p>Warning: use this method for boolean, float or string only.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Cell.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">formula</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">value</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">formula</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a cell element containing the given value. The textual
 representation is automatically formatted but can be provided. Cell
 type can be deduced as well, unless the number is a percentage or
@@ -12775,9 +12753,9 @@ <h3 id="odfdo.Cell.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/cell.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/cell.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
 <span class="normal">50</span>
 <span class="normal">51</span>
 <span class="normal">52</span>
@@ -12873,24 +12851,22 @@ <h3 id="odfdo.Cell.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Cell.is_empty" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return whether the cell has no value or the value evaluates
 to False (empty string), and no style.</p>
 <p>If aggressive is True, empty cells with style are considered empty.</p>
@@ -12899,9 +12875,9 @@ <h3 id="odfdo.Cell.is_empty" class="doc doc-heading">
 </code></pre>
 <p>Return: bool</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/cell.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">361</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/cell.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">361</span>
 <span class="normal">362</span>
 <span class="normal">363</span>
 <span class="normal">364</span>
@@ -12935,30 +12911,28 @@ <h3 id="odfdo.Cell.is_empty" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">False</span>
     <span class="k">return</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Cell.is_spanned" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_spanned</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">is_spanned</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return whether the cell is spanned over several cells.</p>
 <p>Returns: True | False</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/cell.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">379</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/cell.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">379</span>
 <span class="normal">380</span>
 <span class="normal">381</span>
 <span class="normal">382</span>
@@ -12982,24 +12956,22 @@ <h3 id="odfdo.Cell.is_spanned" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">True</span>
     <span class="k">return</span> <span class="kc">False</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Cell.set_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">formula</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">formula</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the cell state from the Python value type.</p>
 <p>Text is how the cell is displayed. Cell type is guessed,
 unless provided.</p>
@@ -13015,9 +12987,9 @@ <h3 id="odfdo.Cell.set_value" class="doc doc-heading">
 currency -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/cell.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">219</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/cell.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">219</span>
 <span class="normal">220</span>
 <span class="normal">221</span>
 <span class="normal">222</span>
@@ -13113,8 +13085,8 @@ <h3 id="odfdo.Cell.set_value" class="doc doc-heading">
     <span class="k">if</span> <span class="n">formula</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">formula</span> <span class="o">=</span> <span class="n">formula</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -13122,8 +13094,7 @@ <h3 id="odfdo.Cell.set_value" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -13132,21 +13103,22 @@ <h3 id="odfdo.Cell.set_value" class="doc doc-heading">
 
 
 <h2 id="odfdo.ChangeInfo" class="doc doc-heading">
-          <code>ChangeInfo</code>
+            <code>ChangeInfo</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.mixin_dc_creator.DcCreatorMixin">DcCreatorMixin</span></code>, <code><span title="odfdo.mixin_dc_date.DcDateMixin">DcDateMixin</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.mixin_dc_creator.DcCreatorMixin">DcCreatorMixin</span></code>, <code><span title="odfdo.mixin_dc_date.DcDateMixin">DcDateMixin</span></code></p>
+
 
-  
       <p>The &ldquo;office:change-info&rdquo; element represents who made a change and when.
 It may also contain a comment (one or more Paragrah &ldquo;text:p&rdquo; elements)
 on the change.</p>
 
+
 <details class="the-comments-available-in-the-changeinfo-are-available-through" open>
   <summary>The comments available in the ChangeInfo are available through</summary>
   <ul>
@@ -13157,9 +13129,9 @@ <h2 id="odfdo.ChangeInfo" class="doc doc-heading">
 <p>creator &ndash; str (or None)</p>
 <p>date &ndash; datetime (or None)</p>
 </details>
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 37</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 37</span>
 <span class="normal"> 38</span>
 <span class="normal"> 39</span>
 <span class="normal"> 40</span>
@@ -13287,12 +13259,11 @@ <h2 id="odfdo.ChangeInfo" class="doc doc-heading">
         <span class="n">para</span><span class="o">.</span><span class="n">append_plain_text</span><span class="p">(</span><span class="n">text</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="n">para</span><span class="p">,</span> <span class="n">xmlposition</span><span class="o">=</span><span class="n">LAST_CHILD</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -13305,15 +13276,14 @@ <h2 id="odfdo.ChangeInfo" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ChangeInfo.get_comments" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_comments</span><span class="p">(</span><span class="n">joined</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_comments</span><span class="p">(</span><span class="n">joined</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get text content of the comments. If joined is True (default), the
 text of different paragraphs is concatenated, else a list of strings,
 one per paragraph, is returned.</p>
@@ -13322,9 +13292,9 @@ <h3 id="odfdo.ChangeInfo.get_comments" class="doc doc-heading">
 </code></pre>
 <p>Return: str or list of str.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">66</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">66</span>
 <span class="normal">67</span>
 <span class="normal">68</span>
 <span class="normal">69</span>
@@ -13360,24 +13330,22 @@ <h3 id="odfdo.ChangeInfo.get_comments" class="doc doc-heading">
         <span class="k">return</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">text</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ChangeInfo.set_comments" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_comments</span><span class="p">(</span><span class="n">text</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">replace</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_comments</span><span class="p">(</span><span class="n">text</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">replace</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the text content of the comments. If replace is True (default),
 the new text replace old comments, else it is added at the end.</p>
 <p>Arguments:</p>
@@ -13386,9 +13354,9 @@ <h3 id="odfdo.ChangeInfo.set_comments" class="doc doc-heading">
 replace -- boolean
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 85</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 85</span>
 <span class="normal"> 86</span>
 <span class="normal"> 87</span>
 <span class="normal"> 88</span>
@@ -13420,8 +13388,8 @@ <h3 id="odfdo.ChangeInfo.set_comments" class="doc doc-heading">
     <span class="n">para</span><span class="o">.</span><span class="n">append_plain_text</span><span class="p">(</span><span class="n">text</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="n">para</span><span class="p">,</span> <span class="n">xmlposition</span><span class="o">=</span><span class="n">LAST_CHILD</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -13429,8 +13397,7 @@ <h3 id="odfdo.ChangeInfo.set_comments" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -13439,23 +13406,23 @@ <h3 id="odfdo.ChangeInfo.set_comments" class="doc doc-heading">
 
 
 <h2 id="odfdo.Chart" class="doc doc-heading">
-          <code>Chart</code>
+            <code>Chart</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Chart, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 93</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 93</span>
 <span class="normal"> 94</span>
 <span class="normal"> 95</span>
 <span class="normal"> 96</span>
@@ -13471,12 +13438,11 @@ <h2 id="odfdo.Chart" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -13487,10 +13453,10 @@ <h2 id="odfdo.Chart" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -13499,22 +13465,22 @@ <h2 id="odfdo.Chart" class="doc doc-heading">
 
 
 <h2 id="odfdo.Column" class="doc doc-heading">
-          <code>Column</code>
+            <code>Column</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF table column &ldquo;table:table-column&rdquo;</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/table.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">171</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/table.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">171</span>
 <span class="normal">172</span>
 <span class="normal">173</span>
 <span class="normal">174</span>
@@ -13790,9 +13756,9 @@ <h2 id="odfdo.Column" class="doc doc-heading">
     <span class="k">def</span> <span class="nf">style</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n">Element</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">set_style_attribute</span><span class="p">(</span><span class="s2">&quot;table:style-name&quot;</span><span class="p">,</span> <span class="n">style</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -13807,8 +13773,8 @@ <h2 id="odfdo.Column" class="doc doc-heading">
 
 
 <h3 id="odfdo.Column.default_cell_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">default_cell_style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">default_cell_style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -13817,10 +13783,10 @@ <h3 id="odfdo.Column.default_cell_style" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the default cell style for column.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -13829,8 +13795,8 @@ <h3 id="odfdo.Column.default_cell_style" class="doc doc-heading">
 
 
 <h3 id="odfdo.Column.repeated" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">repeated</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">repeated</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -13839,12 +13805,12 @@ <h3 id="odfdo.Column.repeated" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get /set the number of times the column is repeated.</p>
 <p>Always None when using the table API.</p>
 <p>Return: int or None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -13853,8 +13819,8 @@ <h3 id="odfdo.Column.repeated" class="doc doc-heading">
 
 
 <h3 id="odfdo.Column.style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -13863,29 +13829,27 @@ <h3 id="odfdo.Column.style" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get /set the style of the column itself.</p>
 <p>Return: str</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Column.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">default_cell_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">default_cell_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a column group element of the optionally given style. Cell
 style can be set for the whole column. If the properties apply to
 several columns, give the number of repeated columns.</p>
@@ -13899,9 +13863,9 @@ <h3 id="odfdo.Column.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">177</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">177</span>
 <span class="normal">178</span>
 <span class="normal">179</span>
 <span class="normal">180</span>
@@ -13965,30 +13929,28 @@ <h3 id="odfdo.Column.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Column.get_default_cell_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_default_cell_style</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_default_cell_style</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the default cell style for column.</p>
 <p>(See also self.default_cell_style property.)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">224</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">224</span>
 <span class="normal">225</span>
 <span class="normal">226</span>
 <span class="normal">227</span>
@@ -14000,30 +13962,28 @@ <h3 id="odfdo.Column.get_default_cell_style" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_attribute_string</span><span class="p">(</span><span class="s2">&quot;table:default-cell-style-name&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Column.set_default_cell_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_default_cell_style</span><span class="p">(</span><span class="n">style</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_default_cell_style</span><span class="p">(</span><span class="n">style</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the default cell style for column.</p>
 <p>(See also self.default_cell_style property.)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">231</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">231</span>
 <span class="normal">232</span>
 <span class="normal">233</span>
 <span class="normal">234</span>
@@ -14035,8 +13995,8 @@ <h3 id="odfdo.Column.set_default_cell_style" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">set_style_attribute</span><span class="p">(</span><span class="s2">&quot;table:default-cell-style-name&quot;</span><span class="p">,</span> <span class="n">style</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -14044,8 +14004,7 @@ <h3 id="odfdo.Column.set_default_cell_style" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -14054,17 +14013,17 @@ <h3 id="odfdo.Column.set_default_cell_style" class="doc doc-heading">
 
 
 <h2 id="odfdo.ConnectorShape" class="doc doc-heading">
-          <code>ConnectorShape</code>
+            <code>ConnectorShape</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+
 
-  
       <p>Create a Connector shape.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -14084,9 +14043,9 @@ <h2 id="odfdo.ConnectorShape" class="doc doc-heading">
 p2 -- (str, str)
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/shapes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">241</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/shapes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">241</span>
 <span class="normal">242</span>
 <span class="normal">243</span>
 <span class="normal">244</span>
@@ -14222,12 +14181,11 @@ <h2 id="odfdo.ConnectorShape" class="doc doc-heading">
                 <span class="bp">self</span><span class="o">.</span><span class="n">x2</span> <span class="o">=</span> <span class="n">p2</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">y2</span> <span class="o">=</span> <span class="n">p2</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -14238,10 +14196,10 @@ <h2 id="odfdo.ConnectorShape" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -14250,20 +14208,20 @@ <h2 id="odfdo.ConnectorShape" class="doc doc-heading">
 
 
 <h2 id="odfdo.Container" class="doc doc-heading">
-          <code>Container</code>
+            <code>Container</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
+    <div class="doc doc-contents ">
+
 
-  
       <p>Representation of the ODF file.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/container.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 62</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/container.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 62</span>
 <span class="normal"> 63</span>
 <span class="normal"> 64</span>
 <span class="normal"> 65</span>
@@ -15133,9 +15091,9 @@ <h2 id="odfdo.Container" class="doc doc-heading">
             <span class="c1"># default:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">_save_as_zip</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">backup</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -15150,8 +15108,8 @@ <h2 id="odfdo.Container" class="doc doc-heading">
 
 
 <h3 id="odfdo.Container.clone" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">clone</span><span class="p">:</span> <span class="n">Container</span></code>
-  
+            <code class="highlight language-python"><span class="n">clone</span><span class="p">:</span> <span class="n">Container</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -15159,10 +15117,10 @@ <h3 id="odfdo.Container.clone" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Make a copy of this container with no path.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -15171,8 +15129,8 @@ <h3 id="odfdo.Container.clone" class="doc doc-heading">
 
 
 <h3 id="odfdo.Container.mimetype" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">mimetype</span><span class="p">:</span> <span class="nb">str</span></code>
-  
+            <code class="highlight language-python"><span class="n">mimetype</span><span class="p">:</span> <span class="nb">str</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -15181,10 +15139,10 @@ <h3 id="odfdo.Container.mimetype" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return str value of mimetype of the document.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -15193,8 +15151,8 @@ <h3 id="odfdo.Container.mimetype" class="doc doc-heading">
 
 
 <h3 id="odfdo.Container.parts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">parts</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">parts</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -15202,61 +15160,57 @@ <h3 id="odfdo.Container.parts" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of members.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Container.del_part" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">del_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">del_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Mark a part for deletion.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/container.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">366</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/container.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">366</span>
 <span class="normal">367</span>
 <span class="normal">368</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">del_part</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Mark a part for deletion.&quot;&quot;&quot;</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">__parts</span><span class="p">[</span><span class="n">path</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Container.get_part" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the bytes of a part of the ODF.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/container.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">319</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/container.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">319</span>
 <span class="normal">320</span>
 <span class="normal">321</span>
 <span class="normal">322</span>
@@ -15302,29 +15256,27 @@ <h3 id="odfdo.Container.get_part" class="doc doc-heading">
         <span class="k">return</span> <span class="n">part</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Container.get_parts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_parts</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_parts</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of members.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/container.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">297</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/container.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">297</span>
 <span class="normal">298</span>
 <span class="normal">299</span>
 <span class="normal">300</span>
@@ -15356,29 +15308,27 @@ <h3 id="odfdo.Container.get_parts" class="doc doc-heading">
     <span class="k">else</span><span class="p">:</span>
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Unable to provide parts of the document&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Container.open" class="doc doc-heading">
-          <code class="highlight language-python"><span class="nb">open</span><span class="p">(</span><span class="n">path_or_file</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="nb">open</span><span class="p">(</span><span class="n">path_or_file</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Load the content of an ODF file.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/container.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">77</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/container.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">77</span>
 <span class="normal">78</span>
 <span class="normal">79</span>
 <span class="normal">80</span>
@@ -15420,24 +15370,22 @@ <h3 id="odfdo.Container.open" class="doc doc-heading">
             <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_read_folder</span><span class="p">()</span>
     <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Document format not managed by odfdo: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">path_or_file</span><span class="p">)</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Container.save" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">save</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">packaging</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">backup</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">save</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">packaging</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">backup</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Save the container to the given target, a path or a file-like
 object.</p>
 <p>Package the output document in the same format than current document,
@@ -15450,9 +15398,9 @@ <h3 id="odfdo.Container.save" class="doc doc-heading">
 backup -- boolean
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/container.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">459</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/container.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">459</span>
 <span class="normal">460</span>
 <span class="normal">461</span>
 <span class="normal">462</span>
@@ -15528,36 +15476,34 @@ <h3 id="odfdo.Container.save" class="doc doc-heading">
         <span class="c1"># default:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_save_as_zip</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">backup</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Container.set_part" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_part</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_part</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Replace or add a new part.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/container.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">362</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/container.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">362</span>
 <span class="normal">363</span>
 <span class="normal">364</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">set_part</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="nb">bytes</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Replace or add a new part.&quot;&quot;&quot;</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">__parts</span><span class="p">[</span><span class="n">path</span><span class="p">]</span> <span class="o">=</span> <span class="n">data</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -15565,8 +15511,7 @@ <h3 id="odfdo.Container.set_part" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -15575,20 +15520,20 @@ <h3 id="odfdo.Container.set_part" class="doc doc-heading">
 
 
 <h2 id="odfdo.Content" class="doc doc-heading">
-          <code>Content</code>
+            <code>Content</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/content.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 33</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/content.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 33</span>
 <span class="normal"> 34</span>
 <span class="normal"> 35</span>
 <span class="normal"> 36</span>
@@ -15726,12 +15671,11 @@ <h2 id="odfdo.Content" class="doc doc-heading">
                 <span class="k">return</span> <span class="n">style</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -15744,15 +15688,14 @@ <h2 id="odfdo.Content" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Content.get_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the style uniquely identified by the name/family pair. If
 the argument is already a style object, it will return it.</p>
 <p>If the name is None, the default style is fetched.</p>
@@ -15768,9 +15711,9 @@ <h3 id="odfdo.Content.get_style" class="doc doc-heading">
 </code></pre>
 <p>Return: Style or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/content.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 66</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/content.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 66</span>
 <span class="normal"> 67</span>
 <span class="normal"> 68</span>
 <span class="normal"> 69</span>
@@ -15842,24 +15785,22 @@ <h3 id="odfdo.Content.get_style" class="doc doc-heading">
             <span class="k">return</span> <span class="n">style</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Content.get_styles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_styles</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_styles</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the list of styles in the Content part, optionally limited
 to the given family.</p>
 <p>Arguments:</p>
@@ -15867,9 +15808,9 @@ <h3 id="odfdo.Content.get_styles" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Style</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/content.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/content.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
 <span class="normal">50</span>
 <span class="normal">51</span>
 <span class="normal">52</span>
@@ -15901,8 +15842,8 @@ <h3 id="odfdo.Content.get_styles" class="doc doc-heading">
         <span class="n">result</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">get_styles</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="n">family</span><span class="p">))</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -15910,8 +15851,7 @@ <h3 id="odfdo.Content.get_styles" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -15920,23 +15860,23 @@ <h3 id="odfdo.Content.get_styles" class="doc doc-heading">
 
 
 <h2 id="odfdo.Database" class="doc doc-heading">
-          <code>Database</code>
+            <code>Database</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Database, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">103</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">103</span>
 <span class="normal">104</span>
 <span class="normal">105</span>
 <span class="normal">106</span>
@@ -15952,12 +15892,11 @@ <h2 id="odfdo.Database" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -15968,10 +15907,10 @@ <h2 id="odfdo.Database" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -15980,15 +15919,15 @@ <h2 id="odfdo.Database" class="doc doc-heading">
 
 
 <h2 id="odfdo.Document" class="doc doc-heading">
-          <code>Document</code>
+            <code>Document</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
+    <div class="doc doc-contents ">
+
 
-  
       <p>Abstraction of the ODF document.</p>
 <p>To create a new Document, several possibilities:</p>
 <pre><code>- Document() or Document("text") -&gt; an "empty" document of type text
@@ -16007,9 +15946,9 @@ <h2 id="odfdo.Document" class="doc doc-heading">
 <p>To explicitly create a document from a custom template, use the
 Document.new(path) method whose argument is the path to the template file.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/document.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 160</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/document.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 160</span>
 <span class="normal"> 161</span>
 <span class="normal"> 162</span>
 <span class="normal"> 163</span>
@@ -18067,9 +18006,9 @@ <h2 id="odfdo.Document" class="doc doc-heading">
         <span class="n">found</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cell_style_properties</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">coord</span><span class="p">)</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;fo:background-color&quot;</span><span class="p">)</span>
         <span class="k">return</span> <span class="n">found</span> <span class="ow">or</span> <span class="n">default</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -18084,8 +18023,8 @@ <h2 id="odfdo.Document" class="doc doc-heading">
 
 
 <h3 id="odfdo.Document.body" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">body</span><span class="p">:</span> <span class="n">Element</span></code>
-  
+            <code class="highlight language-python"><span class="n">body</span><span class="p">:</span> <span class="n">Element</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -18093,11 +18032,11 @@ <h3 id="odfdo.Document.body" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the body element of the content part, where actual content
 is stored.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -18106,8 +18045,8 @@ <h3 id="odfdo.Document.body" class="doc doc-heading">
 
 
 <h3 id="odfdo.Document.clone" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">clone</span><span class="p">:</span> <span class="n">Document</span></code>
-  
+            <code class="highlight language-python"><span class="n">clone</span><span class="p">:</span> <span class="n">Document</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -18115,11 +18054,11 @@ <h3 id="odfdo.Document.clone" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return an exact copy of the document.</p>
 <p>Return: Document</p>
-  </div>
+    </div>
 
 </div>
 
@@ -18128,8 +18067,8 @@ <h3 id="odfdo.Document.clone" class="doc doc-heading">
 
 
 <h3 id="odfdo.Document.manifest" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">manifest</span><span class="p">:</span> <span class="n">Manifest</span></code>
-  
+            <code class="highlight language-python"><span class="n">manifest</span><span class="p">:</span> <span class="n">Manifest</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -18137,10 +18076,10 @@ <h3 id="odfdo.Document.manifest" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the manifest part (manifest.xml) of the document.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -18149,8 +18088,8 @@ <h3 id="odfdo.Document.manifest" class="doc doc-heading">
 
 
 <h3 id="odfdo.Document.meta" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">meta</span><span class="p">:</span> <span class="n">Meta</span></code>
-  
+            <code class="highlight language-python"><span class="n">meta</span><span class="p">:</span> <span class="n">Meta</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -18158,11 +18097,11 @@ <h3 id="odfdo.Document.meta" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the meta part (meta.xml) of the document, where meta data
 are stored.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -18171,8 +18110,8 @@ <h3 id="odfdo.Document.meta" class="doc doc-heading">
 
 
 <h3 id="odfdo.Document.parts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">parts</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">parts</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -18180,11 +18119,11 @@ <h3 id="odfdo.Document.parts" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return available part names with path inside the archive, e.g.
 [&lsquo;content.xml&rsquo;, &hellip;, &lsquo;Pictures/100000000000032000000258912EB1C3.jpg&rsquo;]</p>
-  </div>
+    </div>
 
 </div>
 
@@ -18193,8 +18132,8 @@ <h3 id="odfdo.Document.parts" class="doc doc-heading">
 
 
 <h3 id="odfdo.Document.path" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">path</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">path</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -18203,28 +18142,26 @@ <h3 id="odfdo.Document.path" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to Document.Container.path.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.add_file" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">add_file</span><span class="p">(</span><span class="n">path_or_file</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">add_file</span><span class="p">(</span><span class="n">path_or_file</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert a file from a path or a file-like object in the container.</p>
 <p>Return the full path to reference in the content.</p>
 <p>Arguments:</p>
@@ -18232,9 +18169,9 @@ <h3 id="odfdo.Document.add_file" class="doc doc-heading">
 </code></pre>
 <p>Return: str (URI)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">547</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">547</span>
 <span class="normal">548</span>
 <span class="normal">549</span>
 <span class="normal">550</span>
@@ -18318,26 +18255,25 @@ <h3 id="odfdo.Document.add_file" class="doc doc-heading">
     <span class="n">manifest</span><span class="o">.</span><span class="n">add_full_path</span><span class="p">(</span><span class="n">full_path</span><span class="p">,</span> <span class="n">media_type</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">full_path</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.add_page_break_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">add_page_break_style</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">add_page_break_style</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Ensure that the document contains the style required for a manual page break.</p>
 
+
 <details class="then-a-manual-page-break-can-be-added-to-the-document-with" open>
   <summary>Then a manual page break can be added to the document with</summary>
   <p>from paragraph import PageBreak
@@ -18346,9 +18282,9 @@ <h3 id="odfdo.Document.add_page_break_style" class="doc doc-heading">
 </details>      <p>Note: this style uses the property &lsquo;fo:break-after&rsquo;, another
 possibility could be the property &lsquo;fo:break-before&rsquo;</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1099</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1099</span>
 <span class="normal">1100</span>
 <span class="normal">1101</span>
 <span class="normal">1102</span>
@@ -18396,30 +18332,28 @@ <h3 id="odfdo.Document.add_page_break_style" class="doc doc-heading">
     <span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">insert_style</span><span class="p">(</span><span class="n">style</span><span class="p">,</span> <span class="n">automatic</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.del_part" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">del_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">del_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Mark a part for deletion. The path is relative to the archive,
 e.g. &ldquo;Pictures/1003200258912EB1C3.jpg&rdquo;</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">320</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">320</span>
 <span class="normal">321</span>
 <span class="normal">322</span>
 <span class="normal">323</span>
@@ -18441,30 +18375,28 @@ <h3 id="odfdo.Document.del_part" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;part &#39;</span><span class="si">{</span><span class="n">path</span><span class="si">}</span><span class="s2">&#39; is mandatory&quot;</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">container</span><span class="o">.</span><span class="n">del_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.delete_styles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_styles</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">delete_styles</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove all style information from content and all styles.</p>
 <p>Return: number of deleted styles</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1012</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1012</span>
 <span class="normal">1013</span>
 <span class="normal">1014</span>
 <span class="normal">1015</span>
@@ -18524,31 +18456,29 @@ <h3 id="odfdo.Document.delete_styles" class="doc doc-heading">
         <span class="n">deleted</span> <span class="o">+=</span> <span class="mi">1</span>
     <span class="k">return</span> <span class="n">deleted</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_cell_background_color" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_cell_background_color</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">coord</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s1">&#39;#ffffff&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_cell_background_color</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">coord</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s1">&#39;#ffffff&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the background color of a table cell of a .ods document,
 from the cell style, or from the row or column.</p>
 <p>If color is not defined, return default value..</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1177</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1177</span>
 <span class="normal">1178</span>
 <span class="normal">1179</span>
 <span class="normal">1180</span>
@@ -18572,30 +18502,28 @@ <h3 id="odfdo.Document.get_cell_background_color" class="doc doc-heading">
     <span class="n">found</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_cell_style_properties</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">coord</span><span class="p">)</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;fo:background-color&quot;</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">found</span> <span class="ow">or</span> <span class="n">default</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_cell_style_properties" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_cell_style_properties</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">coord</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_cell_style_properties</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">coord</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the style properties of a table cell of a .ods document,
 from the cell style or from the row style.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1133</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1133</span>
 <span class="normal">1134</span>
 <span class="normal">1135</span>
 <span class="normal">1136</span>
@@ -18681,29 +18609,27 @@ <h3 id="odfdo.Document.get_cell_style_properties" class="doc doc-heading">
         <span class="k">pass</span>
     <span class="k">return</span> <span class="p">{}</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_formated_meta" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_formated_meta</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_formated_meta</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return meta informations as text, with some formatting.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">507</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">507</span>
 <span class="normal">508</span>
 <span class="normal">509</span>
 <span class="normal">510</span>
@@ -18781,29 +18707,27 @@ <h3 id="odfdo.Document.get_formated_meta" class="doc doc-heading">
 
     <span class="k">return</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_formatted_text" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_formatted_text</span><span class="p">(</span><span class="n">rst_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_formatted_text</span><span class="p">(</span><span class="n">rst_mode</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return content as text, with some formatting.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">457</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">457</span>
 <span class="normal">458</span>
 <span class="normal">459</span>
 <span class="normal">460</span>
@@ -18831,24 +18755,22 @@ <h3 id="odfdo.Document.get_formatted_text" class="doc doc-heading">
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_formatted_text</span><span class="p">(</span><span class="n">rst_mode</span><span class="p">)</span>
     <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Type of document &#39;</span><span class="si">{</span><span class="n">doc_type</span><span class="si">}</span><span class="s2">&#39; not supported yet&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_part" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_part</span><span class="p">(</span><span class="n">path</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the bytes of the given part. The path is relative to the
 archive, e.g. &ldquo;Pictures/1003200258912EB1C3.jpg&rdquo;.</p>
 <p>&lsquo;content&rsquo;, &lsquo;meta&rsquo;, &lsquo;settings&rsquo;, &lsquo;styles&rsquo; and &lsquo;manifest&rsquo; are shortcuts
@@ -18856,9 +18778,9 @@ <h3 id="odfdo.Document.get_part" class="doc doc-heading">
 its own API.</p>
 <p>path formated as URI, so always use &lsquo;/&rsquo; separator</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">277</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">277</span>
 <span class="normal">278</span>
 <span class="normal">279</span>
 <span class="normal">280</span>
@@ -18906,30 +18828,28 @@ <h3 id="odfdo.Document.get_part" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">__xmlparts</span><span class="p">[</span><span class="n">path</span><span class="p">]</span> <span class="o">=</span> <span class="n">part</span> <span class="o">=</span> <span class="bp">cls</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">container</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">part</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_parts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_parts</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_parts</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return available part names with path inside the archive, e.g.
 [&lsquo;content.xml&rsquo;, &hellip;, &lsquo;Pictures/100000000000032000000258912EB1C3.jpg&rsquo;]</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">262</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">262</span>
 <span class="normal">263</span>
 <span class="normal">264</span>
 <span class="normal">265</span>
@@ -18943,24 +18863,22 @@ <h3 id="odfdo.Document.get_parts" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Empty Container&quot;</span><span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">container</span><span class="o">.</span><span class="n">parts</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the style uniquely identified by the name/family pair. If
 the argument is already a style object, it will return it.</p>
 <p>If the name is None, the default style is fetched.</p>
@@ -18976,9 +18894,9 @@ <h3 id="odfdo.Document.get_style" class="doc doc-heading">
 </code></pre>
 <p>Return: Style or None if not found.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">674</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">674</span>
 <span class="normal">675</span>
 <span class="normal">676</span>
 <span class="normal">677</span>
@@ -19052,29 +18970,27 @@ <h3 id="odfdo.Document.get_style" class="doc doc-heading">
         <span class="n">display_name</span><span class="o">=</span><span class="n">display_name</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_style_properties" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_style_properties</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_style_properties</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the properties of the required style as a dict.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1124</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1124</span>
 <span class="normal">1125</span>
 <span class="normal">1126</span>
 <span class="normal">1127</span>
@@ -19090,24 +19006,22 @@ <h3 id="odfdo.Document.get_style_properties" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">style</span><span class="o">.</span><span class="n">get_properties</span><span class="p">(</span><span class="n">area</span><span class="o">=</span><span class="n">area</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_styled_elements" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_styled_elements</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_styled_elements</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Brute-force to find paragraphs, tables, etc. using the given style
 name (or all by default).</p>
 <p>Arguments:</p>
@@ -19115,9 +19029,9 @@ <h3 id="odfdo.Document.get_styled_elements" class="doc doc-heading">
 </code></pre>
 <p>Return: list</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">934</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">934</span>
 <span class="normal">935</span>
 <span class="normal">936</span>
 <span class="normal">937</span>
@@ -19145,35 +19059,34 @@ <h3 id="odfdo.Document.get_styled_elements" class="doc doc-heading">
         <span class="n">name</span>
     <span class="p">)</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">styles</span><span class="o">.</span><span class="n">root</span><span class="o">.</span><span class="n">get_styled_elements</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.get_type" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_type</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_type</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the ODF type (also called class) of this document.</p>
 
+
 <details class="return" open>
   <summary>&lsquo;chart&rsquo;, &lsquo;database&rsquo;, &lsquo;formula&rsquo;, &lsquo;graphics&rsquo;,</summary>
   <p>&lsquo;graphics-template&rsquo;, &lsquo;image&rsquo;, &lsquo;presentation&rsquo;,
 &lsquo;presentation-template&rsquo;, &lsquo;spreadsheet&rsquo;, &lsquo;spreadsheet-template&rsquo;,
 &lsquo;text&rsquo;, &lsquo;text-master&rsquo;, &lsquo;text-template&rsquo; or &lsquo;text-web&rsquo;</p>
 </details>
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">344</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">344</span>
 <span class="normal">345</span>
 <span class="normal">346</span>
 <span class="normal">347</span>
@@ -19199,24 +19112,22 @@ <h3 id="odfdo.Document.get_type" class="doc doc-heading">
     <span class="c1"># Isolate and return the last part</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">mimetype</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.insert_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_style</span><span class="p">(</span><span class="n">style</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">automatic</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_style</span><span class="p">(</span><span class="n">style</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">automatic</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert the given style object in the document, as required by the
 style family and type.</p>
 <p>The style is expected to be a common style with a name. In case it
@@ -19242,9 +19153,9 @@ <h3 id="odfdo.Document.insert_style" class="doc doc-heading">
 </code></pre>
 <p>Return : style name &ndash; str</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">844</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">844</span>
 <span class="normal">845</span>
 <span class="normal">846</span>
 <span class="normal">847</span>
@@ -19422,31 +19333,29 @@ <h3 id="odfdo.Document.insert_style" class="doc doc-heading">
     <span class="n">style_container</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">style_element</span><span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pseudo_style_attribute</span><span class="p">(</span><span class="n">style_element</span><span class="p">,</span> <span class="s2">&quot;name&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.merge_styles_from" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">merge_styles_from</span><span class="p">(</span><span class="n">document</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">merge_styles_from</span><span class="p">(</span><span class="n">document</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Copy all the styles of a document into ourself.</p>
 <p>Styles with the same type and name will be replaced, so only unique
 styles will be preserved.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1043</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1043</span>
 <span class="normal">1044</span>
 <span class="normal">1045</span>
 <span class="normal">1046</span>
@@ -19556,19 +19465,17 @@ <h3 id="odfdo.Document.merge_styles_from" class="doc doc-heading">
             <span class="n">media_type</span> <span class="o">=</span> <span class="n">document_manifest</span><span class="o">.</span><span class="n">get_media_type</span><span class="p">(</span><span class="n">url</span><span class="p">)</span>
             <span class="n">manifest</span><span class="o">.</span><span class="n">add_full_path</span><span class="p">(</span><span class="n">url</span><span class="p">,</span> <span class="n">media_type</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.new" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">new</span><span class="p">(</span><span class="n">template</span><span class="o">=</span><span class="s1">&#39;text&#39;</span><span class="p">)</span></code>
-  
+            <code class="highlight language-python"><span class="n">new</span><span class="p">(</span><span class="n">template</span><span class="o">=</span><span class="s1">&#39;text&#39;</span><span class="p">)</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small>
   </span>
@@ -19576,8 +19483,8 @@ <h3 id="odfdo.Document.new" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a Document from a template.</p>
 <p>The template argument is expected to be the path to a ODF template.</p>
 <p>Arguments:</p>
@@ -19585,9 +19492,9 @@ <h3 id="odfdo.Document.new" class="doc doc-heading">
 </code></pre>
 <p>Return : ODF document &ndash; Document</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">229</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">229</span>
 <span class="normal">230</span>
 <span class="normal">231</span>
 <span class="normal">232</span>
@@ -19615,24 +19522,22 @@ <h3 id="odfdo.Document.new" class="doc doc-heading">
     <span class="n">container</span> <span class="o">=</span> <span class="n">container_from_template</span><span class="p">(</span><span class="n">template</span><span class="p">)</span>
     <span class="k">return</span> <span class="bp">cls</span><span class="p">(</span><span class="n">container</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.save" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">save</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">packaging</span><span class="o">=</span><span class="n">ZIP</span><span class="p">,</span> <span class="n">pretty</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">backup</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">save</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">packaging</span><span class="o">=</span><span class="n">ZIP</span><span class="p">,</span> <span class="n">pretty</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">backup</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Save the document, at the same place it was opened or at the given
 target path. Target can also be a file-like object. It can be saved
 as a Zip file (default), flat XML format or as files in a folder
@@ -19647,9 +19552,9 @@ <h3 id="odfdo.Document.save" class="doc doc-heading">
 backup -- bool
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">611</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">611</span>
 <span class="normal">612</span>
 <span class="normal">613</span>
 <span class="normal">614</span>
@@ -19715,31 +19620,29 @@ <h3 id="odfdo.Document.save" class="doc doc-heading">
     <span class="c1"># Save the container</span>
     <span class="n">container</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">target</span><span class="p">,</span> <span class="n">packaging</span><span class="o">=</span><span class="n">packaging</span><span class="p">,</span> <span class="n">backup</span><span class="o">=</span><span class="n">backup</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Document.set_part" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_part</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_part</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the bytes of the given part. The path is relative to the
 archive, e.g. &ldquo;Pictures/1003200258912EB1C3.jpg&rdquo;.</p>
 <p>path formated as URI, so always use &lsquo;/&rsquo; separator</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/document.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">302</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/document.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">302</span>
 <span class="normal">303</span>
 <span class="normal">304</span>
 <span class="normal">305</span>
@@ -19773,8 +19676,8 @@ <h3 id="odfdo.Document.set_part" class="doc doc-heading">
             <span class="bp">self</span><span class="o">.</span><span class="n">__xmlparts</span><span class="p">[</span><span class="n">path</span><span class="p">]</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">container</span><span class="o">.</span><span class="n">set_part</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -19782,8 +19685,7 @@ <h3 id="odfdo.Document.set_part" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -19792,20 +19694,20 @@ <h3 id="odfdo.Document.set_part" class="doc doc-heading">
 
 
 <h2 id="odfdo.DrawFillImage" class="doc doc-heading">
-          <code>DrawFillImage</code>
+            <code>DrawFillImage</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.image.DrawImage" href="#odfdo.DrawImage">DrawImage</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.image.DrawImage" href="#odfdo.DrawImage">DrawImage</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/image.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 84</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/image.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 84</span>
 <span class="normal"> 85</span>
 <span class="normal"> 86</span>
 <span class="normal"> 87</span>
@@ -19881,12 +19783,11 @@ <h2 id="odfdo.DrawFillImage" class="doc doc-heading">
             <span class="bp">self</span><span class="o">.</span><span class="n">height</span> <span class="o">=</span> <span class="n">height</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">width</span> <span class="o">=</span> <span class="n">width</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -19899,15 +19800,14 @@ <h2 id="odfdo.DrawFillImage" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.DrawFillImage.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>The &ldquo;draw:fill-image&rdquo; element specifies a link to a bitmap
 resource. Fill image are not available as automatic styles.
 The &ldquo;draw:fill-image&rdquo; element is usable within the following element:
@@ -19922,9 +19822,9 @@ <h3 id="odfdo.DrawFillImage.__init__" class="doc doc-heading">
 width -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/image.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 93</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/image.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 93</span>
 <span class="normal"> 94</span>
 <span class="normal"> 95</span>
 <span class="normal"> 96</span>
@@ -19982,8 +19882,8 @@ <h3 id="odfdo.DrawFillImage.__init__" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">height</span> <span class="o">=</span> <span class="n">height</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">width</span> <span class="o">=</span> <span class="n">width</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -19991,8 +19891,7 @@ <h3 id="odfdo.DrawFillImage.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -20001,17 +19900,17 @@ <h3 id="odfdo.DrawFillImage.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.DrawGroup" class="doc doc-heading">
-          <code>DrawGroup</code>
+            <code>DrawGroup</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.frame.AnchorMix">AnchorMix</span></code>, <code><span title="odfdo.frame.ZMix">ZMix</span></code>, <code><span title="odfdo.frame.PosMix">PosMix</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.frame.AnchorMix">AnchorMix</span></code>, <code><span title="odfdo.frame.ZMix">ZMix</span></code>, <code><span title="odfdo.frame.PosMix">PosMix</span></code></p>
+
 
-  
       <p>The DrawGroup &ldquo;draw:g&rdquo; element represents a group of drawing shapes.</p>
 <p>Warning: implementation is currently minimal.</p>
 <p>Drawing shapes contained by a &ldquo;draw:g&rdquo; element that is itself
@@ -20034,9 +19933,9 @@ <h2 id="odfdo.DrawGroup" class="doc doc-heading">
 &ldquo;draw:rect&rdquo;, &ldquo;draw:regular-polygon&rdquo;, &ldquo;office:event-listeners&rdquo;,
 &ldquo;svg:desc&rdquo; and &ldquo;svg:title&rdquo;.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/shapes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">314</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/shapes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">314</span>
 <span class="normal">315</span>
 <span class="normal">316</span>
 <span class="normal">317</span>
@@ -20194,9 +20093,9 @@ <h2 id="odfdo.DrawGroup" class="doc doc-heading">
             <span class="k">if</span> <span class="n">presentation_style</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">presentation_style</span> <span class="o">=</span> <span class="n">presentation_style</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -20212,8 +20111,7 @@ <h2 id="odfdo.DrawGroup" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -20222,17 +20120,17 @@ <h2 id="odfdo.DrawGroup" class="doc doc-heading">
 
 
 <h2 id="odfdo.DrawImage" class="doc doc-heading">
-          <code>DrawImage</code>
+            <code>DrawImage</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The &ldquo;draw:image&rdquo; element represents an image. An image can be
 either:
 - A link to an external resource or
@@ -20240,9 +20138,9 @@ <h2 id="odfdo.DrawImage" class="doc doc-heading">
 <p>Warning: image elements must be stored in a frame &ldquo;draw:frame&rdquo;,
 see Frame().</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/image.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/image.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
 <span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
@@ -20340,12 +20238,11 @@ <h2 id="odfdo.DrawImage" class="doc doc-heading">
             <span class="bp">self</span><span class="o">.</span><span class="n">actuate</span> <span class="o">=</span> <span class="n">actuate</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">filter_name</span> <span class="o">=</span> <span class="n">filter_name</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -20358,15 +20255,14 @@ <h2 id="odfdo.DrawImage" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.DrawImage.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">xlink_type</span><span class="o">=</span><span class="s1">&#39;simple&#39;</span><span class="p">,</span> <span class="n">show</span><span class="o">=</span><span class="s1">&#39;embed&#39;</span><span class="p">,</span> <span class="n">actuate</span><span class="o">=</span><span class="s1">&#39;onLoad&#39;</span><span class="p">,</span> <span class="n">filter_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">xlink_type</span><span class="o">=</span><span class="s1">&#39;simple&#39;</span><span class="p">,</span> <span class="n">show</span><span class="o">=</span><span class="s1">&#39;embed&#39;</span><span class="p">,</span> <span class="n">actuate</span><span class="o">=</span><span class="s1">&#39;onLoad&#39;</span><span class="p">,</span> <span class="n">filter_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Initialisation of an DrawImage.</p>
 <p>Arguments:</p>
 <pre><code>url -- str
@@ -20380,9 +20276,9 @@ <h3 id="odfdo.DrawImage.__init__" class="doc doc-heading">
 filter_name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/image.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/image.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
 <span class="normal">50</span>
 <span class="normal">51</span>
 <span class="normal">52</span>
@@ -20442,8 +20338,8 @@ <h3 id="odfdo.DrawImage.__init__" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">actuate</span> <span class="o">=</span> <span class="n">actuate</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">filter_name</span> <span class="o">=</span> <span class="n">filter_name</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -20451,8 +20347,7 @@ <h3 id="odfdo.DrawImage.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -20461,22 +20356,22 @@ <h3 id="odfdo.DrawImage.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.DrawPage" class="doc doc-heading">
-          <code>DrawPage</code>
+            <code>DrawPage</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF draw page &ldquo;draw:page&rdquo;, for pages of presentation and drawings.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/draw_page.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 32</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/draw_page.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 32</span>
 <span class="normal"> 33</span>
 <span class="normal"> 34</span>
 <span class="normal"> 35</span>
@@ -20656,12 +20551,11 @@ <h2 id="odfdo.DrawPage" class="doc doc-heading">
         <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
         <span class="k">return</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -20674,15 +20568,14 @@ <h2 id="odfdo.DrawPage" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.DrawPage.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">master_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_page_layout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">master_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_page_layout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Arguments:</p>
 <pre><code>draw_id -- str
 
@@ -20695,9 +20588,9 @@ <h3 id="odfdo.DrawPage.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/draw_page.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">46</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/draw_page.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">46</span>
 <span class="normal">47</span>
 <span class="normal">48</span>
 <span class="normal">49</span>
@@ -20765,8 +20658,8 @@ <h3 id="odfdo.DrawPage.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -20774,8 +20667,7 @@ <h3 id="odfdo.DrawPage.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -20784,23 +20676,23 @@ <h3 id="odfdo.DrawPage.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Drawing" class="doc doc-heading">
-          <code>Drawing</code>
+            <code>Drawing</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Drawing, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">113</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">113</span>
 <span class="normal">114</span>
 <span class="normal">115</span>
 <span class="normal">116</span>
@@ -20816,12 +20708,11 @@ <h2 id="odfdo.Drawing" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -20832,10 +20723,10 @@ <h2 id="odfdo.Drawing" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -20844,24 +20735,24 @@ <h2 id="odfdo.Drawing" class="doc doc-heading">
 
 
 <h2 id="odfdo.EText" class="doc doc-heading">
-          <code>EText</code>
+            <code>EText</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code>str</code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code>str</code></p>
+
 
-  
       <p>Representation of an XML text node. Created to hide the specifics of
 lxml in searching text nodes using XPath.</p>
 <p>Constructed like any str object but only accepts lxml text objects.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/element.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">228</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/element.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">228</span>
 <span class="normal">229</span>
 <span class="normal">230</span>
 <span class="normal">231</span>
@@ -20919,12 +20810,11 @@ <h2 id="odfdo.EText" class="doc doc-heading">
     <span class="k">def</span> <span class="nf">is_tail</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__is_tail</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -20935,10 +20825,10 @@ <h2 id="odfdo.EText" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -20947,23 +20837,23 @@ <h2 id="odfdo.EText" class="doc doc-heading">
 
 
 <h2 id="odfdo.Element" class="doc doc-heading">
-          <code>Element</code>
+            <code>Element</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.utils.CachedElement">CachedElement</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.utils.CachedElement">CachedElement</span></code></p>
+
 
-  
       <p>Super class of all ODF classes.</p>
 <p>Representation of an XML element. Abstraction of the XML library behind.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/element.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 259</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/element.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 259</span>
 <span class="normal"> 260</span>
 <span class="normal"> 261</span>
 <span class="normal"> 262</span>
@@ -27239,9 +27129,9 @@ <h2 id="odfdo.Element" class="doc doc-heading">
             <span class="n">elements</span> <span class="o">=</span> <span class="n">filtered</span>
         <span class="k">return</span> <span class="n">elements</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -27256,8 +27146,8 @@ <h2 id="odfdo.Element" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.document_body" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">document_body</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">document_body</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27265,10 +27155,10 @@ <h3 id="odfdo.Element.document_body" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the first children of document body if any: &lsquo;office:body/*[1]&rsquo;</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27277,8 +27167,8 @@ <h3 id="odfdo.Element.document_body" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.frames" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">frames</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">frames</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27286,11 +27176,11 @@ <h3 id="odfdo.Element.frames" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the frames.</p>
 <p>Return: list of Frame</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27299,8 +27189,8 @@ <h3 id="odfdo.Element.frames" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.headers" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">headers</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">headers</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27308,11 +27198,11 @@ <h3 id="odfdo.Element.headers" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the Headers.</p>
 <p>Return: list of Header</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27321,8 +27211,8 @@ <h3 id="odfdo.Element.headers" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.images" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">images</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">images</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27330,11 +27220,11 @@ <h3 id="odfdo.Element.images" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the images.</p>
 <p>Return: list of Element</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27343,8 +27233,8 @@ <h3 id="odfdo.Element.images" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.lists" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">lists</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">lists</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27352,11 +27242,11 @@ <h3 id="odfdo.Element.lists" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the lists.</p>
 <p>Return: list of List</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27365,8 +27255,8 @@ <h3 id="odfdo.Element.lists" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.paragraphs" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">paragraphs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">paragraphs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27374,11 +27264,11 @@ <h3 id="odfdo.Element.paragraphs" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the paragraphs.</p>
 <p>Return: list of Paragraph</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27387,8 +27277,8 @@ <h3 id="odfdo.Element.paragraphs" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.sections" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">sections</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">sections</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27396,11 +27286,11 @@ <h3 id="odfdo.Element.sections" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the sections.</p>
 <p>Return: list of Element</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27409,8 +27299,8 @@ <h3 id="odfdo.Element.sections" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.spans" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">spans</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">spans</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27418,11 +27308,11 @@ <h3 id="odfdo.Element.spans" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the spans.</p>
 <p>Return: list of Span</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27431,8 +27321,8 @@ <h3 id="odfdo.Element.spans" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.tag" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">tag</span><span class="p">:</span> <span class="nb">str</span></code>
-  
+            <code class="highlight language-python"><span class="n">tag</span><span class="p">:</span> <span class="nb">str</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -27441,14 +27331,14 @@ <h3 id="odfdo.Element.tag" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get/set the underlying xml tag with the given qualified name.</p>
 <p>Warning: direct change of tag does not change the element class.</p>
 <p>Arguments:</p>
 <pre><code>qname -- str (e.g. "text:span")
 </code></pre>
-  </div>
+    </div>
 
 </div>
 
@@ -27457,8 +27347,8 @@ <h3 id="odfdo.Element.tag" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.tail" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">tail</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">tail</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -27467,10 +27357,10 @@ <h3 id="odfdo.Element.tail" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the text immediately following the element.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27479,8 +27369,8 @@ <h3 id="odfdo.Element.tail" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.text" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">text</span><span class="p">:</span> <span class="nb">str</span></code>
-  
+            <code class="highlight language-python"><span class="n">text</span><span class="p">:</span> <span class="nb">str</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -27489,10 +27379,10 @@ <h3 id="odfdo.Element.text" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the text content of the element.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27501,8 +27391,8 @@ <h3 id="odfdo.Element.text" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.text_changes" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">text_changes</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">text_changes</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27510,12 +27400,12 @@ <h3 id="odfdo.Element.text_changes" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the text changes, either single deletion
 (text:change) or start of range of changes (text:change-start).</p>
 <p>Return: list of Element</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27524,8 +27414,8 @@ <h3 id="odfdo.Element.text_changes" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.text_content" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">text_content</span><span class="p">:</span> <span class="nb">str</span></code>
-  
+            <code class="highlight language-python"><span class="n">text_content</span><span class="p">:</span> <span class="nb">str</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -27534,12 +27424,12 @@ <h3 id="odfdo.Element.text_content" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the text of the embedded paragraph, including embeded
 annotations, cells&hellip;</p>
 <p>Set create a paragraph if missing</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27548,8 +27438,8 @@ <h3 id="odfdo.Element.text_content" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.toc" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">toc</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">toc</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27557,11 +27447,11 @@ <h3 id="odfdo.Element.toc" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the first table of contents.</p>
 <p>Return: odf_toc or None if not found</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27570,8 +27460,8 @@ <h3 id="odfdo.Element.toc" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.tocs" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">tocs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">tocs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27579,11 +27469,11 @@ <h3 id="odfdo.Element.tocs" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the tables of contents.</p>
 <p>Return: list of odf_toc</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27592,8 +27482,8 @@ <h3 id="odfdo.Element.tocs" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.tracked_changes" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">tracked_changes</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">tracked_changes</span><span class="p">:</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27601,11 +27491,11 @@ <h3 id="odfdo.Element.tracked_changes" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the tracked-changes part in the text body.</p>
 <p>Return: Element or None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -27614,8 +27504,8 @@ <h3 id="odfdo.Element.tracked_changes" class="doc doc-heading">
 
 
 <h3 id="odfdo.Element.user_defined_list" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">user_defined_list</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">user_defined_list</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Element</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -27623,34 +27513,32 @@ <h3 id="odfdo.Element.user_defined_list" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the user defined field declarations.</p>
 <p>Return: list of Element</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.append" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append</span><span class="p">(</span><span class="n">str_or_element</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append</span><span class="p">(</span><span class="n">str_or_element</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert element or text in the last position.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1344</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1344</span>
 <span class="normal">1345</span>
 <span class="normal">1346</span>
 <span class="normal">1347</span>
@@ -27696,33 +27584,31 @@ <h3 id="odfdo.Element.append" class="doc doc-heading">
     <span class="k">else</span><span class="p">:</span>
         <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Element or string expected, not &quot;</span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">str_or_element</span><span class="p">)</span><span class="si">}</span><span class="s1">&quot;&#39;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.append_named_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append_named_range</span><span class="p">(</span><span class="n">named_range</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append_named_range</span><span class="p">(</span><span class="n">named_range</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Append the named range to the spreadsheet, replacing existing named
 range of same name if any.</p>
 <p>Arguments:</p>
 <pre><code>named_range --  NamedRange
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2088</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2088</span>
 <span class="normal">2089</span>
 <span class="normal">2090</span>
 <span class="normal">2091</span>
@@ -27764,29 +27650,27 @@ <h3 id="odfdo.Element.append_named_range" class="doc doc-heading">
         <span class="n">named_expressions</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">current</span><span class="p">)</span>
     <span class="n">named_expressions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">named_range</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.clear" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">clear</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">clear</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove text, children and attributes from the element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1554</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1554</span>
 <span class="normal">1555</span>
 <span class="normal">1556</span>
 <span class="normal">1557</span>
@@ -27822,24 +27706,22 @@ <h3 id="odfdo.Element.clear" class="doc doc-heading">
         <span class="k">if</span> <span class="n">remember</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">_indexes</span><span class="p">[</span><span class="s2">&quot;_rmap&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.delete" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the given element from the XML tree. If no element is given,
 &ldquo;self&rdquo; is deleted. The XML library may allow to continue to use an
 element now &ldquo;orphan&rdquo; as long as you have a reference to it.</p>
@@ -27850,9 +27732,9 @@ <h3 id="odfdo.Element.delete" class="doc doc-heading">
 keep_tail -- boolean (default to True), True for most usages.
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1368</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1368</span>
 <span class="normal">1369</span>
 <span class="normal">1370</span>
 <span class="normal">1371</span>
@@ -27924,32 +27806,30 @@ <h3 id="odfdo.Element.delete" class="doc doc-heading">
                 <span class="n">parent</span><span class="o">.</span><span class="n">__element</span><span class="o">.</span><span class="n">text</span> <span class="o">+=</span> <span class="n">tail</span>
     <span class="n">parent</span><span class="o">.</span><span class="n">__element</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">child</span><span class="o">.</span><span class="n">__element</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.delete_named_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the Named Range of specified name from the spreadsheet.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2110</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2110</span>
 <span class="normal">2111</span>
 <span class="normal">2112</span>
 <span class="normal">2113</span>
@@ -27989,29 +27869,27 @@ <h3 id="odfdo.Element.delete_named_range" class="doc doc-heading">
     <span class="k">if</span> <span class="ow">not</span> <span class="n">children</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">named_expressions</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.elements_repeated_sequence" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">elements_repeated_sequence</span><span class="p">(</span><span class="n">xpath_instance</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">elements_repeated_sequence</span><span class="p">(</span><span class="n">xpath_instance</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Utility method for table module.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">722</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">722</span>
 <span class="normal">723</span>
 <span class="normal">724</span>
 <span class="normal">725</span>
@@ -28065,29 +27943,27 @@ <h3 id="odfdo.Element.elements_repeated_sequence" class="doc doc-heading">
         <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">idx</span><span class="p">,</span> <span class="nb">max</span><span class="p">(</span><span class="n">int_value</span><span class="p">,</span> <span class="mi">1</span><span class="p">)))</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.extend" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">extend</span><span class="p">(</span><span class="n">odf_elements</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">extend</span><span class="p">(</span><span class="n">odf_elements</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Fast append elements at the end of ourself using extend.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1337</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1337</span>
 <span class="normal">1338</span>
 <span class="normal">1339</span>
 <span class="normal">1340</span>
@@ -28099,19 +27975,17 @@ <h3 id="odfdo.Element.extend" class="doc doc-heading">
         <span class="n">elements</span> <span class="o">=</span> <span class="p">[</span><span class="n">element</span><span class="o">.</span><span class="n">__element</span> <span class="k">for</span> <span class="n">element</span> <span class="ow">in</span> <span class="n">odf_elements</span><span class="p">]</span>
         <span class="n">current</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">elements</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.from_tag" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">from_tag</span><span class="p">(</span><span class="n">tag_or_elem</span><span class="p">)</span></code>
-  
+            <code class="highlight language-python"><span class="n">from_tag</span><span class="p">(</span><span class="n">tag_or_elem</span><span class="p">)</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small>
   </span>
@@ -28119,8 +27993,8 @@ <h3 id="odfdo.Element.from_tag" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Element class and subclass factory.</p>
 <p>Turn an lxml Element or ODF string tag into an ODF XML Element
 of the relevant class.</p>
@@ -28129,9 +28003,9 @@ <h3 id="odfdo.Element.from_tag" class="doc doc-heading">
 </code></pre>
 <p>Return: Element (or subclass) instance</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">292</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">292</span>
 <span class="normal">293</span>
 <span class="normal">294</span>
 <span class="normal">295</span>
@@ -28171,24 +28045,22 @@ <h3 id="odfdo.Element.from_tag" class="doc doc-heading">
     <span class="n">klass</span> <span class="o">=</span> <span class="n">_class_registry</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">elem</span><span class="o">.</span><span class="n">tag</span><span class="p">,</span> <span class="bp">cls</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">klass</span><span class="p">(</span><span class="n">tag_or_elem</span><span class="o">=</span><span class="n">elem</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_annotation" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_annotation</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_annotation</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the annotation that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -28205,9 +28077,9 @@ <h3 id="odfdo.Element.get_annotation" class="doc doc-heading">
 </code></pre>
 <p>Return: Annotation or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2220</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2220</span>
 <span class="normal">2221</span>
 <span class="normal">2222</span>
 <span class="normal">2223</span>
@@ -28287,24 +28159,22 @@ <h3 id="odfdo.Element.get_annotation" class="doc doc-heading">
     <span class="k">except</span> <span class="ne">IndexError</span><span class="p">:</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_annotation_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_annotation_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_annotation_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the annotation end that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -28313,9 +28183,9 @@ <h3 id="odfdo.Element.get_annotation_end" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2268</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2268</span>
 <span class="normal">2269</span>
 <span class="normal">2270</span>
 <span class="normal">2271</span>
@@ -28351,30 +28221,28 @@ <h3 id="odfdo.Element.get_annotation_end" class="doc doc-heading">
         <span class="s2">&quot;descendant::office:annotation-end&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">office_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_annotation_ends" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_annotation_ends</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_annotation_ends</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the annotation ends.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2261</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2261</span>
 <span class="normal">2262</span>
 <span class="normal">2263</span>
 <span class="normal">2264</span>
@@ -28386,24 +28254,22 @@ <h3 id="odfdo.Element.get_annotation_ends" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::office:annotation-end&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_annotations" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_annotations</span><span class="p">(</span><span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_annotations</span><span class="p">(</span><span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the annotations that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>creator -- str
@@ -28416,9 +28282,9 @@ <h3 id="odfdo.Element.get_annotations" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Annotation</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2183</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2183</span>
 <span class="normal">2184</span>
 <span class="normal">2185</span>
 <span class="normal">2186</span>
@@ -28490,29 +28356,27 @@ <h3 id="odfdo.Element.get_annotations" class="doc doc-heading">
         <span class="n">annotations</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">annotation</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">annotations</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_attribute" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_attribute</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_attribute</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the attribute value as type str | bool | None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">802</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">802</span>
 <span class="normal">803</span>
 <span class="normal">804</span>
 <span class="normal">805</span>
@@ -28532,29 +28396,27 @@ <h3 id="odfdo.Element.get_attribute" class="doc doc-heading">
         <span class="k">return</span> <span class="n">Boolean</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
     <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_attribute_integer" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_attribute_integer</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_attribute_integer</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return either the attribute as type int, or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">813</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">813</span>
 <span class="normal">814</span>
 <span class="normal">815</span>
 <span class="normal">816</span>
@@ -28576,29 +28438,27 @@ <h3 id="odfdo.Element.get_attribute_integer" class="doc doc-heading">
     <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_attribute_string" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_attribute_string</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_attribute_string</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return either the attribute as type str, or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">825</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">825</span>
 <span class="normal">826</span>
 <span class="normal">827</span>
 <span class="normal">828</span>
@@ -28614,24 +28474,22 @@ <h3 id="odfdo.Element.get_attribute_string" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_between" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_between</span><span class="p">(</span><span class="n">tag1</span><span class="p">,</span> <span class="n">tag2</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_between</span><span class="p">(</span><span class="n">tag1</span><span class="p">,</span> <span class="n">tag2</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Returns elements between tag1 and tag2, tag1 and tag2 shall
 be unique and having an id attribute.
 (WARN: buggy if tag1/tag2 defines a malformed odf xml.)
@@ -28659,9 +28517,9 @@ <h3 id="odfdo.Element.get_between" class="doc doc-heading">
 </code></pre>
 <p>Return: list of odf_paragraph or odf_header</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1205</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1205</span>
 <span class="normal">1206</span>
 <span class="normal">1207</span>
 <span class="normal">1208</span>
@@ -28811,24 +28669,22 @@ <h3 id="odfdo.Element.get_between" class="doc doc-heading">
     <span class="k">else</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">inner</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_bookmark" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_bookmark</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_bookmark</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the bookmark that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -28837,9 +28693,9 @@ <h3 id="odfdo.Element.get_bookmark" class="doc doc-heading">
 </code></pre>
 <p>Return: Bookmark or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2602</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2602</span>
 <span class="normal">2603</span>
 <span class="normal">2604</span>
 <span class="normal">2605</span>
@@ -28875,24 +28731,22 @@ <h3 id="odfdo.Element.get_bookmark" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:bookmark&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_bookmark_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_bookmark_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_bookmark_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the bookmark end that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -28901,9 +28755,9 @@ <h3 id="odfdo.Element.get_bookmark_end" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2654</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2654</span>
 <span class="normal">2655</span>
 <span class="normal">2656</span>
 <span class="normal">2657</span>
@@ -28939,30 +28793,28 @@ <h3 id="odfdo.Element.get_bookmark_end" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:bookmark-end&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_bookmark_ends" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_bookmark_ends</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_bookmark_ends</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the bookmark ends.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2647</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2647</span>
 <span class="normal">2648</span>
 <span class="normal">2649</span>
 <span class="normal">2650</span>
@@ -28974,24 +28826,22 @@ <h3 id="odfdo.Element.get_bookmark_ends" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:bookmark-end&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_bookmark_start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_bookmark_start</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_bookmark_start</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the bookmark start that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29000,9 +28850,9 @@ <h3 id="odfdo.Element.get_bookmark_start" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2628</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2628</span>
 <span class="normal">2629</span>
 <span class="normal">2630</span>
 <span class="normal">2631</span>
@@ -29038,30 +28888,28 @@ <h3 id="odfdo.Element.get_bookmark_start" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:bookmark-start&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_bookmark_starts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_bookmark_starts</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_bookmark_starts</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the bookmark starts.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2621</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2621</span>
 <span class="normal">2622</span>
 <span class="normal">2623</span>
 <span class="normal">2624</span>
@@ -29073,30 +28921,28 @@ <h3 id="odfdo.Element.get_bookmark_starts" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:bookmark-start&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_bookmarks" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_bookmarks</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_bookmarks</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the bookmarks.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2595</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2595</span>
 <span class="normal">2596</span>
 <span class="normal">2597</span>
 <span class="normal">2598</span>
@@ -29108,30 +28954,28 @@ <h3 id="odfdo.Element.get_bookmarks" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:bookmark&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_changes_ids" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_changes_ids</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_changes_ids</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return a list of ids that refers to a change region in the tracked
 changes list.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3080</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3080</span>
 <span class="normal">3081</span>
 <span class="normal">3082</span>
 <span class="normal">3083</span>
@@ -29149,24 +28993,22 @@ <h3 id="odfdo.Element.get_changes_ids" class="doc doc-heading">
     <span class="n">xpath_query</span> <span class="o">+=</span> <span class="s2">&quot; | descendant::text:change/@text:change-id&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_connector" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_connector</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_connector</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the draw connector that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29177,9 +29019,9 @@ <h3 id="odfdo.Element.get_draw_connector" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_shape or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3029</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3029</span>
 <span class="normal">3030</span>
 <span class="normal">3031</span>
 <span class="normal">3032</span>
@@ -29221,24 +29063,22 @@ <h3 id="odfdo.Element.get_draw_connector" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:connector&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="nb">id</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_connectors" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_connectors</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_connectors</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the draw connectors that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>draw_style -- str
@@ -29249,9 +29089,9 @@ <h3 id="odfdo.Element.get_draw_connectors" class="doc doc-heading">
 </code></pre>
 <p>Return: list of odf_shape</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3004</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3004</span>
 <span class="normal">3005</span>
 <span class="normal">3006</span>
 <span class="normal">3007</span>
@@ -29299,24 +29139,22 @@ <h3 id="odfdo.Element.get_draw_connectors" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_ellipse" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_ellipse</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_ellipse</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the draw ellipse that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29327,9 +29165,9 @@ <h3 id="odfdo.Element.get_draw_ellipse" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_shape or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2980</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2980</span>
 <span class="normal">2981</span>
 <span class="normal">2982</span>
 <span class="normal">2983</span>
@@ -29371,24 +29209,22 @@ <h3 id="odfdo.Element.get_draw_ellipse" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:ellipse&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="nb">id</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_ellipses" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_ellipses</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_ellipses</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the draw ellipses that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>draw_style -- str
@@ -29399,9 +29235,9 @@ <h3 id="odfdo.Element.get_draw_ellipses" class="doc doc-heading">
 </code></pre>
 <p>Return: list of odf_shape</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2955</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2955</span>
 <span class="normal">2956</span>
 <span class="normal">2957</span>
 <span class="normal">2958</span>
@@ -29449,24 +29285,22 @@ <h3 id="odfdo.Element.get_draw_ellipses" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_line" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_line</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_line</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the draw line that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29477,9 +29311,9 @@ <h3 id="odfdo.Element.get_draw_line" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_shape or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2882</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2882</span>
 <span class="normal">2883</span>
 <span class="normal">2884</span>
 <span class="normal">2885</span>
@@ -29521,24 +29355,22 @@ <h3 id="odfdo.Element.get_draw_line" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:line&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="nb">id</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_lines" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_lines</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_lines</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the draw lines that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>draw_style -- str
@@ -29549,9 +29381,9 @@ <h3 id="odfdo.Element.get_draw_lines" class="doc doc-heading">
 </code></pre>
 <p>Return: list of odf_shape</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2857</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2857</span>
 <span class="normal">2858</span>
 <span class="normal">2859</span>
 <span class="normal">2860</span>
@@ -29599,24 +29431,22 @@ <h3 id="odfdo.Element.get_draw_lines" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_page" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_page</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_page</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the draw page that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29627,9 +29457,9 @@ <h3 id="odfdo.Element.get_draw_page" class="doc doc-heading">
 </code></pre>
 <p>Return: DrawPage or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2507</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2507</span>
 <span class="normal">2508</span>
 <span class="normal">2509</span>
 <span class="normal">2510</span>
@@ -29671,24 +29501,22 @@ <h3 id="odfdo.Element.get_draw_page" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:page&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">draw_name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_pages" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_pages</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_pages</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the draw pages that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -29697,9 +29525,9 @@ <h3 id="odfdo.Element.get_draw_pages" class="doc doc-heading">
 </code></pre>
 <p>Return: list of DrawPage</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2488</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2488</span>
 <span class="normal">2489</span>
 <span class="normal">2490</span>
 <span class="normal">2491</span>
@@ -29735,24 +29563,22 @@ <h3 id="odfdo.Element.get_draw_pages" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:page&quot;</span><span class="p">,</span> <span class="n">draw_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_rectangle" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_rectangle</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_rectangle</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nb">id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the draw rectangle that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29763,9 +29589,9 @@ <h3 id="odfdo.Element.get_draw_rectangle" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_shape or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2931</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2931</span>
 <span class="normal">2932</span>
 <span class="normal">2933</span>
 <span class="normal">2934</span>
@@ -29807,24 +29633,22 @@ <h3 id="odfdo.Element.get_draw_rectangle" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:rect&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="nb">id</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_draw_rectangles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_draw_rectangles</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_draw_rectangles</span><span class="p">(</span><span class="n">draw_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the draw rectangles that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>draw_style -- str
@@ -29835,9 +29659,9 @@ <h3 id="odfdo.Element.get_draw_rectangles" class="doc doc-heading">
 </code></pre>
 <p>Return: list of odf_shape</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2906</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2906</span>
 <span class="normal">2907</span>
 <span class="normal">2908</span>
 <span class="normal">2909</span>
@@ -29885,52 +29709,48 @@ <h3 id="odfdo.Element.get_draw_rectangles" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_formatted_text" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_formatted_text</span><span class="p">(</span><span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_formatted_text</span><span class="p">(</span><span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>This function should return a beautiful version of the text.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1607</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1607</span>
 <span class="normal">1608</span>
 <span class="normal">1609</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_formatted_text</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">context</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;This function should return a beautiful version of the text.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="s2">&quot;&quot;</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_frame" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_frame</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_frame</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the section that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -29947,9 +29767,9 @@ <h3 id="odfdo.Element.get_frame" class="doc doc-heading">
 </code></pre>
 <p>Return: Frame or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1956</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1956</span>
 <span class="normal">1957</span>
 <span class="normal">1958</span>
 <span class="normal">1959</span>
@@ -30021,24 +29841,22 @@ <h3 id="odfdo.Element.get_frame" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_frames" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_frames</span><span class="p">(</span><span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_frames</span><span class="p">(</span><span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the frames that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>presentation_class -- str
@@ -30053,9 +29871,9 @@ <h3 id="odfdo.Element.get_frames" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Frame</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1915</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1915</span>
 <span class="normal">1916</span>
 <span class="normal">1917</span>
 <span class="normal">1918</span>
@@ -30119,24 +29937,22 @@ <h3 id="odfdo.Element.get_frames" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_header" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_header</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">outline_level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_header</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">outline_level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the Header that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -30145,9 +29961,9 @@ <h3 id="odfdo.Element.get_header" class="doc doc-heading">
 </code></pre>
 <p>Return: Header or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1842</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1842</span>
 <span class="normal">1843</span>
 <span class="normal">1844</span>
 <span class="normal">1845</span>
@@ -30191,24 +30007,22 @@ <h3 id="odfdo.Element.get_header" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_headers" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_headers</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">outline_level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_headers</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">outline_level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the Headers that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -30217,9 +30031,9 @@ <h3 id="odfdo.Element.get_headers" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Header</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1811</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1811</span>
 <span class="normal">1812</span>
 <span class="normal">1813</span>
 <span class="normal">1814</span>
@@ -30263,24 +30077,22 @@ <h3 id="odfdo.Element.get_headers" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_image" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_image</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_image</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the image matching the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -30293,9 +30105,9 @@ <h3 id="odfdo.Element.get_image" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2025</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2025</span>
 <span class="normal">2026</span>
 <span class="normal">2027</span>
 <span class="normal">2028</span>
@@ -30361,24 +30173,22 @@ <h3 id="odfdo.Element.get_image" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:image&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="n">url</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_images" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_images</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_images</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the images matching the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -30389,9 +30199,9 @@ <h3 id="odfdo.Element.get_images" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1995</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1995</span>
 <span class="normal">1996</span>
 <span class="normal">1997</span>
 <span class="normal">1998</span>
@@ -30433,24 +30243,22 @@ <h3 id="odfdo.Element.get_images" class="doc doc-heading">
         <span class="s2">&quot;descendant::draw:image&quot;</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="n">url</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_link" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_link</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_link</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the link that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -30465,9 +30273,9 @@ <h3 id="odfdo.Element.get_link" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2560</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2560</span>
 <span class="normal">2561</span>
 <span class="normal">2562</span>
 <span class="normal">2563</span>
@@ -30531,24 +30339,22 @@ <h3 id="odfdo.Element.get_link" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_links" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_links</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_links</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the links that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
@@ -30561,9 +30367,9 @@ <h3 id="odfdo.Element.get_links" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2531</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2531</span>
 <span class="normal">2532</span>
 <span class="normal">2533</span>
 <span class="normal">2534</span>
@@ -30619,24 +30425,22 @@ <h3 id="odfdo.Element.get_links" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_list" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_list</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_list</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the list that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -30645,9 +30449,9 @@ <h3 id="odfdo.Element.get_list" class="doc doc-heading">
 </code></pre>
 <p>Return: List or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1894</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1894</span>
 <span class="normal">1895</span>
 <span class="normal">1896</span>
 <span class="normal">1897</span>
@@ -30683,24 +30487,22 @@ <h3 id="odfdo.Element.get_list" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:list&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_lists" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_lists</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_lists</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the lists that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -30709,9 +30511,9 @@ <h3 id="odfdo.Element.get_lists" class="doc doc-heading">
 </code></pre>
 <p>Return: list of List</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1867</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1867</span>
 <span class="normal">1868</span>
 <span class="normal">1869</span>
 <span class="normal">1870</span>
@@ -30747,33 +30549,31 @@ <h3 id="odfdo.Element.get_lists" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:list&quot;</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_named_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the named range of specified name, or None if not found.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 <p>Return: NamedRange</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2071</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2071</span>
 <span class="normal">2072</span>
 <span class="normal">2073</span>
 <span class="normal">2074</span>
@@ -30805,30 +30605,28 @@ <h3 id="odfdo.Element.get_named_range" class="doc doc-heading">
     <span class="k">else</span><span class="p">:</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_named_ranges" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_named_ranges</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_named_ranges</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the tables named ranges.</p>
 <p>Return: list of odf_named_range</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2061</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2061</span>
 <span class="normal">2062</span>
 <span class="normal">2063</span>
 <span class="normal">2064</span>
@@ -30846,24 +30644,22 @@ <h3 id="odfdo.Element.get_named_ranges" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="n">named_ranges</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_note" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_note</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">note_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">note_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_note</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">note_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">note_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the note that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -30876,9 +30672,9 @@ <h3 id="odfdo.Element.get_note" class="doc doc-heading">
 </code></pre>
 <p>Return: Note or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2152</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2152</span>
 <span class="normal">2153</span>
 <span class="normal">2154</span>
 <span class="normal">2155</span>
@@ -30934,24 +30730,22 @@ <h3 id="odfdo.Element.get_note" class="doc doc-heading">
         <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_notes" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_notes</span><span class="p">(</span><span class="n">note_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_notes</span><span class="p">(</span><span class="n">note_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the notes that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>note_class -- 'footnote' or 'endnote'
@@ -30960,9 +30754,9 @@ <h3 id="odfdo.Element.get_notes" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Note</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2133</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2133</span>
 <span class="normal">2134</span>
 <span class="normal">2135</span>
 <span class="normal">2136</span>
@@ -30998,30 +30792,28 @@ <h3 id="odfdo.Element.get_notes" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:note&quot;</span><span class="p">,</span> <span class="n">note_class</span><span class="o">=</span><span class="n">note_class</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_office_names" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_office_names</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_office_names</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the used office:name tags values of the element.</p>
 <p>Return: list of unique str</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2289</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2289</span>
 <span class="normal">2290</span>
 <span class="normal">2291</span>
 <span class="normal">2292</span>
@@ -31041,30 +30833,28 @@ <h3 id="odfdo.Element.get_office_names" class="doc doc-heading">
         <span class="k">return</span> <span class="p">[]</span>
     <span class="k">return</span> <span class="nb">list</span><span class="p">({</span><span class="nb">str</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">response</span> <span class="k">if</span> <span class="n">name</span><span class="p">})</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_orphan_draw_connectors" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_orphan_draw_connectors</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_orphan_draw_connectors</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return a list of connectors which don&rsquo;t have any shape connected
 to them.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3051</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3051</span>
 <span class="normal">3052</span>
 <span class="normal">3053</span>
 <span class="normal">3054</span>
@@ -31086,24 +30876,22 @@ <h3 id="odfdo.Element.get_orphan_draw_connectors" class="doc doc-heading">
             <span class="n">connectors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">connector</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">connectors</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_paragraph" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_paragraph</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_paragraph</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the paragraph that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -31112,9 +30900,9 @@ <h3 id="odfdo.Element.get_paragraph" class="doc doc-heading">
 </code></pre>
 <p>Return: Paragraph or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1744</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1744</span>
 <span class="normal">1745</span>
 <span class="normal">1746</span>
 <span class="normal">1747</span>
@@ -31146,24 +30934,22 @@ <h3 id="odfdo.Element.get_paragraph" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_element</span><span class="p">(</span><span class="s2">&quot;descendant::text:p&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_paragraphs" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_paragraphs</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_paragraphs</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the paragraphs that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -31172,9 +30958,9 @@ <h3 id="odfdo.Element.get_paragraphs" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Paragraph</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1717</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1717</span>
 <span class="normal">1718</span>
 <span class="normal">1719</span>
 <span class="normal">1720</span>
@@ -31210,24 +30996,22 @@ <h3 id="odfdo.Element.get_paragraphs" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:p&quot;</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_mark" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_mark</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_mark</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the reference mark that match the criteria. Either single
 position reference mark (text:reference-mark) or start of range
 reference (text:reference-mark-start).</p>
@@ -31238,9 +31022,9 @@ <h3 id="odfdo.Element.get_reference_mark" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2776</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2776</span>
 <span class="normal">2777</span>
 <span class="normal">2778</span>
 <span class="normal">2779</span>
@@ -31298,24 +31082,22 @@ <h3 id="odfdo.Element.get_reference_mark" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_element</span><span class="p">(</span><span class="n">request</span><span class="p">,</span> <span class="n">position</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_mark_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_mark_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_mark_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the reference mark end that matches the criteria. Search only
 the tags text:reference-mark-end.
 Consider using : get_reference_marks()</p>
@@ -31326,9 +31108,9 @@ <h3 id="odfdo.Element.get_reference_mark_end" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2744</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2744</span>
 <span class="normal">2745</span>
 <span class="normal">2746</span>
 <span class="normal">2747</span>
@@ -31368,32 +31150,30 @@ <h3 id="odfdo.Element.get_reference_mark_end" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:reference-mark-end&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_mark_ends" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_mark_ends</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_mark_ends</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the reference mark ends. Search only the tags
 text:reference-mark-end.
 Consider using : get_reference_marks()</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2735</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2735</span>
 <span class="normal">2736</span>
 <span class="normal">2737</span>
 <span class="normal">2738</span>
@@ -31409,24 +31189,22 @@ <h3 id="odfdo.Element.get_reference_mark_ends" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:reference-mark-end&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_mark_single" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_mark_single</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_mark_single</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the reference mark that matches the criteria. Search only the
 tags text:reference-mark.
 Consider using : get_reference_mark()</p>
@@ -31437,9 +31215,9 @@ <h3 id="odfdo.Element.get_reference_mark_single" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2684</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2684</span>
 <span class="normal">2685</span>
 <span class="normal">2686</span>
 <span class="normal">2687</span>
@@ -31479,24 +31257,22 @@ <h3 id="odfdo.Element.get_reference_mark_single" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:reference-mark&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_mark_start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_mark_start</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_mark_start</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the reference mark start that matches the criteria. Search
 only the tags text:reference-mark-start.
 Consider using : get_reference_mark()</p>
@@ -31507,9 +31283,9 @@ <h3 id="odfdo.Element.get_reference_mark_start" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2714</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2714</span>
 <span class="normal">2715</span>
 <span class="normal">2716</span>
 <span class="normal">2717</span>
@@ -31549,32 +31325,30 @@ <h3 id="odfdo.Element.get_reference_mark_start" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:reference-mark-start&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_mark_starts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_mark_starts</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_mark_starts</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the reference mark starts. Search only the tags
 text:reference-mark-start.
 Consider using : get_reference_marks()</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2705</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2705</span>
 <span class="normal">2706</span>
 <span class="normal">2707</span>
 <span class="normal">2708</span>
@@ -31590,32 +31364,30 @@ <h3 id="odfdo.Element.get_reference_mark_starts" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:reference-mark-start&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_marks" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_marks</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_marks</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the reference marks, either single position reference
 (text:reference-mark) or start of range reference
 (text:reference-mark-start).</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2765</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2765</span>
 <span class="normal">2766</span>
 <span class="normal">2767</span>
 <span class="normal">2768</span>
@@ -31635,32 +31407,30 @@ <h3 id="odfdo.Element.get_reference_marks" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:reference-mark-start | descendant::text:reference-mark&quot;</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_reference_marks_single" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_reference_marks_single</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_reference_marks_single</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the reference marks. Search only the tags
 text:reference-mark.
 Consider using : get_reference_marks()</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2675</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2675</span>
 <span class="normal">2676</span>
 <span class="normal">2677</span>
 <span class="normal">2678</span>
@@ -31676,24 +31446,22 @@ <h3 id="odfdo.Element.get_reference_marks_single" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:reference-mark&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_references" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_references</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_references</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the references (text:reference-ref). If name is
 provided, returns the references of that name.</p>
 <p>Return: list of Element</p>
@@ -31701,9 +31469,9 @@ <h3 id="odfdo.Element.get_references" class="doc doc-heading">
 <pre><code>name -- str or None
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2806</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2806</span>
 <span class="normal">2807</span>
 <span class="normal">2808</span>
 <span class="normal">2809</span>
@@ -31731,24 +31499,22 @@ <h3 id="odfdo.Element.get_references" class="doc doc-heading">
     <span class="n">request</span> <span class="o">=</span> <span class="sa">f</span><span class="s1">&#39;descendant::text:reference-ref[@text:ref-name=&quot;</span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1">&quot;]&#39;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_section" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_section</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_section</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the section that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -31757,9 +31523,9 @@ <h3 id="odfdo.Element.get_section" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1696</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1696</span>
 <span class="normal">1697</span>
 <span class="normal">1698</span>
 <span class="normal">1699</span>
@@ -31795,24 +31561,22 @@ <h3 id="odfdo.Element.get_section" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:section&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_sections" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_sections</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_sections</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the sections that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -31821,9 +31585,9 @@ <h3 id="odfdo.Element.get_sections" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1667</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1667</span>
 <span class="normal">1668</span>
 <span class="normal">1669</span>
 <span class="normal">1670</span>
@@ -31859,24 +31623,22 @@ <h3 id="odfdo.Element.get_sections" class="doc doc-heading">
         <span class="s2">&quot;text:section&quot;</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_span" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_span</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_span</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the span that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -31885,9 +31647,9 @@ <h3 id="odfdo.Element.get_span" class="doc doc-heading">
 </code></pre>
 <p>Return: Span or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1790</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1790</span>
 <span class="normal">1791</span>
 <span class="normal">1792</span>
 <span class="normal">1793</span>
@@ -31923,24 +31685,22 @@ <h3 id="odfdo.Element.get_span" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:span&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_spans" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_spans</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_spans</span><span class="p">(</span><span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the spans that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -31949,9 +31709,9 @@ <h3 id="odfdo.Element.get_spans" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Span</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1763</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1763</span>
 <span class="normal">1764</span>
 <span class="normal">1765</span>
 <span class="normal">1766</span>
@@ -31987,24 +31747,22 @@ <h3 id="odfdo.Element.get_spans" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:span&quot;</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the style uniquely identified by the family/name pair. If
 the argument is already a style object, it will return it.</p>
 <p>If the name is not the internal name but the name you gave in the
@@ -32019,9 +31777,9 @@ <h3 id="odfdo.Element.get_style" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_style or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3294</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3294</span>
 <span class="normal">3295</span>
 <span class="normal">3296</span>
 <span class="normal">3297</span>
@@ -32117,24 +31875,22 @@ <h3 id="odfdo.Element.get_style" class="doc doc-heading">
             <span class="n">family</span><span class="o">=</span><span class="n">family</span><span class="p">,</span>
         <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_styled_elements" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_styled_elements</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_styled_elements</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Brute-force to find paragraphs, tables, etc. using the given style
 name (or all by default).</p>
 <p>Arguments:</p>
@@ -32142,9 +31898,9 @@ <h3 id="odfdo.Element.get_styled_elements" class="doc doc-heading">
 </code></pre>
 <p>Return: list</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1611</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1611</span>
 <span class="normal">1612</span>
 <span class="normal">1613</span>
 <span class="normal">1614</span>
@@ -32184,24 +31940,22 @@ <h3 id="odfdo.Element.get_styled_elements" class="doc doc-heading">
         <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::*&quot;</span><span class="p">,</span> <span class="n">parent_style</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the text change that matches the criteria. Either single
 deletion (text:change) or start of range of changes (text:change-start).
 position : index of the element to retrieve if several matches, default
@@ -32214,9 +31968,9 @@ <h3 id="odfdo.Element.get_text_change" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3197</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3197</span>
 <span class="normal">3198</span>
 <span class="normal">3199</span>
 <span class="normal">3200</span>
@@ -32270,24 +32024,22 @@ <h3 id="odfdo.Element.get_text_change" class="doc doc-heading">
     <span class="n">request</span> <span class="o">=</span> <span class="s2">&quot;descendant::text:change-start | descendant::text:change&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_element</span><span class="p">(</span><span class="n">request</span><span class="p">,</span> <span class="n">position</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change_deletion" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change_deletion</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change_deletion</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the text change of deletion kind that matches the criteria.
 Search only for the tags text:change.
 Consider using : get_text_change()</p>
@@ -32298,9 +32050,9 @@ <h3 id="odfdo.Element.get_text_change_deletion" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3098</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3098</span>
 <span class="normal">3099</span>
 <span class="normal">3100</span>
 <span class="normal">3101</span>
@@ -32340,31 +32092,29 @@ <h3 id="odfdo.Element.get_text_change_deletion" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:change&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">change_id</span><span class="o">=</span><span class="n">idx</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change_deletions" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change_deletions</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change_deletions</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the text changes of deletion kind: the tags text:change.
 Consider using : get_text_changes()</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3090</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3090</span>
 <span class="normal">3091</span>
 <span class="normal">3092</span>
 <span class="normal">3093</span>
@@ -32378,24 +32128,22 @@ <h3 id="odfdo.Element.get_text_change_deletions" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:text:change&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change_end</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the text change-end that matches the criteria. Search only
 the tags text:change-end.
 Consider using : get_text_change()</p>
@@ -32406,9 +32154,9 @@ <h3 id="odfdo.Element.get_text_change_end" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3158</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3158</span>
 <span class="normal">3159</span>
 <span class="normal">3160</span>
 <span class="normal">3161</span>
@@ -32448,32 +32196,30 @@ <h3 id="odfdo.Element.get_text_change_end" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:change-end&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">change_id</span><span class="o">=</span><span class="n">idx</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change_ends" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change_ends</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change_ends</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the text change-end. Search only the tags
 text:change-end.
 Consider using : get_text_changes()</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3149</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3149</span>
 <span class="normal">3150</span>
 <span class="normal">3151</span>
 <span class="normal">3152</span>
@@ -32489,24 +32235,22 @@ <h3 id="odfdo.Element.get_text_change_ends" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:change-end&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change_start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change_start</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change_start</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">idx</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the text change-start that matches the criteria. Search
 only the tags text:change-start.
 Consider using : get_text_change()</p>
@@ -32517,9 +32261,9 @@ <h3 id="odfdo.Element.get_text_change_start" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3128</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3128</span>
 <span class="normal">3129</span>
 <span class="normal">3130</span>
 <span class="normal">3131</span>
@@ -32559,32 +32303,30 @@ <h3 id="odfdo.Element.get_text_change_start" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:change-start&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">change_id</span><span class="o">=</span><span class="n">idx</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_change_starts" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_change_starts</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_text_change_starts</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the text change-start. Search only for the tags
 text:change-start.
 Consider using : get_text_changes()</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3119</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3119</span>
 <span class="normal">3120</span>
 <span class="normal">3121</span>
 <span class="normal">3122</span>
@@ -32600,31 +32342,29 @@ <h3 id="odfdo.Element.get_text_change_starts" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:change-start&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_text_changes" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_text_changes</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_text_changes</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the text changes, either single deletion
 (text:change) or start of range of changes (text:change-start).</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3179</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3179</span>
 <span class="normal">3180</span>
 <span class="normal">3181</span>
 <span class="normal">3182</span>
@@ -32640,24 +32380,22 @@ <h3 id="odfdo.Element.get_text_changes" class="doc doc-heading">
     <span class="n">request</span> <span class="o">=</span> <span class="s2">&quot;descendant::text:change-start | descendant::text:change&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_toc" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_toc</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_toc</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the table of contents that matches the criteria.</p>
 <p>Arguments:</p>
 <pre><code>position -- int
@@ -32666,9 +32404,9 @@ <h3 id="odfdo.Element.get_toc" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_toc or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3242</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3242</span>
 <span class="normal">3243</span>
 <span class="normal">3244</span>
 <span class="normal">3245</span>
@@ -32704,30 +32442,28 @@ <h3 id="odfdo.Element.get_toc" class="doc doc-heading">
         <span class="s2">&quot;text:table-of-content&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_tocs" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_tocs</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_tocs</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the tables of contents.</p>
 <p>Return: list of odf_toc</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3227</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3227</span>
 <span class="normal">3228</span>
 <span class="normal">3229</span>
 <span class="normal">3230</span>
@@ -32739,30 +32475,28 @@ <h3 id="odfdo.Element.get_tocs" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_elements</span><span class="p">(</span><span class="s2">&quot;text:table-of-content&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_tracked_changes" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_tracked_changes</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_tracked_changes</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the tracked-changes part in the text body.</p>
 <p>Return: Element or None</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3065</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3065</span>
 <span class="normal">3066</span>
 <span class="normal">3067</span>
 <span class="normal">3068</span>
@@ -32774,30 +32508,28 @@ <h3 id="odfdo.Element.get_tracked_changes" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_element</span><span class="p">(</span><span class="s2">&quot;//text:tracked-changes&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_defined" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_defined</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_user_defined</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>return the user defined declaration for the given name.</p>
 <p>return: Element or none if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2458</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2458</span>
 <span class="normal">2459</span>
 <span class="normal">2460</span>
 <span class="normal">2461</span>
@@ -32813,30 +32545,28 @@ <h3 id="odfdo.Element.get_user_defined" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:user-defined&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_defined_list" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_defined_list</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_user_defined_list</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the user defined field declarations.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2443</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2443</span>
 <span class="normal">2444</span>
 <span class="normal">2445</span>
 <span class="normal">2446</span>
@@ -32848,24 +32578,22 @@ <h3 id="odfdo.Element.get_user_defined_list" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:user-defined&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_defined_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_defined_value</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_user_defined_value</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the value of the given user defined field name.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
@@ -32875,9 +32603,9 @@ <h3 id="odfdo.Element.get_user_defined_value" class="doc doc-heading">
 </code></pre>
 <p>Return: most appropriate Python type</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2467</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2467</span>
 <span class="normal">2468</span>
 <span class="normal">2469</span>
 <span class="normal">2470</span>
@@ -32913,30 +32641,28 @@ <h3 id="odfdo.Element.get_user_defined_value" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">user_defined</span><span class="o">.</span><span class="n">get_value</span><span class="p">(</span><span class="n">value_type</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_field_decl" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_field_decl</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_user_field_decl</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>return the user field declaration for the given name.</p>
 <p>return: Element or none if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2412</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2412</span>
 <span class="normal">2413</span>
 <span class="normal">2414</span>
 <span class="normal">2415</span>
@@ -32952,30 +32678,28 @@ <h3 id="odfdo.Element.get_user_field_decl" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:user-field-decl&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_field_decl_list" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_field_decl_list</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_user_field_decl_list</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the user field declarations.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2405</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2405</span>
 <span class="normal">2406</span>
 <span class="normal">2407</span>
 <span class="normal">2408</span>
@@ -32987,31 +32711,29 @@ <h3 id="odfdo.Element.get_user_field_decl_list" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:user-field-decl&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_field_decls" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_field_decls</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_user_field_decls</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the container for user field declarations. Created if not
 found.</p>
 <p>Return: Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2389</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2389</span>
 <span class="normal">2390</span>
 <span class="normal">2391</span>
 <span class="normal">2392</span>
@@ -33041,24 +32763,22 @@ <h3 id="odfdo.Element.get_user_field_decls" class="doc doc-heading">
 
     <span class="k">return</span> <span class="n">user_field_decls</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_user_field_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_field_value</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_user_field_value</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the value of the given user field name.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
@@ -33068,9 +32788,9 @@ <h3 id="odfdo.Element.get_user_field_value" class="doc doc-heading">
 </code></pre>
 <p>Return: most appropriate Python type</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2421</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2421</span>
 <span class="normal">2422</span>
 <span class="normal">2423</span>
 <span class="normal">2424</span>
@@ -33106,24 +32826,22 @@ <h3 id="odfdo.Element.get_user_field_value" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">user_field_decl</span><span class="o">.</span><span class="n">get_value</span><span class="p">(</span><span class="n">value_type</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_variable_decl" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_variable_decl</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_variable_decl</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>return the variable declaration for the given name.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
@@ -33132,9 +32850,9 @@ <h3 id="odfdo.Element.get_variable_decl" class="doc doc-heading">
 </code></pre>
 <p>return: Element or none if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2325</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2325</span>
 <span class="normal">2326</span>
 <span class="normal">2327</span>
 <span class="normal">2328</span>
@@ -33162,30 +32880,28 @@ <h3 id="odfdo.Element.get_variable_decl" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:variable-decl&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_variable_decl_list" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_variable_decl_list</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_variable_decl_list</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the variable declarations.</p>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2318</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2318</span>
 <span class="normal">2319</span>
 <span class="normal">2320</span>
 <span class="normal">2321</span>
@@ -33197,31 +32913,29 @@ <h3 id="odfdo.Element.get_variable_decl_list" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:variable-decl&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_variable_decls" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_variable_decls</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_variable_decls</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the container for variable declarations. Created if not
 found.</p>
 <p>Return: Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2302</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2302</span>
 <span class="normal">2303</span>
 <span class="normal">2304</span>
 <span class="normal">2305</span>
@@ -33251,24 +32965,22 @@ <h3 id="odfdo.Element.get_variable_decls" class="doc doc-heading">
 
     <span class="k">return</span> <span class="n">variable_decls</span>  <span class="c1"># type:ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_variable_set" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_variable_set</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=-</span><span class="mi">1</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_variable_set</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">position</span><span class="o">=-</span><span class="mi">1</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the variable set for the given name (last one by default).</p>
 <p>Arguments:</p>
 <pre><code>name -- str
@@ -33277,9 +32989,9 @@ <h3 id="odfdo.Element.get_variable_set" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2351</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2351</span>
 <span class="normal">2352</span>
 <span class="normal">2353</span>
 <span class="normal">2354</span>
@@ -33307,24 +33019,22 @@ <h3 id="odfdo.Element.get_variable_set" class="doc doc-heading">
         <span class="s2">&quot;descendant::text:variable-set&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_variable_set_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_variable_set_value</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_variable_set_value</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the last value of the given variable name.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
@@ -33334,9 +33044,9 @@ <h3 id="odfdo.Element.get_variable_set_value" class="doc doc-heading">
 </code></pre>
 <p>Return: most appropriate Python type</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2366</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2366</span>
 <span class="normal">2367</span>
 <span class="normal">2368</span>
 <span class="normal">2369</span>
@@ -33376,33 +33086,31 @@ <h3 id="odfdo.Element.get_variable_set_value" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">variable_set</span><span class="o">.</span><span class="n">get_value</span><span class="p">(</span><span class="n">value_type</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.get_variable_sets" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_variable_sets</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_variable_sets</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the variable sets that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2340</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2340</span>
 <span class="normal">2341</span>
 <span class="normal">2342</span>
 <span class="normal">2343</span>
@@ -33422,30 +33130,28 @@ <h3 id="odfdo.Element.get_variable_sets" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;descendant::text:variable-set&quot;</span><span class="p">,</span> <span class="n">text_name</span><span class="o">=</span><span class="n">name</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.index" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">index</span><span class="p">(</span><span class="n">child</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">index</span><span class="p">(</span><span class="n">child</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the position of the child in this element.</p>
 <p>Inspired by lxml</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1000</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1000</span>
 <span class="normal">1001</span>
 <span class="normal">1002</span>
 <span class="normal">1003</span>
@@ -33457,24 +33163,22 @@ <h3 id="odfdo.Element.index" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__element</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">child</span><span class="o">.</span><span class="n">__element</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.insert" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert</span><span class="p">(</span><span class="n">element</span><span class="p">,</span> <span class="n">xmlposition</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert</span><span class="p">(</span><span class="n">element</span><span class="p">,</span> <span class="n">xmlposition</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert an element relatively to ourself.</p>
 <p>Insert either using DOM vocabulary or by numeric position.
 If text start is True, insert the element before any existing text.</p>
@@ -33490,9 +33194,9 @@ <h3 id="odfdo.Element.insert" class="doc doc-heading">
 position -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1281</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1281</span>
 <span class="normal">1282</span>
 <span class="normal">1283</span>
 <span class="normal">1284</span>
@@ -33602,30 +33306,28 @@ <h3 id="odfdo.Element.insert" class="doc doc-heading">
     <span class="k">else</span><span class="p">:</span>
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;(xml)position must be defined&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.is_empty" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_empty</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">is_empty</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Check if the element is empty : no text, no children, no tail.</p>
 <p>Return: Boolean</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1048</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1048</span>
 <span class="normal">1049</span>
 <span class="normal">1050</span>
 <span class="normal">1051</span>
@@ -33651,24 +33353,22 @@ <h3 id="odfdo.Element.is_empty" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">False</span>
     <span class="k">return</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.match" class="doc doc-heading">
-          <code class="highlight language-python"><span class="k">match</span><span class="p">(</span><span class="n">pattern</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="k">match</span><span class="p">(</span><span class="n">pattern</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>return True if the pattern is found one or more times anywhere in
 the text content of the element.</p>
 <p>Python regular expression syntax applies.</p>
@@ -33677,9 +33377,9 @@ <h3 id="odfdo.Element.match" class="doc doc-heading">
 </code></pre>
 <p>Return: bool</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">907</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">907</span>
 <span class="normal">908</span>
 <span class="normal">909</span>
 <span class="normal">910</span>
@@ -33705,24 +33405,22 @@ <h3 id="odfdo.Element.match" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">search</span><span class="p">(</span><span class="n">pattern</span><span class="p">)</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.replace" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">replace</span><span class="p">(</span><span class="n">pattern</span><span class="p">,</span> <span class="n">new</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">replace</span><span class="p">(</span><span class="n">pattern</span><span class="p">,</span> <span class="n">new</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Replace the pattern with the given text, or delete if text is an
 empty string, and return the number of replacements. By default, only
 return the number of occurences that would be replaced.</p>
@@ -33736,9 +33434,9 @@ <h3 id="odfdo.Element.replace" class="doc doc-heading">
 </code></pre>
 <p>Return: int</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">921</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">921</span>
 <span class="normal">922</span>
 <span class="normal">923</span>
 <span class="normal">924</span>
@@ -33808,31 +33506,29 @@ <h3 id="odfdo.Element.replace" class="doc doc-heading">
             <span class="n">count</span> <span class="o">+=</span> <span class="n">number</span>
     <span class="k">return</span> <span class="n">count</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.replace_element" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">replace_element</span><span class="p">(</span><span class="n">old_element</span><span class="p">,</span> <span class="n">new_element</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">replace_element</span><span class="p">(</span><span class="n">old_element</span><span class="p">,</span> <span class="n">new_element</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Replaces in place a sub element with the element passed as second
 argument.</p>
 <p>Warning : no clone for old element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1405</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1405</span>
 <span class="normal">1406</span>
 <span class="normal">1407</span>
 <span class="normal">1408</span>
@@ -33848,24 +33544,22 @@ <h3 id="odfdo.Element.replace_element" class="doc doc-heading">
     <span class="n">current</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">__element</span>
     <span class="n">current</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">old_element</span><span class="o">.</span><span class="n">__element</span><span class="p">,</span> <span class="n">new_element</span><span class="o">.</span><span class="n">__element</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.search" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">search</span><span class="p">(</span><span class="n">pattern</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">search</span><span class="p">(</span><span class="n">pattern</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the first position of the pattern in the text content of
 the element, or None if not found.</p>
 <p>Python regular expression syntax applies.</p>
@@ -33874,9 +33568,9 @@ <h3 id="odfdo.Element.search" class="doc doc-heading">
 </code></pre>
 <p>Return: int or None</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">890</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">890</span>
 <span class="normal">891</span>
 <span class="normal">892</span>
 <span class="normal">893</span>
@@ -33908,29 +33602,27 @@ <h3 id="odfdo.Element.search" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">match</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.serialize" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">serialize</span><span class="p">(</span><span class="n">pretty</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">with_ns</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">serialize</span><span class="p">(</span><span class="n">pretty</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">with_ns</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return text serialization of XML element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1588</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1588</span>
 <span class="normal">1589</span>
 <span class="normal">1590</span>
 <span class="normal">1591</span>
@@ -33952,29 +33644,27 @@ <h3 id="odfdo.Element.serialize" class="doc doc-heading">
     <span class="c1"># Remove namespaces</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_strip_namespaces</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.set_style_attribute" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_style_attribute</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_style_attribute</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to accept a style object as a value.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">852</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">852</span>
 <span class="normal">853</span>
 <span class="normal">854</span>
 <span class="normal">855</span>
@@ -33984,24 +33674,22 @@ <h3 id="odfdo.Element.set_style_attribute" class="doc doc-heading">
         <span class="n">value</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>  <span class="c1"># type:ignore</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">set_attribute</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.strip_elements" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">strip_elements</span><span class="p">(</span><span class="n">sub_elements</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">strip_elements</span><span class="p">(</span><span class="n">sub_elements</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove the tags of provided elements, keeping inner childs and text.</p>
 <p>Return : the striped element.</p>
 <p>Warning : no clone in sub_elements list.</p>
@@ -34009,9 +33697,9 @@ <h3 id="odfdo.Element.strip_elements" class="doc doc-heading">
 <pre><code>sub_elements -- Element or list of Element
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1414</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1414</span>
 <span class="normal">1415</span>
 <span class="normal">1416</span>
 <span class="normal">1417</span>
@@ -34057,24 +33745,22 @@ <h3 id="odfdo.Element.strip_elements" class="doc doc-heading">
     <span class="n">strip</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;text:this-will-be-removed&quot;</span><span class="p">,)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">strip_tags</span><span class="p">(</span><span class="n">strip</span><span class="o">=</span><span class="n">strip</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.strip_tags" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">strip_tags</span><span class="p">(</span><span class="n">strip</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">protect</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s1">&#39;text:p&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">strip_tags</span><span class="p">(</span><span class="n">strip</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">protect</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s1">&#39;text:p&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove the tags listed in strip, recursively, keeping inner childs
 and text. Tags listed in protect stop the removal one level depth. If
 the first level element is stripped, default is used to embed the
@@ -34094,9 +33780,9 @@ <h3 id="odfdo.Element.strip_tags" class="doc doc-heading">
 <pre><code>Element.
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1438</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1438</span>
 <span class="normal">1439</span>
 <span class="normal">1440</span>
 <span class="normal">1441</span>
@@ -34182,30 +33868,28 @@ <h3 id="odfdo.Element.strip_tags" class="doc doc-heading">
         <span class="n">element</span> <span class="o">=</span> <span class="n">new</span>
     <span class="k">return</span> <span class="n">element</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Element.xpath" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Apply XPath query to the element and its subtree. Return list of
 Element or EText instances translated from the nodes found.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1536</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1536</span>
 <span class="normal">1537</span>
 <span class="normal">1538</span>
 <span class="normal">1539</span>
@@ -34239,8 +33923,8 @@ <h3 id="odfdo.Element.xpath" class="doc doc-heading">
             <span class="c1">#     result.append(obj)</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -34248,8 +33932,7 @@ <h3 id="odfdo.Element.xpath" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -34258,20 +33941,20 @@ <h3 id="odfdo.Element.xpath" class="doc doc-heading">
 
 
 <h2 id="odfdo.ElementTyped" class="doc doc-heading">
-          <code>ElementTyped</code>
+            <code>ElementTyped</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/element_typed.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 34</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/element_typed.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 34</span>
 <span class="normal"> 35</span>
 <span class="normal"> 36</span>
 <span class="normal"> 37</span>
@@ -34619,12 +34302,11 @@ <h2 id="odfdo.ElementTyped" class="doc doc-heading">
             <span class="n">try_get_text</span><span class="o">=</span><span class="n">try_get_text</span><span class="p">,</span>
         <span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -34637,21 +34319,20 @@ <h2 id="odfdo.ElementTyped" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ElementTyped.get_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">try_get_text</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">value_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">try_get_text</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return Python typed value.</p>
 <p>Only for &ldquo;with office:value-type&rdquo; elements, not for meta fields.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/element_typed.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">190</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/element_typed.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">190</span>
 <span class="normal">191</span>
 <span class="normal">192</span>
 <span class="normal">193</span>
@@ -34687,8 +34368,8 @@ <h3 id="odfdo.ElementTyped.get_value" class="doc doc-heading">
         <span class="n">try_get_text</span><span class="o">=</span><span class="n">try_get_text</span><span class="p">,</span>
     <span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -34696,8 +34377,7 @@ <h3 id="odfdo.ElementTyped.get_value" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -34706,17 +34386,17 @@ <h3 id="odfdo.ElementTyped.get_value" class="doc doc-heading">
 
 
 <h2 id="odfdo.EllipseShape" class="doc doc-heading">
-          <code>EllipseShape</code>
+            <code>EllipseShape</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+
 
-  
       <p>Create a ellipse shape.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -34732,9 +34412,9 @@ <h2 id="odfdo.EllipseShape" class="doc doc-heading">
 size -- (str, str)
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/shapes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">193</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/shapes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">193</span>
 <span class="normal">194</span>
 <span class="normal">195</span>
 <span class="normal">196</span>
@@ -34820,12 +34500,11 @@ <h2 id="odfdo.EllipseShape" class="doc doc-heading">
         <span class="p">)</span>
         <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -34836,10 +34515,10 @@ <h2 id="odfdo.EllipseShape" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -34848,24 +34527,24 @@ <h2 id="odfdo.EllipseShape" class="doc doc-heading">
 
 
 <h2 id="odfdo.Frame" class="doc doc-heading">
-          <code>Frame</code>
+            <code>Frame</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.frame.AnchorMix">AnchorMix</span></code>, <code><span title="odfdo.frame.PosMix">PosMix</span></code>, <code><span title="odfdo.frame.ZMix">ZMix</span></code>, <code><span title="odfdo.frame.SizeMix">SizeMix</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code>, <code><span title="odfdo.frame.AnchorMix">AnchorMix</span></code>, <code><span title="odfdo.frame.PosMix">PosMix</span></code>, <code><span title="odfdo.frame.ZMix">ZMix</span></code>, <code><span title="odfdo.frame.SizeMix">SizeMix</span></code></p>
+
 
-  
       <p>ODF Frame &ldquo;draw:frame&rdquo;</p>
 <p>Frames are not useful by themselves. You should consider calling
 Frame.image_frame() or Frame.text_frame directly.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/frame.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">167</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/frame.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">167</span>
 <span class="normal">168</span>
 <span class="normal">169</span>
 <span class="normal">170</span>
@@ -35511,12 +35190,11 @@ <h2 id="odfdo.Frame" class="doc doc-heading">
         <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
         <span class="k">return</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -35529,15 +35207,14 @@ <h2 id="odfdo.Frame" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Frame.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;1cm&#39;</span><span class="p">,</span> <span class="s1">&#39;1cm&#39;</span><span class="p">),</span> <span class="n">z_index</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">layer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;1cm&#39;</span><span class="p">,</span> <span class="s1">&#39;1cm&#39;</span><span class="p">),</span> <span class="n">z_index</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">layer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a frame element of the given size. Position is relative to the
 context the frame is inserted in. If positioned by page, give the page
 number and the x, y position.</p>
@@ -35571,9 +35248,9 @@ <h3 id="odfdo.Frame.__init__" class="doc doc-heading">
 presentation_style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/frame.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">188</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/frame.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">188</span>
 <span class="normal">189</span>
 <span class="normal">190</span>
 <span class="normal">191</span>
@@ -35725,19 +35402,17 @@ <h3 id="odfdo.Frame.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">presentation_style</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">presentation_style</span> <span class="o">=</span> <span class="n">presentation_style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Frame.image_frame" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">image_frame</span><span class="p">(</span><span class="n">image</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;1cm&#39;</span><span class="p">,</span> <span class="s1">&#39;1cm&#39;</span><span class="p">),</span> <span class="n">z_index</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">layer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
-  
+            <code class="highlight language-python"><span class="n">image_frame</span><span class="p">(</span><span class="n">image</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;1cm&#39;</span><span class="p">,</span> <span class="s1">&#39;1cm&#39;</span><span class="p">),</span> <span class="n">z_index</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">layer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small>
   </span>
@@ -35745,8 +35420,8 @@ <h3 id="odfdo.Frame.image_frame" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a ready-to-use image, since image must be embedded in a
 frame.</p>
 <p>The optionnal text will appear above the image.</p>
@@ -35759,9 +35434,9 @@ <h3 id="odfdo.Frame.image_frame" class="doc doc-heading">
 </code></pre>
 <p>Return: Frame</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/frame.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">265</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/frame.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">265</span>
 <span class="normal">266</span>
 <span class="normal">267</span>
 <span class="normal">268</span>
@@ -35863,19 +35538,17 @@ <h3 id="odfdo.Frame.image_frame" class="doc doc-heading">
         <span class="n">image_element</span><span class="o">.</span><span class="n">text_content</span> <span class="o">=</span> <span class="n">text</span>
     <span class="k">return</span> <span class="n">frame</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Frame.text_frame" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">text_frame</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;1cm&#39;</span><span class="p">,</span> <span class="s1">&#39;1cm&#39;</span><span class="p">),</span> <span class="n">z_index</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">layer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
-  
+            <code class="highlight language-python"><span class="n">text_frame</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">,</span> <span class="n">text_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">draw_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="s1">&#39;1cm&#39;</span><span class="p">,</span> <span class="s1">&#39;1cm&#39;</span><span class="p">),</span> <span class="n">z_index</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">presentation_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">anchor_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">layer</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">presentation_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small>
   </span>
@@ -35883,8 +35556,8 @@ <h3 id="odfdo.Frame.text_frame" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a ready-to-use text box, since text box must be embedded in
 a frame.</p>
 <p>The optionnal text will appear above the image.</p>
@@ -35898,9 +35571,9 @@ <h3 id="odfdo.Frame.text_frame" class="doc doc-heading">
 </code></pre>
 <p>Return: Frame</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/frame.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">317</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/frame.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">317</span>
 <span class="normal">318</span>
 <span class="normal">319</span>
 <span class="normal">320</span>
@@ -36000,8 +35673,8 @@ <h3 id="odfdo.Frame.text_frame" class="doc doc-heading">
     <span class="n">frame</span><span class="o">.</span><span class="n">set_text_box</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">,</span> <span class="n">text_style</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">frame</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -36009,8 +35682,7 @@ <h3 id="odfdo.Frame.text_frame" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -36019,22 +35691,22 @@ <h3 id="odfdo.Frame.text_frame" class="doc doc-heading">
 
 
 <h2 id="odfdo.Header" class="doc doc-heading">
-          <code>Header</code>
+            <code>Header</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.paragraph.Paragraph" href="#odfdo.Paragraph">Paragraph</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.paragraph.Paragraph" href="#odfdo.Paragraph">Paragraph</a></code></p>
+
 
-  
       <p>Specialised paragraph for headings &ldquo;text:h&rdquo;.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/header.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 32</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/header.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 32</span>
 <span class="normal"> 33</span>
 <span class="normal"> 34</span>
 <span class="normal"> 35</span>
@@ -36210,12 +35882,11 @@ <h2 id="odfdo.Header" class="doc doc-heading">
         <span class="n">result</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">title</span><span class="p">,</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">LEVEL_STYLES</span><span class="p">[</span><span class="n">level</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">title</span><span class="p">),</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">]</span>
         <span class="k">return</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -36228,15 +35899,14 @@ <h2 id="odfdo.Header" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Header.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">level</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">restart_numbering</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">start_value</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">suppress_numbering</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">level</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">restart_numbering</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">start_value</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">suppress_numbering</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a header element of the given style and level, containing the
 optional given text.</p>
 <p>Level count begins at 1.</p>
@@ -36252,9 +35922,9 @@ <h3 id="odfdo.Header.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/header.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">43</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/header.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">43</span>
 <span class="normal">44</span>
 <span class="normal">45</span>
 <span class="normal">46</span>
@@ -36334,8 +36004,8 @@ <h3 id="odfdo.Header.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -36343,8 +36013,7 @@ <h3 id="odfdo.Header.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -36353,23 +36022,23 @@ <h3 id="odfdo.Header.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Image" class="doc doc-heading">
-          <code>Image</code>
+            <code>Image</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Image, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">123</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">123</span>
 <span class="normal">124</span>
 <span class="normal">125</span>
 <span class="normal">126</span>
@@ -36385,12 +36054,11 @@ <h2 id="odfdo.Image" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -36401,10 +36069,10 @@ <h2 id="odfdo.Image" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -36413,26 +36081,26 @@ <h2 id="odfdo.Image" class="doc doc-heading">
 
 
 <h2 id="odfdo.IndexTitle" class="doc doc-heading">
-          <code>IndexTitle</code>
+            <code>IndexTitle</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The &ldquo;text:index-title&rdquo; element contains the title of an index.</p>
 <p>The element has the following attributes:
 text:name, text:protected, text:protection-key,
 text:protection-key-digest-algorithm, text:style-name, xml:id.</p>
 <p>The actual title is stored in a child element</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/toc.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">39</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/toc.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">39</span>
 <span class="normal">40</span>
 <span class="normal">41</span>
 <span class="normal">42</span>
@@ -36530,12 +36198,11 @@ <h2 id="odfdo.IndexTitle" class="doc doc-heading">
         <span class="n">title</span> <span class="o">=</span> <span class="n">Paragraph</span><span class="p">(</span><span class="n">title_text</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="n">title_text_style</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">title</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -36546,10 +36213,10 @@ <h2 id="odfdo.IndexTitle" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -36558,25 +36225,25 @@ <h2 id="odfdo.IndexTitle" class="doc doc-heading">
 
 
 <h2 id="odfdo.IndexTitleTemplate" class="doc doc-heading">
-          <code>IndexTitleTemplate</code>
+            <code>IndexTitleTemplate</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF &ldquo;text:index-title-template&rdquo;</p>
 <p>Arguments:</p>
 <pre><code>style -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/toc.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">446</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/toc.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">446</span>
 <span class="normal">447</span>
 <span class="normal">448</span>
 <span class="normal">449</span>
@@ -36606,12 +36273,11 @@ <h2 id="odfdo.IndexTitleTemplate" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span> <span class="ow">and</span> <span class="n">style</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -36622,10 +36288,10 @@ <h2 id="odfdo.IndexTitleTemplate" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -36634,22 +36300,22 @@ <h2 id="odfdo.IndexTitleTemplate" class="doc doc-heading">
 
 
 <h2 id="odfdo.LineBreak" class="doc doc-heading">
-          <code>LineBreak</code>
+            <code>LineBreak</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>This element represents a line break &ldquo;text:line-break&rdquo;</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">222</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">222</span>
 <span class="normal">223</span>
 <span class="normal">224</span>
 <span class="normal">225</span>
@@ -36663,12 +36329,11 @@ <h2 id="odfdo.LineBreak" class="doc doc-heading">
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -36679,10 +36344,10 @@ <h2 id="odfdo.LineBreak" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -36691,17 +36356,17 @@ <h2 id="odfdo.LineBreak" class="doc doc-heading">
 
 
 <h2 id="odfdo.LineShape" class="doc doc-heading">
-          <code>LineShape</code>
+            <code>LineShape</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+
 
-  
       <p>Create a line shape.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -36717,9 +36382,9 @@ <h2 id="odfdo.LineShape" class="doc doc-heading">
 p2 -- (str, str)
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/shapes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 88</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/shapes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 88</span>
 <span class="normal"> 89</span>
 <span class="normal"> 90</span>
 <span class="normal"> 91</span>
@@ -36823,12 +36488,11 @@ <h2 id="odfdo.LineShape" class="doc doc-heading">
                 <span class="bp">self</span><span class="o">.</span><span class="n">x2</span> <span class="o">=</span> <span class="n">p2</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">y2</span> <span class="o">=</span> <span class="n">p2</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -36839,10 +36503,10 @@ <h2 id="odfdo.LineShape" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -36851,22 +36515,22 @@ <h2 id="odfdo.LineShape" class="doc doc-heading">
 
 
 <h2 id="odfdo.Link" class="doc doc-heading">
-          <code>Link</code>
+            <code>Link</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.paragraph_base.ParagraphBase">ParagraphBase</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.paragraph_base.ParagraphBase">ParagraphBase</span></code></p>
+
 
-  
       <p>Link class, &ldquo;text:a&rdquo; ODF element.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/link.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 32</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/link.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 32</span>
 <span class="normal"> 33</span>
 <span class="normal"> 34</span>
 <span class="normal"> 35</span>
@@ -37006,12 +36670,11 @@ <h2 id="odfdo.Link" class="doc doc-heading">
             <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;[</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">](</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">url</span><span class="si">}</span><span class="s2">)&quot;</span>
         <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;(</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">url</span><span class="si">}</span><span class="s2">)&quot;</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -37024,15 +36687,14 @@ <h2 id="odfdo.Link" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Link.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">target_frame</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">visited_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">url</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">target_frame</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">visited_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Arguments:</p>
 <pre><code>url -- str
 
@@ -37049,9 +36711,9 @@ <h3 id="odfdo.Link.__init__" class="doc doc-heading">
 visited_style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/link.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">46</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/link.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">46</span>
 <span class="normal">47</span>
 <span class="normal">48</span>
 <span class="normal">49</span>
@@ -37147,8 +36809,8 @@ <h3 id="odfdo.Link.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">visited_style</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">visited_style</span> <span class="o">=</span> <span class="n">visited_style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -37156,8 +36818,7 @@ <h3 id="odfdo.Link.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -37166,22 +36827,22 @@ <h3 id="odfdo.Link.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.List" class="doc doc-heading">
-          <code>List</code>
+            <code>List</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF List &ldquo;text:list&rdquo;.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/list.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 67</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/list.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 67</span>
 <span class="normal"> 68</span>
 <span class="normal"> 69</span>
 <span class="normal"> 70</span>
@@ -37477,12 +37138,11 @@ <h2 id="odfdo.List" class="doc doc-heading">
             <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
         <span class="k">return</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -37495,15 +37155,14 @@ <h2 id="odfdo.List" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.List.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">list_content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">list_content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a list element, optionaly loading the list by a list of
 item (str or elements).</p>
 <p>The list_content argument is just a shortcut for the most common case.
@@ -37515,9 +37174,9 @@ <h3 id="odfdo.List.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/list.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 73</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/list.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 73</span>
 <span class="normal"> 74</span>
 <span class="normal"> 75</span>
 <span class="normal"> 76</span>
@@ -37575,24 +37234,22 @@ <h3 id="odfdo.List.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.List.get_item" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_item</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_item</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the list item that matches the criteria. In nested lists,
 return the list item that really contains that content.</p>
 <p>Arguments:</p>
@@ -37602,9 +37259,9 @@ <h3 id="odfdo.List.get_item" class="doc doc-heading">
 </code></pre>
 <p>Return: Element or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/list.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">116</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/list.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
 <span class="normal">119</span>
@@ -37654,24 +37311,22 @@ <h3 id="odfdo.List.get_item" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_element</span><span class="p">(</span><span class="s2">&quot;text:list-item&quot;</span><span class="p">,</span> <span class="n">position</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.List.get_items" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_items</span><span class="p">(</span><span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_items</span><span class="p">(</span><span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return all the list items that match the criteria.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -37680,9 +37335,9 @@ <h3 id="odfdo.List.get_items" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Element</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/list.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">103</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/list.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">103</span>
 <span class="normal">104</span>
 <span class="normal">105</span>
 <span class="normal">106</span>
@@ -37706,8 +37361,8 @@ <h3 id="odfdo.List.get_items" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_elements</span><span class="p">(</span><span class="s2">&quot;text:list-item&quot;</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -37715,8 +37370,7 @@ <h3 id="odfdo.List.get_items" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -37725,22 +37379,22 @@ <h3 id="odfdo.List.get_items" class="doc doc-heading">
 
 
 <h2 id="odfdo.ListItem" class="doc doc-heading">
-          <code>ListItem</code>
+            <code>ListItem</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF element &ldquo;text:list-item&rdquo;, item of a List.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/list.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">40</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/list.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">40</span>
 <span class="normal">41</span>
 <span class="normal">42</span>
 <span class="normal">43</span>
@@ -37790,12 +37444,11 @@ <h2 id="odfdo.ListItem" class="doc doc-heading">
             <span class="k">elif</span> <span class="n">text_or_element</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
                 <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Expected str or Element&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -37808,24 +37461,23 @@ <h2 id="odfdo.ListItem" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ListItem.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">text_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">text_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a list item element, optionaly passing at creation time a
 string or Element as content.</p>
 <p>Arguments:</p>
 <pre><code>text_or_element -- str or ODF Element
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/list.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">45</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/list.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">45</span>
 <span class="normal">46</span>
 <span class="normal">47</span>
 <span class="normal">48</span>
@@ -37865,8 +37517,8 @@ <h3 id="odfdo.ListItem.__init__" class="doc doc-heading">
         <span class="k">elif</span> <span class="n">text_or_element</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Expected str or Element&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -37874,8 +37526,7 @@ <h3 id="odfdo.ListItem.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -37884,20 +37535,20 @@ <h3 id="odfdo.ListItem.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Manifest" class="doc doc-heading">
-          <code>Manifest</code>
+            <code>Manifest</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/manifest.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 30</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/manifest.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 30</span>
 <span class="normal"> 31</span>
 <span class="normal"> 32</span>
 <span class="normal"> 33</span>
@@ -38061,12 +37712,11 @@ <h2 id="odfdo.Manifest" class="doc doc-heading">
         <span class="n">file_entry</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_file_entry</span><span class="p">(</span><span class="n">full_path</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">root</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">file_entry</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -38079,21 +37729,20 @@ <h2 id="odfdo.Manifest" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Manifest.get_media_type" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_media_type</span><span class="p">(</span><span class="n">full_path</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_media_type</span><span class="p">(</span><span class="n">full_path</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the media type of an existing path.</p>
 <p>Return: str</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/manifest.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">66</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/manifest.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">66</span>
 <span class="normal">67</span>
 <span class="normal">68</span>
 <span class="normal">69</span>
@@ -38119,30 +37768,28 @@ <h3 id="odfdo.Manifest.get_media_type" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Manifest.get_path_medias" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_path_medias</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_path_medias</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the list of (full_path, media_type) pairs in the manifest.</p>
 <p>Return: list of str tuples</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/manifest.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">48</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/manifest.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">48</span>
 <span class="normal">49</span>
 <span class="normal">50</span>
 <span class="normal">51</span>
@@ -38176,30 +37823,28 @@ <h3 id="odfdo.Manifest.get_path_medias" class="doc doc-heading">
         <span class="p">)</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Manifest.get_paths" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_paths</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_paths</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the list of full paths in the manifest.</p>
 <p>Return: list of str</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/manifest.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">31</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/manifest.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
@@ -38213,24 +37858,22 @@ <h3 id="odfdo.Manifest.get_paths" class="doc doc-heading">
     <span class="n">xpath_query</span> <span class="o">=</span> <span class="s2">&quot;//manifest:file-entry/attribute::manifest:full-path&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Manifest.set_media_type" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_media_type</span><span class="p">(</span><span class="n">full_path</span><span class="p">,</span> <span class="n">media_type</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_media_type</span><span class="p">(</span><span class="n">full_path</span><span class="p">,</span> <span class="n">media_type</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the media type of an existing path.</p>
 <p>Arguments:</p>
 <pre><code>full_path -- str
@@ -38238,9 +37881,9 @@ <h3 id="odfdo.Manifest.set_media_type" class="doc doc-heading">
 media_type -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/manifest.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">80</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/manifest.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">80</span>
 <span class="normal">81</span>
 <span class="normal">82</span>
 <span class="normal">83</span>
@@ -38262,8 +37905,8 @@ <h3 id="odfdo.Manifest.set_media_type" class="doc doc-heading">
     <span class="n">file_entry</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_file_entry</span><span class="p">(</span><span class="n">full_path</span><span class="p">)</span>
     <span class="n">file_entry</span><span class="o">.</span><span class="n">set_attribute</span><span class="p">(</span><span class="s2">&quot;manifest:media-type&quot;</span><span class="p">,</span> <span class="n">media_type</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -38271,8 +37914,7 @@ <h3 id="odfdo.Manifest.set_media_type" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -38281,20 +37923,20 @@ <h3 id="odfdo.Manifest.set_media_type" class="doc doc-heading">
 
 
 <h2 id="odfdo.Meta" class="doc doc-heading">
-          <code>Meta</code>
+            <code>Meta</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code>, <code><span title="odfdo.mixin_dc_creator.DcCreatorMixin">DcCreatorMixin</span></code>, <code><span title="odfdo.mixin_dc_date.DcDateMixin">DcDateMixin</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code>, <code><span title="odfdo.mixin_dc_creator.DcCreatorMixin">DcCreatorMixin</span></code>, <code><span title="odfdo.mixin_dc_date.DcDateMixin">DcDateMixin</span></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/meta.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 47</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/meta.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 47</span>
 <span class="normal"> 48</span>
 <span class="normal"> 49</span>
 <span class="normal"> 50</span>
@@ -39978,9 +39620,9 @@ <h2 id="odfdo.Meta" class="doc doc-heading">
             <span class="k">return</span> <span class="p">(</span><span class="n">Duration</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="n">text</span><span class="p">),</span> <span class="n">value_type</span><span class="p">,</span> <span class="n">text</span><span class="p">)</span>
         <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Unknown value type: &#39;</span><span class="si">{</span><span class="n">value_type</span><span class="si">!r}</span><span class="s2">&#39;&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -39995,8 +39637,8 @@ <h2 id="odfdo.Meta" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.auto_reload" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">auto_reload</span><span class="p">:</span> <span class="n">MetaAutoReload</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">auto_reload</span><span class="p">:</span> <span class="n">MetaAutoReload</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -40004,10 +39646,10 @@ <h3 id="odfdo.Meta.auto_reload" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the MetaAutoReload <meta:auto-reload> element or None.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40016,8 +39658,8 @@ <h3 id="odfdo.Meta.auto_reload" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.creation_date" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">creation_date</span><span class="p">:</span> <span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">creation_date</span><span class="p">:</span> <span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40026,13 +39668,13 @@ <h3 id="odfdo.Meta.creation_date" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the date and time when a document was created
 <meta:creation-date>.</p>
 <p>If provided datetime is None, use current time.</p>
 <p>Return: datetime (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40041,8 +39683,8 @@ <h3 id="odfdo.Meta.creation_date" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.description" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40051,11 +39693,11 @@ <h3 id="odfdo.Meta.description" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the description of a document <dc:description>.</p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40064,8 +39706,8 @@ <h3 id="odfdo.Meta.description" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.editing_cycles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">editing_cycles</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">editing_cycles</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40074,14 +39716,14 @@ <h3 id="odfdo.Meta.editing_cycles" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the number of times a document has been edited
 <meta:editing-cycles>.</p>
 <p>When a document is created, this value is set to 1. Each time
 a document is saved, the editing-cycles number is incremented by 1.</p>
 <p>Return: int (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40090,8 +39732,8 @@ <h3 id="odfdo.Meta.editing_cycles" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.editing_duration" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">editing_duration</span><span class="p">:</span> <span class="n">timedelta</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">editing_duration</span><span class="p">:</span> <span class="n">timedelta</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40100,12 +39742,12 @@ <h3 id="odfdo.Meta.editing_duration" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the total time spent editing a document
 <meta:editing-duration>.</p>
 <p>Return: timedelta (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40114,8 +39756,8 @@ <h3 id="odfdo.Meta.editing_duration" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.generator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">generator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">generator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40124,8 +39766,8 @@ <h3 id="odfdo.Meta.generator" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the signature of the software that generated this
 document.</p>
 <p>Return: str (or None if inexistant)</p>
@@ -40134,7 +39776,7 @@ <h3 id="odfdo.Meta.generator" class="doc doc-heading">
 KOffice/2.0.0
 &gt;&gt;&gt; document.meta.generator = "Odfdo experiment"
 </code></pre>
-  </div>
+    </div>
 
 </div>
 
@@ -40143,8 +39785,8 @@ <h3 id="odfdo.Meta.generator" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.hyperlink_behaviour" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">hyperlink_behaviour</span><span class="p">:</span> <span class="n">MetaAutoReload</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">hyperlink_behaviour</span><span class="p">:</span> <span class="n">MetaAutoReload</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -40152,10 +39794,10 @@ <h3 id="odfdo.Meta.hyperlink_behaviour" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the MetaHyperlinkBehaviour <meta:hyperlink-behaviour> element or None.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40164,8 +39806,8 @@ <h3 id="odfdo.Meta.hyperlink_behaviour" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.initial_creator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">initial_creator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">initial_creator</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40174,12 +39816,12 @@ <h3 id="odfdo.Meta.initial_creator" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the initial creator of a document
 <meta:initial-creator>.</p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40188,8 +39830,8 @@ <h3 id="odfdo.Meta.initial_creator" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.keyword" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">keyword</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">keyword</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40198,12 +39840,12 @@ <h3 id="odfdo.Meta.keyword" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set some keyword(s) keyword pertaining to a document
 <dc:keyword>.</p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40212,8 +39854,8 @@ <h3 id="odfdo.Meta.keyword" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.language" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">language</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">language</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40222,11 +39864,11 @@ <h3 id="odfdo.Meta.language" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the default language of the document <dc:language>.</p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40235,8 +39877,8 @@ <h3 id="odfdo.Meta.language" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.print_date" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">print_date</span><span class="p">:</span> <span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">print_date</span><span class="p">:</span> <span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40245,13 +39887,13 @@ <h3 id="odfdo.Meta.print_date" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the date and time when a document when a document was last printed
 <meta:print-date></p>
 <p>If provided datetime is None, use current time.</p>
 <p>Return: datetime (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40260,8 +39902,8 @@ <h3 id="odfdo.Meta.print_date" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.printed_by" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">printed_by</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">printed_by</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40270,12 +39912,12 @@ <h3 id="odfdo.Meta.printed_by" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the name of the last person who printed a document.
 <meta:printed-by></p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40284,8 +39926,8 @@ <h3 id="odfdo.Meta.printed_by" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.statistic" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">statistic</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">statistic</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40294,8 +39936,8 @@ <h3 id="odfdo.Meta.statistic" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the statistics about a document
 <meta:document-statistic>.</p>
 <p>Return: dict (or None if inexistant)</p>
@@ -40309,7 +39951,7 @@ <h3 id="odfdo.Meta.statistic" class="doc doc-heading">
  'meta:word-count': 6,
  'meta:character-count': 7}
 </code></pre>
-  </div>
+    </div>
 
 </div>
 
@@ -40318,8 +39960,8 @@ <h3 id="odfdo.Meta.statistic" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.subject" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">subject</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">subject</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40328,11 +39970,11 @@ <h3 id="odfdo.Meta.subject" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the subject of a document <dc:subject>.</p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40341,8 +39983,8 @@ <h3 id="odfdo.Meta.subject" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.template" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">template</span><span class="p">:</span> <span class="n">MetaTemplate</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">template</span><span class="p">:</span> <span class="n">MetaTemplate</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -40350,10 +39992,10 @@ <h3 id="odfdo.Meta.template" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the MetaTemplate <meta:template> element or None.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40362,8 +40004,8 @@ <h3 id="odfdo.Meta.template" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.title" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">title</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">title</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40372,11 +40014,11 @@ <h3 id="odfdo.Meta.title" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the title of the document <dc:title>.</p>
 <p>Return: str (or None if inexistant)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -40385,8 +40027,8 @@ <h3 id="odfdo.Meta.title" class="doc doc-heading">
 
 
 <h3 id="odfdo.Meta.user_defined_metadata" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">user_defined_metadata</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">user_defined_metadata</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -40395,35 +40037,33 @@ <h3 id="odfdo.Meta.user_defined_metadata" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set all additional user-defined metadata for a document.</p>
 <p>Return a dict of str/value mapping.</p>
 <p>Value types can be: Decimal, date, time, boolean or str.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.clear_user_defined_metadata" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">clear_user_defined_metadata</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">clear_user_defined_metadata</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove all user-defined metadata.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">772</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">772</span>
 <span class="normal">773</span>
 <span class="normal">774</span>
 <span class="normal">775</span>
@@ -40439,29 +40079,27 @@ <h3 id="odfdo.Meta.clear_user_defined_metadata" class="doc doc-heading">
             <span class="k">continue</span>
         <span class="k">break</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_auto_reload" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_auto_reload</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_auto_reload</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the MetaAutoReload <meta:auto-reload> element or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">352</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">352</span>
 <span class="normal">353</span>
 <span class="normal">354</span>
 <span class="normal">355</span>
@@ -40473,31 +40111,29 @@ <h3 id="odfdo.Meta.get_auto_reload" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_creation_date" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_creation_date</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_creation_date</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the creation date of the document.</p>
 <p>(Also available as &ldquo;self.creation_date&rdquo; property.)</p>
 <p>Return: datetime (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">255</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">255</span>
 <span class="normal">256</span>
 <span class="normal">257</span>
 <span class="normal">258</span>
@@ -40521,31 +40157,29 @@ <h3 id="odfdo.Meta.get_creation_date" class="doc doc-heading">
     <span class="n">creation_date</span> <span class="o">=</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
     <span class="k">return</span> <span class="n">DateTime</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="n">creation_date</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_description" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_description</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_description</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the description of the document. Also known as comments.</p>
 <p>(Also available as &ldquo;self.description&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 98</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 98</span>
 <span class="normal"> 99</span>
 <span class="normal">100</span>
 <span class="normal">101</span>
@@ -40567,32 +40201,30 @@ <h3 id="odfdo.Meta.get_description" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_editing_cycles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_editing_cycles</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_editing_cycles</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the number of times the document was edited, as reported by
 the generator.</p>
 <p>(Also available as &ldquo;self.editing_cycles&rdquo; property.)</p>
 <p>Return: int (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">555</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">555</span>
 <span class="normal">556</span>
 <span class="normal">557</span>
 <span class="normal">558</span>
@@ -40618,32 +40250,30 @@ <h3 id="odfdo.Meta.get_editing_cycles" class="doc doc-heading">
     <span class="n">cycles</span> <span class="o">=</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
     <span class="k">return</span> <span class="nb">int</span><span class="p">(</span><span class="n">cycles</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_editing_duration" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_editing_duration</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_editing_duration</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the time the document was edited, as reported by the
 generator.</p>
 <p>(Also available as &ldquo;self.editing_duration&rdquo; property.)</p>
 <p>Return: timedelta (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">511</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">511</span>
 <span class="normal">512</span>
 <span class="normal">513</span>
 <span class="normal">514</span>
@@ -40669,24 +40299,22 @@ <h3 id="odfdo.Meta.get_editing_duration" class="doc doc-heading">
     <span class="n">duration</span> <span class="o">=</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
     <span class="k">return</span> <span class="n">Duration</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="n">duration</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_generator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_generator</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_generator</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the signature of the software that generated this document.</p>
 <p>(Also available as &ldquo;self.generator&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
@@ -40695,9 +40323,9 @@ <h3 id="odfdo.Meta.get_generator" class="doc doc-heading">
 KOffice/2.0.0
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">631</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">631</span>
 <span class="normal">632</span>
 <span class="normal">633</span>
 <span class="normal">634</span>
@@ -40723,29 +40351,27 @@ <h3 id="odfdo.Meta.get_generator" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">generator</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_hyperlink_behaviour" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_hyperlink_behaviour</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_hyperlink_behaviour</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the MetaHyperlinkBehaviour <meta:hyperlink-behaviour> element or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">372</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">372</span>
 <span class="normal">373</span>
 <span class="normal">374</span>
 <span class="normal">375</span>
@@ -40757,24 +40383,22 @@ <h3 id="odfdo.Meta.get_hyperlink_behaviour" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_initial_creator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_initial_creator</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_initial_creator</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the first creator of the document.</p>
 <p>(Also available as &ldquo;self.initial_creator&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
@@ -40783,9 +40407,9 @@ <h3 id="odfdo.Meta.get_initial_creator" class="doc doc-heading">
 Unknown
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">398</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">398</span>
 <span class="normal">399</span>
 <span class="normal">400</span>
 <span class="normal">401</span>
@@ -40817,32 +40441,30 @@ <h3 id="odfdo.Meta.get_initial_creator" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_keywords" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_keywords</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_keywords</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the keywords of the document. Return the field as-is, without
 any assumption on the keyword separator.</p>
 <p>(Also available as &ldquo;self.keyword&rdquo; and &ldquo;self.keywords&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">467</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">467</span>
 <span class="normal">468</span>
 <span class="normal">469</span>
 <span class="normal">470</span>
@@ -40866,24 +40488,22 @@ <h3 id="odfdo.Meta.get_keywords" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_language" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_language</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_language</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the default language of the document.</p>
 <p>(Also available as &ldquo;self.language&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
@@ -40892,9 +40512,9 @@ <h3 id="odfdo.Meta.get_language" class="doc doc-heading">
 fr-FR
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">181</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">181</span>
 <span class="normal">182</span>
 <span class="normal">183</span>
 <span class="normal">184</span>
@@ -40926,24 +40546,22 @@ <h3 id="odfdo.Meta.get_language" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_statistic" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_statistic</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_statistic</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the statistics about a document.</p>
 <p>(Also available as &ldquo;self.statistic&rdquo; property.)</p>
 <p>Return: dict (or None if inexistant)</p>
@@ -40958,9 +40576,9 @@ <h3 id="odfdo.Meta.get_statistic" class="doc doc-heading">
  'meta:character-count': 7}
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">671</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">671</span>
 <span class="normal">672</span>
 <span class="normal">673</span>
 <span class="normal">674</span>
@@ -41010,31 +40628,29 @@ <h3 id="odfdo.Meta.get_statistic" class="doc doc-heading">
         <span class="n">statistic</span><span class="p">[</span><span class="n">to_str</span><span class="p">(</span><span class="n">key</span><span class="p">)]</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">statistic</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_subject" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_subject</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_subject</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the subject of the document.</p>
 <p>(Also available as &ldquo;self.subject&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">142</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">142</span>
 <span class="normal">143</span>
 <span class="normal">144</span>
 <span class="normal">145</span>
@@ -41056,29 +40672,27 @@ <h3 id="odfdo.Meta.get_subject" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_template" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_template</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_template</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the MetaTemplate <meta:template> element or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">327</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">327</span>
 <span class="normal">328</span>
 <span class="normal">329</span>
 <span class="normal">330</span>
@@ -41090,32 +40704,30 @@ <h3 id="odfdo.Meta.get_template" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_title" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_title</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_title</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the title of the document.</p>
 <p>This is not the first heading but the title metadata.</p>
 <p>(Also available as &ldquo;self.title&rdquo; property.)</p>
 <p>Return: str (or None if inexistant)</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">55</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">55</span>
 <span class="normal">56</span>
 <span class="normal">57</span>
 <span class="normal">58</span>
@@ -41141,32 +40753,30 @@ <h3 id="odfdo.Meta.get_title" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">element</span><span class="o">.</span><span class="n">text</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_user_defined_metadata" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_defined_metadata</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_user_defined_metadata</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get all additional user-defined metadata for a document.</p>
 <p>(Also available as &ldquo;self.user_defined_metadata&rdquo; property.)</p>
 <p>Return a dict of str/value mapping.</p>
 <p>Value types can be: Decimal, date, time, boolean or str.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">751</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">751</span>
 <span class="normal">752</span>
 <span class="normal">753</span>
 <span class="normal">754</span>
@@ -41206,33 +40816,31 @@ <h3 id="odfdo.Meta.get_user_defined_metadata" class="doc doc-heading">
         <span class="n">result</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.get_user_defined_metadata_of_name" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_user_defined_metadata_of_name</span><span class="p">(</span><span class="n">keyname</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_user_defined_metadata_of_name</span><span class="p">(</span><span class="n">keyname</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the content of the user defined metadata of that name.
 Return None if no name matchs or a dic of fields.</p>
 <p>Arguments:</p>
 <pre><code>name -- string, name (meta:name content)
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">797</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">797</span>
 <span class="normal">798</span>
 <span class="normal">799</span>
 <span class="normal">800</span>
@@ -41284,29 +40892,27 @@ <h3 id="odfdo.Meta.get_user_defined_metadata_of_name" class="doc doc-heading">
     <span class="n">result</span><span class="p">[</span><span class="s2">&quot;text&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">text</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_auto_reload" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_auto_reload</span><span class="p">(</span><span class="n">delay</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_auto_reload</span><span class="p">(</span><span class="n">delay</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the MetaAutoReload <meta:auto-reload> element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">364</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">364</span>
 <span class="normal">365</span>
 <span class="normal">366</span>
 <span class="normal">367</span>
@@ -41320,24 +40926,22 @@ <h3 id="odfdo.Meta.set_auto_reload" class="doc doc-heading">
         <span class="n">current</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">autoreload</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_creation_date" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_creation_date</span><span class="p">(</span><span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_creation_date</span><span class="p">(</span><span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the creation date of the document.</p>
 <p>If provided datetime is None, use current time.</p>
 <p>(Also available as &ldquo;self.creation_date&rdquo; property.)</p>
@@ -41345,9 +40949,9 @@ <h3 id="odfdo.Meta.set_creation_date" class="doc doc-heading">
 <pre><code>date -- datetime
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">268</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">268</span>
 <span class="normal">269</span>
 <span class="normal">270</span>
 <span class="normal">271</span>
@@ -41383,33 +40987,31 @@ <h3 id="odfdo.Meta.set_creation_date" class="doc doc-heading">
         <span class="n">date</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">()</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">DateTime</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">date</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_description" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_description</span><span class="p">(</span><span class="n">description</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_description</span><span class="p">(</span><span class="n">description</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the description of the document. Also known as comments.</p>
 <p>(Also available as &ldquo;self.description&rdquo; property.)</p>
 <p>Arguments:</p>
 <pre><code>description -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">113</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">113</span>
 <span class="normal">114</span>
 <span class="normal">115</span>
 <span class="normal">116</span>
@@ -41437,33 +41039,31 @@ <h3 id="odfdo.Meta.set_description" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">description</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_editing_cycles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_editing_cycles</span><span class="p">(</span><span class="n">cycles</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_editing_cycles</span><span class="p">(</span><span class="n">cycles</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the number of times the document was edited.</p>
 <p>(Also available as &ldquo;self.editing_cycles&rdquo; property.)</p>
 <p>Arguments:</p>
 <pre><code>cycles -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">569</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">569</span>
 <span class="normal">570</span>
 <span class="normal">571</span>
 <span class="normal">572</span>
@@ -41499,33 +41099,31 @@ <h3 id="odfdo.Meta.set_editing_cycles" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">cycles</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_editing_duration" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_editing_duration</span><span class="p">(</span><span class="n">duration</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_editing_duration</span><span class="p">(</span><span class="n">duration</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the time the document was edited.</p>
 <p>(Also available as &ldquo;self.editing_duration&rdquo; property.)</p>
 <p>Arguments:</p>
 <pre><code>duration -- timedelta
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">525</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">525</span>
 <span class="normal">526</span>
 <span class="normal">527</span>
 <span class="normal">528</span>
@@ -41557,24 +41155,22 @@ <h3 id="odfdo.Meta.set_editing_duration" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">Duration</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">duration</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_generator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_generator</span><span class="p">(</span><span class="n">generator</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_generator</span><span class="p">(</span><span class="n">generator</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the signature of the software that generated this document.</p>
 <p>(Also available as &ldquo;self.generator&rdquo; property.)</p>
 <p>Arguments:</p>
@@ -41584,9 +41180,9 @@ <h3 id="odfdo.Meta.set_generator" class="doc doc-heading">
 <pre><code>&gt;&gt;&gt; document.meta.set_generator("Odfdo experiment")
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">645</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">645</span>
 <span class="normal">646</span>
 <span class="normal">647</span>
 <span class="normal">648</span>
@@ -41614,33 +41210,31 @@ <h3 id="odfdo.Meta.set_generator" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">generator</span> <span class="o">=</span> <span class="n">generator</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_generator_default" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_generator_default</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">set_generator_default</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the signature of the software that generated this document
 to ourself.</p>
 <p>Example::</p>
 <pre><code>&gt;&gt;&gt; document.meta.set_generator_default()
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">660</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">660</span>
 <span class="normal">661</span>
 <span class="normal">662</span>
 <span class="normal">663</span>
@@ -41660,29 +41254,27 @@ <h3 id="odfdo.Meta.set_generator_default" class="doc doc-heading">
     <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_generator_modified</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">generator</span> <span class="o">=</span> <span class="n">GENERATOR</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_hyperlink_behaviour" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_hyperlink_behaviour</span><span class="p">(</span><span class="n">target_frame_name</span><span class="o">=</span><span class="s1">&#39;_blank&#39;</span><span class="p">,</span> <span class="n">show</span><span class="o">=</span><span class="s1">&#39;replace&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_hyperlink_behaviour</span><span class="p">(</span><span class="n">target_frame_name</span><span class="o">=</span><span class="s1">&#39;_blank&#39;</span><span class="p">,</span> <span class="n">show</span><span class="o">=</span><span class="s1">&#39;replace&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the MetaHyperlinkBehaviour <meta:hyperlink-behaviour> element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">384</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">384</span>
 <span class="normal">385</span>
 <span class="normal">386</span>
 <span class="normal">387</span>
@@ -41708,24 +41300,22 @@ <h3 id="odfdo.Meta.set_hyperlink_behaviour" class="doc doc-heading">
         <span class="n">current</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">behaviour</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_initial_creator" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_initial_creator</span><span class="p">(</span><span class="n">creator</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_initial_creator</span><span class="p">(</span><span class="n">creator</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the first creator of the document.</p>
 <p>(Also available as &ldquo;self.initial_creator&rdquo; property.)</p>
 <p>Arguments:</p>
@@ -41735,9 +41325,9 @@ <h3 id="odfdo.Meta.set_initial_creator" class="doc doc-heading">
 <pre><code>&gt;&gt;&gt; document.meta.set_initial_creator("Plato")
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">415</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">415</span>
 <span class="normal">416</span>
 <span class="normal">417</span>
 <span class="normal">418</span>
@@ -41773,24 +41363,22 @@ <h3 id="odfdo.Meta.set_initial_creator" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">creator</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_keywords" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_keywords</span><span class="p">(</span><span class="n">keywords</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_keywords</span><span class="p">(</span><span class="n">keywords</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the keywords of the document. Although the name is plural, a
 str string is required, so join your list first.</p>
 <p>(Also available as &ldquo;self.keyword&rdquo; and &ldquo;self.keywords&rdquo; property.)</p>
@@ -41798,9 +41386,9 @@ <h3 id="odfdo.Meta.set_keywords" class="doc doc-heading">
 <pre><code>keywords -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">480</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">480</span>
 <span class="normal">481</span>
 <span class="normal">482</span>
 <span class="normal">483</span>
@@ -41830,24 +41418,22 @@ <h3 id="odfdo.Meta.set_keywords" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">keywords</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_language" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_language</span><span class="p">(</span><span class="n">language</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_language</span><span class="p">(</span><span class="n">language</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the default language of the document.</p>
 <p>(Also available as &ldquo;self.language&rdquo; property.)</p>
 <p>Arguments:</p>
@@ -41857,9 +41443,9 @@ <h3 id="odfdo.Meta.set_language" class="doc doc-heading">
 <pre><code>&gt;&gt;&gt; document.meta.set_language('fr-FR')
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">198</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">198</span>
 <span class="normal">199</span>
 <span class="normal">200</span>
 <span class="normal">201</span>
@@ -41905,24 +41491,22 @@ <h3 id="odfdo.Meta.set_language" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">language</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_statistic" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_statistic</span><span class="p">(</span><span class="n">statistic</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_statistic</span><span class="p">(</span><span class="n">statistic</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the statistics about a document.</p>
 <p>(Also available as &ldquo;self.statistic&rdquo; property.)</p>
 <p>Arguments:</p>
@@ -41939,9 +41523,9 @@ <h3 id="odfdo.Meta.set_statistic" class="doc doc-heading">
 &gt;&gt;&gt; document.meta.set_statistic(statistic)
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">697</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">697</span>
 <span class="normal">698</span>
 <span class="normal">699</span>
 <span class="normal">700</span>
@@ -41999,33 +41583,31 @@ <h3 id="odfdo.Meta.set_statistic" class="doc doc-heading">
             <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Statistic value must be a int&quot;</span><span class="p">)</span> <span class="kn">from</span> <span class="nn">e</span>
         <span class="n">element</span><span class="o">.</span><span class="n">set_attribute</span><span class="p">(</span><span class="n">to_str</span><span class="p">(</span><span class="n">key</span><span class="p">),</span> <span class="nb">str</span><span class="p">(</span><span class="n">ivalue</span><span class="p">))</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_subject" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_subject</span><span class="p">(</span><span class="n">subject</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_subject</span><span class="p">(</span><span class="n">subject</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the subject of the document.</p>
 <p>(Also available as &ldquo;self.subject&rdquo; property.)</p>
 <p>Arguments:</p>
 <pre><code>subject -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">154</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">154</span>
 <span class="normal">155</span>
 <span class="normal">156</span>
 <span class="normal">157</span>
@@ -42053,29 +41635,27 @@ <h3 id="odfdo.Meta.set_subject" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">subject</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_template" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_template</span><span class="p">(</span><span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_template</span><span class="p">(</span><span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the MetaTemplate <meta:template> element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">339</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">339</span>
 <span class="normal">340</span>
 <span class="normal">341</span>
 <span class="normal">342</span>
@@ -42099,24 +41679,22 @@ <h3 id="odfdo.Meta.set_template" class="doc doc-heading">
         <span class="n">current</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">template</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Meta.set_title" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_title</span><span class="p">(</span><span class="n">title</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_title</span><span class="p">(</span><span class="n">title</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the title of the document.</p>
 <p>This is not the first heading but the title metadata.</p>
 <p>(Also available as &ldquo;self.title&rdquo; property.)</p>
@@ -42124,9 +41702,9 @@ <h3 id="odfdo.Meta.set_title" class="doc doc-heading">
 <pre><code>title -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">69</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">69</span>
 <span class="normal">70</span>
 <span class="normal">71</span>
 <span class="normal">72</span>
@@ -42158,8 +41736,8 @@ <h3 id="odfdo.Meta.set_title" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">get_meta_body</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
     <span class="n">element</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">title</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -42167,8 +41745,7 @@ <h3 id="odfdo.Meta.set_title" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -42177,20 +41754,20 @@ <h3 id="odfdo.Meta.set_title" class="doc doc-heading">
 
 
 <h2 id="odfdo.MetaAutoReload" class="doc doc-heading">
-          <code>MetaAutoReload</code>
+            <code>MetaAutoReload</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/meta_auto_reload.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">32</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/meta_auto_reload.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
 <span class="normal">35</span>
@@ -42276,12 +41853,11 @@ <h2 id="odfdo.MetaAutoReload" class="doc doc-heading">
     <span class="k">def</span> <span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
         <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;(</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">href</span><span class="si">}</span><span class="s2">)&quot;</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -42294,15 +41870,14 @@ <h2 id="odfdo.MetaAutoReload" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.MetaAutoReload.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">delay</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">delay</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>The <meta:auto-reload> element specifies whether a document is
 reloaded or replaced by another document after a specified period
 of time has elapsed.</p>
@@ -42312,9 +41887,9 @@ <h3 id="odfdo.MetaAutoReload.__init__" class="doc doc-heading">
 href -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta_auto_reload.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">42</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta_auto_reload.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">42</span>
 <span class="normal">43</span>
 <span class="normal">44</span>
 <span class="normal">45</span>
@@ -42368,8 +41943,8 @@ <h3 id="odfdo.MetaAutoReload.__init__" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">delay</span> <span class="o">=</span> <span class="n">Duration</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">delay</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">href</span> <span class="o">=</span> <span class="n">href</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -42377,8 +41952,7 @@ <h3 id="odfdo.MetaAutoReload.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -42387,20 +41961,20 @@ <h3 id="odfdo.MetaAutoReload.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.MetaHyperlinkBehaviour" class="doc doc-heading">
-          <code>MetaHyperlinkBehaviour</code>
+            <code>MetaHyperlinkBehaviour</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/meta_hyperlink_behaviour.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/meta_hyperlink_behaviour.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
 <span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
@@ -42474,12 +42048,11 @@ <h2 id="odfdo.MetaHyperlinkBehaviour" class="doc doc-heading">
     <span class="k">def</span> <span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
         <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;(</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">target_frame_name</span><span class="si">}</span><span class="s2">)&quot;</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -42492,15 +42065,14 @@ <h2 id="odfdo.MetaHyperlinkBehaviour" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.MetaHyperlinkBehaviour.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">target_frame_name</span><span class="o">=</span><span class="s1">&#39;_blank&#39;</span><span class="p">,</span> <span class="n">show</span><span class="o">=</span><span class="s1">&#39;replace&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">target_frame_name</span><span class="o">=</span><span class="s1">&#39;_blank&#39;</span><span class="p">,</span> <span class="n">show</span><span class="o">=</span><span class="s1">&#39;replace&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>The <meta:hyperlink-behaviour> element specifies the default behavior
 for hyperlinks in a document.</p>
 <p>Arguments:</p>
@@ -42509,9 +42081,9 @@ <h3 id="odfdo.MetaHyperlinkBehaviour.__init__" class="doc doc-heading">
 show -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta_hyperlink_behaviour.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">37</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta_hyperlink_behaviour.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">37</span>
 <span class="normal">38</span>
 <span class="normal">39</span>
 <span class="normal">40</span>
@@ -42553,8 +42125,8 @@ <h3 id="odfdo.MetaHyperlinkBehaviour.__init__" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">target_frame_name</span> <span class="o">=</span> <span class="n">target_frame_name</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">show</span> <span class="o">=</span> <span class="n">show</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -42562,8 +42134,7 @@ <h3 id="odfdo.MetaHyperlinkBehaviour.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -42572,20 +42143,20 @@ <h3 id="odfdo.MetaHyperlinkBehaviour.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.MetaTemplate" class="doc doc-heading">
-          <code>MetaTemplate</code>
+            <code>MetaTemplate</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/meta_template.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">32</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/meta_template.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
 <span class="normal">35</span>
@@ -42681,12 +42252,11 @@ <h2 id="odfdo.MetaTemplate" class="doc doc-heading">
             <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;[</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">title</span><span class="si">}</span><span class="s2">](</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">href</span><span class="si">}</span><span class="s2">)&quot;</span>
         <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;(</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">href</span><span class="si">}</span><span class="s2">)&quot;</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -42699,15 +42269,14 @@ <h2 id="odfdo.MetaTemplate" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.MetaTemplate.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">href</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">title</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>The <meta:template> element specifies a IRI for the document template
 that was used to create a document. The IRI is specified as an
 Xlink.</p>
@@ -42719,9 +42288,9 @@ <h3 id="odfdo.MetaTemplate.__init__" class="doc doc-heading">
 title -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/meta_template.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">42</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/meta_template.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">42</span>
 <span class="normal">43</span>
 <span class="normal">44</span>
 <span class="normal">45</span>
@@ -42781,8 +42350,8 @@ <h3 id="odfdo.MetaTemplate.__init__" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">href</span> <span class="o">=</span> <span class="n">href</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">title</span> <span class="o">=</span> <span class="n">title</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -42790,8 +42359,7 @@ <h3 id="odfdo.MetaTemplate.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -42800,17 +42368,17 @@ <h3 id="odfdo.MetaTemplate.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.NamedRange" class="doc doc-heading">
-          <code>NamedRange</code>
+            <code>NamedRange</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF Named Range &ldquo;table:named-range&rdquo;. Identifies inside the spreadsheet
 a range of cells of a table by a name and the name of the table.</p>
 <p>Name Ranges have the following attributes:</p>
@@ -42827,9 +42395,9 @@ <h2 id="odfdo.NamedRange" class="doc doc-heading">
 usage -- None or str, usage of the named range.
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/table.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2964</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/table.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2964</span>
 <span class="normal">2965</span>
 <span class="normal">2966</span>
 <span class="normal">2967</span>
@@ -43367,9 +42935,9 @@ <h2 id="odfdo.NamedRange" class="doc doc-heading">
             <span class="n">style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span>
         <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -43384,8 +42952,8 @@ <h2 id="odfdo.NamedRange" class="doc doc-heading">
 
 
 <h3 id="odfdo.NamedRange.name" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -43394,28 +42962,26 @@ <h3 id="odfdo.NamedRange.name" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the name of the table.</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">crange</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">usage</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">crange</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">usage</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a Named Range element. &lsquo;name&rsquo; must contains only letters, digits
    and &lsquo;_&rsquo;, and must not be like a coordinate as &lsquo;A1&rsquo;. &lsquo;table_name&rsquo; must be
    a correct table name (no &ldquo;&rsquo;&rdquo; or &ldquo;/&rdquo; in it).</p>
@@ -43429,9 +42995,9 @@ <h3 id="odfdo.NamedRange.__init__" class="doc doc-heading">
  usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2985</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2985</span>
 <span class="normal">2986</span>
 <span class="normal">2987</span>
 <span class="normal">2988</span>
@@ -43521,30 +43087,28 @@ <h3 id="odfdo.NamedRange.__init__" class="doc doc-heading">
     <span class="n">crange</span> <span class="o">=</span> <span class="n">crange</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_set_range</span><span class="p">(</span><span class="n">crange</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.get_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to retrieve the value of the first cell of the named range.
 See table.get_value() for the arguments description and return format.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3174</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3174</span>
 <span class="normal">3175</span>
 <span class="normal">3176</span>
 <span class="normal">3177</span>
@@ -43566,30 +43130,28 @@ <h3 id="odfdo.NamedRange.get_value" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span>
     <span class="k">return</span> <span class="n">table</span><span class="o">.</span><span class="n">get_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">start</span><span class="p">,</span> <span class="n">get_type</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.get_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_values</span><span class="p">(</span><span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_values</span><span class="p">(</span><span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to retrieve the values of the cells of the named range. See
 table.get_values() for the arguments description and return format.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3156</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3156</span>
 <span class="normal">3157</span>
 <span class="normal">3158</span>
 <span class="normal">3159</span>
@@ -43623,24 +43185,22 @@ <h3 id="odfdo.NamedRange.get_values" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span>
     <span class="k">return</span> <span class="n">table</span><span class="o">.</span><span class="n">get_values</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">crange</span><span class="p">,</span> <span class="n">cell_type</span><span class="p">,</span> <span class="n">complete</span><span class="p">,</span> <span class="n">get_type</span><span class="p">,</span> <span class="n">flat</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.set_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_range</span><span class="p">(</span><span class="n">crange</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_range</span><span class="p">(</span><span class="n">crange</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the range of the named range. Range can be either one cell
 (like &lsquo;A1&rsquo;) or an area (&lsquo;A1:B2&rsquo;). It can be provided as an alpha numeric
 value like &ldquo;A1:B2&rsquo; or a tuple like (0, 0, 1, 1) or (0, 0).</p>
@@ -43648,9 +43208,9 @@ <h3 id="odfdo.NamedRange.set_range" class="doc doc-heading">
 <pre><code>crange -- str or tuple of int, cell or area coordinate
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3119</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3119</span>
 <span class="normal">3120</span>
 <span class="normal">3121</span>
 <span class="normal">3122</span>
@@ -43672,32 +43232,30 @@ <h3 id="odfdo.NamedRange.set_range" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_set_range</span><span class="p">(</span><span class="n">crange</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_attributes</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.set_table_name" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_table_name</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_table_name</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the name of the table of the Named Range. The name is mandatory.</p>
 <p>Arguments:</p>
 <pre><code>name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3098</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3098</span>
 <span class="normal">3099</span>
 <span class="normal">3100</span>
 <span class="normal">3101</span>
@@ -43715,24 +43273,22 @@ <h3 id="odfdo.NamedRange.set_table_name" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">table_name</span> <span class="o">=</span> <span class="n">_table_name_check</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_attributes</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.set_usage" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_usage</span><span class="p">(</span><span class="n">usage</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_usage</span><span class="p">(</span><span class="n">usage</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the usage of the Named Range. Usage can be None (default) or one
 of :
     &lsquo;print-range&rsquo;
@@ -43743,9 +43299,9 @@ <h3 id="odfdo.NamedRange.set_usage" class="doc doc-heading">
 <pre><code>usage -- None or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3031</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3031</span>
 <span class="normal">3032</span>
 <span class="normal">3033</span>
 <span class="normal">3034</span>
@@ -43791,30 +43347,28 @@ <h3 id="odfdo.NamedRange.set_usage" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">set_attribute</span><span class="p">(</span><span class="s2">&quot;table:range-usable-as&quot;</span><span class="p">,</span> <span class="n">usage</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">usage</span> <span class="o">=</span> <span class="n">usage</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.set_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the value of the first cell of the named range.
 See table.set_value() for the arguments description.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3210</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3210</span>
 <span class="normal">3211</span>
 <span class="normal">3212</span>
 <span class="normal">3213</span>
@@ -43860,30 +43414,28 @@ <h3 id="odfdo.NamedRange.set_value" class="doc doc-heading">
         <span class="n">style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.NamedRange.set_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the values of the cells of the named range.
 See table.set_values() for the arguments description.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3186</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">3186</span>
 <span class="normal">3187</span>
 <span class="normal">3188</span>
 <span class="normal">3189</span>
@@ -43929,8 +43481,8 @@ <h3 id="odfdo.NamedRange.set_values" class="doc doc-heading">
         <span class="n">currency</span><span class="o">=</span><span class="n">currency</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -43938,8 +43490,7 @@ <h3 id="odfdo.NamedRange.set_values" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -43948,17 +43499,17 @@ <h3 id="odfdo.NamedRange.set_values" class="doc doc-heading">
 
 
 <h2 id="odfdo.Note" class="doc doc-heading">
-          <code>Note</code>
+            <code>Note</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>Either a footnote or a endnote element with the given text,
 optionally referencing it using the given note_id.</p>
 <p>Arguments:</p>
@@ -43971,9 +43522,9 @@ <h2 id="odfdo.Note" class="doc doc-heading">
 body -- str or Element
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/note.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 58</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/note.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 58</span>
 <span class="normal"> 59</span>
 <span class="normal"> 60</span>
 <span class="normal"> 61</span>
@@ -44143,12 +43694,11 @@ <h2 id="odfdo.Note" class="doc doc-heading">
         <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">note_body</span><span class="p">:</span>
             <span class="k">pass</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -44159,10 +43709,10 @@ <h2 id="odfdo.Note" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -44171,24 +43721,24 @@ <h2 id="odfdo.Note" class="doc doc-heading">
 
 
 <h2 id="odfdo.Paragraph" class="doc doc-heading">
-          <code>Paragraph</code>
+            <code>Paragraph</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.paragraph_base.ParagraphBase">ParagraphBase</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.paragraph_base.ParagraphBase">ParagraphBase</span></code></p>
+
 
-  
       <p>Specialised element for paragraphs &ldquo;text:p&rdquo;. The &ldquo;text:p&rdquo; element
 represents a paragraph, which is the basic unit of text in an OpenDocument
 file.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">146</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">146</span>
 <span class="normal">147</span>
 <span class="normal">148</span>
 <span class="normal">149</span>
@@ -45488,12 +45038,11 @@ <h2 id="odfdo.Paragraph" class="doc doc-heading">
 
         <span class="k">return</span> <span class="n">bookmark</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -45506,15 +45055,14 @@ <h2 id="odfdo.Paragraph" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">text_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">text_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a paragraph element of the given style containing the optional
 given text.</p>
 <p>Arguments:</p>
@@ -45523,9 +45071,9 @@ <h3 id="odfdo.Paragraph.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">154</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">154</span>
 <span class="normal">155</span>
 <span class="normal">156</span>
 <span class="normal">157</span>
@@ -45571,24 +45119,22 @@ <h3 id="odfdo.Paragraph.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.insert_annotation" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_annotation</span><span class="p">(</span><span class="n">annotation_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">body</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_annotation</span><span class="p">(</span><span class="n">annotation_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">body</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert an annotation, at the position defined by the regex (before,
 after, content) or by positionnal argument (position). If content is
 provided, the annotation covers the full content regex. Else, the
@@ -45619,9 +45165,9 @@ <h3 id="odfdo.Paragraph.insert_annotation" class="doc doc-heading">
 date -- datetime
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">209</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">209</span>
 <span class="normal">210</span>
 <span class="normal">211</span>
 <span class="normal">212</span>
@@ -45865,24 +45411,22 @@ <h3 id="odfdo.Paragraph.insert_annotation" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="n">annotation_element</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.insert_annotation_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_annotation_end</span><span class="p">(</span><span class="n">annotation_element</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_annotation_end</span><span class="p">(</span><span class="n">annotation_element</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert an annotation end tag for an existing annotation. If some end
 tag already exists, replace it. Annotation end tag is set at the
 position defined by the regex (before or after).</p>
@@ -45898,9 +45442,9 @@ <h3 id="odfdo.Paragraph.insert_annotation_end" class="doc doc-heading">
 position -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">332</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">332</span>
 <span class="normal">333</span>
 <span class="normal">334</span>
 <span class="normal">335</span>
@@ -45988,24 +45532,22 @@ <h3 id="odfdo.Paragraph.insert_annotation_end" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="n">end_tag</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.insert_reference" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_reference</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">ref_format</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">display</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_reference</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">ref_format</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">display</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create and insert a reference to a content marked by a reference
 mark. The Reference element (&ldquo;text:reference-ref&rdquo;) represents a
 field that references a &ldquo;text:reference-mark-start&rdquo; or
@@ -46038,9 +45580,9 @@ <h3 id="odfdo.Paragraph.insert_reference" class="doc doc-heading">
 display -- str or None
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">623</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">623</span>
 <span class="normal">624</span>
 <span class="normal">625</span>
 <span class="normal">626</span>
@@ -46168,33 +45710,31 @@ <h3 id="odfdo.Paragraph.insert_reference" class="doc doc-heading">
             <span class="n">reference</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="n">before</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="n">after</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="n">position</span><span class="p">,</span> <span class="n">main_text</span><span class="o">=</span><span class="kc">True</span>
         <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.remove_link" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">remove_link</span><span class="p">(</span><span class="n">links</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">remove_link</span><span class="p">(</span><span class="n">links</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Send back a copy of the element (not a clone), with the sub links
    removed.</p>
 <p>Arguments:</p>
 <pre><code>links -- Link or list of Link
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">613</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">613</span>
 <span class="normal">614</span>
 <span class="normal">615</span>
 <span class="normal">616</span>
@@ -46212,29 +45752,27 @@ <h3 id="odfdo.Paragraph.remove_link" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">strip_elements</span><span class="p">(</span><span class="n">links</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.remove_links" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">remove_links</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">remove_links</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Send back a copy of the element, without links tags.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">608</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">608</span>
 <span class="normal">609</span>
 <span class="normal">610</span>
 <span class="normal">611</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">remove_links</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Element</span> <span class="o">|</span> <span class="nb">list</span><span class="p">:</span>
@@ -46242,32 +45780,30 @@ <h3 id="odfdo.Paragraph.remove_links" class="doc doc-heading">
     <span class="n">strip</span> <span class="o">=</span> <span class="p">(</span><span class="n">Link</span><span class="o">.</span><span class="n">_tag</span><span class="p">,)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">strip_tags</span><span class="p">(</span><span class="n">strip</span><span class="o">=</span><span class="n">strip</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.remove_span" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">remove_span</span><span class="p">(</span><span class="n">spans</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">remove_span</span><span class="p">(</span><span class="n">spans</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Send back a copy of the element, the spans (not a clone) removed.</p>
 <p>Arguments:</p>
 <pre><code>spans -- Element or list of Element
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">568</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">568</span>
 <span class="normal">569</span>
 <span class="normal">570</span>
 <span class="normal">571</span>
@@ -46283,31 +45819,29 @@ <h3 id="odfdo.Paragraph.remove_span" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">strip_elements</span><span class="p">(</span><span class="n">spans</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.remove_spans" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">remove_spans</span><span class="p">(</span><span class="n">keep_heading</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">remove_spans</span><span class="p">(</span><span class="n">keep_heading</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Send back a copy of the element, without span styles.
 If keep_heading is True (default), the first level heading style is left
 unchanged.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">556</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">556</span>
 <span class="normal">557</span>
 <span class="normal">558</span>
 <span class="normal">559</span>
@@ -46329,24 +45863,22 @@ <h3 id="odfdo.Paragraph.remove_spans" class="doc doc-heading">
         <span class="n">protect</span> <span class="o">=</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">strip_tags</span><span class="p">(</span><span class="n">strip</span><span class="o">=</span><span class="n">strip</span><span class="p">,</span> <span class="n">protect</span><span class="o">=</span><span class="n">protect</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.set_bookmark" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_bookmark</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">role</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_bookmark</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">role</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert a bookmark before or after the characters in the text which
 match the regex before/after. When the regex matches more of one part
 of the text, position can be set to choose which part must be used.
@@ -46380,9 +45912,9 @@ <h3 id="odfdo.Paragraph.set_bookmark" class="doc doc-heading">
 content -- str regex
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">688</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">688</span>
 <span class="normal">689</span>
 <span class="normal">690</span>
 <span class="normal">691</span>
@@ -46598,24 +46130,22 @@ <h3 id="odfdo.Paragraph.set_bookmark" class="doc doc-heading">
 
     <span class="k">return</span> <span class="n">bookmark</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.set_link" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_link</span><span class="p">(</span><span class="n">match</span><span class="p">,</span> <span class="n">tail</span><span class="p">,</span> <span class="n">url</span><span class="p">,</span> <span class="n">regex</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">offset</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_link</span><span class="p">(</span><span class="n">match</span><span class="p">,</span> <span class="n">tail</span><span class="p">,</span> <span class="n">url</span><span class="p">,</span> <span class="n">regex</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">offset</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>set_link(url, regex=None, offset=None, length=0)
 Make a link to the provided url from text content matching the regex
 OR the positional arguments offset and length.</p>
@@ -46630,9 +46160,9 @@ <h3 id="odfdo.Paragraph.set_link" class="doc doc-heading">
 length -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">577</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">577</span>
 <span class="normal">578</span>
 <span class="normal">579</span>
 <span class="normal">580</span>
@@ -46692,24 +46222,22 @@ <h3 id="odfdo.Paragraph.set_link" class="doc doc-heading">
     <span class="n">link</span><span class="o">.</span><span class="n">tail</span> <span class="o">=</span> <span class="n">tail</span>
     <span class="k">return</span> <span class="n">link</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.set_reference_mark" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_reference_mark</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_reference_mark</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert a reference mark, at the position defined by the regex
 (before, after, content) or by positionnal argument (position). If
 content is provided, the annotation covers the full range content regex
@@ -46736,9 +46264,9 @@ <h3 id="odfdo.Paragraph.set_reference_mark" class="doc doc-heading">
 </code></pre>
 <p>Return: the created ReferenceMark or ReferenceMarkStart</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">377</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">377</span>
 <span class="normal">378</span>
 <span class="normal">379</span>
 <span class="normal">380</span>
@@ -46938,24 +46466,22 @@ <h3 id="odfdo.Paragraph.set_reference_mark" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="n">reference</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.set_reference_mark_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_reference_mark_end</span><span class="p">(</span><span class="n">reference_mark</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_reference_mark_end</span><span class="p">(</span><span class="n">reference_mark</span><span class="p">,</span> <span class="n">before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert/move a ReferenceMarkEnd for an existing reference mark. If
 some end tag already exists, replace it. Reference tag is set at the
 position defined by the regex (before or after).</p>
@@ -46971,9 +46497,9 @@ <h3 id="odfdo.Paragraph.set_reference_mark_end" class="doc doc-heading">
 position -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">478</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">478</span>
 <span class="normal">479</span>
 <span class="normal">480</span>
 <span class="normal">481</span>
@@ -47059,24 +46585,22 @@ <h3 id="odfdo.Paragraph.set_reference_mark_end" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="n">end_tag</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Paragraph.set_span" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_span</span><span class="p">(</span><span class="n">match</span><span class="p">,</span> <span class="n">tail</span><span class="p">,</span> <span class="n">style</span><span class="p">,</span> <span class="n">regex</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">offset</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_span</span><span class="p">(</span><span class="n">match</span><span class="p">,</span> <span class="n">tail</span><span class="p">,</span> <span class="n">style</span><span class="p">,</span> <span class="n">regex</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">offset</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">length</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>set_span(style, regex=None, offset=None, length=0)
 Apply the given style to text content matching the regex OR the
 positional arguments offset and length.</p>
@@ -47091,9 +46615,9 @@ <h3 id="odfdo.Paragraph.set_span" class="doc doc-heading">
 length -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">525</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">525</span>
 <span class="normal">526</span>
 <span class="normal">527</span>
 <span class="normal">528</span>
@@ -47153,8 +46677,8 @@ <h3 id="odfdo.Paragraph.set_span" class="doc doc-heading">
     <span class="n">span</span><span class="o">.</span><span class="n">tail</span> <span class="o">=</span> <span class="n">tail</span>
     <span class="k">return</span> <span class="n">span</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -47162,8 +46686,7 @@ <h3 id="odfdo.Paragraph.set_span" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -47172,23 +46695,23 @@ <h3 id="odfdo.Paragraph.set_span" class="doc doc-heading">
 
 
 <h2 id="odfdo.Presentation" class="doc doc-heading">
-          <code>Presentation</code>
+            <code>Presentation</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Presentation, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">133</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">133</span>
 <span class="normal">134</span>
 <span class="normal">135</span>
 <span class="normal">136</span>
@@ -47204,12 +46727,11 @@ <h2 id="odfdo.Presentation" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -47220,10 +46742,10 @@ <h2 id="odfdo.Presentation" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -47232,17 +46754,17 @@ <h2 id="odfdo.Presentation" class="doc doc-heading">
 
 
 <h2 id="odfdo.RectangleShape" class="doc doc-heading">
-          <code>RectangleShape</code>
+            <code>RectangleShape</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><span title="odfdo.shapes.ShapeBase">ShapeBase</span></code></p>
+
 
-  
       <p>Create a rectangle shape.</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -47258,9 +46780,9 @@ <h2 id="odfdo.RectangleShape" class="doc doc-heading">
 size -- (str, str)
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/shapes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">145</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/shapes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">145</span>
 <span class="normal">146</span>
 <span class="normal">147</span>
 <span class="normal">148</span>
@@ -47346,12 +46868,11 @@ <h2 id="odfdo.RectangleShape" class="doc doc-heading">
         <span class="p">)</span>
         <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -47362,10 +46883,10 @@ <h2 id="odfdo.RectangleShape" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -47374,17 +46895,17 @@ <h2 id="odfdo.RectangleShape" class="doc doc-heading">
 
 
 <h2 id="odfdo.Reference" class="doc doc-heading">
-          <code>Reference</code>
+            <code>Reference</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>A reference to a content marked by a reference mark.
 The odf_reference element (&ldquo;text:reference-ref&rdquo;) represents a field that
 references a &ldquo;text:reference-mark-start&rdquo; or &ldquo;text:reference-mark&rdquo; element.
@@ -47430,9 +46951,9 @@ <h2 id="odfdo.Reference" class="doc doc-heading">
     the referenced item.
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/reference.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 58</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/reference.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 58</span>
 <span class="normal"> 59</span>
 <span class="normal"> 60</span>
 <span class="normal"> 61</span>
@@ -47688,12 +47209,11 @@ <h2 id="odfdo.Reference" class="doc doc-heading">
         <span class="c1"># we know it is a ReferenceMarkStart:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">reference</span><span class="o">.</span><span class="n">referenced_text</span><span class="p">()</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -47706,15 +47226,14 @@ <h2 id="odfdo.Reference" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Reference.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">ref_format</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">ref_format</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a reference to a content marked by a reference mark. An
 actual reference mark with the provided name should exist.</p>
 <p>Consider using: odfdo.paragraph.insert_reference()</p>
@@ -47732,9 +47251,9 @@ <h3 id="odfdo.Reference.__init__" class="doc doc-heading">
                 'number-all-superior', 'number-no-superior'.
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">123</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">123</span>
 <span class="normal">124</span>
 <span class="normal">125</span>
 <span class="normal">126</span>
@@ -47784,31 +47303,29 @@ <h3 id="odfdo.Reference.__init__" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">ref_format</span> <span class="o">=</span> <span class="n">ref_format</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Reference.update" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">update</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">update</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Update the content of the reference text field. Currently only
 &lsquo;text&rsquo; format is implemented. Other values, for example the &lsquo;page&rsquo; text
 field, may need to be refreshed through a visual ODF parser.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">168</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">168</span>
 <span class="normal">169</span>
 <span class="normal">170</span>
 <span class="normal">171</span>
@@ -47844,8 +47361,8 @@ <h3 id="odfdo.Reference.update" class="doc doc-heading">
     <span class="c1"># we know it is a ReferenceMarkStart:</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">reference</span><span class="o">.</span><span class="n">referenced_text</span><span class="p">()</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -47853,8 +47370,7 @@ <h3 id="odfdo.Reference.update" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -47863,24 +47379,24 @@ <h3 id="odfdo.Reference.update" class="doc doc-heading">
 
 
 <h2 id="odfdo.ReferenceMark" class="doc doc-heading">
-          <code>ReferenceMark</code>
+            <code>ReferenceMark</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>A point reference.
 A point reference marks a position in text and is represented by a single
 &ldquo;text:reference-mark&rdquo; element.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/reference.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">191</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/reference.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">191</span>
 <span class="normal">192</span>
 <span class="normal">193</span>
 <span class="normal">194</span>
@@ -47922,12 +47438,11 @@ <h2 id="odfdo.ReferenceMark" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -47940,15 +47455,14 @@ <h2 id="odfdo.ReferenceMark" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMark.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>A point reference. A point reference marks a position in text and is
 represented by a single &ldquo;text:reference-mark&rdquo; element.
 Consider using the wrapper: odfdo.paragraph.set_reference_mark()</p>
@@ -47956,9 +47470,9 @@ <h3 id="odfdo.ReferenceMark.__init__" class="doc doc-heading">
 <pre><code>name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">200</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">200</span>
 <span class="normal">201</span>
 <span class="normal">202</span>
 <span class="normal">203</span>
@@ -47982,8 +47496,8 @@ <h3 id="odfdo.ReferenceMark.__init__" class="doc doc-heading">
     <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -47991,8 +47505,7 @@ <h3 id="odfdo.ReferenceMark.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -48001,23 +47514,23 @@ <h3 id="odfdo.ReferenceMark.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.ReferenceMarkEnd" class="doc doc-heading">
-          <code>ReferenceMarkEnd</code>
+            <code>ReferenceMarkEnd</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The &ldquo;text:reference-mark-end&rdquo; element represents the end of a range
 reference.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/reference.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">217</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/reference.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">217</span>
 <span class="normal">218</span>
 <span class="normal">219</span>
 <span class="normal">220</span>
@@ -48081,12 +47594,11 @@ <h2 id="odfdo.ReferenceMarkEnd" class="doc doc-heading">
         <span class="n">result</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">x</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">xpath</span><span class="p">(</span><span class="n">request</span><span class="p">))</span>
         <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -48099,15 +47611,14 @@ <h2 id="odfdo.ReferenceMarkEnd" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMarkEnd.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>The &ldquo;text:reference-mark-end&rdquo; element represent the end of a range
 reference.
 Consider using the wrappers: odfdo.paragraph.set_reference_mark() and
@@ -48116,9 +47627,9 @@ <h3 id="odfdo.ReferenceMarkEnd.__init__" class="doc doc-heading">
 <pre><code>name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">225</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">225</span>
 <span class="normal">226</span>
 <span class="normal">227</span>
 <span class="normal">228</span>
@@ -48144,29 +47655,27 @@ <h3 id="odfdo.ReferenceMarkEnd.__init__" class="doc doc-heading">
     <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMarkEnd.referenced_text" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">referenced_text</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">referenced_text</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the text between reference-mark-start and reference-mark-end.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">239</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">239</span>
 <span class="normal">240</span>
 <span class="normal">241</span>
 <span class="normal">242</span>
@@ -48186,8 +47695,8 @@ <h3 id="odfdo.ReferenceMarkEnd.referenced_text" class="doc doc-heading">
     <span class="n">result</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">x</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">xpath</span><span class="p">(</span><span class="n">request</span><span class="p">))</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -48195,8 +47704,7 @@ <h3 id="odfdo.ReferenceMarkEnd.referenced_text" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -48205,23 +47713,23 @@ <h3 id="odfdo.ReferenceMarkEnd.referenced_text" class="doc doc-heading">
 
 
 <h2 id="odfdo.ReferenceMarkStart" class="doc doc-heading">
-          <code>ReferenceMarkStart</code>
+            <code>ReferenceMarkStart</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The &ldquo;text:reference-mark-start&rdquo; element represents the start of a
 range reference.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/reference.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">254</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/reference.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">254</span>
 <span class="normal">255</span>
 <span class="normal">256</span>
 <span class="normal">257</span>
@@ -48425,12 +47933,11 @@ <h2 id="odfdo.ReferenceMarkStart" class="doc doc-heading">
         <span class="c1"># act like normal delete</span>
         <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -48443,15 +47950,14 @@ <h2 id="odfdo.ReferenceMarkStart" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMarkStart.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>The &ldquo;text:reference-mark-start&rdquo; element represent the start of a range
 reference.
 Consider using the wrapper: odfdo.paragraph.set_reference_mark()</p>
@@ -48459,9 +47965,9 @@ <h3 id="odfdo.ReferenceMarkStart.__init__" class="doc doc-heading">
 <pre><code>name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">262</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">262</span>
 <span class="normal">263</span>
 <span class="normal">264</span>
 <span class="normal">265</span>
@@ -48485,24 +47991,22 @@ <h3 id="odfdo.ReferenceMarkStart.__init__" class="doc doc-heading">
     <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMarkStart.delete" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the given element from the XML tree. If no element is given,
 &ldquo;self&rdquo; is deleted. The XML library may allow to continue to use an
 element now &ldquo;orphan&rdquo; as long as you have a reference to it.</p>
@@ -48513,9 +48017,9 @@ <h3 id="odfdo.ReferenceMarkStart.delete" class="doc doc-heading">
 keep_tail -- boolean (default to True), True for most usages.
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">329</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">329</span>
 <span class="normal">330</span>
 <span class="normal">331</span>
 <span class="normal">332</span>
@@ -48569,24 +48073,22 @@ <h3 id="odfdo.ReferenceMarkStart.delete" class="doc doc-heading">
     <span class="c1"># act like normal delete</span>
     <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMarkStart.get_referenced" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_referenced</span><span class="p">(</span><span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">as_xml</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">as_list</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_referenced</span><span class="p">(</span><span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">as_xml</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">as_list</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the document content between the start and end tags of the
 reference. The content returned by this method can spread over several
 headers and paragraphs.
@@ -48608,9 +48110,9 @@ <h3 id="odfdo.ReferenceMarkStart.get_referenced" class="doc doc-heading">
            return a raw list of odf elements.
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">286</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">286</span>
 <span class="normal">287</span>
 <span class="normal">288</span>
 <span class="normal">289</span>
@@ -48694,29 +48196,27 @@ <h3 id="odfdo.ReferenceMarkStart.get_referenced" class="doc doc-heading">
     <span class="n">start</span> <span class="o">=</span> <span class="bp">self</span>
     <span class="k">return</span> <span class="n">_get_referenced</span><span class="p">(</span><span class="n">body</span><span class="p">,</span> <span class="n">start</span><span class="p">,</span> <span class="n">end</span><span class="p">,</span> <span class="n">no_header</span><span class="p">,</span> <span class="n">clean</span><span class="p">,</span> <span class="n">as_xml</span><span class="p">,</span> <span class="n">as_list</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.ReferenceMarkStart.referenced_text" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">referenced_text</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">referenced_text</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the text between reference-mark-start and reference-mark-end.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/reference.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">275</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/reference.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">275</span>
 <span class="normal">276</span>
 <span class="normal">277</span>
 <span class="normal">278</span>
@@ -48736,8 +48236,8 @@ <h3 id="odfdo.ReferenceMarkStart.referenced_text" class="doc doc-heading">
     <span class="n">result</span> <span class="o">=</span> <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">x</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">xpath</span><span class="p">(</span><span class="n">request</span><span class="p">))</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -48745,8 +48245,7 @@ <h3 id="odfdo.ReferenceMarkStart.referenced_text" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -48755,22 +48254,22 @@ <h3 id="odfdo.ReferenceMarkStart.referenced_text" class="doc doc-heading">
 
 
 <h2 id="odfdo.Row" class="doc doc-heading">
-          <code>Row</code>
+            <code>Row</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF table row &ldquo;table:table-row&rdquo;</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/row.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 51</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/row.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 51</span>
 <span class="normal"> 52</span>
 <span class="normal"> 53</span>
 <span class="normal"> 54</span>
@@ -50334,9 +49833,9 @@ <h2 id="odfdo.Row" class="doc doc-heading">
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="nb">all</span><span class="p">(</span><span class="n">cell</span><span class="o">.</span><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="n">aggressive</span><span class="p">)</span> <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_cells</span><span class="p">())</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -50351,8 +49850,8 @@ <h2 id="odfdo.Row" class="doc doc-heading">
 
 
 <h3 id="odfdo.Row.cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">cells</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Cell</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">cells</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Cell</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -50360,11 +49859,11 @@ <h3 id="odfdo.Row.cells" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of all cells.</p>
 <p>Return: list of Cell</p>
-  </div>
+    </div>
 
 </div>
 
@@ -50373,8 +49872,8 @@ <h3 id="odfdo.Row.cells" class="doc doc-heading">
 
 
 <h3 id="odfdo.Row.repeated" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">repeated</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">repeated</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -50383,12 +49882,12 @@ <h3 id="odfdo.Row.repeated" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the number of times the row is repeated.</p>
 <p>Always None when using the table API.</p>
 <p>Return: int or None</p>
-  </div>
+    </div>
 
 </div>
 
@@ -50397,8 +49896,8 @@ <h3 id="odfdo.Row.repeated" class="doc doc-heading">
 
 
 <h3 id="odfdo.Row.style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -50407,11 +49906,11 @@ <h3 id="odfdo.Row.style" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get /set the style of the row itself.</p>
 <p>Return: str</p>
-  </div>
+    </div>
 
 </div>
 
@@ -50420,8 +49919,8 @@ <h3 id="odfdo.Row.style" class="doc doc-heading">
 
 
 <h3 id="odfdo.Row.width" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">width</span><span class="p">:</span> <span class="nb">int</span></code>
-  
+            <code class="highlight language-python"><span class="n">width</span><span class="p">:</span> <span class="nb">int</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -50429,30 +49928,28 @@ <h3 id="odfdo.Row.width" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the number of expected cells in the row, i.e. addition
 repetitions.</p>
 <p>Return: int</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>create a Row, optionally filled with &ldquo;width&rdquo; number of cells.</p>
 <p>Rows contain cells, their number determine the number of columns.</p>
 <p>You don&rsquo;t generally have to create rows by hand, use the Table API.</p>
@@ -50464,9 +49961,9 @@ <h3 id="odfdo.Row.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">58</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">58</span>
 <span class="normal">59</span>
 <span class="normal">60</span>
 <span class="normal">61</span>
@@ -50546,24 +50043,22 @@ <h3 id="odfdo.Row.__init__" class="doc doc-heading">
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_compute_row_cache</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.append_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append_cell</span><span class="p">(</span><span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">_repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append_cell</span><span class="p">(</span><span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">_repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Append the given cell at the end of the row. Repeated cells are
 accepted. If no cell is given, an empty one is created.</p>
 <p>Do not use when working on a table, use Table.append_cell().</p>
@@ -50574,9 +50069,9 @@ <h3 id="odfdo.Row.append_cell" class="doc doc-heading">
 </code></pre>
 <p>returns the cell with x and y updated</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">543</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">543</span>
 <span class="normal">544</span>
 <span class="normal">545</span>
 <span class="normal">546</span>
@@ -50638,24 +50133,22 @@ <h3 id="odfdo.Row.append_cell" class="doc doc-heading">
     <span class="n">cell</span><span class="o">.</span><span class="n">y</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">y</span>
     <span class="k">return</span> <span class="n">cell</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.delete_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_cell</span><span class="p">(</span><span class="n">x</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete_cell</span><span class="p">(</span><span class="n">x</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the cell at the given position &ldquo;x&rdquo; starting from 0.
 Alphabetical positions like &ldquo;D&rdquo; are accepted.</p>
 <p>Cells on the right will be shifted to the left. In a table, other
@@ -50664,9 +50157,9 @@ <h3 id="odfdo.Row.delete_cell" class="doc doc-heading">
 <pre><code>x -- int or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">578</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">578</span>
 <span class="normal">579</span>
 <span class="normal">580</span>
 <span class="normal">581</span>
@@ -50696,33 +50189,31 @@ <h3 id="odfdo.Row.delete_cell" class="doc doc-heading">
         <span class="k">return</span>
     <span class="n">delete_item_in_vault</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="bp">self</span><span class="p">,</span> <span class="n">_xpath_cell_idx</span><span class="p">,</span> <span class="s2">&quot;_rmap&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.force_width" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">force_width</span><span class="p">(</span><span class="n">width</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">force_width</span><span class="p">(</span><span class="n">width</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Change the repeated property of the last cell of the row
 to comply with the required max width.</p>
 <p>Arguments:</p>
 <pre><code>width -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">800</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">800</span>
 <span class="normal">801</span>
 <span class="normal">802</span>
 <span class="normal">803</span>
@@ -50760,24 +50251,22 @@ <h3 id="odfdo.Row.force_width" class="doc doc-heading">
         <span class="n">cell</span><span class="o">.</span><span class="n">_set_repeated</span><span class="p">(</span><span class="n">repeated</span> <span class="o">-</span> <span class="n">delta</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_compute_row_cache</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.get_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the cell at position &ldquo;x&rdquo; starting from 0. Alphabetical
 positions like &ldquo;D&rdquo; are accepted.</p>
 <p>A  copy is returned, use set_cell() to push it back.</p>
@@ -50786,9 +50275,9 @@ <h3 id="odfdo.Row.get_cell" class="doc doc-heading">
 </code></pre>
 <p>Return: Cell | None</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">385</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">385</span>
 <span class="normal">386</span>
 <span class="normal">387</span>
 <span class="normal">388</span>
@@ -50826,24 +50315,22 @@ <h3 id="odfdo.Row.get_cell" class="doc doc-heading">
     <span class="n">cell</span><span class="o">.</span><span class="n">x</span> <span class="o">=</span> <span class="n">x</span>
     <span class="k">return</span> <span class="n">cell</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.get_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_cells</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_cells</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of cells matching the criteria.</p>
 <p>Filter by cell_type, with cell_type &lsquo;all&rsquo; will retrieve cells of any
 type, aka non empty cells.</p>
@@ -50861,9 +50348,9 @@ <h3 id="odfdo.Row.get_cells" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Cell</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">304</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">304</span>
 <span class="normal">305</span>
 <span class="normal">306</span>
 <span class="normal">307</span>
@@ -50965,32 +50452,30 @@ <h3 id="odfdo.Row.get_cells" class="doc doc-heading">
         <span class="n">cells</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cell</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cells</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.get_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the value of the cell at position &ldquo;x&rdquo;.
 If get_type is True, returns the tuples (value, ODF type).</p>
 <p>If the cell is empty, returns None or (None, None)</p>
 <p>See get_cell() and Cell.get_value().</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">405</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">405</span>
 <span class="normal">406</span>
 <span class="normal">407</span>
 <span class="normal">408</span>
@@ -51036,24 +50521,22 @@ <h3 id="odfdo.Row.get_value" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="n">cell</span><span class="o">.</span><span class="n">get_value</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.get_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_values</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_values</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the cell values in this row.</p>
 <p>Filter by cell_type, with cell_type &lsquo;all&rsquo; will retrieve cells of any
 type, aka non empty cells.
@@ -51079,9 +50562,9 @@ <h3 id="odfdo.Row.get_values" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Python types, or list of tuples.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">594</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">594</span>
 <span class="normal">595</span>
 <span class="normal">596</span>
 <span class="normal">597</span>
@@ -51207,24 +50690,22 @@ <h3 id="odfdo.Row.get_values" class="doc doc-heading">
             <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="n">x</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="n">z</span><span class="p">)</span>
         <span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.insert_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert the given cell at position &ldquo;x&rdquo; starting from 0. If no cell
 is given, an empty one is created.</p>
 <p>Alphabetical positions like &ldquo;D&rdquo; are accepted.</p>
@@ -51236,9 +50717,9 @@ <h3 id="odfdo.Row.insert_cell" class="doc doc-heading">
 </code></pre>
 <p>returns the cell with x and y updated</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">498</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">498</span>
 <span class="normal">499</span>
 <span class="normal">500</span>
 <span class="normal">501</span>
@@ -51314,24 +50795,22 @@ <h3 id="odfdo.Row.insert_cell" class="doc doc-heading">
         <span class="n">cell_back</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">append_cell</span><span class="p">(</span><span class="n">cell</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="n">clone</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cell_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.is_empty" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return whether every cell in the row has no value or the value
 evaluates to False (empty string), and no style.</p>
 <p>If aggressive is True, empty cells with style are considered empty.</p>
@@ -51340,9 +50819,9 @@ <h3 id="odfdo.Row.is_empty" class="doc doc-heading">
 </code></pre>
 <p>Return: bool</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">820</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">820</span>
 <span class="normal">821</span>
 <span class="normal">822</span>
 <span class="normal">823</span>
@@ -51368,30 +50847,28 @@ <h3 id="odfdo.Row.is_empty" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="nb">all</span><span class="p">(</span><span class="n">cell</span><span class="o">.</span><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="n">aggressive</span><span class="p">)</span> <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_cells</span><span class="p">())</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.last_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">last_cell</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">last_cell</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the las cell of the row.</p>
 <p>Return Cell | None</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">790</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">790</span>
 <span class="normal">791</span>
 <span class="normal">792</span>
 <span class="normal">793</span>
@@ -51409,31 +50886,29 @@ <h3 id="odfdo.Row.last_cell" class="doc doc-heading">
     <span class="k">except</span> <span class="ne">IndexError</span><span class="p">:</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.minimized_width" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">minimized_width</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">minimized_width</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the length of the row if the last repeated sequence is
 reduced to one.</p>
 <p>Return: int</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">769</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">769</span>
 <span class="normal">770</span>
 <span class="normal">771</span>
 <span class="normal">772</span>
@@ -51473,24 +50948,22 @@ <h3 id="odfdo.Row.minimized_width" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_indexes</span><span class="p">[</span><span class="s2">&quot;_rmap&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
     <span class="k">return</span> <span class="n">min_width</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.rstrip" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">rstrip</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">rstrip</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove <em>in-place</em> empty cells at the right of the row. An empty
 cell has no value but can have style. If &ldquo;aggressive&rdquo; is True, style
 is ignored.</p>
@@ -51498,9 +50971,9 @@ <h3 id="odfdo.Row.rstrip" class="doc doc-heading">
 <pre><code>aggressive -- bool
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">740</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">740</span>
 <span class="normal">741</span>
 <span class="normal">742</span>
 <span class="normal">743</span>
@@ -51530,24 +51003,22 @@ <h3 id="odfdo.Row.rstrip" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_compute_row_cache</span><span class="p">()</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_indexes</span><span class="p">[</span><span class="s2">&quot;_rmap&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.set_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Push the cell back in the row at position &ldquo;x&rdquo; starting from 0.
 Alphabetical positions like &ldquo;D&rdquo; are accepted.</p>
 <p>Arguments:</p>
@@ -51555,9 +51026,9 @@ <h3 id="odfdo.Row.set_cell" class="doc doc-heading">
 </code></pre>
 <p>returns the cell with x and y updated</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">429</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">429</span>
 <span class="normal">430</span>
 <span class="normal">431</span>
 <span class="normal">432</span>
@@ -51631,24 +51102,22 @@ <h3 id="odfdo.Row.set_cell" class="doc doc-heading">
         <span class="n">cell_back</span> <span class="o">=</span> <span class="n">cell</span>
     <span class="k">return</span> <span class="n">cell_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.set_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_cells</span><span class="p">(</span><span class="n">cells</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_cells</span><span class="p">(</span><span class="n">cells</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the cells in the row, from the &lsquo;start&rsquo; column.
 This method does not clear the row, use row.clear() before to start
 with an empty row.</p>
@@ -51658,9 +51127,9 @@ <h3 id="odfdo.Row.set_cells" class="doc doc-heading">
 start -- int or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">658</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">658</span>
 <span class="normal">659</span>
 <span class="normal">660</span>
 <span class="normal">661</span>
@@ -51726,24 +51195,22 @@ <h3 id="odfdo.Row.set_cells" class="doc doc-heading">
             <span class="k">else</span><span class="p">:</span>
                 <span class="n">x</span> <span class="o">+=</span> <span class="mi">1</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.set_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the value of the cell at position &ldquo;x&rdquo;.</p>
 <p>Arguments:</p>
 <pre><code>x -- int or str
@@ -51759,9 +51226,9 @@ <h3 id="odfdo.Row.set_value" class="doc doc-heading">
 </code></pre>
 <p>See get_cell() and Cell.get_value().</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">467</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">467</span>
 <span class="normal">468</span>
 <span class="normal">469</span>
 <span class="normal">470</span>
@@ -51821,24 +51288,22 @@ <h3 id="odfdo.Row.set_value" class="doc doc-heading">
         <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.set_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the value of cells in the row, from the &lsquo;start&rsquo;
 column vith values.
 This method does not clear the row, use row.clear() before to start
@@ -51856,9 +51321,9 @@ <h3 id="odfdo.Row.set_values" class="doc doc-heading">
 style -- cell style
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">692</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">692</span>
 <span class="normal">693</span>
 <span class="normal">694</span>
 <span class="normal">695</span>
@@ -51952,24 +51417,22 @@ <h3 id="odfdo.Row.set_values" class="doc doc-heading">
             <span class="p">)</span>
             <span class="n">x</span> <span class="o">+=</span> <span class="mi">1</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Row.traverse" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">traverse</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">traverse</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Yield as many cell elements as expected cells in the row, i.e.
 expand repetitions by returning the same cell as many times as
 necessary.</p>
@@ -51981,9 +51444,9 @@ <h3 id="odfdo.Row.traverse" class="doc doc-heading">
 </code></pre>
 <p>Copies are returned, use set_cell() to push them back.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/row.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">218</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/row.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">218</span>
 <span class="normal">219</span>
 <span class="normal">220</span>
 <span class="normal">221</span>
@@ -52153,8 +51616,8 @@ <h3 id="odfdo.Row.traverse" class="doc doc-heading">
                     <span class="n">x</span> <span class="o">+=</span> <span class="mi">1</span>
                     <span class="k">yield</span> <span class="n">cell</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -52162,8 +51625,7 @@ <h3 id="odfdo.Row.traverse" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -52172,22 +51634,22 @@ <h3 id="odfdo.Row.traverse" class="doc doc-heading">
 
 
 <h2 id="odfdo.RowGroup" class="doc doc-heading">
-          <code>RowGroup</code>
+            <code>RowGroup</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>&ldquo;table:table-row-group&rdquo; group rows with common properties.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/table.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">140</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/table.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">140</span>
 <span class="normal">141</span>
 <span class="normal">142</span>
 <span class="normal">143</span>
@@ -52245,12 +51707,11 @@ <h2 id="odfdo.RowGroup" class="doc doc-heading">
                 <span class="n">row</span> <span class="o">=</span> <span class="n">Row</span><span class="p">(</span><span class="n">width</span><span class="o">=</span><span class="n">width</span><span class="p">)</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -52263,15 +51724,14 @@ <h2 id="odfdo.RowGroup" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.RowGroup.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a group of rows, optionnaly filled with &ldquo;height&rdquo; number of
 rows, of &ldquo;width&rdquo; cells each.</p>
 <p>Row group bear style information applied to a series of rows.</p>
@@ -52281,9 +51741,9 @@ <h3 id="odfdo.RowGroup.__init__" class="doc doc-heading">
 width -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">147</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">147</span>
 <span class="normal">148</span>
 <span class="normal">149</span>
 <span class="normal">150</span>
@@ -52327,8 +51787,8 @@ <h3 id="odfdo.RowGroup.__init__" class="doc doc-heading">
             <span class="n">row</span> <span class="o">=</span> <span class="n">Row</span><span class="p">(</span><span class="n">width</span><span class="o">=</span><span class="n">width</span><span class="p">)</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -52336,8 +51796,7 @@ <h3 id="odfdo.RowGroup.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -52346,17 +51805,17 @@ <h3 id="odfdo.RowGroup.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Section" class="doc doc-heading">
-          <code>Section</code>
+            <code>Section</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF section &ldquo;text:section&rdquo;</p>
 <p>Arguments:</p>
 <pre><code>style -- str
@@ -52364,9 +51823,9 @@ <h2 id="odfdo.Section" class="doc doc-heading">
 name -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/section.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">31</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/section.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
 <span class="normal">34</span>
@@ -52432,12 +51891,11 @@ <h2 id="odfdo.Section" class="doc doc-heading">
         <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
         <span class="k">return</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -52448,10 +51906,10 @@ <h2 id="odfdo.Section" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -52460,26 +51918,26 @@ <h2 id="odfdo.Section" class="doc doc-heading">
 
 
 <h2 id="odfdo.Spacer" class="doc doc-heading">
-          <code>Spacer</code>
+            <code>Spacer</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>This element shall be used to represent the second and all following “ “
 (U+0020, SPACE) characters in a sequence of “ “ (U+0020, SPACE) characters.
 Note: It is not an error if the character preceding the element is not a
 white space character, but it is good practice to use this element only for
 the second and all following SPACE characters in a sequence.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">168</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">168</span>
 <span class="normal">169</span>
 <span class="normal">170</span>
 <span class="normal">171</span>
@@ -52519,12 +51977,11 @@ <h2 id="odfdo.Spacer" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">number</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">number</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -52537,22 +51994,21 @@ <h2 id="odfdo.Spacer" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Spacer.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">number</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">number</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Arguments:</p>
 <pre><code>number -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">179</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">179</span>
 <span class="normal">180</span>
 <span class="normal">181</span>
 <span class="normal">182</span>
@@ -52570,8 +52026,8 @@ <h3 id="odfdo.Spacer.__init__" class="doc doc-heading">
     <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">number</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">number</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -52579,8 +52035,7 @@ <h3 id="odfdo.Spacer.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -52589,23 +52044,23 @@ <h3 id="odfdo.Spacer.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Span" class="doc doc-heading">
-          <code>Span</code>
+            <code>Span</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.paragraph.Paragraph" href="#odfdo.Paragraph">Paragraph</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.paragraph.Paragraph" href="#odfdo.Paragraph">Paragraph</a></code></p>
+
 
-  
       <p>Create a span element &ldquo;text:span&rdquo; of the given style containing the optional
 given text.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">798</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">798</span>
 <span class="normal">799</span>
 <span class="normal">800</span>
 <span class="normal">801</span>
@@ -52665,12 +52120,11 @@ <h2 id="odfdo.Span" class="doc doc-heading">
             <span class="k">if</span> <span class="n">style</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -52683,24 +52137,23 @@ <h2 id="odfdo.Span" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Span.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">text</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Arguments:</p>
 <pre><code>text -- str
 
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">809</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">809</span>
 <span class="normal">810</span>
 <span class="normal">811</span>
 <span class="normal">812</span>
@@ -52738,8 +52191,8 @@ <h3 id="odfdo.Span.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">style</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -52747,8 +52200,7 @@ <h3 id="odfdo.Span.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -52757,23 +52209,23 @@ <h3 id="odfdo.Span.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.Spreadsheet" class="doc doc-heading">
-          <code>Spreadsheet</code>
+            <code>Spreadsheet</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Spreadsheet, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">143</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">143</span>
 <span class="normal">144</span>
 <span class="normal">145</span>
 <span class="normal">146</span>
@@ -52789,12 +52241,11 @@ <h2 id="odfdo.Spreadsheet" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -52805,10 +52256,10 @@ <h2 id="odfdo.Spreadsheet" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -52817,17 +52268,17 @@ <h2 id="odfdo.Spreadsheet" class="doc doc-heading">
 
 
 <h2 id="odfdo.Style" class="doc doc-heading">
-          <code>Style</code>
+            <code>Style</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>Style class for all these tags:</p>
 <p>&lsquo;style:style&rsquo;
 &lsquo;number:date-style&rsquo;,
@@ -52843,9 +52294,9 @@ <h2 id="odfdo.Style" class="doc doc-heading">
 &lsquo;style:tab-stops&rsquo;,
 &hellip;</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/style.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">284</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/style.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">284</span>
 <span class="normal">285</span>
 <span class="normal">286</span>
 <span class="normal">287</span>
@@ -54263,12 +53714,11 @@ <h2 id="odfdo.Style" class="doc doc-heading">
             <span class="bp">self</span><span class="o">.</span><span class="n">font_family_generic</span> <span class="o">=</span> <span class="n">family_generic</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">font_pitch</span> <span class="o">=</span> <span class="n">pitch</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -54281,15 +53731,14 @@ <h2 id="odfdo.Style" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">parent_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">background_color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">italic</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">bold</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">master_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">page_layout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">next_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">data_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">shadow</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">use_optimal_height</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">break_before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">break_after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">min_height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_family</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_family_generic</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_pitch</span><span class="o">=</span><span class="s1">&#39;variable&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">parent_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">background_color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">italic</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">bold</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">master_page</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">page_layout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">next_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">data_style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">shadow</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">use_optimal_height</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">break_before</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">break_after</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">min_height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_family</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_family_generic</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">font_pitch</span><span class="o">=</span><span class="s1">&#39;variable&#39;</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a style of the given family. The name is not mandatory at this
 point but will become required when inserting in a document as a common
 style.</p>
@@ -54347,9 +53796,9 @@ <h3 id="odfdo.Style.__init__" class="doc doc-heading">
 break_after -- 'page', 'column' or 'auto'
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">323</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">323</span>
 <span class="normal">324</span>
 <span class="normal">325</span>
 <span class="normal">326</span>
@@ -54791,24 +54240,22 @@ <h3 id="odfdo.Style.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">kwargs</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">set_properties</span><span class="p">(</span><span class="n">kwargs</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="n">area</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.del_properties" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">del_properties</span><span class="p">(</span><span class="n">properties</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">del_properties</span><span class="p">(</span><span class="n">properties</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the given properties, either by list argument or
 positional argument (or both). Remove only from the given area,
 identical to the style family by default.</p>
@@ -54818,9 +54265,9 @@ <h3 id="odfdo.Style.del_properties" class="doc doc-heading">
 area -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">632</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">632</span>
 <span class="normal">633</span>
 <span class="normal">634</span>
 <span class="normal">635</span>
@@ -54872,30 +54319,28 @@ <h3 id="odfdo.Style.del_properties" class="doc doc-heading">
     <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">_expand_properties_list</span><span class="p">(</span><span class="n">properties</span><span class="p">):</span>
         <span class="n">element</span><span class="o">.</span><span class="n">del_attribute</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.get_page_footer" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_page_footer</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_page_footer</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the element that contains the footer contents.</p>
 <p>If None, no footer was set.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">948</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">948</span>
 <span class="normal">949</span>
 <span class="normal">950</span>
 <span class="normal">951</span>
@@ -54911,30 +54356,28 @@ <h3 id="odfdo.Style.get_page_footer" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_element</span><span class="p">(</span><span class="s2">&quot;style:footer&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.get_page_header" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_page_header</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_page_header</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the element that contains the header contents.</p>
 <p>If None, no header was set.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">921</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">921</span>
 <span class="normal">922</span>
 <span class="normal">923</span>
 <span class="normal">924</span>
@@ -54950,24 +54393,22 @@ <h3 id="odfdo.Style.get_page_header" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_element</span><span class="p">(</span><span class="s2">&quot;style:header&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.get_properties" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_properties</span><span class="p">(</span><span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_properties</span><span class="p">(</span><span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the mapping of all properties of this style. By default the
 properties of the same family, e.g. a paragraph style and its
 paragraph properties. Specify the area to get the text properties of
@@ -54977,9 +54418,9 @@ <h3 id="odfdo.Style.get_properties" class="doc doc-heading">
 </code></pre>
 <p>Return: dict</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">559</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">559</span>
 <span class="normal">560</span>
 <span class="normal">561</span>
 <span class="normal">562</span>
@@ -55023,24 +54464,22 @@ <h3 id="odfdo.Style.get_properties" class="doc doc-heading">
         <span class="n">properties</span><span class="p">[</span><span class="n">child</span><span class="o">.</span><span class="n">tag</span><span class="p">]</span> <span class="o">=</span> <span class="n">child</span><span class="o">.</span><span class="n">attributes</span>
     <span class="k">return</span> <span class="n">properties</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.set_background" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_background</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="s1">&#39;center&#39;</span><span class="p">,</span> <span class="n">repeat</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">opacity</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">filter</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_background</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">position</span><span class="o">=</span><span class="s1">&#39;center&#39;</span><span class="p">,</span> <span class="n">repeat</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">opacity</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="nb">filter</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the background color of a text style, or the background color
 or image of a paragraph style or page layout.</p>
 <p>With no argument, remove any existing background.</p>
@@ -55065,9 +54504,9 @@ <h3 id="odfdo.Style.set_background" class="doc doc-heading">
 filter -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">659</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">659</span>
 <span class="normal">660</span>
 <span class="normal">661</span>
 <span class="normal">662</span>
@@ -55247,24 +54686,22 @@ <h3 id="odfdo.Style.set_background" class="doc doc-heading">
         <span class="k">if</span> <span class="nb">filter</span><span class="p">:</span>
             <span class="n">bg_image</span><span class="o">.</span><span class="n">filter</span> <span class="o">=</span> <span class="nb">filter</span>  <span class="c1"># type:ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.set_level_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_level_style</span><span class="p">(</span><span class="n">level</span><span class="p">,</span> <span class="n">num_format</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">bullet_char</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_levels</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">prefix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">suffix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start_value</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_level_style</span><span class="p">(</span><span class="n">level</span><span class="p">,</span> <span class="n">num_format</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">bullet_char</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_levels</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">prefix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">suffix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">start_value</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Arguments:</p>
 <pre><code>level -- int
 
@@ -55287,13 +54724,14 @@ <h3 id="odfdo.Style.set_level_style" class="doc doc-heading">
 clone -- List Style
 </code></pre>
 
+
 <details class="return" open>
   <summary>Return</summary>
   <p>level_style created</p>
 </details>
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">762</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">762</span>
 <span class="normal">763</span>
 <span class="normal">764</span>
 <span class="normal">765</span>
@@ -55479,24 +54917,22 @@ <h3 id="odfdo.Style.set_level_style" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">level_style</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">level_style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.set_page_footer" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_page_footer</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_page_footer</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create or replace the footer by the given content. It can already
 be a complete footer.</p>
 <p>If you only want to update the existing footer, get it and use the
@@ -55505,9 +54941,9 @@ <h3 id="odfdo.Style.set_page_footer" class="doc doc-heading">
 <pre><code>text_or_element -- str or Element or a list of them
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">957</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">957</span>
 <span class="normal">958</span>
 <span class="normal">959</span>
 <span class="normal">960</span>
@@ -55541,24 +54977,22 @@ <h3 id="odfdo.Style.set_page_footer" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_set_header_or_footer</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;footer&quot;</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="s2">&quot;Footer&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.set_page_header" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_page_header</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_page_header</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create or replace the header by the given content. It can already
 be a complete header.</p>
 <p>If you only want to update the existing header, get it and use the
@@ -55567,9 +55001,9 @@ <h3 id="odfdo.Style.set_page_header" class="doc doc-heading">
 <pre><code>text_or_element -- str or Element or a list of them
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">930</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">930</span>
 <span class="normal">931</span>
 <span class="normal">932</span>
 <span class="normal">933</span>
@@ -55603,24 +55037,22 @@ <h3 id="odfdo.Style.set_page_header" class="doc doc-heading">
         <span class="k">return</span> <span class="kc">None</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_set_header_or_footer</span><span class="p">(</span><span class="n">text_or_element</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Style.set_properties" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_properties</span><span class="p">(</span><span class="n">properties</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_properties</span><span class="p">(</span><span class="n">properties</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">area</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the properties of the &ldquo;area&rdquo; type of this style. Properties
 are given either as a dict or as named arguments (or both). The area
 is identical to the style family by default. If the properties
@@ -55635,9 +55067,9 @@ <h3 id="odfdo.Style.set_properties" class="doc doc-heading">
 area -- 'paragraph', 'text'...
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">582</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">582</span>
 <span class="normal">583</span>
 <span class="normal">584</span>
 <span class="normal">585</span>
@@ -55735,8 +55167,8 @@ <h3 id="odfdo.Style.set_properties" class="doc doc-heading">
         <span class="k">else</span><span class="p">:</span>
             <span class="k">pass</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -55744,8 +55176,7 @@ <h3 id="odfdo.Style.set_properties" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -55754,20 +55185,20 @@ <h3 id="odfdo.Style.set_properties" class="doc doc-heading">
 
 
 <h2 id="odfdo.Styles" class="doc doc-heading">
-          <code>Styles</code>
+            <code>Styles</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.xmlpart.XmlPart" href="#odfdo.XmlPart">XmlPart</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/styles.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 57</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/styles.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 57</span>
 <span class="normal"> 58</span>
 <span class="normal"> 59</span>
 <span class="normal"> 60</span>
@@ -55947,12 +55378,11 @@ <h2 id="odfdo.Styles" class="doc doc-heading">
         <span class="k">except</span> <span class="ne">IndexError</span><span class="p">:</span>
             <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -55965,15 +55395,14 @@ <h2 id="odfdo.Styles" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Styles.get_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_style</span><span class="p">(</span><span class="n">family</span><span class="p">,</span> <span class="n">name_or_element</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the style uniquely identified by the name/family pair. If
 the argument is already a style object, it will return it.</p>
 <p>If the name is None, the default style is fetched.</p>
@@ -55989,9 +55418,9 @@ <h3 id="odfdo.Styles.get_style" class="doc doc-heading">
 </code></pre>
 <p>Return: odf_style or None if not found</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/styles.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">100</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/styles.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">100</span>
 <span class="normal">101</span>
 <span class="normal">102</span>
 <span class="normal">103</span>
@@ -56063,24 +55492,22 @@ <h3 id="odfdo.Styles.get_style" class="doc doc-heading">
             <span class="k">return</span> <span class="n">style</span>  <span class="c1"># type: ignore</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Styles.get_styles" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_styles</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">automatic</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_styles</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">automatic</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the list of styles in the Content part, optionally limited
 to the given family, optionaly limited to automatic styles.</p>
 <p>Arguments:</p>
@@ -56090,9 +55517,9 @@ <h3 id="odfdo.Styles.get_styles" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Style</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/styles.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">77</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/styles.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">77</span>
 <span class="normal">78</span>
 <span class="normal">79</span>
 <span class="normal">80</span>
@@ -56136,8 +55563,8 @@ <h3 id="odfdo.Styles.get_styles" class="doc doc-heading">
         <span class="n">result</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">get_styles</span><span class="p">(</span><span class="n">family</span><span class="o">=</span><span class="n">family</span><span class="p">))</span>
     <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -56145,8 +55572,7 @@ <h3 id="odfdo.Styles.get_styles" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -56155,17 +55581,17 @@ <h3 id="odfdo.Styles.get_styles" class="doc doc-heading">
 
 
 <h2 id="odfdo.TOC" class="doc doc-heading">
-          <code>TOC</code>
+            <code>TOC</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>Table of content.
 The &ldquo;text:table-of-content&rdquo; element represents a table of contents for a
 document. The items that can be listed in a table of contents are:
@@ -56198,9 +55624,9 @@ <h2 id="odfdo.TOC" class="doc doc-heading">
 entry_style -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/toc.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">167</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/toc.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">167</span>
 <span class="normal">168</span>
 <span class="normal">169</span>
 <span class="normal">170</span>
@@ -56748,12 +56174,11 @@ <h2 id="odfdo.TOC" class="doc doc-heading">
                 <span class="n">paragraph</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">_toc_entry_style_name</span><span class="p">(</span><span class="n">level</span><span class="p">)</span>
             <span class="n">index_body</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">paragraph</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -56766,15 +56191,14 @@ <h2 id="odfdo.TOC" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TOC.fill" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">fill</span><span class="p">(</span><span class="n">document</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">use_default_styles</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">fill</span><span class="p">(</span><span class="n">document</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">use_default_styles</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Fill the TOC with the titles found in the document. A TOC is not
 contextual so it will catch all titles before and after its insertion.
 If the TOC is not attached to a document, attach it beforehand or
@@ -56786,9 +56210,9 @@ <h3 id="odfdo.TOC.fill" class="doc doc-heading">
 use_default_styles -- bool
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/toc.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">376</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/toc.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">376</span>
 <span class="normal">377</span>
 <span class="normal">378</span>
 <span class="normal">379</span>
@@ -56918,8 +56342,8 @@ <h3 id="odfdo.TOC.fill" class="doc doc-heading">
             <span class="n">paragraph</span><span class="o">.</span><span class="n">style</span> <span class="o">=</span> <span class="n">_toc_entry_style_name</span><span class="p">(</span><span class="n">level</span><span class="p">)</span>
         <span class="n">index_body</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">paragraph</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -56927,8 +56351,7 @@ <h3 id="odfdo.TOC.fill" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -56937,17 +56360,17 @@ <h3 id="odfdo.TOC.fill" class="doc doc-heading">
 
 
 <h2 id="odfdo.Tab" class="doc doc-heading">
-          <code>Tab</code>
+            <code>Tab</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>This element represents the [UNICODE] tab character (HORIZONTAL
 TABULATION, U+0009).</p>
 <p>The position attribute contains the number of the tab-stop to which
@@ -56957,9 +56380,9 @@ <h2 id="odfdo.Tab" class="doc doc-heading">
 oriented consumers should determine the tab positions based on the style
 information</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">193</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">193</span>
 <span class="normal">194</span>
 <span class="normal">195</span>
 <span class="normal">196</span>
@@ -57007,12 +56430,11 @@ <h2 id="odfdo.Tab" class="doc doc-heading">
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span> <span class="ow">and</span> <span class="n">position</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">position</span> <span class="o">&gt;=</span> <span class="mi">0</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">position</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">position</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -57025,22 +56447,21 @@ <h2 id="odfdo.Tab" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Tab.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">position</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Arguments:</p>
 <pre><code>position -- int
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">208</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph_base.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">208</span>
 <span class="normal">209</span>
 <span class="normal">210</span>
 <span class="normal">211</span>
@@ -57058,8 +56479,8 @@ <h3 id="odfdo.Tab.__init__" class="doc doc-heading">
     <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_do_init</span> <span class="ow">and</span> <span class="n">position</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">position</span> <span class="o">&gt;=</span> <span class="mi">0</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">position</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">position</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -57067,8 +56488,7 @@ <h3 id="odfdo.Tab.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -57077,23 +56497,23 @@ <h3 id="odfdo.Tab.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.TabStopStyle" class="doc doc-heading">
-          <code>TabStopStyle</code>
+            <code>TabStopStyle</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF &ldquo;style:tab-stop&rdquo;
 Base style for a TOC entryBase style for a TOC entry</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/toc.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 93</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/toc.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 93</span>
 <span class="normal"> 94</span>
 <span class="normal"> 95</span>
 <span class="normal"> 96</span>
@@ -57195,12 +56615,11 @@ <h2 id="odfdo.TabStopStyle" class="doc doc-heading">
             <span class="k">if</span> <span class="n">style_type</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">style_type</span> <span class="o">=</span> <span class="n">style_type</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -57211,10 +56630,10 @@ <h2 id="odfdo.TabStopStyle" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -57223,22 +56642,22 @@ <h2 id="odfdo.TabStopStyle" class="doc doc-heading">
 
 
 <h2 id="odfdo.Table" class="doc doc-heading">
-          <code>Table</code>
+            <code>Table</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF table &ldquo;table:table&rdquo;</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/table.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 311</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/table.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 311</span>
 <span class="normal"> 312</span>
 <span class="normal"> 313</span>
 <span class="normal"> 314</span>
@@ -62540,9 +61959,9 @@ <h2 id="odfdo.Table" class="doc doc-heading">
         <span class="n">path</span><span class="o">.</span><span class="n">write_text</span><span class="p">(</span><span class="n">out</span><span class="o">.</span><span class="n">getvalue</span><span class="p">())</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -62557,8 +61976,8 @@ <h2 id="odfdo.Table" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">cells</span><span class="p">:</span> <span class="nb">list</span></code>
-  
+            <code class="highlight language-python"><span class="n">cells</span><span class="p">:</span> <span class="nb">list</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -62566,11 +61985,11 @@ <h3 id="odfdo.Table.cells" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get all cells of the table.</p>
 <p>Return: list of list of Cell</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62579,8 +61998,8 @@ <h3 id="odfdo.Table.cells" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.columns" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">columns</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Column</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">columns</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Column</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -62588,12 +62007,12 @@ <h3 id="odfdo.Table.columns" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of all columns matching the criteria.</p>
 <p>Copies are returned, use set_column() to push them back.</p>
 <p>Return: list of columns</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62602,8 +62021,8 @@ <h3 id="odfdo.Table.columns" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.height" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">height</span><span class="p">:</span> <span class="nb">int</span></code>
-  
+            <code class="highlight language-python"><span class="n">height</span><span class="p">:</span> <span class="nb">int</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -62611,11 +62030,11 @@ <h3 id="odfdo.Table.height" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the current height of the table.</p>
 <p>Return: int</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62624,8 +62043,8 @@ <h3 id="odfdo.Table.height" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.name" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -62634,10 +62053,10 @@ <h3 id="odfdo.Table.name" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the name of the table.</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62646,8 +62065,8 @@ <h3 id="odfdo.Table.name" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.rows" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">rows</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">rows</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -62655,11 +62074,11 @@ <h3 id="odfdo.Table.rows" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of all rows.</p>
 <p>Return: list of rows</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62668,8 +62087,8 @@ <h3 id="odfdo.Table.rows" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.size" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">size</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]</span></code>
-  
+            <code class="highlight language-python"><span class="n">size</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -62677,11 +62096,11 @@ <h3 id="odfdo.Table.size" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the current width and height of the table.</p>
 <p>Return: (int, int)</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62690,8 +62109,8 @@ <h3 id="odfdo.Table.size" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
-  
+            <code class="highlight language-python"><span class="n">style</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -62700,11 +62119,11 @@ <h3 id="odfdo.Table.style" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get / set the style of the table</p>
 <p>Return: str</p>
-  </div>
+    </div>
 
 </div>
 
@@ -62713,8 +62132,8 @@ <h3 id="odfdo.Table.style" class="doc doc-heading">
 
 
 <h3 id="odfdo.Table.width" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">width</span><span class="p">:</span> <span class="nb">int</span></code>
-  
+            <code class="highlight language-python"><span class="n">width</span><span class="p">:</span> <span class="nb">int</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
   </span>
@@ -62722,31 +62141,29 @@ <h3 id="odfdo.Table.width" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the current width of the table, measured on columns.</p>
 <p>Rows may have different widths, use the Table API to ensure width
 consistency.</p>
 <p>Return: int</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">protected</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">protection_key</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">printable</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">print_ranges</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">width</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">protected</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">protection_key</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">display</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">printable</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">print_ranges</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a table element, optionally prefilled with &ldquo;height&rdquo; rows of
 &ldquo;width&rdquo; cells each.</p>
 <p>If the table is to be protected, a protection key must be provided,
@@ -62783,9 +62200,9 @@ <h3 id="odfdo.Table.__init__" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">318</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">318</span>
 <span class="normal">319</span>
 <span class="normal">320</span>
 <span class="normal">321</span>
@@ -62953,29 +62370,27 @@ <h3 id="odfdo.Table.__init__" class="doc doc-heading">
                 <span class="bp">self</span><span class="o">.</span><span class="n">_append</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_compute_table_cache</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.append" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append</span><span class="p">(</span><span class="n">something</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append</span><span class="p">(</span><span class="n">something</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Dispatch .append() call to append_row() or append_column().</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">758</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">758</span>
 <span class="normal">759</span>
 <span class="normal">760</span>
 <span class="normal">761</span>
@@ -62993,24 +62408,22 @@ <h3 id="odfdo.Table.append" class="doc doc-heading">
         <span class="c1"># probably still an error</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_append</span><span class="p">(</span><span class="n">something</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.append_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append_cell</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append_cell</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Append the given cell at the &ldquo;y&rdquo; coordinate. Repeated cells are
 accepted. If no cell is given, an empty one is created.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -63022,9 +62435,9 @@ <h3 id="odfdo.Table.append_cell" class="doc doc-heading">
 </code></pre>
 <p>returns the cell with x and y updated</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2108</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2108</span>
 <span class="normal">2109</span>
 <span class="normal">2110</span>
 <span class="normal">2111</span>
@@ -63092,24 +62505,22 @@ <h3 id="odfdo.Table.append_cell" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cell_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.append_column" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append_column</span><span class="p">(</span><span class="n">column</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">_repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append_column</span><span class="p">(</span><span class="n">column</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">_repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Append the column at the end of the table. If no column is given,
 an empty one is created.</p>
 <p>ODF columns don&rsquo;t contain cells, only style information.</p>
@@ -63119,9 +62530,9 @@ <h3 id="odfdo.Table.append_column" class="doc doc-heading">
 <pre><code>column -- Column
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2409</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2409</span>
 <span class="normal">2410</span>
 <span class="normal">2411</span>
 <span class="normal">2412</span>
@@ -63195,24 +62606,22 @@ <h3 id="odfdo.Table.append_column" class="doc doc-heading">
     <span class="c1"># No need to update row widths</span>
     <span class="k">return</span> <span class="n">column</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.append_row" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">append_row</span><span class="p">(</span><span class="n">row</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">_repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">append_row</span><span class="p">(</span><span class="n">row</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">_repeated</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Append the row at the end of the table. If no row is given, an
 empty one is created.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -63225,9 +62634,9 @@ <h3 id="odfdo.Table.append_row" class="doc doc-heading">
 </code></pre>
 <p>returns the row, with updated row.y</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1533</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1533</span>
 <span class="normal">1534</span>
 <span class="normal">1535</span>
 <span class="normal">1536</span>
@@ -63311,24 +62720,22 @@ <h3 id="odfdo.Table.append_row" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">row</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.del_span" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">del_span</span><span class="p">(</span><span class="n">area</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">del_span</span><span class="p">(</span><span class="n">area</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete a Cell Span. &lsquo;area&rsquo; is the cell coordiante of the upper left
 cell of the spanned area.</p>
 <p>Area can be either one cell (like &lsquo;A1&rsquo;) or an area (&lsquo;A1:B2&rsquo;). It can
@@ -63339,9 +62746,9 @@ <h3 id="odfdo.Table.del_span" class="doc doc-heading">
 <pre><code>area -- str or tuple of int, cell or area coordinate
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2878</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2878</span>
 <span class="normal">2879</span>
 <span class="normal">2880</span>
 <span class="normal">2881</span>
@@ -63431,24 +62838,22 @@ <h3 id="odfdo.Table.del_span" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">set_cells</span><span class="p">(</span><span class="n">cells</span><span class="p">,</span> <span class="n">coord</span><span class="o">=</span><span class="n">start</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
     <span class="k">return</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.delete_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the cell at the given coordinates, so that next cells are
 shifted to the left.</p>
 <p>Coordinates are either a 2-uplet of (x, y) starting from 0, or a
@@ -63458,9 +62863,9 @@ <h3 id="odfdo.Table.delete_cell" class="doc doc-heading">
 <pre><code>coord -- (int, int) or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2143</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2143</span>
 <span class="normal">2144</span>
 <span class="normal">2145</span>
 <span class="normal">2146</span>
@@ -63512,24 +62917,22 @@ <h3 id="odfdo.Table.delete_cell" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span>
     <span class="n">row</span><span class="o">.</span><span class="n">delete_cell</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.delete_column" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_column</span><span class="p">(</span><span class="n">x</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete_column</span><span class="p">(</span><span class="n">x</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the column at the given position. ODF columns don&rsquo;t contain
 cells, only style information.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
@@ -63538,9 +62941,9 @@ <h3 id="odfdo.Table.delete_column" class="doc doc-heading">
 <pre><code>x -- int or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2447</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2447</span>
 <span class="normal">2448</span>
 <span class="normal">2449</span>
 <span class="normal">2450</span>
@@ -63584,24 +62987,22 @@ <h3 id="odfdo.Table.delete_column" class="doc doc-heading">
         <span class="k">if</span> <span class="n">row</span><span class="o">.</span><span class="n">width</span> <span class="o">&gt;=</span> <span class="n">width</span><span class="p">:</span>
             <span class="n">row</span><span class="o">.</span><span class="n">delete_cell</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.delete_named_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the Named Range of specified name from the spreadsheet.
 Beware : named ranges are stored at the body level, thus do not call
 this method on a cloned table.</p>
@@ -63609,9 +63010,9 @@ <h3 id="odfdo.Table.delete_named_range" class="doc doc-heading">
 <pre><code>name -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2750</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2750</span>
 <span class="normal">2751</span>
 <span class="normal">2752</span>
 <span class="normal">2753</span>
@@ -63643,33 +63044,31 @@ <h3 id="odfdo.Table.delete_named_range" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Table is not inside a document.&quot;</span><span class="p">)</span>
     <span class="n">body</span><span class="o">.</span><span class="n">delete_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.delete_row" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete_row</span><span class="p">(</span><span class="n">y</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete_row</span><span class="p">(</span><span class="n">y</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the row at the given &ldquo;y&rdquo; position.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
 <p>Arguments:</p>
 <pre><code>y -- int or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1576</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1576</span>
 <span class="normal">1577</span>
 <span class="normal">1578</span>
 <span class="normal">1579</span>
@@ -63699,32 +63098,30 @@ <h3 id="odfdo.Table.delete_row" class="doc doc-heading">
     <span class="c1"># Inside the defined table</span>
     <span class="n">delete_item_in_vault</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="bp">self</span><span class="p">,</span> <span class="n">_xpath_row_idx</span><span class="p">,</span> <span class="s2">&quot;_tmap&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.extend_rows" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">extend_rows</span><span class="p">(</span><span class="n">rows</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">extend_rows</span><span class="p">(</span><span class="n">rows</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Append a list of rows at the end of the table.</p>
 <p>Arguments:</p>
 <pre><code>rows -- list of Row
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1513</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1513</span>
 <span class="normal">1514</span>
 <span class="normal">1515</span>
 <span class="normal">1516</span>
@@ -63762,24 +63159,22 @@ <h3 id="odfdo.Table.extend_rows" class="doc doc-heading">
     <span class="k">if</span> <span class="n">diff</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">append_column</span><span class="p">(</span><span class="n">Column</span><span class="p">(</span><span class="n">repeated</span><span class="o">=</span><span class="n">diff</span><span class="p">))</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">keep_repeated</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">keep_repeated</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the cell at the given coordinates.</p>
 <p>They are either a 2-uplet of (x, y) starting from 0, or a
 human-readable position like &ldquo;C4&rdquo;.</p>
@@ -63789,9 +63184,9 @@ <h3 id="odfdo.Table.get_cell" class="doc doc-heading">
 </code></pre>
 <p>Return: Cell</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1781</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1781</span>
 <span class="normal">1782</span>
 <span class="normal">1783</span>
 <span class="normal">1784</span>
@@ -63877,24 +63272,22 @@ <h3 id="odfdo.Table.get_cell" class="doc doc-heading">
     <span class="n">cell</span><span class="o">.</span><span class="n">y</span> <span class="o">=</span> <span class="n">y</span>
     <span class="k">return</span> <span class="n">cell</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_cells</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_cells</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the cells matching the criteria. If &lsquo;coord&rsquo; is None,
 parse the whole table, else parse the area defined by &lsquo;coord&rsquo;.</p>
 <p>Filter by  cell_type = &ldquo;all&rdquo;  will retrieve cells of any
@@ -63917,9 +63310,9 @@ <h3 id="odfdo.Table.get_cells" class="doc doc-heading">
 </code></pre>
 <p>Return: list of list of Cell</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1708</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1708</span>
 <span class="normal">1709</span>
 <span class="normal">1710</span>
 <span class="normal">1711</span>
@@ -64041,24 +63434,22 @@ <h3 id="odfdo.Table.get_cells" class="doc doc-heading">
             <span class="n">lcells</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row_cells</span><span class="p">)</span>
         <span class="k">return</span> <span class="n">lcells</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_column" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_column</span><span class="p">(</span><span class="n">x</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_column</span><span class="p">(</span><span class="n">x</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the column at the given &ldquo;x&rdquo; position.</p>
 <p>ODF columns don&rsquo;t contain cells, only style information.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
@@ -64069,9 +63460,9 @@ <h3 id="odfdo.Table.get_column" class="doc doc-heading">
 </code></pre>
 <p>Return: Column</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2304</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2304</span>
 <span class="normal">2305</span>
 <span class="normal">2306</span>
 <span class="normal">2307</span>
@@ -64115,24 +63506,22 @@ <h3 id="odfdo.Table.get_column" class="doc doc-heading">
     <span class="n">column</span><span class="o">.</span><span class="n">x</span> <span class="o">=</span> <span class="n">x</span>
     <span class="k">return</span> <span class="n">column</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_column_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_column_cells</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_column_cells</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of cells at the given position.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
 like &ldquo;C&rdquo; is accepted.</p>
@@ -64153,9 +63542,9 @@ <h3 id="odfdo.Table.get_column_cells" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Cell</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2470</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2470</span>
 <span class="normal">2471</span>
 <span class="normal">2472</span>
 <span class="normal">2473</span>
@@ -64283,24 +63672,22 @@ <h3 id="odfdo.Table.get_column_cells" class="doc doc-heading">
         <span class="n">cells</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cell</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cells</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_column_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_column_values</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_column_values</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the list of Python values for the cells at the
 given position.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
@@ -64321,9 +63708,9 @@ <h3 id="odfdo.Table.get_column_values" class="doc doc-heading">
 </code></pre>
 <p>Return: list of Python types</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2535</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2535</span>
 <span class="normal">2536</span>
 <span class="normal">2537</span>
 <span class="normal">2538</span>
@@ -64433,24 +63820,22 @@ <h3 id="odfdo.Table.get_column_values" class="doc doc-heading">
         <span class="n">values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cell</span><span class="o">.</span><span class="n">get_value</span><span class="p">(</span><span class="n">get_type</span><span class="o">=</span><span class="n">get_type</span><span class="p">))</span>
     <span class="k">return</span> <span class="n">values</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_columns" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_columns</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_columns</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of columns matching the criteria.</p>
 <p>Copies are returned, use set_column() to push them back.</p>
 <p>Arguments:</p>
@@ -64460,9 +63845,9 @@ <h3 id="odfdo.Table.get_columns" class="doc doc-heading">
 </code></pre>
 <p>Return: list of columns</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2249</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2249</span>
 <span class="normal">2250</span>
 <span class="normal">2251</span>
 <span class="normal">2252</span>
@@ -64520,24 +63905,22 @@ <h3 id="odfdo.Table.get_columns" class="doc doc-heading">
         <span class="n">columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">columns</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_named_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Returns the Name Ranges of the specified name. If
 table_name is provided, limits the search to these tables.
 Beware : named ranges are stored at the body level, thus do not call
@@ -64547,9 +63930,9 @@ <h3 id="odfdo.Table.get_named_range" class="doc doc-heading">
 </code></pre>
 <p>Return : NamedRange</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2702</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2702</span>
 <span class="normal">2703</span>
 <span class="normal">2704</span>
 <span class="normal">2705</span>
@@ -64581,24 +63964,22 @@ <h3 id="odfdo.Table.get_named_range" class="doc doc-heading">
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Table is not inside a document&quot;</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">body</span><span class="o">.</span><span class="n">get_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_named_ranges" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_named_ranges</span><span class="p">(</span><span class="n">table_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_named_ranges</span><span class="p">(</span><span class="n">table_name</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Returns the list of available Name Ranges of the spreadsheet. If
 table_name is provided, limits the search to these tables.
 Beware : named ranges are stored at the body level, thus do not call
@@ -64608,9 +63989,9 @@ <h3 id="odfdo.Table.get_named_ranges" class="doc doc-heading">
 </code></pre>
 <p>Return : list of table_range</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2668</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2668</span>
 <span class="normal">2669</span>
 <span class="normal">2670</span>
 <span class="normal">2671</span>
@@ -64676,24 +64057,22 @@ <h3 id="odfdo.Table.get_named_ranges" class="doc doc-heading">
         <span class="n">nr</span> <span class="k">for</span> <span class="n">nr</span> <span class="ow">in</span> <span class="n">all_named_ranges</span> <span class="k">if</span> <span class="n">nr</span><span class="o">.</span><span class="n">table_name</span> <span class="ow">in</span> <span class="n">filter_</span>  <span class="c1"># type:ignore</span>
     <span class="p">]</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_row" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">create</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">create</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the row at the given &ldquo;y&rdquo; position.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
 <p>A copy is returned, use set_cell() to push it back.</p>
@@ -64702,9 +64081,9 @@ <h3 id="odfdo.Table.get_row" class="doc doc-heading">
 </code></pre>
 <p>Return: Row</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1416</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1416</span>
 <span class="normal">1417</span>
 <span class="normal">1418</span>
 <span class="normal">1419</span>
@@ -64744,24 +64123,22 @@ <h3 id="odfdo.Table.get_row" class="doc doc-heading">
     <span class="n">row</span><span class="o">.</span><span class="n">y</span> <span class="o">=</span> <span class="n">y</span>
     <span class="k">return</span> <span class="n">row</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_row_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_row_values</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_row_values</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the list of Python values for the cells of the row
 at the given &ldquo;y&rdquo; position.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -64781,9 +64158,9 @@ <h3 id="odfdo.Table.get_row_values" class="doc doc-heading">
 </code></pre>
 <p>Return: list of lists of Python types</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1592</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1592</span>
 <span class="normal">1593</span>
 <span class="normal">1594</span>
 <span class="normal">1595</span>
@@ -64865,24 +64242,22 @@ <h3 id="odfdo.Table.get_row_values" class="doc doc-heading">
             <span class="n">values</span><span class="o">.</span><span class="n">extend</span><span class="p">([</span><span class="kc">None</span><span class="p">]</span> <span class="o">*</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">width</span> <span class="o">-</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">)))</span>
     <span class="k">return</span> <span class="n">values</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_rows" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_rows</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_rows</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">content</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the list of rows matching the criteria.</p>
 <p>Filter by coordinates will parse the area defined by the coordinates.</p>
 <p>Arguments:</p>
@@ -64894,9 +64269,9 @@ <h3 id="odfdo.Table.get_rows" class="doc doc-heading">
 </code></pre>
 <p>Return: list of rows</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1348</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1348</span>
 <span class="normal">1349</span>
 <span class="normal">1350</span>
 <span class="normal">1351</span>
@@ -64966,24 +64341,22 @@ <h3 id="odfdo.Table.get_rows" class="doc doc-heading">
         <span class="n">rows</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">rows</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_value</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the Python value of the cell at the given
 coordinates.</p>
 <p>If get_type is True, returns the tuples (value, ODF type)</p>
@@ -64995,9 +64368,9 @@ <h3 id="odfdo.Table.get_value" class="doc doc-heading">
 </code></pre>
 <p>Return: Python type</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1825</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1825</span>
 <span class="normal">1826</span>
 <span class="normal">1827</span>
 <span class="normal">1828</span>
@@ -65079,29 +64452,27 @@ <h3 id="odfdo.Table.get_value" class="doc doc-heading">
             <span class="k">return</span> <span class="kc">None</span>
         <span class="k">return</span> <span class="n">cell</span><span class="o">.</span><span class="n">get_value</span><span class="p">(</span><span class="n">get_type</span><span class="o">=</span><span class="n">get_type</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.get_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_values</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_values</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">flat</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get a matrix of values of the table.</p>
 <p>Filter by coordinates will parse the area defined by the coordinates.</p>
 <p>If &lsquo;cell_type&rsquo; is used and &lsquo;complete&rsquo; is True (default), missing values
 are replaced by None.
-Filter by &lsquo; cell_type = &ldquo;all&rdquo; &lsquo; will retrieve cells of any
+Filter by &rsquo; cell_type = &ldquo;all&rdquo; &rsquo; will retrieve cells of any
 type, aka non empty cells.</p>
 <p>If &lsquo;cell_type&rsquo; is None, complete is always True : with no cell type
 queried, get_values() returns None for each empty cell, the length
@@ -65122,9 +64493,9 @@ <h3 id="odfdo.Table.get_values" class="doc doc-heading">
 </code></pre>
 <p>Return: list of lists of Python types</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">895</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">895</span>
 <span class="normal">896</span>
 <span class="normal">897</span>
 <span class="normal">898</span>
@@ -65262,24 +64633,22 @@ <h3 id="odfdo.Table.get_values" class="doc doc-heading">
             <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">values</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">data</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.insert_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert the given cell at the given coordinates. If no cell is
 given, an empty one is created.</p>
 <p>Coordinates are either a 2-uplet of (x, y) starting from 0, or a
@@ -65292,9 +64661,9 @@ <h3 id="odfdo.Table.insert_cell" class="doc doc-heading">
 </code></pre>
 <p>returns the cell with x and y updated</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2067</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2067</span>
 <span class="normal">2068</span>
 <span class="normal">2069</span>
 <span class="normal">2070</span>
@@ -65374,24 +64743,22 @@ <h3 id="odfdo.Table.insert_cell" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cell_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.insert_column" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_column</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">column</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_column</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">column</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert the column before the given &ldquo;x&rdquo; position. If no column is
 given, an empty one is created.</p>
 <p>ODF columns don&rsquo;t contain cells, only style information.</p>
@@ -65403,9 +64770,9 @@ <h3 id="odfdo.Table.insert_column" class="doc doc-heading">
 column -- Column
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2366</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2366</span>
 <span class="normal">2367</span>
 <span class="normal">2368</span>
 <span class="normal">2369</span>
@@ -65489,24 +64856,22 @@ <h3 id="odfdo.Table.insert_column" class="doc doc-heading">
         <span class="c1"># Longer rows shouldn&#39;t exist!</span>
     <span class="k">return</span> <span class="n">column_back</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.insert_row" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">insert_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">insert_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Insert the row before the given &ldquo;y&rdquo; position. If no row is given,
 an empty one is created.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -65518,9 +64883,9 @@ <h3 id="odfdo.Table.insert_row" class="doc doc-heading">
 </code></pre>
 <p>returns the row, with updated row.y</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1478</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1478</span>
 <span class="normal">1479</span>
 <span class="normal">1480</span>
 <span class="normal">1481</span>
@@ -65588,24 +64953,22 @@ <h3 id="odfdo.Table.insert_row" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row_back</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
     <span class="k">return</span> <span class="n">row_back</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.is_column_empty" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_column_empty</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">is_column_empty</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return wether every cell in the column at &ldquo;x&rdquo; position has no value
 or the value evaluates to False (empty string), and no style.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
@@ -65613,9 +64976,9 @@ <h3 id="odfdo.Table.is_column_empty" class="doc doc-heading">
 <p>If aggressive is True, empty cells with style are considered empty.</p>
 <p>Return: bool</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2648</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2648</span>
 <span class="normal">2649</span>
 <span class="normal">2650</span>
 <span class="normal">2651</span>
@@ -65649,24 +65012,22 @@ <h3 id="odfdo.Table.is_column_empty" class="doc doc-heading">
             <span class="k">return</span> <span class="kc">False</span>
     <span class="k">return</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.is_empty" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return whether every cell in the table has no value or the value
 evaluates to False (empty string), and no style.</p>
 <p>If aggressive is True, empty cells with style are considered empty.</p>
@@ -65674,9 +65035,9 @@ <h3 id="odfdo.Table.is_empty" class="doc doc-heading">
 <pre><code>aggressive -- bool
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1256</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1256</span>
 <span class="normal">1257</span>
 <span class="normal">1258</span>
 <span class="normal">1259</span>
@@ -65698,24 +65059,22 @@ <h3 id="odfdo.Table.is_empty" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="nb">all</span><span class="p">(</span><span class="n">row</span><span class="o">.</span><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="n">aggressive</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_rows</span><span class="p">())</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.is_row_empty" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">is_row_empty</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">is_row_empty</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return wether every cell in the row at the given &ldquo;y&rdquo; position has
 no value or the value evaluates to False (empty string), and no style.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -65726,9 +65085,9 @@ <h3 id="odfdo.Table.is_row_empty" class="doc doc-heading">
 aggressive -- bool
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1688</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1688</span>
 <span class="normal">1689</span>
 <span class="normal">1690</span>
 <span class="normal">1691</span>
@@ -65758,24 +65117,22 @@ <h3 id="odfdo.Table.is_row_empty" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span><span class="o">.</span><span class="n">is_empty</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="n">aggressive</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.iter_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">iter_values</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">iter_values</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">complete</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">get_type</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Iterate through lines of Python values of the table.</p>
 <p>Filter by coordinates will parse the area defined by the coordinates.</p>
 <p>cell_type, complete, grt_type : see get_values()</p>
@@ -65791,9 +65148,9 @@ <h3 id="odfdo.Table.iter_values" class="doc doc-heading">
 </code></pre>
 <p>Return: iterator of lists</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 965</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 965</span>
 <span class="normal"> 966</span>
 <span class="normal"> 967</span>
 <span class="normal"> 968</span>
@@ -65897,30 +65254,28 @@ <h3 id="odfdo.Table.iter_values" class="doc doc-heading">
                 <span class="n">values</span><span class="o">.</span><span class="n">extend</span><span class="p">([</span><span class="kc">None</span><span class="p">]</span> <span class="o">*</span> <span class="p">(</span><span class="n">width</span> <span class="o">-</span> <span class="nb">len</span><span class="p">(</span><span class="n">values</span><span class="p">)))</span>
         <span class="k">yield</span> <span class="n">values</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.optimize_width" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">optimize_width</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">optimize_width</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove <em>in-place</em> empty rows below and empty cells at the right of
 the table. Keep repeated styles of empty cells but minimize row width.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1130</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1130</span>
 <span class="normal">1131</span>
 <span class="normal">1132</span>
 <span class="normal">1133</span>
@@ -65936,24 +65291,22 @@ <h3 id="odfdo.Table.optimize_width" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_optimize_width_rstrip_rows</span><span class="p">(</span><span class="n">width</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_optimize_width_adapt_columns</span><span class="p">(</span><span class="n">width</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.rstrip" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">rstrip</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">rstrip</span><span class="p">(</span><span class="n">aggressive</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Remove <em>in-place</em> empty rows below and empty cells at the right of
 the table. Cells are empty if they contain no value or it evaluates
 to False, and no style.</p>
@@ -65962,9 +65315,9 @@ <h3 id="odfdo.Table.rstrip" class="doc doc-heading">
 <pre><code>aggressive -- bool
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1081</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1081</span>
 <span class="normal">1082</span>
 <span class="normal">1083</span>
 <span class="normal">1084</span>
@@ -66060,24 +65413,22 @@ <h3 id="odfdo.Table.rstrip" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_indexes</span><span class="p">[</span><span class="s2">&quot;_cmap&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_compute_table_cache</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_cell" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">cell</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Replace a cell of the table at the given coordinates.</p>
 <p>They are either a 2-uplet of (x, y) starting from 0, or a
 human-readable position like &ldquo;C4&rdquo;.</p>
@@ -66088,9 +65439,9 @@ <h3 id="odfdo.Table.set_cell" class="doc doc-heading">
 </code></pre>
 <p>return the cell, with x and y updated</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1867</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1867</span>
 <span class="normal">1868</span>
 <span class="normal">1869</span>
 <span class="normal">1870</span>
@@ -66190,24 +65541,22 @@ <h3 id="odfdo.Table.set_cell" class="doc doc-heading">
             <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cell_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_cell_image" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_cell_image</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">image_frame</span><span class="p">,</span> <span class="n">doc_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_cell_image</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">image_frame</span><span class="p">,</span> <span class="n">doc_type</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Do all the magic to display an image in the cell at the given
 coordinates.</p>
 <p>They are either a 2-uplet of (x, y) starting from 0, or a
@@ -66224,9 +65573,9 @@ <h3 id="odfdo.Table.set_cell_image" class="doc doc-heading">
 doc_type -- 'spreadsheet' or 'text'
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1999</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1999</span>
 <span class="normal">2000</span>
 <span class="normal">2001</span>
 <span class="normal">2002</span>
@@ -66360,24 +65709,22 @@ <h3 id="odfdo.Table.set_cell_image" class="doc doc-heading">
         <span class="n">paragraph</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">image_frame</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">set_cell</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">cell</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_cells</span><span class="p">(</span><span class="n">cells</span><span class="p">,</span> <span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_cells</span><span class="p">(</span><span class="n">cells</span><span class="p">,</span> <span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the cells in the table, from the &lsquo;coord&rsquo; position.</p>
 <p>&lsquo;coord&rsquo; is the coordinate of the upper left cell to be modified by
 values. If &lsquo;coord&rsquo; is None, default to the position (0,0) (&ldquo;A1&rdquo;).
@@ -66395,9 +65742,9 @@ <h3 id="odfdo.Table.set_cells" class="doc doc-heading">
 values -- list of lists of python types
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1918</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1918</span>
 <span class="normal">1919</span>
 <span class="normal">1920</span>
 <span class="normal">1921</span>
@@ -66491,24 +65838,22 @@ <h3 id="odfdo.Table.set_cells" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_column" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_column</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">column</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_column</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">column</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Replace the column at the given &ldquo;x&rdquo; position.</p>
 <p>ODF columns don&rsquo;t contain cells, only style information.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
@@ -66519,9 +65864,9 @@ <h3 id="odfdo.Table.set_column" class="doc doc-heading">
 column -- Column
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2327</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2327</span>
 <span class="normal">2328</span>
 <span class="normal">2329</span>
 <span class="normal">2330</span>
@@ -66597,24 +65942,22 @@ <h3 id="odfdo.Table.set_column" class="doc doc-heading">
         <span class="p">)</span>
     <span class="k">return</span> <span class="n">column_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_column_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_column_cells</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cells</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_column_cells</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cells</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the list of cells at the given position.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
 like &ldquo;C&rdquo; is accepted.</p>
@@ -66625,9 +65968,9 @@ <h3 id="odfdo.Table.set_column_cells" class="doc doc-heading">
 cells -- list of Cell
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2591</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2591</span>
 <span class="normal">2592</span>
 <span class="normal">2593</span>
 <span class="normal">2594</span>
@@ -66669,24 +66012,22 @@ <h3 id="odfdo.Table.set_column_cells" class="doc doc-heading">
         <span class="n">row</span><span class="o">.</span><span class="n">set_cell</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="nb">next</span><span class="p">(</span><span class="n">cells_iterator</span><span class="p">))</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_column_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_column_values</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_column_values</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the list of Python values of cells at the given
 position.</p>
 <p>Position start at 0. So cell C4 is on column 2. Alphabetical position
@@ -66705,9 +66046,9 @@ <h3 id="odfdo.Table.set_column_values" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2613</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2613</span>
 <span class="normal">2614</span>
 <span class="normal">2615</span>
 <span class="normal">2616</span>
@@ -66775,24 +66116,22 @@ <h3 id="odfdo.Table.set_column_values" class="doc doc-heading">
     <span class="p">]</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">set_column_cells</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">cells</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_named_range" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">crange</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">usage</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_named_range</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">crange</span><span class="p">,</span> <span class="n">table_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">usage</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a Named Range element and insert it in the document.
 Beware : named ranges are stored at the body level, thus do not call
 this method on a cloned table.</p>
@@ -66806,9 +66145,9 @@ <h3 id="odfdo.Table.set_named_range" class="doc doc-heading">
 uage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2719</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2719</span>
 <span class="normal">2720</span>
 <span class="normal">2721</span>
 <span class="normal">2722</span>
@@ -66868,24 +66207,22 @@ <h3 id="odfdo.Table.set_named_range" class="doc doc-heading">
     <span class="n">named_range</span> <span class="o">=</span> <span class="n">NamedRange</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">crange</span><span class="p">,</span> <span class="n">table_name</span><span class="p">,</span> <span class="n">usage</span><span class="p">)</span>
     <span class="n">body</span><span class="o">.</span><span class="n">append_named_range</span><span class="p">(</span><span class="n">named_range</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_row" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Replace the row at the given position with the new one. Repetions of
 the old row will be adjusted.</p>
 <p>If row is None, a new empty row is created.</p>
@@ -66897,9 +66234,9 @@ <h3 id="odfdo.Table.set_row" class="doc doc-heading">
 </code></pre>
 <p>returns the row, with updated row.y</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1437</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1437</span>
 <span class="normal">1438</span>
 <span class="normal">1439</span>
 <span class="normal">1440</span>
@@ -66979,24 +66316,22 @@ <h3 id="odfdo.Table.set_row" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row_back</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">row_back</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_row_cells" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_row_cells</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">cells</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_row_cells</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">cells</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set <em>all</em> the cells of the row at the given
 &ldquo;y&rdquo; position.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -67009,9 +66344,9 @@ <h3 id="odfdo.Table.set_row_cells" class="doc doc-heading">
 </code></pre>
 <p>returns the row, with updated row.y</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1666</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1666</span>
 <span class="normal">1667</span>
 <span class="normal">1668</span>
 <span class="normal">1669</span>
@@ -67053,24 +66388,22 @@ <h3 id="odfdo.Table.set_row_cells" class="doc doc-heading">
     <span class="n">row</span><span class="o">.</span><span class="n">extend_cells</span><span class="p">(</span><span class="n">cells</span><span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="p">)</span>  <span class="c1"># needed if clones rows</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_row_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_row_values</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_row_values</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">values</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the values of <em>all</em> cells of the row at the given
 &ldquo;y&rdquo; position.</p>
 <p>Position start at 0. So cell A4 is on row 3.</p>
@@ -67088,9 +66421,9 @@ <h3 id="odfdo.Table.set_row_values" class="doc doc-heading">
 </code></pre>
 <p>returns the row, with updated row.y</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1634</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1634</span>
 <span class="normal">1635</span>
 <span class="normal">1636</span>
 <span class="normal">1637</span>
@@ -67152,24 +66485,22 @@ <h3 id="odfdo.Table.set_row_values" class="doc doc-heading">
     <span class="n">row</span><span class="o">.</span><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="n">style</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="n">cell_type</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="n">currency</span><span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="p">)</span>  <span class="c1"># needed if clones rows</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_span" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_span</span><span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">merge</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_span</span><span class="p">(</span><span class="n">area</span><span class="p">,</span> <span class="n">merge</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Create a Cell Span : span the first cell of the area on several
 columns and/or rows.
 If merge is True, replace text of the cell by the concatenation of
@@ -67189,9 +66520,9 @@ <h3 id="odfdo.Table.set_span" class="doc doc-heading">
 merge -- boolean
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2771</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2771</span>
 <span class="normal">2772</span>
 <span class="normal">2773</span>
 <span class="normal">2774</span>
@@ -67403,24 +66734,22 @@ <h3 id="odfdo.Table.set_span" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">set_cells</span><span class="p">(</span><span class="n">cells</span><span class="p">,</span> <span class="n">coord</span><span class="o">=</span><span class="n">start</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
     <span class="k">return</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_value" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_value</span><span class="p">(</span><span class="n">coord</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the Python value of the cell at the given coordinates.</p>
 <p>They are either a 2-uplet of (x, y) starting from 0, or a
 human-readable position like &ldquo;C4&rdquo;.</p>
@@ -67437,9 +66766,9 @@ <h3 id="odfdo.Table.set_value" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1966</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1966</span>
 <span class="normal">1967</span>
 <span class="normal">1968</span>
 <span class="normal">1969</span>
@@ -67503,24 +66832,22 @@ <h3 id="odfdo.Table.set_value" class="doc doc-heading">
         <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.set_values" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_values</span><span class="p">(</span><span class="n">values</span><span class="p">,</span> <span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">cell_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">currency</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the value of cells in the table, from the &lsquo;coord&rsquo; position
 with values.</p>
 <p>&lsquo;coord&rsquo; is the coordinate of the upper left cell to be modified by
@@ -67545,9 +66872,9 @@ <h3 id="odfdo.Table.set_values" class="doc doc-heading">
 style -- str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1018</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1018</span>
 <span class="normal">1019</span>
 <span class="normal">1020</span>
 <span class="normal">1021</span>
@@ -67671,24 +66998,22 @@ <h3 id="odfdo.Table.set_values" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">set_row</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">row</span><span class="p">,</span> <span class="n">clone</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_update_width</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.to_csv" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">to_csv</span><span class="p">(</span><span class="n">path_or_file</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="s1">&#39;excel&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">to_csv</span><span class="p">(</span><span class="n">path_or_file</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">dialect</span><span class="o">=</span><span class="s1">&#39;excel&#39;</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Write the table as CSV in the file.</p>
 <p>If the file is a string, it is opened as a local path. Else an
 opened file-like is expected.</p>
@@ -67698,9 +67023,9 @@ <h3 id="odfdo.Table.to_csv" class="doc doc-heading">
 dialect -- str, python csv.dialect, can be 'excel', 'unix'...
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2926</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2926</span>
 <span class="normal">2927</span>
 <span class="normal">2928</span>
 <span class="normal">2929</span>
@@ -67772,24 +67097,22 @@ <h3 id="odfdo.Table.to_csv" class="doc doc-heading">
     <span class="n">path</span><span class="o">.</span><span class="n">write_text</span><span class="p">(</span><span class="n">out</span><span class="o">.</span><span class="n">getvalue</span><span class="p">())</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.transpose" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">transpose</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">transpose</span><span class="p">(</span><span class="n">coord</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Swap <em>in-place</em> rows and columns of the table.</p>
 <p>If &lsquo;coord&rsquo; is not None, apply transpose only to the area defined by the
 coordinates. Beware, if area is not square, some cells mays be over
@@ -67800,9 +67123,9 @@ <h3 id="odfdo.Table.transpose" class="doc doc-heading">
 start -- int or str
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1192</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1192</span>
 <span class="normal">1193</span>
 <span class="normal">1194</span>
 <span class="normal">1195</span>
@@ -67928,24 +67251,22 @@ <h3 id="odfdo.Table.transpose" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">set_cells</span><span class="p">(</span><span class="n">filtered_data</span><span class="p">,</span> <span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">,</span> <span class="n">x</span> <span class="o">+</span> <span class="n">h</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">y</span> <span class="o">+</span> <span class="n">w</span> <span class="o">-</span> <span class="mi">1</span><span class="p">))</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_compute_table_cache</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.traverse" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">traverse</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">traverse</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Yield as many row elements as expected rows in the table, i.e.
 expand repetitions by returning the same row as many times as
 necessary.</p>
@@ -67957,9 +67278,9 @@ <h3 id="odfdo.Table.traverse" class="doc doc-heading">
 </code></pre>
 <p>Copies are returned, use set_row() to push them back.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1275</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1275</span>
 <span class="normal">1276</span>
 <span class="normal">1277</span>
 <span class="normal">1278</span>
@@ -68103,24 +67424,22 @@ <h3 id="odfdo.Table.traverse" class="doc doc-heading">
                         <span class="n">row</span><span class="o">.</span><span class="n">repeated</span> <span class="o">=</span> <span class="kc">None</span>
                     <span class="k">yield</span> <span class="n">row</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.Table.traverse_columns" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">traverse_columns</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">traverse_columns</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Yield as many column elements as expected columns in the table,
 i.e. expand repetitions by returning the same column as many times as
 necessary.</p>
@@ -68132,9 +67451,9 @@ <h3 id="odfdo.Table.traverse_columns" class="doc doc-heading">
 </code></pre>
 <p>Copies are returned, use set_column() to push them back.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/table.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2176</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/table.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">2176</span>
 <span class="normal">2177</span>
 <span class="normal">2178</span>
 <span class="normal">2179</span>
@@ -68278,8 +67597,8 @@ <h3 id="odfdo.Table.traverse_columns" class="doc doc-heading">
                         <span class="n">column</span><span class="o">.</span><span class="n">repeated</span> <span class="o">=</span> <span class="kc">None</span>
                     <span class="k">yield</span> <span class="n">column</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -68287,8 +67606,7 @@ <h3 id="odfdo.Table.traverse_columns" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -68297,23 +67615,23 @@ <h3 id="odfdo.Table.traverse_columns" class="doc doc-heading">
 
 
 <h2 id="odfdo.Text" class="doc doc-heading">
-          <code>Text</code>
+            <code>Text</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.body.Body" href="#odfdo.Body">Body</a></code></p>
+
 
-  
       <p>Text, specialized class of Element in charge of actual content
 management.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/body.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">153</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/body.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">153</span>
 <span class="normal">154</span>
 <span class="normal">155</span>
 <span class="normal">156</span>
@@ -68329,9 +67647,9 @@ <h2 id="odfdo.Text" class="doc doc-heading">
     <span class="n">_caching</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">_properties</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">PropDef</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -68347,8 +67665,7 @@ <h2 id="odfdo.Text" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -68357,23 +67674,23 @@ <h2 id="odfdo.Text" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextChange" class="doc doc-heading">
-          <code>TextChange</code>
+            <code>TextChange</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The TextChange &ldquo;text:change&rdquo; element marks a position in an empty
 region where text has been deleted.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">477</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">477</span>
 <span class="normal">478</span>
 <span class="normal">479</span>
 <span class="normal">480</span>
@@ -68539,12 +67856,11 @@ <h2 id="odfdo.TextChange" class="doc doc-heading">
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Return None.&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -68557,22 +67873,21 @@ <h2 id="odfdo.TextChange" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChange.get_deleted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="n">tracked_changes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="n">tracked_changes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the deleted informations stored in the
 TextDeletion stored in the tracked changes.</p>
 <p>Return: Paragraph (or None).&rdquo;</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">523</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">523</span>
 <span class="normal">524</span>
 <span class="normal">525</span>
 <span class="normal">526</span>
@@ -68612,57 +67927,53 @@ <h3 id="odfdo.TextChange.get_deleted" class="doc doc-heading">
         <span class="n">clean</span><span class="o">=</span><span class="n">clean</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChange.get_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_end</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_end</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">557</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">557</span>
 <span class="normal">558</span>
 <span class="normal">559</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_end</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">TextChangeEnd</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Return None.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChange.get_inserted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">544</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">544</span>
 <span class="normal">545</span>
 <span class="normal">546</span>
 <span class="normal">547</span>
@@ -68678,36 +67989,34 @@ <h3 id="odfdo.TextChange.get_inserted" class="doc doc-heading">
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Return None.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChange.get_start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_start</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_start</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">553</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">553</span>
 <span class="normal">554</span>
 <span class="normal">555</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_start</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">TextChangeStart</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Return None.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -68715,8 +68024,7 @@ <h3 id="odfdo.TextChange.get_start" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -68725,24 +68033,24 @@ <h3 id="odfdo.TextChange.get_start" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextChangeEnd" class="doc doc-heading">
-          <code>TextChangeEnd</code>
+            <code>TextChangeEnd</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextChange" href="#odfdo.TextChange">TextChange</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextChange" href="#odfdo.TextChange">TextChange</a></code></p>
+
 
-  
       <p>The TextChangeEnd &ldquo;text:change-end&rdquo; element marks the end of a region
 with content where text has been inserted or the format has been
 changed.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">562</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">562</span>
 <span class="normal">563</span>
 <span class="normal">564</span>
 <span class="normal">565</span>
@@ -68874,12 +68182,11 @@ <h2 id="odfdo.TextChangeEnd" class="doc doc-heading">
             <span class="n">start</span><span class="p">,</span> <span class="n">end</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="n">as_text</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="n">no_header</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="n">clean</span>
         <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -68892,71 +68199,66 @@ <h2 id="odfdo.TextChangeEnd" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeEnd.get_deleted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">585</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">585</span>
 <span class="normal">586</span>
 <span class="normal">587</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_deleted</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Element</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Return None.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeEnd.get_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_end</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_end</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return self.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">581</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">581</span>
 <span class="normal">582</span>
 <span class="normal">583</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_end</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">TextChangeEnd</span> <span class="o">|</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Return self.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeEnd.get_inserted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the content between text:change-start and text:change-end.</p>
 <p>If no content exists (deletion tag), returns None (or &lsquo;&rsquo; if text flag
 is True).
@@ -68973,9 +68275,9 @@ <h3 id="odfdo.TextChangeEnd.get_inserted" class="doc doc-heading">
 </code></pre>
 <p>Return: list or Element or text</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">589</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">589</span>
 <span class="normal">590</span>
 <span class="normal">591</span>
 <span class="normal">592</span>
@@ -69053,29 +68355,27 @@ <h3 id="odfdo.TextChangeEnd.get_inserted" class="doc doc-heading">
         <span class="n">start</span><span class="p">,</span> <span class="n">end</span><span class="p">,</span> <span class="n">as_text</span><span class="o">=</span><span class="n">as_text</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="n">no_header</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="n">clean</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeEnd.get_start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_start</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_start</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the corresponding annotation starting tag or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">570</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">570</span>
 <span class="normal">571</span>
 <span class="normal">572</span>
 <span class="normal">573</span>
@@ -69095,8 +68395,8 @@ <h3 id="odfdo.TextChangeEnd.get_start" class="doc doc-heading">
         <span class="n">body</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">root</span>
     <span class="k">return</span> <span class="n">body</span><span class="o">.</span><span class="n">get_text_change_start</span><span class="p">(</span><span class="n">idx</span><span class="o">=</span><span class="n">idx</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -69104,8 +68404,7 @@ <h3 id="odfdo.TextChangeEnd.get_start" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -69114,24 +68413,24 @@ <h3 id="odfdo.TextChangeEnd.get_start" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextChangeStart" class="doc doc-heading">
-          <code>TextChangeStart</code>
+            <code>TextChangeStart</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextChangeEnd" href="#odfdo.TextChangeEnd">TextChangeEnd</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextChangeEnd" href="#odfdo.TextChangeEnd">TextChangeEnd</a></code></p>
+
 
-  
       <p>The TextChangeStart &ldquo;text:change-start&rdquo; element marks the start of a
 region with content where text has been inserted or the format has
 been changed.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">630</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">630</span>
 <span class="normal">631</span>
 <span class="normal">632</span>
 <span class="normal">633</span>
@@ -69239,12 +68538,11 @@ <h2 id="odfdo.TextChangeStart" class="doc doc-heading">
         <span class="c1"># act like normal delete</span>
         <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -69257,15 +68555,14 @@ <h2 id="odfdo.TextChangeStart" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeStart.delete" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">delete</span><span class="p">(</span><span class="n">child</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">keep_tail</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Delete the given element from the XML tree. If no element is given,
 &ldquo;self&rdquo; is deleted. The XML library may allow to continue to use an
 element now &ldquo;orphan&rdquo; as long as you have a reference to it.</p>
@@ -69276,9 +68573,9 @@ <h3 id="odfdo.TextChangeStart.delete" class="doc doc-heading">
 keep_tail -- boolean (default to True), True for most usages.
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">653</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">653</span>
 <span class="normal">654</span>
 <span class="normal">655</span>
 <span class="normal">656</span>
@@ -69340,29 +68637,27 @@ <h3 id="odfdo.TextChangeStart.delete" class="doc doc-heading">
     <span class="c1"># act like normal delete</span>
     <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeStart.get_end" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_end</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_end</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return the corresponding change-end tag or None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">642</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">642</span>
 <span class="normal">643</span>
 <span class="normal">644</span>
 <span class="normal">645</span>
@@ -69382,36 +68677,34 @@ <h3 id="odfdo.TextChangeStart.get_end" class="doc doc-heading">
         <span class="n">body</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">root</span>
     <span class="k">return</span> <span class="n">body</span><span class="o">.</span><span class="n">get_text_change_end</span><span class="p">(</span><span class="n">idx</span><span class="o">=</span><span class="n">idx</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangeStart.get_start" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_start</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_start</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return self.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">638</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">638</span>
 <span class="normal">639</span>
 <span class="normal">640</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">get_start</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">TextChangeStart</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Return self.&quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -69419,8 +68712,7 @@ <h3 id="odfdo.TextChangeStart.get_start" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -69429,17 +68721,17 @@ <h3 id="odfdo.TextChangeStart.get_start" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextChangedRegion" class="doc doc-heading">
-          <code>TextChangedRegion</code>
+            <code>TextChangedRegion</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>Each TextChangedRegion &ldquo;text:changed-region&rdquo; element contains a single
 element, one of TextInsertion, TextDeletion or TextFormatChange that
 corresponds to a change being tracked within the scope of the
@@ -69450,6 +68742,7 @@ <h2 id="odfdo.TextChangedRegion" class="doc doc-heading">
 elements that identify where the change applies to markup in the scope of
 the &ldquo;text:tracked-changes&rdquo; element.</p>
 
+
 <details class="warning-" open>
   <summary>for this implementation, text:change should be referenced only</summary>
   <p>once in the scope, which is different from ODF 1.2 requirement:</p>
@@ -69459,9 +68752,9 @@ <h2 id="odfdo.TextChangedRegion" class="doc doc-heading">
      deletion. "
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">327</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">327</span>
 <span class="normal">328</span>
 <span class="normal">329</span>
 <span class="normal">330</span>
@@ -69645,12 +68938,11 @@ <h2 id="odfdo.TextChangedRegion" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">_set_text_id</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_set_xml_id</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -69663,22 +68955,21 @@ <h2 id="odfdo.TextChangedRegion" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangedRegion.get_change_element" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_change_element</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_change_element</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the change element child. It can be either: TextInsertion,
 TextDeletion, or TextFormatChange as an Element object.</p>
 <p>Return: Element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">383</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">383</span>
 <span class="normal">384</span>
 <span class="normal">385</span>
 <span class="normal">386</span>
@@ -69702,31 +68993,29 @@ <h3 id="odfdo.TextChangedRegion.get_change_element" class="doc doc-heading">
     <span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_filtered_element</span><span class="p">(</span><span class="n">request</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangedRegion.get_change_info" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_change_info</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_change_info</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to get the ChangeInfo element of the change
 element child.</p>
 <p>Return: ChangeInfo element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">348</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">348</span>
 <span class="normal">349</span>
 <span class="normal">350</span>
 <span class="normal">351</span>
@@ -69740,30 +69029,28 @@ <h3 id="odfdo.TextChangedRegion.get_change_info" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_element</span><span class="p">(</span><span class="s2">&quot;descendant::office:change-info&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangedRegion.get_id" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_id</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_id</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the &ldquo;text:id&rdquo; attribute.</p>
 <p>Return: str</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">408</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">408</span>
 <span class="normal">409</span>
 <span class="normal">410</span>
 <span class="normal">411</span>
@@ -69775,24 +69062,22 @@ <h3 id="odfdo.TextChangedRegion.get_id" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_text_id</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangedRegion.set_change_info" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_change_info</span><span class="p">(</span><span class="n">change_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">comments</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_change_info</span><span class="p">(</span><span class="n">change_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">comments</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to set the ChangeInfo element of the sub change element.
 See TextInsertion.set_change_info() for details.</p>
 <p>Arguments:</p>
@@ -69805,9 +69090,9 @@ <h3 id="odfdo.TextChangedRegion.set_change_info" class="doc doc-heading">
  comments -- Paragraph or list of Paragraph elements (or None)
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">356</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">356</span>
 <span class="normal">357</span>
 <span class="normal">358</span>
 <span class="normal">359</span>
@@ -69859,29 +69144,27 @@ <h3 id="odfdo.TextChangedRegion.set_change_info" class="doc doc-heading">
         <span class="n">change_info</span><span class="o">=</span><span class="n">change_info</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="n">creator</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="n">date</span><span class="p">,</span> <span class="n">comments</span><span class="o">=</span><span class="n">comments</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextChangedRegion.set_id" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_id</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_id</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set both the &ldquo;text:id&rdquo; and &ldquo;xml:id&rdquo; attributes with same value.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">415</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">415</span>
 <span class="normal">416</span>
 <span class="normal">417</span>
 <span class="normal">418</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">set_id</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">idx</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
@@ -69889,8 +69172,8 @@ <h3 id="odfdo.TextChangedRegion.set_id" class="doc doc-heading">
     <span class="bp">self</span><span class="o">.</span><span class="n">_set_text_id</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span>
     <span class="bp">self</span><span class="o">.</span><span class="n">_set_xml_id</span><span class="p">(</span><span class="n">idx</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -69898,8 +69181,7 @@ <h3 id="odfdo.TextChangedRegion.set_id" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -69908,17 +69190,17 @@ <h3 id="odfdo.TextChangedRegion.set_id" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextDeletion" class="doc doc-heading">
-          <code>TextDeletion</code>
+            <code>TextDeletion</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextInsertion" href="#odfdo.TextInsertion">TextInsertion</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextInsertion" href="#odfdo.TextInsertion">TextInsertion</a></code></p>
+
 
-  
       <p>The TextDeletion &ldquo;text:deletion&rdquo; contains information that identifies
 the person responsible for a deletion and the date of that deletion.
 This information may also contain one or more Paragraph which contains
@@ -69944,9 +69226,9 @@ <h2 id="odfdo.TextDeletion" class="doc doc-heading">
   - Otherwise, copy the text content of the &ldquo;text:deletion&rdquo; element in
   place of the change mark.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">220</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">220</span>
 <span class="normal">221</span>
 <span class="normal">222</span>
 <span class="normal">223</span>
@@ -70130,12 +69412,11 @@ <h2 id="odfdo.TextDeletion" class="doc doc-heading">
             <span class="k">return</span> <span class="s2">&quot;&quot;</span>
         <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -70148,15 +69429,14 @@ <h2 id="odfdo.TextDeletion" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextDeletion.get_deleted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the deleted informations stored in the TextDeletion.
 If as_text is True: returns the text content.
 If no_header is True: existing Heading are changed in Paragraph</p>
@@ -70167,9 +69447,9 @@ <h3 id="odfdo.TextDeletion.get_deleted" class="doc doc-heading">
 </code></pre>
 <p>Return: Paragraph and Header list</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">249</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">249</span>
 <span class="normal">250</span>
 <span class="normal">251</span>
 <span class="normal">252</span>
@@ -70241,29 +69521,27 @@ <h3 id="odfdo.TextDeletion.get_deleted" class="doc doc-heading">
         <span class="k">return</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">elem</span><span class="o">.</span><span class="n">get_formatted_text</span><span class="p">(</span><span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span> <span class="k">for</span> <span class="n">elem</span> <span class="ow">in</span> <span class="n">inner</span><span class="p">])</span>
     <span class="k">return</span> <span class="n">inner</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextDeletion.get_inserted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">302</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">302</span>
 <span class="normal">303</span>
 <span class="normal">304</span>
 <span class="normal">305</span>
@@ -70283,24 +69561,22 @@ <h3 id="odfdo.TextDeletion.get_inserted" class="doc doc-heading">
         <span class="k">return</span> <span class="s2">&quot;&quot;</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextDeletion.set_deleted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_deleted</span><span class="p">(</span><span class="n">paragraph_or_list</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_deleted</span><span class="p">(</span><span class="n">paragraph_or_list</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the deleted informations stored in the TextDeletion. An
 actual content that was deleted is expected, embeded in a Paragraph
 element or Header.</p>
@@ -70308,9 +69584,9 @@ <h3 id="odfdo.TextDeletion.set_deleted" class="doc doc-heading">
 <pre><code>paragraph_or_list -- Paragraph or Header element (or list)
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">286</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">286</span>
 <span class="normal">287</span>
 <span class="normal">288</span>
 <span class="normal">289</span>
@@ -70340,8 +69616,8 @@ <h3 id="odfdo.TextDeletion.set_deleted" class="doc doc-heading">
     <span class="k">for</span> <span class="n">element</span> <span class="ow">in</span> <span class="n">paragraph_or_list</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -70349,8 +69625,7 @@ <h3 id="odfdo.TextDeletion.set_deleted" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -70359,17 +69634,17 @@ <h3 id="odfdo.TextDeletion.set_deleted" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextFormatChange" class="doc doc-heading">
-          <code>TextFormatChange</code>
+            <code>TextFormatChange</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextInsertion" href="#odfdo.TextInsertion">TextInsertion</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.tracked_changes.TextInsertion" href="#odfdo.TextInsertion">TextInsertion</a></code></p>
+
 
-  
       <p>The TextFormatChange &ldquo;text:format-change&rdquo; element represents any change
 in formatting attributes. The region where the change took place is
 marked by &ldquo;text:change-start&rdquo;, &ldquo;text:change-end&rdquo; or &ldquo;text:change&rdquo;
@@ -70377,9 +69652,9 @@ <h2 id="odfdo.TextFormatChange" class="doc doc-heading">
 <p>Note: This element does not contain formatting changes that have taken
 place.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">314</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">314</span>
 <span class="normal">315</span>
 <span class="normal">316</span>
 <span class="normal">317</span>
@@ -70401,12 +69676,11 @@ <h2 id="odfdo.TextFormatChange" class="doc doc-heading">
 
     <span class="n">_tag</span> <span class="o">=</span> <span class="s2">&quot;text:format-change&quot;</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -70417,10 +69691,10 @@ <h2 id="odfdo.TextFormatChange" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -70429,17 +69703,17 @@ <h2 id="odfdo.TextFormatChange" class="doc doc-heading">
 
 
 <h2 id="odfdo.TextInsertion" class="doc doc-heading">
-          <code>TextInsertion</code>
+            <code>TextInsertion</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The TextInsertion &ldquo;text:insertion&rdquo; element contains the information
 that identifies the person responsible for a change and the date of
 that change. This information may also contain one or more &ldquo;text:p&rdquo;
@@ -70449,9 +69723,9 @@ <h2 id="odfdo.TextInsertion" class="doc doc-heading">
 element to the text:change-id attribute on the &ldquo;text:change-start&rdquo;
 and &ldquo;text:change-end&rdquo; elements.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">103</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">103</span>
 <span class="normal">104</span>
 <span class="normal">105</span>
 <span class="normal">106</span>
@@ -70681,12 +69955,11 @@ <h2 id="odfdo.TextInsertion" class="doc doc-heading">
         <span class="k">else</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="n">new_change_info</span><span class="p">,</span> <span class="n">xmlposition</span><span class="o">=</span><span class="n">FIRST_CHILD</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -70699,21 +69972,20 @@ <h2 id="odfdo.TextInsertion" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextInsertion.get_change_info" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_change_info</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">get_change_info</span><span class="p">()</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get the ChangeInfo child of the element.</p>
 <p>Return: ChangeInfo element.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">164</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">164</span>
 <span class="normal">165</span>
 <span class="normal">166</span>
 <span class="normal">167</span>
@@ -70725,29 +69997,27 @@ <h3 id="odfdo.TextInsertion.get_change_info" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_element</span><span class="p">(</span><span class="s2">&quot;descendant::office:change-info&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextInsertion.get_deleted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_deleted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return: None.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">116</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">116</span>
 <span class="normal">117</span>
 <span class="normal">118</span>
 <span class="normal">119</span>
@@ -70765,24 +70035,22 @@ <h3 id="odfdo.TextInsertion.get_deleted" class="doc doc-heading">
         <span class="k">return</span> <span class="s2">&quot;&quot;</span>
     <span class="k">return</span> <span class="kc">None</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextInsertion.get_inserted" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">get_inserted</span><span class="p">(</span><span class="n">as_text</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Shortcut to text:change-start.get_inserted(). Return the content
 between text:change-start and text:change-end.</p>
 <p>If as_text is True: returns the text content.
@@ -70798,9 +70066,9 @@ <h3 id="odfdo.TextInsertion.get_inserted" class="doc doc-heading">
 </code></pre>
 <p>Return: list or Element or text</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">126</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">126</span>
 <span class="normal">127</span>
 <span class="normal">128</span>
 <span class="normal">129</span>
@@ -70874,24 +70142,22 @@ <h3 id="odfdo.TextInsertion.get_inserted" class="doc doc-heading">
         <span class="n">as_text</span><span class="o">=</span><span class="n">as_text</span><span class="p">,</span> <span class="n">no_header</span><span class="o">=</span><span class="n">no_header</span><span class="p">,</span> <span class="n">clean</span><span class="o">=</span><span class="n">clean</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.TextInsertion.set_change_info" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">set_change_info</span><span class="p">(</span><span class="n">change_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">comments</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">set_change_info</span><span class="p">(</span><span class="n">change_info</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">creator</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">date</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">comments</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Set the ChangeInfo element for the change element. If change_info
 is not provided, creator, date and comments will be used to build a
 suitable change info element. Default for creator is &lsquo;Unknown&rsquo;,
@@ -70908,9 +70174,9 @@ <h3 id="odfdo.TextInsertion.set_change_info" class="doc doc-heading">
  comments -- Paragraph or list of Paragraph elements (or None)
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">171</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">171</span>
 <span class="normal">172</span>
 <span class="normal">173</span>
 <span class="normal">174</span>
@@ -71004,8 +70270,8 @@ <h3 id="odfdo.TextInsertion.set_change_info" class="doc doc-heading">
     <span class="k">else</span><span class="p">:</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="n">new_change_info</span><span class="p">,</span> <span class="n">xmlposition</span><span class="o">=</span><span class="n">FIRST_CHILD</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -71013,8 +70279,7 @@ <h3 id="odfdo.TextInsertion.set_change_info" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -71023,25 +70288,25 @@ <h3 id="odfdo.TextInsertion.set_change_info" class="doc doc-heading">
 
 
 <h2 id="odfdo.TocEntryTemplate" class="doc doc-heading">
-          <code>TocEntryTemplate</code>
+            <code>TocEntryTemplate</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>ODF &ldquo;text:table-of-content-entry-template&rdquo;</p>
 <p>Arguments:</p>
 <pre><code>style -- str
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/toc.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">466</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/toc.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">466</span>
 <span class="normal">467</span>
 <span class="normal">468</span>
 <span class="normal">469</span>
@@ -71123,9 +70388,9 @@ <h2 id="odfdo.TocEntryTemplate" class="doc doc-heading">
         <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">ts</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">Element</span><span class="o">.</span><span class="n">from_tag</span><span class="p">(</span><span class="s2">&quot;text:index-entry-page-number&quot;</span><span class="p">))</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -71141,8 +70406,7 @@ <h2 id="odfdo.TocEntryTemplate" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -71151,17 +70415,17 @@ <h2 id="odfdo.TocEntryTemplate" class="doc doc-heading">
 
 
 <h2 id="odfdo.TrackedChanges" class="doc doc-heading">
-          <code>TrackedChanges</code>
+            <code>TrackedChanges</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>The TrackedChanges &ldquo;text:tracked-changes&rdquo; element acts as a container
 for TextChangedRegion elements that represent changes in a certain
 scope of an OpenDocument document. This scope is the element in which
@@ -71172,9 +70436,9 @@ <h2 id="odfdo.TrackedChanges" class="doc doc-heading">
 scope. In this case, all change mark elements in this scope shall be
 ignored.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">421</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/tracked_changes.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">421</span>
 <span class="normal">422</span>
 <span class="normal">423</span>
 <span class="normal">424</span>
@@ -71282,12 +70546,11 @@ <h2 id="odfdo.TrackedChanges" class="doc doc-heading">
             <span class="n">content</span><span class="o">=</span><span class="n">content</span><span class="p">,</span>
         <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -71298,10 +70561,10 @@ <h2 id="odfdo.TrackedChanges" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -71310,17 +70573,17 @@ <h2 id="odfdo.TrackedChanges" class="doc doc-heading">
 
 
 <h2 id="odfdo.UserDefined" class="doc doc-heading">
-          <code>UserDefined</code>
+            <code>UserDefined</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element_typed.ElementTyped" href="#odfdo.ElementTyped">ElementTyped</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element_typed.ElementTyped" href="#odfdo.ElementTyped">ElementTyped</a></code></p>
+
 
-  
       <p>Return a user defined field &ldquo;text:user-defined&rdquo;. If the current
 document is provided, try to extract the content of the meta user defined
 field of same name.</p>
@@ -71338,9 +70601,9 @@ <h2 id="odfdo.UserDefined" class="doc doc-heading">
 from_document -- ODF document
 </code></pre>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/variable.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">211</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/variable.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">211</span>
 <span class="normal">212</span>
 <span class="normal">213</span>
 <span class="normal">214</span>
@@ -71446,12 +70709,11 @@ <h2 id="odfdo.UserDefined" class="doc doc-heading">
             <span class="p">)</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">text</span> <span class="o">=</span> <span class="n">text</span>  <span class="c1"># type: ignore</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -71462,10 +70724,10 @@ <h2 id="odfdo.UserDefined" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -71474,20 +70736,20 @@ <h2 id="odfdo.UserDefined" class="doc doc-heading">
 
 
 <h2 id="odfdo.VarChapter" class="doc doc-heading">
-          <code>VarChapter</code>
+            <code>VarChapter</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/variable.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">375</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/variable.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">375</span>
 <span class="normal">376</span>
 <span class="normal">377</span>
 <span class="normal">378</span>
@@ -71547,12 +70809,11 @@ <h2 id="odfdo.VarChapter" class="doc doc-heading">
             <span class="k">if</span> <span class="n">outline_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">outline_level</span> <span class="o">=</span> <span class="n">outline_level</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -71565,21 +70826,20 @@ <h2 id="odfdo.VarChapter" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.VarChapter.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">display</span><span class="o">=</span><span class="s1">&#39;name&#39;</span><span class="p">,</span> <span class="n">outline_level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">display</span><span class="o">=</span><span class="s1">&#39;name&#39;</span><span class="p">,</span> <span class="n">outline_level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>display can be: &lsquo;number&rsquo;, &lsquo;name&rsquo;, &lsquo;number-and-name&rsquo;, &lsquo;plain-number&rsquo; or
 &lsquo;plain-number-and-name&rsquo;</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/variable.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">389</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/variable.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">389</span>
 <span class="normal">390</span>
 <span class="normal">391</span>
 <span class="normal">392</span>
@@ -71611,8 +70871,8 @@ <h3 id="odfdo.VarChapter.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">outline_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">outline_level</span> <span class="o">=</span> <span class="n">outline_level</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -71620,8 +70880,7 @@ <h3 id="odfdo.VarChapter.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -71630,20 +70889,20 @@ <h3 id="odfdo.VarChapter.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.VarFileName" class="doc doc-heading">
-          <code>VarFileName</code>
+            <code>VarFileName</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
 
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/variable.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">410</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/variable.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">410</span>
 <span class="normal">411</span>
 <span class="normal">412</span>
 <span class="normal">413</span>
@@ -71697,12 +70956,11 @@ <h2 id="odfdo.VarFileName" class="doc doc-heading">
             <span class="k">if</span> <span class="n">fixed</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">fixed</span> <span class="o">=</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -71715,20 +70973,19 @@ <h2 id="odfdo.VarFileName" class="doc doc-heading">
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.VarFileName.__init__" class="doc doc-heading">
-          <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">display</span><span class="o">=</span><span class="s1">&#39;full&#39;</span><span class="p">,</span> <span class="n">fixed</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">display</span><span class="o">=</span><span class="s1">&#39;full&#39;</span><span class="p">,</span> <span class="n">fixed</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>display can be: &lsquo;full&rsquo;, &lsquo;path&rsquo;, &lsquo;name&rsquo; or &lsquo;name-and-extension&rsquo;</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/variable.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">423</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/variable.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">423</span>
 <span class="normal">424</span>
 <span class="normal">425</span>
 <span class="normal">426</span>
@@ -71756,8 +71013,8 @@ <h3 id="odfdo.VarFileName.__init__" class="doc doc-heading">
         <span class="k">if</span> <span class="n">fixed</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">fixed</span> <span class="o">=</span> <span class="kc">True</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -71765,8 +71022,7 @@ <h3 id="odfdo.VarFileName.__init__" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
@@ -71775,23 +71031,23 @@ <h3 id="odfdo.VarFileName.__init__" class="doc doc-heading">
 
 
 <h2 id="odfdo.VarPageNumber" class="doc doc-heading">
-          <code>VarPageNumber</code>
+            <code>VarPageNumber</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="odfdo.element.Element" href="#odfdo.Element">Element</a></code></p>
+
 
-  
       <p>select_page &ndash; string in (&lsquo;previous&rsquo;, &lsquo;current&rsquo;, &lsquo;next&rsquo;)</p>
 <p>page_adjust &ndash; int (to add or subtract to the page number)</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/variable.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">269</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/variable.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">269</span>
 <span class="normal">270</span>
 <span class="normal">271</span>
 <span class="normal">272</span>
@@ -71843,12 +71099,11 @@ <h2 id="odfdo.VarPageNumber" class="doc doc-heading">
             <span class="k">if</span> <span class="n">page_adjust</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">page_adjust</span> <span class="o">=</span> <span class="n">page_adjust</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
 
-  
 
-  <div class="doc doc-children">
 
+  <div class="doc doc-children">
 
 
 
@@ -71859,10 +71114,10 @@ <h2 id="odfdo.VarPageNumber" class="doc doc-heading">
 
 
 
-  </div>
 
   </div>
 
+    </div>
 
 </div>
 
@@ -71871,21 +71126,21 @@ <h2 id="odfdo.VarPageNumber" class="doc doc-heading">
 
 
 <h2 id="odfdo.XmlPart" class="doc doc-heading">
-          <code>XmlPart</code>
+            <code>XmlPart</code>
 
 
 </h2>
 
 
-  <div class="doc doc-contents ">
+    <div class="doc doc-contents ">
+
 
-  
       <p>Representation of an XML part.</p>
 <p>Abstraction of the XML library behind.</p>
 
-            <details class="quote">
-              <summary>Source code in <code>odfdo/xmlpart.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 36</span>
+              <details class="quote">
+                <summary>Source code in <code>odfdo/xmlpart.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 36</span>
 <span class="normal"> 37</span>
 <span class="normal"> 38</span>
 <span class="normal"> 39</span>
@@ -72081,9 +71336,9 @@ <h2 id="odfdo.XmlPart" class="doc doc-heading">
             <span class="n">bytes_tree</span> <span class="o">=</span> <span class="n">bytes_tree</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
         <span class="k">return</span> <span class="n">xml_header</span> <span class="o">+</span> <span class="n">bytes_tree</span>
 </code></pre></div></td></tr></table></div>
-            </details>
+              </details>
+
 
-  
 
   <div class="doc doc-children">
 
@@ -72098,8 +71353,8 @@ <h2 id="odfdo.XmlPart" class="doc doc-heading">
 
 
 <h3 id="odfdo.XmlPart.body" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">body</span><span class="p">:</span> <span class="n">Element</span></code>
-  
+            <code class="highlight language-python"><span class="n">body</span><span class="p">:</span> <span class="n">Element</span></code>
+
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-property"><code>property</code></small>
       <small class="doc doc-label doc-label-writable"><code>writable</code></small>
@@ -72108,34 +71363,32 @@ <h3 id="odfdo.XmlPart.body" class="doc doc-heading">
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Get or set the document body : &lsquo;office:body&rsquo;</p>
-  </div>
+    </div>
 
 </div>
 
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h3 id="odfdo.XmlPart.xpath" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span></code>
 
 </h3>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Apply XPath query to the XML part. Return list of Element or
 EText instances translated from the nodes found.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/xmlpart.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">101</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/xmlpart.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">101</span>
 <span class="normal">102</span>
 <span class="normal">103</span>
 <span class="normal">104</span>
@@ -72147,8 +71400,8 @@ <h3 id="odfdo.XmlPart.xpath" class="doc doc-heading">
     <span class="n">root</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">root</span>
     <span class="k">return</span> <span class="n">root</span><span class="o">.</span><span class="n">xpath</span><span class="p">(</span><span class="n">xpath_query</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -72156,34 +71409,32 @@ <h3 id="odfdo.XmlPart.xpath" class="doc doc-heading">
 
   </div>
 
-  </div>
-
+    </div>
 
 </div>
 
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.PageBreak" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">PageBreak</span><span class="p">()</span></code>
+            <code class="highlight language-python"><span class="n">PageBreak</span><span class="p">()</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return an empty paragraph with a manual page break.</p>
 
+
 <details class="using-this-function-requires-to-register-the-page-break-style-with" open>
   <summary>Using this function requires to register the page break style with</summary>
   <p>document.add_page_break_style()</p>
 </details>
-          <details class="quote">
-            <summary>Source code in <code>odfdo/paragraph.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">830</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/paragraph.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">830</span>
 <span class="normal">831</span>
 <span class="normal">832</span>
 <span class="normal">833</span>
@@ -72197,24 +71448,22 @@ <h2 id="odfdo.PageBreak" class="doc doc-heading">
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">return</span> <span class="n">Paragraph</span><span class="p">(</span><span class="s2">&quot;&quot;</span><span class="p">,</span> <span class="n">style</span><span class="o">=</span><span class="s2">&quot;odfdopagebreak&quot;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.create_table_cell_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">create_table_cell_style</span><span class="p">(</span><span class="n">border</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">background_color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">shadow</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">create_table_cell_style</span><span class="p">(</span><span class="n">border</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">border_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_top</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_bottom</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_left</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">padding_right</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">background_color</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">shadow</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Return a cell style.</p>
 <p>The borders arguments must be some style attribute strings or None, see the
 method &lsquo;make_table_cell_border_string&rsquo; to generate them.
@@ -72257,9 +71506,9 @@ <h2 id="odfdo.create_table_cell_style" class="doc doc-heading">
 </code></pre>
 <p>Return : Style</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">186</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">186</span>
 <span class="normal">187</span>
 <span class="normal">188</span>
 <span class="normal">189</span>
@@ -72451,33 +71700,31 @@ <h2 id="odfdo.create_table_cell_style" class="doc doc-heading">
         <span class="n">cell_style</span><span class="o">.</span><span class="n">set_properties</span><span class="p">(</span><span class="n">area</span><span class="o">=</span><span class="s2">&quot;text&quot;</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="n">color</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">cell_style</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.default_frame_position_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">default_frame_position_style</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;FramePosition&#39;</span><span class="p">,</span> <span class="n">horizontal_pos</span><span class="o">=</span><span class="s1">&#39;from-left&#39;</span><span class="p">,</span> <span class="n">vertical_pos</span><span class="o">=</span><span class="s1">&#39;from-top&#39;</span><span class="p">,</span> <span class="n">horizontal_rel</span><span class="o">=</span><span class="s1">&#39;paragraph&#39;</span><span class="p">,</span> <span class="n">vertical_rel</span><span class="o">=</span><span class="s1">&#39;paragraph&#39;</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">default_frame_position_style</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;FramePosition&#39;</span><span class="p">,</span> <span class="n">horizontal_pos</span><span class="o">=</span><span class="s1">&#39;from-left&#39;</span><span class="p">,</span> <span class="n">vertical_pos</span><span class="o">=</span><span class="s1">&#39;from-top&#39;</span><span class="p">,</span> <span class="n">horizontal_rel</span><span class="o">=</span><span class="s1">&#39;paragraph&#39;</span><span class="p">,</span> <span class="n">vertical_rel</span><span class="o">=</span><span class="s1">&#39;paragraph&#39;</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Helper style for positioning frames in desktop applications that need
 it.</p>
 <p>Default arguments should be enough.</p>
 <p>Use the returned Style as the frame style or build a new graphic style
 with this style as the parent.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/frame.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">41</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/frame.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">41</span>
 <span class="normal">42</span>
 <span class="normal">43</span>
 <span class="normal">44</span>
@@ -72523,29 +71770,27 @@ <h2 id="odfdo.default_frame_position_style" class="doc doc-heading">
         <span class="n">vertical_rel</span><span class="o">=</span><span class="n">vertical_rel</span><span class="p">,</span>
     <span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.default_toc_level_style" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">default_toc_level_style</span><span class="p">(</span><span class="n">level</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">default_toc_level_style</span><span class="p">(</span><span class="n">level</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Generate an automatic default style for the given TOC level.</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/toc.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">149</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/toc.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">149</span>
 <span class="normal">150</span>
 <span class="normal">151</span>
 <span class="normal">152</span>
@@ -72577,24 +71822,22 @@ <h2 id="odfdo.default_toc_level_style" class="doc doc-heading">
     <span class="n">toc_style_level</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">properties</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">toc_style_level</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.hex2rgb" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">hex2rgb</span><span class="p">(</span><span class="n">color</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">hex2rgb</span><span class="p">(</span><span class="n">color</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Turns a &ldquo;#RRGGBB&rdquo; hexadecimal color representation into a (R, G, B)
 tuple.</p>
 <p>Arguments:</p>
@@ -72602,9 +71845,9 @@ <h2 id="odfdo.hex2rgb" class="doc doc-heading">
 </code></pre>
 <p>Return: tuple</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/utils/color.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">25</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/utils/color.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">25</span>
 <span class="normal">26</span>
 <span class="normal">27</span>
 <span class="normal">28</span>
@@ -72638,24 +71881,22 @@ <h2 id="odfdo.hex2rgb" class="doc doc-heading">
     <span class="n">blue</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">code</span><span class="p">[</span><span class="mi">4</span><span class="p">:</span><span class="mi">6</span><span class="p">],</span> <span class="mi">16</span><span class="p">)</span>
     <span class="k">return</span> <span class="p">(</span><span class="n">red</span><span class="p">,</span> <span class="n">green</span><span class="p">,</span> <span class="n">blue</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.hexa_color" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">hexa_color</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">hexa_color</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Convert a color definition of type tuple or string to hexadecimal
 representation.</p>
 <p>Empty string is converted to black.
@@ -72665,9 +71906,9 @@ <h2 id="odfdo.hexa_color" class="doc doc-heading">
 </code></pre>
 <p>Return: str or None</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/utils/color.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 80</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/utils/color.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 80</span>
 <span class="normal"> 81</span>
 <span class="normal"> 82</span>
 <span class="normal"> 83</span>
@@ -72717,24 +71958,22 @@ <h2 id="odfdo.hexa_color" class="doc doc-heading">
         <span class="k">return</span> <span class="n">color</span>
     <span class="k">return</span> <span class="n">rgb2hex</span><span class="p">(</span><span class="n">color</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.make_table_cell_border_string" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">make_table_cell_border_string</span><span class="p">(</span><span class="n">thick</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">line</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">make_table_cell_border_string</span><span class="p">(</span><span class="n">thick</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">line</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">color</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Returns a string for style:table-cell-properties fo:border,
 with default : &ldquo;0.06pt solid #000000&rdquo;</p>
 <pre><code>thick -- str or float or int
@@ -72743,9 +71982,9 @@ <h2 id="odfdo.make_table_cell_border_string" class="doc doc-heading">
 </code></pre>
 <p>Returns : str</p>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/style.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">166</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/style.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">166</span>
 <span class="normal">167</span>
 <span class="normal">168</span>
 <span class="normal">169</span>
@@ -72781,24 +72020,22 @@ <h2 id="odfdo.make_table_cell_border_string" class="doc doc-heading">
     <span class="n">color_string</span> <span class="o">=</span> <span class="n">hexa_color</span><span class="p">(</span><span class="n">color</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;#000000&quot;</span>
     <span class="k">return</span> <span class="s2">&quot; &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">((</span><span class="n">thick_string</span><span class="p">,</span> <span class="n">line_string</span><span class="p">,</span> <span class="n">color_string</span><span class="p">))</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
-
 <div class="doc doc-object doc-function">
 
 
-
 <h2 id="odfdo.rgb2hex" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">rgb2hex</span><span class="p">(</span><span class="n">color</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">rgb2hex</span><span class="p">(</span><span class="n">color</span><span class="p">)</span></code>
 
 </h2>
 
 
-  <div class="doc doc-contents ">
-  
+    <div class="doc doc-contents ">
+
       <p>Turns a color name or a (R, G, B) color tuple into a &ldquo;#RRGGBB&rdquo;
 hexadecimal representation.</p>
 <p>Arguments:</p>
@@ -72812,9 +72049,9 @@ <h2 id="odfdo.rgb2hex" class="doc doc-heading">
 '#EE82EE'
 </code></pre>
 
-          <details class="quote">
-            <summary>Source code in <code>odfdo/utils/color.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">44</span>
+            <details class="quote">
+              <summary>Source code in <code>odfdo/utils/color.py</code></summary>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">44</span>
 <span class="normal">45</span>
 <span class="normal">46</span>
 <span class="normal">47</span>
@@ -72882,8 +72119,8 @@ <h2 id="odfdo.rgb2hex" class="doc doc-heading">
             <span class="p">)</span>
     <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;#</span><span class="si">{</span><span class="n">code</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="si">:</span><span class="s2">02X</span><span class="si">}{</span><span class="n">code</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="si">:</span><span class="s2">02X</span><span class="si">}{</span><span class="n">code</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span><span class="si">:</span><span class="s2">02X</span><span class="si">}</span><span class="s2">&quot;</span>
 </code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+            </details>
+    </div>
 
 </div>
 
@@ -72891,7 +72128,7 @@ <h2 id="odfdo.rgb2hex" class="doc doc-heading">
 
   </div>
 
-  </div>
+    </div>
 
 </div>
 
@@ -72943,7 +72180,7 @@ <h2 id="odfdo.rgb2hex" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": ".", "features": [], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="assets/javascripts/bundle.a7c05c9e.min.js"></script>
+      <script src="assets/javascripts/bundle.081f42fc.min.js"></script>
       
     
   </body>
diff --git a/doc/search/search_index.json b/doc/search/search_index.json
index 3e51c99..be2116d 100644
--- a/doc/search/search_index.json
+++ b/doc/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"odfdo","text":"<p>Python library for OpenDocument format (ODF)</p> <p></p> <p><code>odfdo</code> is a Python3 library implementing the ISO/IEC 26300 OpenDocument Format standard.</p> <p>Project: https://github.com/jdum/odfdo</p> <p>Author: jerome.dumonteil@gmail.com</p> <p>License: Apache License, Version 2.0</p> <p><code>odfdo</code> is a derivative work of the former <code>lpod-python</code> project.</p>"},{"location":"index.html#installation","title":"Installation","text":"<p>Installation from Pypi (recommended):</p> <pre><code>pip install odfdo\n</code></pre> <p>Installation from sources (requiring setuptools):</p> <pre><code>pip install .\n</code></pre> <p>After installation from sources, you can check everything is working (some requirements: <code>pytest</code>, Pillow, \u2026):</p> <pre><code>pytest\n</code></pre> <p>The tests should run for a few seconds or minutes and issue no error.</p>"},{"location":"index.html#usage","title":"Usage","text":"<pre><code>from odfdo import Document, Paragraph\n\ndoc = Document('text')\ndoc.body.append(Paragraph(\"Hello world!\"))\ndoc.save(\"hello.odt\")\n</code></pre>"},{"location":"index.html#tldr","title":"tl;dr","text":"<p>\u2018Intended Audience :: Developers\u2019</p>"},{"location":"index.html#documentation","title":"Documentation","text":"<p>There is no detailed documentation or tutorial, but:</p> <ul> <li>the <code>recipes</code> folder contains more than 50 working sample scripts,</li> <li>the <code>doc</code> folder contains an auto generated documentation.</li> </ul> <p>When installing odfdo, a few scripts are installed:</p> <ul> <li><code>odfdo-diff</code>: show a diff between two .odt document.</li> <li><code>odfdo-folder</code>: convert standard ODF file to folder and files, and reverse.</li> <li><code>odfdo-show</code>: dump text from an ODF file to the standard output, and optionally styles and meta informations.</li> <li><code>odfdo-styles</code>: command line interface tool to manipulate styles of ODF files.</li> <li><code>odfdo-replace</code>: find a pattern (regex) in an ODF file and replace by some string.</li> <li><code>odfdo-highlight</code>: highlight the text matching a pattern (regex) in an ODF file.</li> <li><code>odfdo-headers</code>: print the headers of an ODF file.</li> <li><code>odfdo-table-shrink</code>: shrink tables to optimize width and height.</li> </ul> <p>About styles: the best way to apply style is by merging styles from a template document into your generated document (See <code>odfdo-styles</code> script). Styles are a complex matter in ODF, so trying to generate styles programmatically is not recommended.</p>"},{"location":"index.html#limitations","title":"Limitations","text":"<p><code>odfdo</code> is intended to facilitate the generation of ODF documents, nevertheless a basic knowledge of the ODF format is necessary.</p> <p>ODF document rendering can vary greatly from software to software. Especially the \u201cstyles\u201d of the document allow an adaptation of the rendering for a particular software.</p> <p>The best (only ?) way to apply style is by merging styles from a template document into your generated document. However a few recipes show how to make programmatically some basic styles: <code>create_basic_text_styles</code>, <code>add_text_span_styles</code>).</p>"},{"location":"index.html#related-project","title":"Related project","text":"<p>I you work on <code>.ods</code> files (spreadsheet), you may be interested by these scripts using this library to parse/generate <code>.ods</code> files: <code>https://github.com/jdum/odsgenerator</code> and <code>https://github.com/jdum/odsparsator</code></p>"},{"location":"index.html#changes-from-former-lpod-library","title":"Changes from former lpod library","text":"<p><code>lpod-python</code> was written in 2009-2010 as a Python 2.x library, see: <code>https://github.com/lpod/lpod-python</code></p> <p><code>odfdo</code> is an adaptation of this former project. <code>odfdo</code> main changes from <code>lpod</code>:</p> <ul> <li><code>odfdo</code> requires Python version 3.9 to 3.12. For Python 3.6 to 3.8 see previous releases.</li> <li>API change: more pythonic.</li> <li>include recipes.</li> <li>use Apache 2.0 license.</li> </ul>"},{"location":"CHANGES.html","title":"Odfdo Release Notes","text":""},{"location":"CHANGES.html#3710-2024-05-4","title":"[3.7.10] - 2024-05-4","text":"<ul> <li> <p>Refactor to add property getter for some common methods. Original get_*     method is still available and permits detailed requests with parameters.</p> <pre><code>-   Body.tables -&gt; Body.get_tables()\n-   Element.tocs -&gt; Element.get_tocs()\n-   Element.toc -&gt; Element.get_toc()\n-   Element.text_changes -&gt; Element.get_text_changes()\n-   Element.tracked_changes -&gt; Element.get_tracked_changes()\n-   Element.user_defined_list -&gt; Element.get_user_defined_list()\n-   Element.images -&gt; Element.get_images()\n-   Element.frames -&gt; Element.get_frames()\n-   Element.lists -&gt; Element.get_lists()\n-   Element.headers -&gt; Element.get_headers()\n-   Element.spans -&gt; Element.get_spans()\n-   Element.paragraphs -&gt; Element.get_paragraphs()\n-   Element.sections -&gt; Element.get_sections()\n-   Table.rows -&gt; Table.get_rows()\n-   Table.cells -&gt; Table.get_cells()\n-   Table.columns -&gt; Table.get_columns()\n-   Row.cells -&gt; Row.get_cells()\n-   Document.parts -&gt; Document.get_parts()\n-   Container.parts -&gt; Container.get_parts()\n</code></pre> </li> <li> <p>Refactor to add property getter/setter for some common methods. Original get_*     and set_* methods are still available and permit detailed requests with parameters.</p> <pre><code>-   Column.default_cell_style -&gt; Column.get/set_default_cell_style()\n</code></pre> </li> </ul>"},{"location":"CHANGES.html#added","title":"Added","text":"<ul> <li>Added <code>Body.tables</code></li> <li>Added <code>Element.tocs</code></li> <li>Added <code>Element.toc</code></li> <li>Added <code>Element.text_changes</code></li> <li>Added <code>Element.tracked_changes</code></li> <li>Added <code>Element.images</code></li> <li>Added <code>Element.frames</code></li> <li>Added <code>Element.lists</code></li> <li>Added <code>Element.headers</code></li> <li>Added <code>Element.spans</code></li> <li>Added <code>Element.paragraphs</code></li> <li>Added <code>Element.sections</code></li> <li>Added <code>Column.default_cell_style</code></li> <li>Added <code>Table.rows</code></li> <li>Added <code>Table.cells</code></li> <li>Added <code>Table.columns</code></li> <li>Added <code>Row.cells</code></li> <li>Added <code>Document.parts</code></li> <li>Added <code>Container.parts</code></li> </ul>"},{"location":"CHANGES.html#379-2024-05-3","title":"[3.7.9] - 2024-05-3","text":"<ul> <li> <p>Refactor the Body access methods, creating relevant a Body class and related sub-classes. Moved some access method from the Element class to relevant Body sub-classes.</p> </li> <li> <p>Refactor metadata methods to permit access throuh @property (the legacy get_* and set_* methods are still available).</p> </li> <li> <p>Added a few metadata elements from the ODF standard (hyperlink-behaviour, auto-reload, template, print-dateprinted-by)</p> </li> </ul>"},{"location":"CHANGES.html#added_1","title":"Added","text":"<ul> <li>Added <code>MetaAutoReload</code> class</li> <li>Added <code>MetaHyperlinkBehaviour</code> class</li> <li>Added <code>MetaTemplate</code> class</li> <li>Added <code>DcCreatorMixin</code> class</li> <li>Added <code>DcDateMixin</code> class</li> <li>Added <code>Body</code> class</li> <li>Added <code>Chart</code> class</li> <li>Added <code>Database</code> class</li> <li>Added <code>Drawing</code> class</li> <li>Added <code>Image</code> class</li> <li>Added <code>Presentation</code> class</li> <li>Added <code>Spreadsheet</code> class</li> <li>Added <code>Text</code> class (renaming the previous internal <code>Text</code> class to <code>EText</code>)</li> </ul>"},{"location":"CHANGES.html#378-2024-05-2","title":"[3.7.8] - 2024-05-2","text":"<p>Fix embedded chart analysis in documents, see recipe <code>change_values_of_a_chart_inside_a_document.py</code>.</p>"},{"location":"CHANGES.html#added_2","title":"Added","text":"<ul> <li>Added <code>change_values_of_a_chart_inside_a_document.py</code> recipe</li> </ul>"},{"location":"CHANGES.html#changed","title":"Changed","text":"<ul> <li> <p>The \u201cpretty\u201d setting when saving the file always defaults to False. This setting should only be used for debugging purposes</p> </li> <li> <p><code>meta.generator</code> can be used via a @property accessor</p> </li> <li> <p>(Internal change) move body() definition to xmlpart</p> </li> <li> <p>(Internal change) refactoring for future XML feature</p> </li> </ul>"},{"location":"CHANGES.html#fixed","title":"Fixed","text":"<ul> <li> <p>Fix parsing of Table when parent uses \u201ctable:table-rows\u201d kind of wrapper</p> </li> <li> <p>Fix a bug when a Cell contains the valid \u2018NaN\u2019 Decimal number</p> </li> </ul>"},{"location":"CHANGES.html#377-2024-04-1","title":"[3.7.7] - 2024-04-1","text":"<p>Improvement of the <code>lxml</code> dependency support.</p>"},{"location":"CHANGES.html#added_3","title":"Added","text":"<ul> <li> <p>Added a <code>CHANGES.md</code> file</p> </li> <li> <p>Automatic tests for ubuntu-latest, macos-latest, windows-latest</p> </li> </ul>"},{"location":"CHANGES.html#changed_1","title":"Changed","text":"<ul> <li> <p>Now supports a wider range of <code>lxml</code> versions:</p> <ul> <li> <p>python 3.9: lxml version 4.8.0 to 4.9.4</p> </li> <li> <p>python 3.10: lxml version 4.8.0 to 5.1.1</p> </li> <li> <p>python 3.11: lxml version 4.9.4 to 5.2.0 and beyond</p> </li> <li> <p>python 3.12: lxml version 4.9.4 to 5.2.0 and beyond</p> </li> </ul> </li> <li> <p>autogenerated documentation now uses <code>mkdocs</code></p> </li> </ul>"},{"location":"CHANGES.html#fixed_1","title":"Fixed","text":"<ul> <li> <p>Use <code>sys.executable</code> to ensure all tests can pass in a github virtualenv on Windows.</p> </li> <li> <p>Remove import of <code>lxml</code> internal <code>\\_ElementUnicodeResult</code> and <code>\\_ElementUnicodeResult</code> classes.</p> </li> </ul>"},{"location":"CHANGES.html#376-2024-03-30","title":"[3.7.6] - 2024-03-30","text":"<p>Quick fix for the crash with new <code>lxml</code> version 5.1.1</p>"},{"location":"CHANGES.html#fixed_2","title":"Fixed","text":"<pre><code>- Fix crash with `lxml` 5.1.1 by restricting version do 5.1.0\n</code></pre>"},{"location":"CHANGES.html#375-2024-03-23","title":"[3.7.5] - 2024-03-23","text":"<p>Add the method <code>get_cell_background_color</code> to retrieve the background color of a cell in a table.</p>"},{"location":"CHANGES.html#added_4","title":"Added","text":"<ul> <li> <p>Tables: some users need to easily access the background color of cells, including cells without \u201cvalue\u201d content. That was requiring a complex parsing of styles. So a new method: <code>Document.get_cell_background_color(sheet_id, cell_coords)</code>.</p> </li> <li> <p>See the corresponding recipe <code>recipes/get_cell_background_color.py</code> for an exemple of usage.</p> </li> <li> <p>Tables: (related to previous). It is often useful to reduce the table size before working on it, especially if styles apply to whole rows. A method called <code>Table.rstrip()</code> already permitted to remove empty bottom rows and empty right columns. However, a <code>Cell</code> mays have no value but a style (color background for example), and <code>rstrip()</code> was removing such cells. So an new clever method is provided: <code>Table.optimize_width()</code> that shrink the table size, still keeping styled empty cells.</p> </li> <li> <p>To test the actual result of this method, you can use the new script <code>odfdo-table-shrink</code> which is basically a wrapper upon this method. (Note: all this stuff aims to facilitate some feature for the related github project <code>odsparsator</code>).</p> </li> <li> <p><code>repr()</code> method for <code>Cell</code>, <code>Row</code> and <code>Column</code>.</p> </li> <li> <p>Ancillary methods related to above features.</p> </li> </ul>"},{"location":"CHANGES.html#fixed_3","title":"Fixed","text":"<ul> <li><code>Document(path)</code> now accepts a <code>str</code> path starting with <code>~</code> as the path relative to the user home.</li> </ul>"},{"location":"CHANGES.html#changed_2","title":"Changed","text":"<ul> <li> <p>Tables: (related to previous), change the <code>Cell.is_empty()</code> test. A cell is now considered as not empty if part of a <code>span</code> (a cell spanned on several rows or columns). This may induce some changes for parsing scripts. Before that, only the first cell of the span (which actually contains the value) was considered as non empty. Now other cells of the span are not empty (but contain a null value).</p> </li> <li> <p>Minor refactor of code, version updates of dependencies.</p> </li> </ul>"},{"location":"CHANGES.html#374-2024-03-17","title":"[3.7.4] - 2024-03-17","text":"<p>Add a recipe as example of programmatically setting text styles for headers and paragraphs, with basic font and color properties.</p>"},{"location":"CHANGES.html#added_5","title":"Added","text":"<ul> <li> <p>Add recipe <code>create_basic_text_styles</code>.</p> </li> <li> <p>All style fields related to color accept a color name from the CSS list of color.</p> </li> </ul>"},{"location":"CHANGES.html#changed_3","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#373-2024-03-10","title":"[3.7.3] - 2024-03-10","text":"<p>Internal maintenance release.</p>"},{"location":"CHANGES.html#fixed_4","title":"Fixed","text":"<ul> <li>Fix logo link on <code>Pypi</code> page.</li> </ul>"},{"location":"CHANGES.html#changed_4","title":"Changed","text":"<ul> <li> <p>Technical updates from <code>optparse</code> to <code>argparse</code>.</p> </li> <li> <p>Updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#372-2024-03-9","title":"[3.7.2] - 2024-03-9","text":"<p>Internal maintenance release.</p>"},{"location":"CHANGES.html#changed_5","title":"Changed","text":"<ul> <li> <p>Use <code>pdoc</code> for autogenerated documentation.</p> </li> <li> <p>Refactor some recipes to use them in a test suit.</p> </li> <li> <p>Code refactor, Updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#371-2024-03-3","title":"[3.7.1] - 2024-03-3","text":"<p>Minor performance improvement of script <code>odfdo-headers</code>.</p>"},{"location":"CHANGES.html#changed_6","title":"Changed","text":"<ul> <li>Use better algorithm for script <code>odfdo-headers</code>.</li> </ul>"},{"location":"CHANGES.html#370-2024-03-2","title":"[3.7.0] - 2024-03-2","text":"<p>New script <code>odfdo-headers</code> to print the headers of a <code>ODF</code> file.</p>"},{"location":"CHANGES.html#added_6","title":"Added","text":"<ul> <li>Add script <code>odfdo-headers</code>.</li> </ul>"},{"location":"CHANGES.html#changed_7","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#360-2024-02-25","title":"[3.6.0] - 2024-02-25","text":"<p>New script <code>odfdo-highlight</code> to highlight the text matching a pattern (regex) in a <code>ODF</code> file.</p>"},{"location":"CHANGES.html#added_7","title":"Added","text":"<ul> <li>Add script <code>odfdo-highlight</code>.</li> </ul>"},{"location":"CHANGES.html#changed_8","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#351-2024-02-20","title":"[3.5.1] - 2024-02-20","text":"<p>Fix the update method of <code>Table of Content</code> and add a recipe to show how to update a <code>TOC</code>.</p>"},{"location":"CHANGES.html#added_8","title":"Added","text":"<ul> <li>Add recipe <code>update_a_text_document_with_a_table_of_content</code>.</li> </ul>"},{"location":"CHANGES.html#changed_9","title":"Changed","text":"<ul> <li> <p>Refactor of TOC related code.</p> </li> <li> <p>Updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#350-2024-01-27","title":"[3.5.0] - 2024-01-27","text":"<p>2024 release, updated ODF templates and better test suit.</p>"},{"location":"CHANGES.html#changed_10","title":"Changed","text":"<ul> <li> <p>Update <code>ODF</code> templates.</p> </li> <li> <p>Refactor many Python files for use of type hints.</p> </li> <li> <p>Updates for year 2024, updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#347-2024-01-15","title":"[3.4.7] - 2024-01-15","text":"<p>Updade to <code>lxml</code> version 5.</p>"},{"location":"CHANGES.html#changed_11","title":"Changed","text":"<pre><code>- Update `lxml` from version 4 to 5.\n</code></pre>"},{"location":"CHANGES.html#346-2023-12-25","title":"[3.4.6] - 2023-12-25","text":"<p>Add script <code>odfdo-replace</code> to find a pattern (regex) in an <code>ODF</code> file and replace by some string.</p>"},{"location":"CHANGES.html#fixed_5","title":"Fixed","text":"<ul> <li>Fix reading content from a <code>BytesIO</code>.</li> </ul>"},{"location":"CHANGES.html#changed_12","title":"Changed","text":"<ul> <li>Add script <code>odfdo-replace</code>.</li> </ul>"},{"location":"CHANGES.html#345-2023-12-24","title":"[3.4.5] - 2023-12-24","text":"<p>Add recipes showing how to save/read document from <code>io.BytesIO</code>.</p>"},{"location":"CHANGES.html#added_9","title":"Added","text":"<ul> <li>Add recipes <code>read_document_from_bytesio.py</code> and <code>save_document_as_bytesio.py</code>.</li> </ul>"},{"location":"CHANGES.html#changed_13","title":"Changed","text":"<ul> <li>Refactoring of code.</li> </ul>"},{"location":"reference.html","title":"Reference","text":""},{"location":"reference.html#odfdo.AnimPar","title":"<code>AnimPar</code>","text":"<p>             Bases: <code>Element</code></p> <p>A container for SMIL Presentation Animations.</p> <p>Arguments:</p> <pre><code>presentation_node_type -- default, on-click, with-previous,\n                          after-previous, timing-root, main-sequence\n                          and interactive-sequence\n\nsmil_begin -- indefinite, 10s, [id].click, [id].begin\n</code></pre> Source code in <code>odfdo/smil.py</code> <pre><code>class AnimPar(Element):\n    \"\"\"A container for SMIL Presentation Animations.\n\n    Arguments:\n\n        presentation_node_type -- default, on-click, with-previous,\n                                  after-previous, timing-root, main-sequence\n                                  and interactive-sequence\n\n        smil_begin -- indefinite, 10s, [id].click, [id].begin\n    \"\"\"\n\n    _tag = \"anim:par\"\n    _properties = (\n        PropDef(\"presentation_node_type\", \"presentation:node-type\"),\n        PropDef(\"smil_begin\", \"smil:begin\"),\n    )\n\n    def __init__(\n        self,\n        presentation_node_type: str | None = None,\n        smil_begin: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if presentation_node_type:\n                self.presentation_node_type = presentation_node_type\n            if smil_begin:\n                self.smil_begin = smil_begin\n</code></pre>"},{"location":"reference.html#odfdo.AnimSeq","title":"<code>AnimSeq</code>","text":"<p>             Bases: <code>Element</code></p> <p>TA container for SMIL Presentation Animations. Animations inside this block are executed after the slide has executed its initial transition.</p> <p>Arguments:</p> <pre><code>presentation_node_type -- default, on-click, with-previous,\n                          after-previous, timing-root, main-sequence\n                          and interactive-sequence\n</code></pre> Source code in <code>odfdo/smil.py</code> <pre><code>class AnimSeq(Element):\n    \"\"\"TA container for SMIL Presentation Animations. Animations\n    inside this block are executed after the slide has executed its initial\n    transition.\n\n    Arguments:\n\n        presentation_node_type -- default, on-click, with-previous,\n                                  after-previous, timing-root, main-sequence\n                                  and interactive-sequence\n    \"\"\"\n\n    _tag = \"anim:seq\"\n    _properties = (PropDef(\"presentation_node_type\", \"presentation:node-type\"),)\n\n    def __init__(\n        self,\n        presentation_node_type: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init and presentation_node_type:\n            self.presentation_node_type = presentation_node_type\n</code></pre>"},{"location":"reference.html#odfdo.AnimTransFilter","title":"<code>AnimTransFilter</code>","text":"<p>             Bases: <code>Element</code></p> <p>Class to make a beautiful transition between two frames.</p> <p>Parameters:</p> Name Type Description Default <code>smil_type</code> <code>and smil_subtype -- see http</code> <p>//www.w3.org/TR/SMIL20/             smil-transitions.html#TransitionEffects-Appendix                             to get a list of all types/subtypes</p> <code>None</code> Source code in <code>odfdo/smil.py</code> <pre><code>class AnimTransFilter(Element):\n    \"\"\"\n    Class to make a beautiful transition between two frames.\n\n    Arguments:\n      smil_dur -- XXX complete me\n\n      smil_type and smil_subtype -- see http://www.w3.org/TR/SMIL20/\n                    smil-transitions.html#TransitionEffects-Appendix\n                                    to get a list of all types/subtypes\n\n      smil_direction -- forward, reverse\n\n      smil_fadeColor -- forward, reverse\n\n      smil_mode -- in, out\n    \"\"\"\n\n    _tag = \"anim:transitionFilter\"\n    _properties = (\n        PropDef(\"smil_dur\", \"smil:dur\"),\n        PropDef(\"smil_type\", \"smil:type\"),\n        PropDef(\"smil_subtype\", \"smil:subtype\"),\n        PropDef(\"smil_direction\", \"smil:direction\"),\n        PropDef(\"smil_fadeColor\", \"smil:fadeColor\"),\n        PropDef(\"smil_mode\", \"smil:mode\"),\n    )\n\n    def __init__(\n        self,\n        smil_dur: str | None = None,\n        smil_type: str | None = None,\n        smil_subtype: str | None = None,\n        smil_direction: str | None = None,\n        smil_fadeColor: str | None = None,\n        smil_mode: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if smil_dur:\n                self.smil_dur = smil_dur\n            if smil_type:\n                self.smil_type = smil_type\n            if smil_subtype:\n                self.smil_subtype = smil_subtype\n            if smil_direction:\n                self.smil_direction = smil_direction\n            if smil_fadeColor:\n                self.smil_fadeColor = smil_fadeColor\n            if smil_mode:\n                self.smil_mode = smil_mode\n</code></pre>"},{"location":"reference.html#odfdo.Annotation","title":"<code>Annotation</code>","text":"<p>             Bases: <code>Element</code>, <code>DcCreatorMixin</code>, <code>DcDateMixin</code></p> <p>Annotation element credited to the given creator with the given text, optionally dated (current date by default). If name not provided and some parent is provided, the name is autogenerated.</p> <p>Arguments:</p> <pre><code>text -- str or odf_element\n\ncreator -- str\n\ndate -- datetime\n\nname -- str\n\nparent -- Element\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>class Annotation(Element, DcCreatorMixin, DcDateMixin):\n    \"\"\"Annotation element credited to the given creator with the\n    given text, optionally dated (current date by default).\n    If name not provided and some parent is provided, the name is\n    autogenerated.\n\n    Arguments:\n\n        text -- str or odf_element\n\n        creator -- str\n\n        date -- datetime\n\n        name -- str\n\n        parent -- Element\n    \"\"\"\n\n    _tag = \"office:annotation\"\n    _properties = (\n        PropDef(\"name\", \"office:name\"),\n        PropDef(\"note_id\", \"text:id\"),\n    )\n\n    def __init__(\n        self,\n        text_or_element: Element | str | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        name: str | None = None,\n        parent: Element | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        # fixme : use offset\n        # TODO allow paragraph and text styles\n        super().__init__(**kwargs)\n\n        if self._do_init:\n            self.note_body = text_or_element  # type:ignore\n            if creator:\n                self.creator = creator\n            if date is None:\n                date = datetime.now()\n            self.date = date\n            if not name:\n                name = get_unique_office_name(parent)\n                self.name = name\n\n    @property\n    def dc_creator(self) -&gt; str | None:\n        \"\"\"Alias for self.creator property.\"\"\"\n        return self.creator\n\n    @dc_creator.setter\n    def dc_creator(self, creator: str) -&gt; None:\n        self.creator = creator\n\n    @property\n    def dc_date(self) -&gt; datetime | None:\n        \"\"\"Alias for self.date property.\"\"\"\n        return self.date\n\n    @dc_date.setter\n    def dc_date(self, dtdate: datetime) -&gt; None:\n        self.date = dtdate\n\n    @property\n    def note_body(self) -&gt; str:\n        return self.text_content\n\n    @note_body.setter\n    def note_body(self, text_or_element: Element | str | None) -&gt; None:\n        if text_or_element is None:\n            self.text_content = \"\"\n        elif isinstance(text_or_element, str):\n            self.text_content = text_or_element\n        elif isinstance(text_or_element, Element):\n            self.clear()\n            self.append(text_or_element)\n        else:\n            raise TypeError(f'Unexpected type for body: \"{type(text_or_element)}\"')\n\n    @property\n    def start(self) -&gt; Element:\n        \"\"\"Return self.\"\"\"\n        return self\n\n    @property\n    def end(self) -&gt; Element | None:\n        \"\"\"Return the corresponding annotation-end tag or None.\"\"\"\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can't find end tag: no parent available\")\n        body = self.document_body\n        if not body:\n            body = parent\n        return body.get_annotation_end(name=name)\n\n    def get_annotated(\n        self,\n        as_text: bool = False,\n        no_header: bool = True,\n        clean: bool = True,\n    ) -&gt; Element | list | str | None:\n        \"\"\"Returns the annotated content from an annotation.\n\n        If no content exists (single position annotation or annotation-end not\n        found), returns [] (or \"\" if text flag is True).\n        If as_text is True: returns the text content.\n        If clean is True: suppress unwanted tags (deletions marks, ...)\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of odf_element, cleaned and without headers.\n\n        Arguments:\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list or Element or text or None\n        \"\"\"\n        end = self.end\n        if end is None:\n            if as_text:\n                return \"\"\n            return None\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_between(\n            self, end, as_text=as_text, no_header=no_header, clean=clean\n        )\n\n    def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        For Annotation : delete the annotation-end tag if exists.\n\n        Arguments:\n\n            child -- Element or None\n        \"\"\"\n        if child is not None:  # act like normal delete\n            super().delete(child)\n            return\n        end = self.end\n        if end:\n            end.delete()\n        # act like normal delete\n        super().delete()\n\n    def check_validity(self) -&gt; None:\n        if not self.note_body:\n            raise ValueError(\"Annotation must have a body\")\n        if not self.dc_creator:\n            raise ValueError(\"Annotation must have a creator\")\n        if not self.dc_date:\n            self.dc_date = datetime.now()\n</code></pre>"},{"location":"reference.html#odfdo.Annotation.dc_creator","title":"<code>dc_creator: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Alias for self.creator property.</p>"},{"location":"reference.html#odfdo.Annotation.dc_date","title":"<code>dc_date: datetime | None</code>  <code>property</code> <code>writable</code>","text":"<p>Alias for self.date property.</p>"},{"location":"reference.html#odfdo.Annotation.end","title":"<code>end: Element | None</code>  <code>property</code>","text":"<p>Return the corresponding annotation-end tag or None.</p>"},{"location":"reference.html#odfdo.Annotation.start","title":"<code>start: Element</code>  <code>property</code>","text":"<p>Return self.</p>"},{"location":"reference.html#odfdo.Annotation.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>For Annotation : delete the annotation-end tag if exists.</p> <p>Arguments:</p> <pre><code>child -- Element or None\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    For Annotation : delete the annotation-end tag if exists.\n\n    Arguments:\n\n        child -- Element or None\n    \"\"\"\n    if child is not None:  # act like normal delete\n        super().delete(child)\n        return\n    end = self.end\n    if end:\n        end.delete()\n    # act like normal delete\n    super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.Annotation.get_annotated","title":"<code>get_annotated(as_text=False, no_header=True, clean=True)</code>","text":"<p>Returns the annotated content from an annotation.</p> <p>If no content exists (single position annotation or annotation-end not found), returns [] (or \u201c\u201d if text flag is True). If as_text is True: returns the text content. If clean is True: suppress unwanted tags (deletions marks, \u2026) If no_header is True: existing text:h are changed in text:p By default: returns a list of odf_element, cleaned and without headers.</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list or Element or text or None</p> Source code in <code>odfdo/note.py</code> <pre><code>def get_annotated(\n    self,\n    as_text: bool = False,\n    no_header: bool = True,\n    clean: bool = True,\n) -&gt; Element | list | str | None:\n    \"\"\"Returns the annotated content from an annotation.\n\n    If no content exists (single position annotation or annotation-end not\n    found), returns [] (or \"\" if text flag is True).\n    If as_text is True: returns the text content.\n    If clean is True: suppress unwanted tags (deletions marks, ...)\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of odf_element, cleaned and without headers.\n\n    Arguments:\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list or Element or text or None\n    \"\"\"\n    end = self.end\n    if end is None:\n        if as_text:\n            return \"\"\n        return None\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_between(\n        self, end, as_text=as_text, no_header=no_header, clean=clean\n    )\n</code></pre>"},{"location":"reference.html#odfdo.AnnotationEnd","title":"<code>AnnotationEnd</code>","text":"<p>             Bases: <code>Element</code></p> <p>AnnotationEnd: the \u201coffice:annotation-end\u201d element may be used to define the end of a text range of document content that spans element boundaries. In that case, an \u201coffice:annotation\u201d element shall precede the \u201coffice:annotation-end\u201d element. Both elements shall have the same value for their office:name attribute. The \u201coffice:annotation-end\u201d element shall be preceded by an \u201coffice:annotation\u201d element that has the same value for its office:name attribute as the \u201coffice:annotation-end\u201d element. An \u201coffice:annotation-end\u201d element without a preceding \u201coffice:annotation\u201d element that has the same name assigned is ignored.</p> Source code in <code>odfdo/note.py</code> <pre><code>class AnnotationEnd(Element):\n    \"\"\"AnnotationEnd: the \"office:annotation-end\" element may be used to\n    define the end of a text range of document content that spans element\n    boundaries. In that case, an \"office:annotation\" element shall precede\n    the \"office:annotation-end\" element. Both elements shall have the same\n    value for their office:name attribute. The \"office:annotation-end\" element\n    shall be preceded by an \"office:annotation\" element that has the same\n    value for its office:name attribute as the \"office:annotation-end\"\n    element. An \"office:annotation-end\" element without a preceding\n    \"office:annotation\" element that has the same name assigned is ignored.\n    \"\"\"\n\n    _tag = \"office:annotation-end\"\n    _properties = (PropDef(\"name\", \"office:name\"),)\n\n    def __init__(\n        self,\n        annotation: Element | None = None,\n        name: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Initialize an AnnotationEnd element. Either annotation or name must be\n        provided to have proper reference for the annotation-end.\n\n        Arguments:\n\n            annotation -- odf_annotation element\n\n            name -- str\n        \"\"\"\n        # fixme : use offset\n        # TODO allow paragraph and text styles\n        super().__init__(**kwargs)\n        if self._do_init:\n            if annotation:\n                name = annotation.name  # type: ignore\n            if not name:\n                raise ValueError(\"Annotation-end must have a name\")\n            self.name = name\n\n    @property\n    def start(self) -&gt; Element | None:\n        \"\"\"Return the corresponding annotation starting tag or None.\"\"\"\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can't find start tag: no parent available\")\n        body = self.document_body\n        if not body:\n            body = parent\n        return body.get_annotation(name=name)\n\n    @property\n    def end(self) -&gt; Element:\n        \"\"\"Return self.\"\"\"\n        return self\n</code></pre>"},{"location":"reference.html#odfdo.AnnotationEnd.end","title":"<code>end: Element</code>  <code>property</code>","text":"<p>Return self.</p>"},{"location":"reference.html#odfdo.AnnotationEnd.start","title":"<code>start: Element | None</code>  <code>property</code>","text":"<p>Return the corresponding annotation starting tag or None.</p>"},{"location":"reference.html#odfdo.AnnotationEnd.__init__","title":"<code>__init__(annotation=None, name=None, **kwargs)</code>","text":"<p>Initialize an AnnotationEnd element. Either annotation or name must be provided to have proper reference for the annotation-end.</p> <p>Arguments:</p> <pre><code>annotation -- odf_annotation element\n\nname -- str\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>def __init__(\n    self,\n    annotation: Element | None = None,\n    name: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Initialize an AnnotationEnd element. Either annotation or name must be\n    provided to have proper reference for the annotation-end.\n\n    Arguments:\n\n        annotation -- odf_annotation element\n\n        name -- str\n    \"\"\"\n    # fixme : use offset\n    # TODO allow paragraph and text styles\n    super().__init__(**kwargs)\n    if self._do_init:\n        if annotation:\n            name = annotation.name  # type: ignore\n        if not name:\n            raise ValueError(\"Annotation-end must have a name\")\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.Body","title":"<code>Body</code>","text":"<p>             Bases: <code>Element</code></p> <p>Body, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Body(Element):\n    \"\"\"Body, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:body\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n\n    def get_tables(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the tables that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Table\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::table:table\", table_style=style, content=content\n        )\n\n    @property\n    def tables(self) -&gt; list[Element]:\n        \"\"\"Return all the tables.\n\n        Return: list of Table\n        \"\"\"\n        return self.get_elements(\"descendant::table:table\")\n\n    def get_table(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the table that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            content -- str regex\n\n        Return: Table or None if not found\n        \"\"\"\n        if name is None and content is None:\n            result = self._filtered_element(\"descendant::table:table\", position)\n        else:\n            result = self._filtered_element(\n                \"descendant::table:table\",\n                position,\n                table_name=name,\n                content=content,\n            )\n        return result\n</code></pre>"},{"location":"reference.html#odfdo.Body.tables","title":"<code>tables: list[Element]</code>  <code>property</code>","text":"<p>Return all the tables.</p> <p>Return: list of Table</p>"},{"location":"reference.html#odfdo.Body.get_table","title":"<code>get_table(position=0, name=None, content=None)</code>","text":"<p>Return the table that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\ncontent -- str regex\n</code></pre> <p>Return: Table or None if not found</p> Source code in <code>odfdo/body.py</code> <pre><code>def get_table(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the table that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        content -- str regex\n\n    Return: Table or None if not found\n    \"\"\"\n    if name is None and content is None:\n        result = self._filtered_element(\"descendant::table:table\", position)\n    else:\n        result = self._filtered_element(\n            \"descendant::table:table\",\n            position,\n            table_name=name,\n            content=content,\n        )\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Body.get_tables","title":"<code>get_tables(style=None, content=None)</code>","text":"<p>Return all the tables that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Table</p> Source code in <code>odfdo/body.py</code> <pre><code>def get_tables(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the tables that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Table\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::table:table\", table_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Bookmark","title":"<code>Bookmark</code>","text":"<p>             Bases: <code>Element</code></p> <p>Bookmark class for ODF \u201ctext:bookmark\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/bookmark.py</code> <pre><code>class Bookmark(Element):\n    \"\"\"\n    Bookmark class for ODF \"text:bookmark\"\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:bookmark\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.BookmarkEnd","title":"<code>BookmarkEnd</code>","text":"<p>             Bases: <code>Element</code></p> <p>BookmarkEnd class for ODF \u201ctext:bookmark-end\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/bookmark.py</code> <pre><code>class BookmarkEnd(Element):\n    \"\"\"\n    BookmarkEnd class for ODF \"text:bookmark-end\"\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:bookmark-end\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.BookmarkStart","title":"<code>BookmarkStart</code>","text":"<p>             Bases: <code>Element</code></p> <p>BookmarkStart class for ODF \u201ctext:bookmark-start\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/bookmark.py</code> <pre><code>class BookmarkStart(Element):\n    \"\"\"\n    BookmarkStart class for ODF \"text:bookmark-start\"\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:bookmark-start\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.Cell","title":"<code>Cell</code>","text":"<p>             Bases: <code>ElementTyped</code></p> <p>\u201ctable:table-cell\u201d table cell element.</p> Source code in <code>odfdo/cell.py</code> <pre><code>class Cell(ElementTyped):\n    \"\"\" \"table:table-cell\" table cell element.\"\"\"\n\n    _tag = \"table:table-cell\"\n    _caching = True\n\n    def __init__(\n        self,\n        value: Any = None,\n        text: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        formula: str | None = None,\n        repeated: int | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a cell element containing the given value. The textual\n        representation is automatically formatted but can be provided. Cell\n        type can be deduced as well, unless the number is a percentage or\n        currency. If cell type is \"currency\", the currency must be given.\n        The cell can be repeated on the given number of columns.\n\n        Arguments:\n\n            value -- bool, int, float, Decimal, date, datetime, str,\n                     timedelta\n\n            text -- str\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            repeated -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self.x = None\n        self.y = None\n        if self._do_init:\n            self.set_value(\n                value,\n                text=text,\n                cell_type=cell_type,\n                currency=currency,\n                formula=formula,\n            )\n            if repeated and repeated &gt; 1:\n                self.repeated = repeated\n            if style is not None:\n                self.style = style\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} x={self.x} y={self.y}&gt;\"\n\n    @property\n    def clone(self) -&gt; Cell:\n        clone = Element.clone.fget(self)  # type: ignore\n        clone.y = self.y\n        clone.x = self.x\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                clone._rmap = self._rmap[:]\n            clone._tmap = self._tmap[:]\n            clone._cmap = self._cmap[:]\n        return clone\n\n    @property\n    def value(\n        self,\n    ) -&gt; str | bool | int | Float | Decimal | date | datetime | timedelta | None:\n        \"\"\"Set / get the value of the cell. The type is read from the\n        'office:value-type' attribute of the cell. When setting the value,\n        the type of the value will determine the new value_type of the cell.\n\n        Warning: use this method for boolean, float or string only.\n        \"\"\"\n        value_type = self.get_attribute_string(\"office:value-type\")\n        if value_type == \"boolean\":\n            return self.get_attribute(\"office:boolean-value\")\n        if value_type in {\"float\", \"percentage\", \"currency\"}:\n            value_decimal = Decimal(str(self.get_attribute_string(\"office:value\")))\n            # Return 3 instead of 3.0 if possible\n            if int(value_decimal) == value_decimal:\n                return int(value_decimal)\n            return value_decimal\n        if value_type == \"date\":\n            value_str = str(self.get_attribute_string(\"office:date-value\"))\n            if \"T\" in value_str:\n                return DateTime.decode(value_str)\n            return Date.decode(value_str)\n        if value_type == \"time\":\n            return Duration.decode(str(self.get_attribute_string(\"office:time-value\")))\n        if value_type == \"string\":\n            value = self.get_attribute_string(\"office:string-value\")\n            if value is not None:\n                return value\n            value_list = []\n            for para in self.get_elements(\"text:p\"):\n                value_list.append(para.text_recursive)\n            return \"\\n\".join(value_list)\n        return None\n\n    @value.setter\n    def value(self, value: str | bytes | bool | int | Float | Decimal | None) -&gt; None:\n        self.clear()\n        if value is None:\n            return\n        if isinstance(value, (str, bytes)):\n            if isinstance(value, bytes):\n                value = bytes_to_str(value)\n            self.set_attribute(\"office:value-type\", \"string\")\n            self.set_attribute(\"office:string-value\", value)\n            self.text = value\n            return\n        if value is True or value is False:\n            self.set_attribute(\"office:value-type\", \"boolean\")\n            value_bool = Boolean.encode(value)\n            self.set_attribute(\"office:boolean-value\", value_bool)\n            self.text = value_bool\n            return\n        if isinstance(value, (int, Float, Decimal)):\n            self.set_attribute(\"office:value-type\", \"float\")\n            value_str = str(value)\n            self.set_attribute(\"office:value\", value_str)\n            self.text = value_str\n            return\n        raise TypeError(f\"Unknown value type, try with set_value() : {value!r}\")\n\n    @property\n    def float(self) -&gt; Float:\n        \"\"\"Set / get the value of the cell as a float (or 0.0).\"\"\"\n        for tag in (\"office:value\", \"office:string-value\", \"office:boolean-value\"):\n            read_attr = self.get_attribute(tag)\n            if isinstance(read_attr, str):\n                with contextlib.suppress(ValueError, TypeError):\n                    return Float(read_attr)\n        return 0.0\n\n    @float.setter\n    def float(self, value: str | Float | int | Decimal) -&gt; None:\n        try:\n            value_float = Float(value)\n        except (ValueError, TypeError):\n            value_float = 0.0\n        value_str = str(value_float)\n        self.clear()\n        self.set_attribute(\"office:value\", value_str)\n        self.set_attribute(\"office:value-type\", \"float\")\n        self.text = value_str\n\n    @property\n    def string(self) -&gt; str:\n        \"\"\"Set / get the value of the cell as a string (or '').\"\"\"\n        value = self.get_attribute_string(\"office:string-value\")\n        if isinstance(value, str):\n            return value\n        return \"\"\n\n    @string.setter\n    def string(\n        self,\n        value: str | bytes | int | Float | Decimal | bool | None,  # type: ignore\n    ) -&gt; None:\n        self.clear()\n        if value is None:\n            value_str = \"\"\n        else:\n            value_str = str(value)\n        self.set_attribute(\"office:value-type\", \"string\")\n        self.set_attribute(\"office:string-value\", value_str)\n        self.text = value_str\n\n    def set_value(\n        self,\n        value: (\n            str  # type: ignore\n            | bytes\n            | Float\n            | int\n            | Decimal\n            | bool\n            | datetime\n            | date\n            | timedelta\n            | None\n        ),\n        text: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        formula: str | None = None,\n    ) -&gt; None:\n        \"\"\"Set the cell state from the Python value type.\n\n        Text is how the cell is displayed. Cell type is guessed,\n        unless provided.\n\n        For monetary values, provide the name of the currency.\n\n        Arguments:\n\n            value -- Python type\n\n            text -- str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                        'currency' or 'percentage'\n\n            currency -- str\n        \"\"\"\n        self.clear()\n        text = self.set_value_and_type(\n            value=value,\n            text=text,\n            value_type=cell_type,\n            currency=currency,\n        )\n        if text is not None:\n            self.text_content = text\n        if formula is not None:\n            self.formula = formula\n\n    @property\n    def type(self) -&gt; str | None:\n        \"\"\"Get / set the type of the cell: boolean, float, date, string\n        or time.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"office:value-type\")\n\n    @type.setter\n    def type(self, cell_type: str) -&gt; None:\n        self.set_attribute(\"office:value-type\", cell_type)\n\n    @property\n    def currency(self) -&gt; str | None:\n        \"\"\"Get / set the currency used for monetary values.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"office:currency\")\n\n    @currency.setter\n    def currency(self, currency: str) -&gt; None:\n        self.set_attribute(\"office:currency\", currency)\n\n    def _set_repeated(self, repeated: int | None) -&gt; None:\n        \"\"\"Internal only. Set the numnber of times the cell is repeated, or\n        None to delete. Without changing cache.\n        \"\"\"\n        if repeated is None or repeated &lt; 2:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:number-columns-repeated\")\n            return\n        self.set_attribute(\"table:number-columns-repeated\", str(repeated))\n\n    @property\n    def repeated(self) -&gt; int | None:\n        \"\"\"Get / set the number of times the cell is repeated.\n\n        Always None when using the table API.\n\n        Return: int or None\n        \"\"\"\n        repeated = self.get_attribute(\"table:number-columns-repeated\")\n        if repeated is None:\n            return None\n        return int(repeated)\n\n    @repeated.setter\n    def repeated(self, repeated: int | None) -&gt; None:\n        self._set_repeated(repeated)\n        # update cache\n        child: Element = self\n        while True:\n            # look for Row, parent may be group of rows\n            upper = child.parent\n            if not upper:\n                # lonely cell\n                return\n            # parent may be group of rows, not table\n            if isinstance(upper, Element) and upper._tag == \"table:table-row\":\n                break\n            child = upper\n        # fixme : need to optimize this\n        if isinstance(upper, Element) and upper._tag == \"table:table-row\":\n            upper._compute_row_cache()\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get / set the style of the cell itself.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"table:style-name\")\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n\n    @property\n    def formula(self) -&gt; str | None:\n        \"\"\"Get / set the formula of the cell, or None if undefined.\n\n        The formula is not interpreted in any way.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"table:formula\")\n\n    @formula.setter\n    def formula(self, formula: str | None) -&gt; None:\n        self.set_attribute(\"table:formula\", formula)\n\n    def is_empty(self, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return whether the cell has no value or the value evaluates\n        to False (empty string), and no style.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            aggressive -- bool\n\n        Return: bool\n        \"\"\"\n        if self.value is not None or self.children or self.is_spanned():\n            return False\n        if not aggressive and self.style is not None:\n            return False\n        return True\n\n    def is_spanned(self) -&gt; bool:\n        \"\"\"Return whether the cell is spanned over several cells.\n\n        Returns: True | False\n        \"\"\"\n        if self.tag == \"table:covered-table-cell\":\n            return True\n        if self.get_attribute(\"table:number-columns-spanned\") is not None:\n            return True\n        if self.get_attribute(\"table:number-rows-spanned\") is not None:\n            return True\n        return False\n\n    _is_spanned = is_spanned  # compatibility\n</code></pre>"},{"location":"reference.html#odfdo.Cell.currency","title":"<code>currency: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the currency used for monetary values.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.float","title":"<code>float: Float</code>  <code>property</code> <code>writable</code>","text":"<p>Set / get the value of the cell as a float (or 0.0).</p>"},{"location":"reference.html#odfdo.Cell.formula","title":"<code>formula: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the formula of the cell, or None if undefined.</p> <p>The formula is not interpreted in any way.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.repeated","title":"<code>repeated: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the number of times the cell is repeated.</p> <p>Always None when using the table API.</p> <p>Return: int or None</p>"},{"location":"reference.html#odfdo.Cell.string","title":"<code>string: str</code>  <code>property</code> <code>writable</code>","text":"<p>Set / get the value of the cell as a string (or \u2018\u2019).</p>"},{"location":"reference.html#odfdo.Cell.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the style of the cell itself.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.type","title":"<code>type: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the type of the cell: boolean, float, date, string or time.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.value","title":"<code>value: str | bool | int | Float | Decimal | date | datetime | timedelta | None</code>  <code>property</code> <code>writable</code>","text":"<p>Set / get the value of the cell. The type is read from the \u2018office:value-type\u2019 attribute of the cell. When setting the value, the type of the value will determine the new value_type of the cell.</p> <p>Warning: use this method for boolean, float or string only.</p>"},{"location":"reference.html#odfdo.Cell.__init__","title":"<code>__init__(value=None, text=None, cell_type=None, currency=None, formula=None, repeated=None, style=None, **kwargs)</code>","text":"<p>Create a cell element containing the given value. The textual representation is automatically formatted but can be provided. Cell type can be deduced as well, unless the number is a percentage or currency. If cell type is \u201ccurrency\u201d, the currency must be given. The cell can be repeated on the given number of columns.</p> <p>Arguments:</p> <pre><code>value -- bool, int, float, Decimal, date, datetime, str,\n         timedelta\n\ntext -- str\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nrepeated -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/cell.py</code> <pre><code>def __init__(\n    self,\n    value: Any = None,\n    text: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    formula: str | None = None,\n    repeated: int | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a cell element containing the given value. The textual\n    representation is automatically formatted but can be provided. Cell\n    type can be deduced as well, unless the number is a percentage or\n    currency. If cell type is \"currency\", the currency must be given.\n    The cell can be repeated on the given number of columns.\n\n    Arguments:\n\n        value -- bool, int, float, Decimal, date, datetime, str,\n                 timedelta\n\n        text -- str\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        repeated -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self.x = None\n    self.y = None\n    if self._do_init:\n        self.set_value(\n            value,\n            text=text,\n            cell_type=cell_type,\n            currency=currency,\n            formula=formula,\n        )\n        if repeated and repeated &gt; 1:\n            self.repeated = repeated\n        if style is not None:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Cell.is_empty","title":"<code>is_empty(aggressive=False)</code>","text":"<p>Return whether the cell has no value or the value evaluates to False (empty string), and no style.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> <p>Return: bool</p> Source code in <code>odfdo/cell.py</code> <pre><code>def is_empty(self, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return whether the cell has no value or the value evaluates\n    to False (empty string), and no style.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        aggressive -- bool\n\n    Return: bool\n    \"\"\"\n    if self.value is not None or self.children or self.is_spanned():\n        return False\n    if not aggressive and self.style is not None:\n        return False\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Cell.is_spanned","title":"<code>is_spanned()</code>","text":"<p>Return whether the cell is spanned over several cells.</p> <p>Returns: True | False</p> Source code in <code>odfdo/cell.py</code> <pre><code>def is_spanned(self) -&gt; bool:\n    \"\"\"Return whether the cell is spanned over several cells.\n\n    Returns: True | False\n    \"\"\"\n    if self.tag == \"table:covered-table-cell\":\n        return True\n    if self.get_attribute(\"table:number-columns-spanned\") is not None:\n        return True\n    if self.get_attribute(\"table:number-rows-spanned\") is not None:\n        return True\n    return False\n</code></pre>"},{"location":"reference.html#odfdo.Cell.set_value","title":"<code>set_value(value, text=None, cell_type=None, currency=None, formula=None)</code>","text":"<p>Set the cell state from the Python value type.</p> <p>Text is how the cell is displayed. Cell type is guessed, unless provided.</p> <p>For monetary values, provide the name of the currency.</p> <p>Arguments:</p> <pre><code>value -- Python type\n\ntext -- str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n            'currency' or 'percentage'\n\ncurrency -- str\n</code></pre> Source code in <code>odfdo/cell.py</code> <pre><code>def set_value(\n    self,\n    value: (\n        str  # type: ignore\n        | bytes\n        | Float\n        | int\n        | Decimal\n        | bool\n        | datetime\n        | date\n        | timedelta\n        | None\n    ),\n    text: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    formula: str | None = None,\n) -&gt; None:\n    \"\"\"Set the cell state from the Python value type.\n\n    Text is how the cell is displayed. Cell type is guessed,\n    unless provided.\n\n    For monetary values, provide the name of the currency.\n\n    Arguments:\n\n        value -- Python type\n\n        text -- str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                    'currency' or 'percentage'\n\n        currency -- str\n    \"\"\"\n    self.clear()\n    text = self.set_value_and_type(\n        value=value,\n        text=text,\n        value_type=cell_type,\n        currency=currency,\n    )\n    if text is not None:\n        self.text_content = text\n    if formula is not None:\n        self.formula = formula\n</code></pre>"},{"location":"reference.html#odfdo.ChangeInfo","title":"<code>ChangeInfo</code>","text":"<p>             Bases: <code>Element</code>, <code>DcCreatorMixin</code>, <code>DcDateMixin</code></p> <p>The \u201coffice:change-info\u201d element represents who made a change and when. It may also contain a comment (one or more Paragrah \u201ctext:p\u201d elements) on the change.</p> The comments available in the ChangeInfo are available through <ul> <li>paragraphs property, get_paragraphs and get_paragraph methods for actual Paragraph.</li> <li>get_comments for a plain text version</li> </ul> <p>Arguments:</p> <p>creator \u2013 str (or None)</p> <p>date \u2013 datetime (or None)</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class ChangeInfo(Element, DcCreatorMixin, DcDateMixin):\n    \"\"\"The \"office:change-info\" element represents who made a change and when.\n    It may also contain a comment (one or more Paragrah \"text:p\" elements)\n    on the change.\n\n    The comments available in the ChangeInfo are available through:\n      - paragraphs property, get_paragraphs and get_paragraph methods for actual Paragraph.\n      - get_comments for a plain text version\n\n      Arguments:\n\n         creator -- str (or None)\n\n         date -- datetime (or None)\n    \"\"\"\n\n    _tag = \"office:change-info\"\n\n    def __init__(\n        self,\n        creator: str | None = None,\n        date: datetime | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.creator = creator or \"Unknown\"\n            self.date = date\n\n    def get_comments(self, joined: bool = True) -&gt; str | list[str]:\n        \"\"\"Get text content of the comments. If joined is True (default), the\n        text of different paragraphs is concatenated, else a list of strings,\n        one per paragraph, is returned.\n\n        Arguments:\n\n            joined -- boolean (default is True)\n\n        Return: str or list of str.\n        \"\"\"\n        content = self.paragraphs\n        if content is None:\n            content = []\n        text = [para.get_formatted_text(simple=True) for para in content]  # type: ignore\n        if joined:\n            return \"\\n\".join(text)\n        return text\n\n    def set_comments(self, text: str = \"\", replace: bool = True) -&gt; None:\n        \"\"\"Set the text content of the comments. If replace is True (default),\n        the new text replace old comments, else it is added at the end.\n\n        Arguments:\n\n            text -- str\n\n            replace -- boolean\n        \"\"\"\n        if replace:\n            for para in self.paragraphs:\n                self.delete(para)\n        para = Paragraph()\n        para.append_plain_text(text)\n        self.insert(para, xmlposition=LAST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.ChangeInfo.get_comments","title":"<code>get_comments(joined=True)</code>","text":"<p>Get text content of the comments. If joined is True (default), the text of different paragraphs is concatenated, else a list of strings, one per paragraph, is returned.</p> <p>Arguments:</p> <pre><code>joined -- boolean (default is True)\n</code></pre> <p>Return: str or list of str.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_comments(self, joined: bool = True) -&gt; str | list[str]:\n    \"\"\"Get text content of the comments. If joined is True (default), the\n    text of different paragraphs is concatenated, else a list of strings,\n    one per paragraph, is returned.\n\n    Arguments:\n\n        joined -- boolean (default is True)\n\n    Return: str or list of str.\n    \"\"\"\n    content = self.paragraphs\n    if content is None:\n        content = []\n    text = [para.get_formatted_text(simple=True) for para in content]  # type: ignore\n    if joined:\n        return \"\\n\".join(text)\n    return text\n</code></pre>"},{"location":"reference.html#odfdo.ChangeInfo.set_comments","title":"<code>set_comments(text='', replace=True)</code>","text":"<p>Set the text content of the comments. If replace is True (default), the new text replace old comments, else it is added at the end.</p> <p>Arguments:</p> <pre><code>text -- str\n\nreplace -- boolean\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_comments(self, text: str = \"\", replace: bool = True) -&gt; None:\n    \"\"\"Set the text content of the comments. If replace is True (default),\n    the new text replace old comments, else it is added at the end.\n\n    Arguments:\n\n        text -- str\n\n        replace -- boolean\n    \"\"\"\n    if replace:\n        for para in self.paragraphs:\n            self.delete(para)\n    para = Paragraph()\n    para.append_plain_text(text)\n    self.insert(para, xmlposition=LAST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.Chart","title":"<code>Chart</code>","text":"<p>             Bases: <code>Body</code></p> <p>Chart, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Chart(Body):\n    \"\"\"Chart, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:chart\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.Column","title":"<code>Column</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF table column \u201ctable:table-column\u201d</p> Source code in <code>odfdo/table.py</code> <pre><code>class Column(Element):\n    \"\"\"ODF table column \"table:table-column\" \"\"\"\n\n    _tag = \"table:table-column\"\n    _caching = True\n\n    def __init__(\n        self,\n        default_cell_style: str | None = None,\n        repeated: int | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a column group element of the optionally given style. Cell\n        style can be set for the whole column. If the properties apply to\n        several columns, give the number of repeated columns.\n\n        Columns don't contain cells, just style information.\n\n        You don't generally have to create columns by hand, use the Table API.\n\n        Arguments:\n\n            default_cell_style -- str\n\n            repeated -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self.x = None\n        if self._do_init:\n            if default_cell_style:\n                self.default_cell_style = default_cell_style\n            if repeated and repeated &gt; 1:\n                self.repeated = repeated\n            if style:\n                self.style = style\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} x={self.x}&gt;\"\n\n    @property\n    def clone(self) -&gt; Column:\n        clone = Element.clone.fget(self)  # type: ignore\n        clone.x = self.x\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                clone._rmap = self._rmap[:]\n            clone._tmap = self._tmap[:]\n            clone._cmap = self._cmap[:]\n        return clone\n\n    def get_default_cell_style(self) -&gt; str | None:\n        \"\"\"Get or set the default cell style for column.\n\n        (See also self.default_cell_style property.)\n        \"\"\"\n        return self.get_attribute_string(\"table:default-cell-style-name\")\n\n    def set_default_cell_style(self, style: Element | str | None) -&gt; None:\n        \"\"\"Get or set the default cell style for column.\n\n        (See also self.default_cell_style property.)\n        \"\"\"\n        self.set_style_attribute(\"table:default-cell-style-name\", style)\n\n    @property\n    def default_cell_style(self) -&gt; str | None:\n        \"\"\"Get or set the default cell style for column.\"\"\"\n        return self.get_attribute_string(\"table:default-cell-style-name\")\n\n    @default_cell_style.setter\n    def default_cell_style(self, style: Element | str | None) -&gt; None:\n        self.set_style_attribute(\"table:default-cell-style-name\", style)\n\n    def _set_repeated(self, repeated: int | None) -&gt; None:\n        \"\"\"Internal only. Set the number of times the column is repeated, or\n        None to delete it. Without changing cache.\n\n        Arguments:\n\n            repeated -- int or None\n        \"\"\"\n        if repeated is None or repeated &lt; 2:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:number-columns-repeated\")\n            return\n        self.set_attribute(\"table:number-columns-repeated\", str(repeated))\n\n    @property\n    def repeated(self) -&gt; int | None:\n        \"\"\"Get /set the number of times the column is repeated.\n\n        Always None when using the table API.\n\n        Return: int or None\n        \"\"\"\n        repeated = self.get_attribute(\"table:number-columns-repeated\")\n        if repeated is None:\n            return None\n        return int(repeated)\n\n    @repeated.setter\n    def repeated(self, repeated: int | None) -&gt; None:\n        self._set_repeated(repeated)\n        # update cache\n        current: Element = self\n        while True:\n            # look for Table, parent may be group of rows\n            upper = current.parent\n            if not upper:\n                # lonely column\n                return\n            # parent may be group of rows, not table\n            if isinstance(upper, Table):\n                break\n            current = upper\n        # fixme : need to optimize this\n        if isinstance(upper, Table):\n            upper._compute_table_cache()\n            if hasattr(self, \"_cmap\"):\n                del self._cmap[:]\n                self._cmap.extend(upper._cmap)\n            else:\n                self._cmap = upper._cmap\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get /set the style of the column itself.\n\n        Return: str\n        \"\"\"\n        return self.get_attribute_string(\"table:style-name\")\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n</code></pre>"},{"location":"reference.html#odfdo.Column.default_cell_style","title":"<code>default_cell_style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the default cell style for column.</p>"},{"location":"reference.html#odfdo.Column.repeated","title":"<code>repeated: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get /set the number of times the column is repeated.</p> <p>Always None when using the table API.</p> <p>Return: int or None</p>"},{"location":"reference.html#odfdo.Column.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get /set the style of the column itself.</p> <p>Return: str</p>"},{"location":"reference.html#odfdo.Column.__init__","title":"<code>__init__(default_cell_style=None, repeated=None, style=None, **kwargs)</code>","text":"<p>Create a column group element of the optionally given style. Cell style can be set for the whole column. If the properties apply to several columns, give the number of repeated columns.</p> <p>Columns don\u2019t contain cells, just style information.</p> <p>You don\u2019t generally have to create columns by hand, use the Table API.</p> <p>Arguments:</p> <pre><code>default_cell_style -- str\n\nrepeated -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    default_cell_style: str | None = None,\n    repeated: int | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a column group element of the optionally given style. Cell\n    style can be set for the whole column. If the properties apply to\n    several columns, give the number of repeated columns.\n\n    Columns don't contain cells, just style information.\n\n    You don't generally have to create columns by hand, use the Table API.\n\n    Arguments:\n\n        default_cell_style -- str\n\n        repeated -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self.x = None\n    if self._do_init:\n        if default_cell_style:\n            self.default_cell_style = default_cell_style\n        if repeated and repeated &gt; 1:\n            self.repeated = repeated\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Column.get_default_cell_style","title":"<code>get_default_cell_style()</code>","text":"<p>Get or set the default cell style for column.</p> <p>(See also self.default_cell_style property.)</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_default_cell_style(self) -&gt; str | None:\n    \"\"\"Get or set the default cell style for column.\n\n    (See also self.default_cell_style property.)\n    \"\"\"\n    return self.get_attribute_string(\"table:default-cell-style-name\")\n</code></pre>"},{"location":"reference.html#odfdo.Column.set_default_cell_style","title":"<code>set_default_cell_style(style)</code>","text":"<p>Get or set the default cell style for column.</p> <p>(See also self.default_cell_style property.)</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_default_cell_style(self, style: Element | str | None) -&gt; None:\n    \"\"\"Get or set the default cell style for column.\n\n    (See also self.default_cell_style property.)\n    \"\"\"\n    self.set_style_attribute(\"table:default-cell-style-name\", style)\n</code></pre>"},{"location":"reference.html#odfdo.ConnectorShape","title":"<code>ConnectorShape</code>","text":"<p>             Bases: <code>ShapeBase</code></p> <p>Create a Connector shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\nconnected_shapes -- (shape, shape)\n\nglue_points -- (point, point)\n\np1 -- (str, str)\n\np2 -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class ConnectorShape(ShapeBase):\n    \"\"\"Create a Connector shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        connected_shapes -- (shape, shape)\n\n        glue_points -- (point, point)\n\n        p1 -- (str, str)\n\n        p2 -- (str, str)\n    \"\"\"\n\n    _tag = \"draw:connector\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"start_shape\", \"draw:start-shape\"),\n        PropDef(\"end_shape\", \"draw:end-shape\"),\n        PropDef(\"start_glue_point\", \"draw:start-glue-point\"),\n        PropDef(\"end_glue_point\", \"draw:end-glue-point\"),\n        PropDef(\"x1\", \"svg:x1\"),\n        PropDef(\"y1\", \"svg:y1\"),\n        PropDef(\"x2\", \"svg:x2\"),\n        PropDef(\"y2\", \"svg:y2\"),\n    )\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        connected_shapes: tuple | None = None,\n        glue_points: tuple | None = None,\n        p1: tuple | None = None,\n        p2: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n            }\n        )\n        super().__init__(**kwargs)\n        if self._do_init:\n            if connected_shapes:\n                self.start_shape = connected_shapes[0].draw_id\n                self.end_shape = connected_shapes[1].draw_id\n            if glue_points:\n                self.start_glue_point = glue_points[0]\n                self.end_glue_point = glue_points[1]\n            if p1:\n                self.x1 = p1[0]\n                self.y1 = p1[1]\n            if p2:\n                self.x2 = p2[0]\n                self.y2 = p2[1]\n</code></pre>"},{"location":"reference.html#odfdo.Container","title":"<code>Container</code>","text":"<p>Representation of the ODF file.</p> Source code in <code>odfdo/container.py</code> <pre><code>class Container:\n    \"\"\"Representation of the ODF file.\"\"\"\n\n    def __init__(self, path: Path | str | io.BytesIO | None = None) -&gt; None:\n        self.__parts: dict[str, bytes | None] = {}\n        self.__parts_ts: dict[str, int] = {}\n        self.__path_like: Path | str | io.BytesIO | None = None\n        self.__packaging: str = ZIP\n        self.path: Path | None = None  # or Path\n        if path:\n            self.open(path)\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} type={self.mimetype} path={self.path}&gt;\"\n\n    def open(self, path_or_file: Path | str | io.BytesIO) -&gt; None:\n        \"\"\"Load the content of an ODF file.\"\"\"\n        self.__path_like = path_or_file\n        if isinstance(path_or_file, (str, Path)):\n            self.path = Path(path_or_file).expanduser()\n            if not self.path.exists():\n                raise FileNotFoundError(str(self.path))\n            self.__path_like = self.path\n        if (self.path or isinstance(self.__path_like, io.BytesIO)) and is_zipfile(\n            self.__path_like  # type: ignore\n        ):\n            self.__packaging = ZIP\n            return self._read_zip()\n        if self.path:\n            is_folder = False\n            with contextlib.suppress(OSError):\n                is_folder = self.path.is_dir()\n            if is_folder:\n                self.__packaging = FOLDER\n                return self._read_folder()\n        raise TypeError(f\"Document format not managed by odfdo: {type(path_or_file)}.\")\n\n    def _read_zip(self) -&gt; None:\n        if isinstance(self.__path_like, io.BytesIO):\n            self.__path_like.seek(0)\n        with ZipFile(self.__path_like) as zf:  # type: ignore\n            mimetype = bytes_to_str(zf.read(\"mimetype\"))\n            if mimetype not in ODF_MIMETYPES:\n                raise ValueError(f\"Document of unknown type {mimetype}\")\n            self.__parts[\"mimetype\"] = str_to_bytes(mimetype)\n        if self.path is None:\n            if isinstance(self.__path_like, io.BytesIO):\n                self.__path_like.seek(0)\n            # read the full file at once and forget file\n            with ZipFile(self.__path_like) as zf:  # type: ignore\n                for name in zf.namelist():\n                    upath = normalize_path(name)\n                    self.__parts[upath] = zf.read(name)\n            self.__path_like = None\n\n    def _read_folder(self) -&gt; None:\n        try:\n            mimetype, timestamp = self._get_folder_part(\"mimetype\")\n        except OSError:\n            printwarn(\"Corrupted or not an OpenDocument folder (missing mimetype)\")\n            mimetype = b\"\"\n            timestamp = int(time.time())\n        if bytes_to_str(mimetype) not in ODF_MIMETYPES:\n            message = f\"Document of unknown type {mimetype!r}, try with ODF Text.\"\n            printwarn(message)\n            self.__parts[\"mimetype\"] = str_to_bytes(ODF_EXTENSIONS[\"odt\"])\n            self.__parts_ts[\"mimetype\"] = timestamp\n\n    def _parse_folder(self, folder: str) -&gt; list[str]:\n        parts = []\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        root = self.path / folder\n        for path in root.iterdir():\n            if path.name.startswith(\".\"):  # no hidden files\n                continue\n            relative_path = path.relative_to(self.path)\n            if path.is_file():\n                parts.append(relative_path.as_posix())\n            if path.is_dir():\n                sub_parts = self._parse_folder(str(relative_path))\n                if sub_parts:\n                    parts.extend(sub_parts)\n                else:\n                    # store leaf directories\n                    parts.append(relative_path.as_posix() + \"/\")\n        return parts\n\n    def _get_folder_parts(self) -&gt; list[str]:\n        \"\"\"Get the list of members in the ODF folder.\"\"\"\n        return self._parse_folder(\"\")\n\n    def _get_folder_part(self, name: str) -&gt; tuple[bytes, int]:\n        \"\"\"Get bytes of a part from the ODF folder, with timestamp.\"\"\"\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        path = self.path / name\n        timestamp = int(path.stat().st_mtime)\n        if path.is_dir():\n            return (b\"\", timestamp)\n        return (path.read_bytes(), timestamp)\n\n    def _get_folder_part_timestamp(self, name: str) -&gt; int:\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        path = self.path / name\n        try:\n            timestamp = int(path.stat().st_mtime)\n        except OSError:\n            timestamp = -1\n        return timestamp\n\n    def _get_zip_part(self, name: str) -&gt; bytes | None:\n        \"\"\"Get bytes of a part from the Zip ODF file. No cache.\"\"\"\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        try:\n            with ZipFile(self.path) as zf:\n                upath = normalize_path(name)\n                self.__parts[upath] = zf.read(name)\n                return self.__parts[upath]\n        except BadZipfile:\n            return None\n\n    def _get_all_zip_part(self) -&gt; None:\n        \"\"\"Read all parts. No cache.\"\"\"\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        try:\n            with ZipFile(self.path) as zf:\n                for name in zf.namelist():\n                    upath = normalize_path(name)\n                    self.__parts[upath] = zf.read(name)\n        except BadZipfile:\n            pass\n\n    def _save_zip(self, target: str | Path | io.BytesIO) -&gt; None:\n        \"\"\"Save a Zip ODF from the available parts.\"\"\"\n        parts = self.__parts\n        with ZipFile(target, \"w\", compression=ZIP_DEFLATED) as filezip:\n            # Parts to save, except manifest at the end\n            part_names = list(parts.keys())\n            try:\n                part_names.remove(ODF_MANIFEST)\n            except ValueError:\n                printwarn(f\"Missing '{ODF_MANIFEST}'\")\n            # \"Pretty-save\" parts in some order\n            # mimetype requires to be first and uncompressed\n            mimetype = parts.get(\"mimetype\")\n            if mimetype is None:\n                raise ValueError(\"Mimetype is not defined\")\n            try:\n                filezip.writestr(\"mimetype\", mimetype, ZIP_STORED)\n                part_names.remove(\"mimetype\")\n            except (ValueError, KeyError):\n                printwarn(\"Missing 'mimetype'\")\n            # XML parts\n            for path in ODF_CONTENT, ODF_META, ODF_SETTINGS, ODF_STYLES:\n                if path not in parts:\n                    printwarn(f\"Missing '{path}'\")\n                    continue\n                part = parts[path]\n                if part is None:\n                    continue\n                filezip.writestr(path, part)\n                part_names.remove(path)\n            # Everything else\n            for path in part_names:\n                data = parts[path]\n                if data is None:\n                    # Deleted\n                    continue\n                filezip.writestr(path, data)\n            # Manifest\n            with contextlib.suppress(KeyError):\n                part = parts[ODF_MANIFEST]\n                if part is not None:\n                    filezip.writestr(ODF_MANIFEST, part)\n\n    def _save_folder(self, folder: Path | str) -&gt; None:\n        \"\"\"Save a folder ODF from the available parts.\"\"\"\n\n        def dump(part_path: str, content: bytes) -&gt; None:\n            if part_path.endswith(\"/\"):  # folder\n                is_folder = True\n                pure_path = PurePath(folder, part_path[:-1])\n            else:\n                is_folder = False\n                pure_path = PurePath(folder, part_path)\n            path = Path(pure_path)\n            if is_folder:\n                path.mkdir(parents=True, exist_ok=True)\n            else:\n                path.parent.mkdir(parents=True, exist_ok=True)\n                path.write_bytes(content)\n                path.chmod(0o666)\n\n        for part_path, data in self.__parts.items():\n            if data is None:\n                # Deleted\n                continue\n            dump(part_path, data)\n\n    def _xml_content(self) -&gt; bytes:\n        mimetype = self.__parts[\"mimetype\"].decode(\"utf8\")\n        doc_xml = (\n            OFFICE_PREFIX.decode(\"utf8\")\n            + f'office:version=\"{OFFICE_VERSION}\"\\n'\n            + f'office:mimetype=\"{mimetype}\"&gt;'\n            + \"&lt;/office:document&gt;\"\n        )\n        root = fromstring(doc_xml.encode(\"utf8\"))\n        for path in ODF_META, ODF_SETTINGS, ODF_STYLES, ODF_CONTENT:\n            if path not in self.__parts:\n                printwarn(f\"Missing '{path}'\")\n                continue\n            part = self.__parts[path]\n            if part is None:\n                continue\n            if isinstance(part, bytes):\n                xpart = fromstring(part)\n            else:\n                xpart = part\n            print(xpart, part.__class__.__name__)\n            for child in xpart:\n                root.append(child)\n        return tostring(root, encoding=\"UTF-8\", xml_declaration=True)\n\n    def _save_xml(self, target: Path | str) -&gt; None:\n        \"\"\"Save a XML flat ODF format from the available parts.\"\"\"\n        target = Path(target).with_suffix(\".xml\")\n        target.write_bytes(self._xml_content())\n\n    # Public API\n\n    def get_parts(self) -&gt; list[str]:\n        \"\"\"Get the list of members.\"\"\"\n        if not self.path:\n            # maybe a file like zip archive\n            return list(self.__parts.keys())\n        if self.__packaging == ZIP:\n            parts = []\n            with ZipFile(self.path) as zf:\n                for name in zf.namelist():\n                    upath = normalize_path(name)\n                    parts.append(upath)\n            return parts\n        elif self.__packaging == FOLDER:\n            return self._get_folder_parts()\n        else:\n            raise ValueError(\"Unable to provide parts of the document\")\n\n    @property\n    def parts(self) -&gt; list[str]:\n        \"\"\"Get the list of members.\"\"\"\n        return self.get_parts()\n\n    def get_part(self, path: str) -&gt; str | bytes | None:\n        \"\"\"Get the bytes of a part of the ODF.\"\"\"\n        path = str(path)\n        if path in self.__parts:\n            part = self.__parts[path]\n            if part is None:\n                raise ValueError(f'Part \"{path}\" is deleted')\n            if self.__packaging == FOLDER:\n                cache_ts = self.__parts_ts.get(path, -1)\n                current_ts = self._get_folder_part_timestamp(path)\n                if current_ts != cache_ts:\n                    part, timestamp = self._get_folder_part(path)\n                    self.__parts[path] = part\n                    self.__parts_ts[path] = timestamp\n            return part\n        if self.__packaging == ZIP:\n            return self._get_zip_part(path)\n        if self.__packaging == FOLDER:\n            part, timestamp = self._get_folder_part(path)\n            self.__parts[path] = part\n            self.__parts_ts[path] = timestamp\n            return part\n        return None\n\n    @property\n    def mimetype(self) -&gt; str:\n        \"\"\"Return str value of mimetype of the document.\"\"\"\n        with contextlib.suppress(Exception):\n            b_mimetype = self.get_part(\"mimetype\")\n            if isinstance(b_mimetype, bytes):\n                return bytes_to_str(b_mimetype)\n        return \"\"\n\n    @mimetype.setter\n    def mimetype(self, mimetype: str | bytes) -&gt; None:\n        \"\"\"Set mimetype value of the document.\"\"\"\n        if isinstance(mimetype, str):\n            self.__parts[\"mimetype\"] = str_to_bytes(mimetype)\n        elif isinstance(mimetype, bytes):\n            self.__parts[\"mimetype\"] = mimetype\n        else:\n            raise TypeError(f'Wrong mimetype \"{mimetype!r}\"')\n\n    def set_part(self, path: str, data: bytes) -&gt; None:\n        \"\"\"Replace or add a new part.\"\"\"\n        self.__parts[path] = data\n\n    def del_part(self, path: str) -&gt; None:\n        \"\"\"Mark a part for deletion.\"\"\"\n        self.__parts[path] = None\n\n    @property\n    def clone(self) -&gt; Container:\n        \"\"\"Make a copy of this container with no path.\"\"\"\n        if self.path and self.__packaging == ZIP:\n            self._get_all_zip_part()\n        clone = deepcopy(self)\n        clone.path = None\n        return clone\n\n    def _backup_or_unlink(self, backup: bool, target: str | Path) -&gt; None:\n        if backup:\n            self._do_backup(target)\n        else:\n            self._do_unlink(target)\n\n    @staticmethod\n    def _do_backup(target: str | Path) -&gt; None:\n        path = Path(target)\n        if not path.exists():\n            return\n        back_file = Path(path.stem + \".backup\" + path.suffix)\n        if back_file.is_dir():\n            try:\n                shutil.rmtree(back_file)\n            except OSError as e:\n                printwarn(str(e))\n        try:\n            shutil.move(target, back_file)\n        except OSError as e:\n            printwarn(str(e))\n\n    @staticmethod\n    def _do_unlink(target: str | Path) -&gt; None:\n        path = Path(target)\n        if path.exists():\n            try:\n                shutil.rmtree(path)\n            except OSError as e:\n                printwarn(str(e))\n\n    def _clean_save_packaging(self, packaging: str | None) -&gt; str:\n        if not packaging:\n            packaging = self.__packaging if self.__packaging else ZIP\n        packaging = packaging.strip().lower()\n        if packaging not in PACKAGING:\n            raise ValueError(f'Packaging of type \"{packaging}\" is not supported')\n        return packaging\n\n    def _clean_save_target(\n        self,\n        target: str | Path | io.BytesIO | None,\n    ) -&gt; str | io.BytesIO:\n        if target is None:\n            target = self.path\n        if isinstance(target, Path):\n            target = str(target)\n        if isinstance(target, str):\n            while target.endswith(os.sep):\n                target = target[:-1]\n            while target.endswith(\".folder\"):\n                target = target.split(\".folder\", 1)[0]\n        return target  # type: ignore\n\n    def _save_as_zip(self, target: str | Path | io.BytesIO, backup: bool) -&gt; None:\n        if isinstance(target, (str, Path)) and backup:\n            self._do_backup(target)\n        self._save_zip(target)\n\n    def _save_as_folder(self, target: str | Path, backup: bool) -&gt; None:\n        if not isinstance(target, (str, Path)):\n            raise TypeError(\n                f\"Saving in folder format requires a folder name, not '{target!r}'\"\n            )\n        if not str(target).endswith(\".folder\"):\n            target = str(target) + \".folder\"\n        self._backup_or_unlink(backup, target)\n        self._save_folder(target)\n\n    def _save_as_xml(self, target: str | Path | io.BytesIO, backup: bool) -&gt; None:\n        if not isinstance(target, (str, Path)):\n            raise TypeError(\n                f\"Saving in XML format requires a folder name, not '{target!r}'\"\n            )\n        if not str(target).endswith(\".xml\"):\n            target = str(target) + \".xml\"\n        if isinstance(target, (str, Path)) and backup:\n            self._do_backup(target)\n        self._save_xml(target)\n\n    def save(\n        self,\n        target: str | Path | io.BytesIO | None,\n        packaging: str | None = None,\n        backup: bool = False,\n    ) -&gt; None:\n        \"\"\"Save the container to the given target, a path or a file-like\n        object.\n\n        Package the output document in the same format than current document,\n        unless \"packaging\" is different.\n\n        Arguments:\n\n            target -- str or file-like or Path\n\n            packaging -- 'zip', or for debugging purpose 'xml' or 'folder'\n\n            backup -- boolean\n        \"\"\"\n        parts = self.__parts\n        packaging = self._clean_save_packaging(packaging)\n        # Load parts else they will be considered deleted\n        for path in self.parts:\n            if path not in parts:\n                self.get_part(path)\n        target = self._clean_save_target(target)\n        if packaging == FOLDER:\n            if isinstance(target, io.BytesIO):\n                raise TypeError(\n                    \"Impossible to save on io.BytesIO with 'folder' packaging\"\n                )\n            self._save_as_folder(target, backup)\n        elif packaging == XML:\n            self._save_as_xml(target, backup)\n        else:\n            # default:\n            self._save_as_zip(target, backup)\n</code></pre>"},{"location":"reference.html#odfdo.Container.clone","title":"<code>clone: Container</code>  <code>property</code>","text":"<p>Make a copy of this container with no path.</p>"},{"location":"reference.html#odfdo.Container.mimetype","title":"<code>mimetype: str</code>  <code>property</code> <code>writable</code>","text":"<p>Return str value of mimetype of the document.</p>"},{"location":"reference.html#odfdo.Container.parts","title":"<code>parts: list[str]</code>  <code>property</code>","text":"<p>Get the list of members.</p>"},{"location":"reference.html#odfdo.Container.del_part","title":"<code>del_part(path)</code>","text":"<p>Mark a part for deletion.</p> Source code in <code>odfdo/container.py</code> <pre><code>def del_part(self, path: str) -&gt; None:\n    \"\"\"Mark a part for deletion.\"\"\"\n    self.__parts[path] = None\n</code></pre>"},{"location":"reference.html#odfdo.Container.get_part","title":"<code>get_part(path)</code>","text":"<p>Get the bytes of a part of the ODF.</p> Source code in <code>odfdo/container.py</code> <pre><code>def get_part(self, path: str) -&gt; str | bytes | None:\n    \"\"\"Get the bytes of a part of the ODF.\"\"\"\n    path = str(path)\n    if path in self.__parts:\n        part = self.__parts[path]\n        if part is None:\n            raise ValueError(f'Part \"{path}\" is deleted')\n        if self.__packaging == FOLDER:\n            cache_ts = self.__parts_ts.get(path, -1)\n            current_ts = self._get_folder_part_timestamp(path)\n            if current_ts != cache_ts:\n                part, timestamp = self._get_folder_part(path)\n                self.__parts[path] = part\n                self.__parts_ts[path] = timestamp\n        return part\n    if self.__packaging == ZIP:\n        return self._get_zip_part(path)\n    if self.__packaging == FOLDER:\n        part, timestamp = self._get_folder_part(path)\n        self.__parts[path] = part\n        self.__parts_ts[path] = timestamp\n        return part\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Container.get_parts","title":"<code>get_parts()</code>","text":"<p>Get the list of members.</p> Source code in <code>odfdo/container.py</code> <pre><code>def get_parts(self) -&gt; list[str]:\n    \"\"\"Get the list of members.\"\"\"\n    if not self.path:\n        # maybe a file like zip archive\n        return list(self.__parts.keys())\n    if self.__packaging == ZIP:\n        parts = []\n        with ZipFile(self.path) as zf:\n            for name in zf.namelist():\n                upath = normalize_path(name)\n                parts.append(upath)\n        return parts\n    elif self.__packaging == FOLDER:\n        return self._get_folder_parts()\n    else:\n        raise ValueError(\"Unable to provide parts of the document\")\n</code></pre>"},{"location":"reference.html#odfdo.Container.open","title":"<code>open(path_or_file)</code>","text":"<p>Load the content of an ODF file.</p> Source code in <code>odfdo/container.py</code> <pre><code>def open(self, path_or_file: Path | str | io.BytesIO) -&gt; None:\n    \"\"\"Load the content of an ODF file.\"\"\"\n    self.__path_like = path_or_file\n    if isinstance(path_or_file, (str, Path)):\n        self.path = Path(path_or_file).expanduser()\n        if not self.path.exists():\n            raise FileNotFoundError(str(self.path))\n        self.__path_like = self.path\n    if (self.path or isinstance(self.__path_like, io.BytesIO)) and is_zipfile(\n        self.__path_like  # type: ignore\n    ):\n        self.__packaging = ZIP\n        return self._read_zip()\n    if self.path:\n        is_folder = False\n        with contextlib.suppress(OSError):\n            is_folder = self.path.is_dir()\n        if is_folder:\n            self.__packaging = FOLDER\n            return self._read_folder()\n    raise TypeError(f\"Document format not managed by odfdo: {type(path_or_file)}.\")\n</code></pre>"},{"location":"reference.html#odfdo.Container.save","title":"<code>save(target, packaging=None, backup=False)</code>","text":"<p>Save the container to the given target, a path or a file-like object.</p> <p>Package the output document in the same format than current document, unless \u201cpackaging\u201d is different.</p> <p>Arguments:</p> <pre><code>target -- str or file-like or Path\n\npackaging -- 'zip', or for debugging purpose 'xml' or 'folder'\n\nbackup -- boolean\n</code></pre> Source code in <code>odfdo/container.py</code> <pre><code>def save(\n    self,\n    target: str | Path | io.BytesIO | None,\n    packaging: str | None = None,\n    backup: bool = False,\n) -&gt; None:\n    \"\"\"Save the container to the given target, a path or a file-like\n    object.\n\n    Package the output document in the same format than current document,\n    unless \"packaging\" is different.\n\n    Arguments:\n\n        target -- str or file-like or Path\n\n        packaging -- 'zip', or for debugging purpose 'xml' or 'folder'\n\n        backup -- boolean\n    \"\"\"\n    parts = self.__parts\n    packaging = self._clean_save_packaging(packaging)\n    # Load parts else they will be considered deleted\n    for path in self.parts:\n        if path not in parts:\n            self.get_part(path)\n    target = self._clean_save_target(target)\n    if packaging == FOLDER:\n        if isinstance(target, io.BytesIO):\n            raise TypeError(\n                \"Impossible to save on io.BytesIO with 'folder' packaging\"\n            )\n        self._save_as_folder(target, backup)\n    elif packaging == XML:\n        self._save_as_xml(target, backup)\n    else:\n        # default:\n        self._save_as_zip(target, backup)\n</code></pre>"},{"location":"reference.html#odfdo.Container.set_part","title":"<code>set_part(path, data)</code>","text":"<p>Replace or add a new part.</p> Source code in <code>odfdo/container.py</code> <pre><code>def set_part(self, path: str, data: bytes) -&gt; None:\n    \"\"\"Replace or add a new part.\"\"\"\n    self.__parts[path] = data\n</code></pre>"},{"location":"reference.html#odfdo.Content","title":"<code>Content</code>","text":"<p>             Bases: <code>XmlPart</code></p> Source code in <code>odfdo/content.py</code> <pre><code>class Content(XmlPart):\n    # The following two seem useless but they match styles API\n\n    def _get_style_contexts(self, family: str | None) -&gt; tuple:\n        if family == \"font-face\":\n            return (self.get_element(\"//office:font-face-decls\"),)\n        return (\n            self.get_element(\"//office:font-face-decls\"),\n            self.get_element(\"//office:automatic-styles\"),\n        )\n\n    def __str__(self) -&gt; str:\n        return str(self.body)\n\n    # Public API\n\n    def get_styles(self, family: str | None = None) -&gt; list[Style]:\n        \"\"\"Return the list of styles in the Content part, optionally limited\n        to the given family.\n\n        Arguments:\n\n            family -- str or None\n\n        Return: list of Style\n        \"\"\"\n        result: list[Style] = []\n        for context in self._get_style_contexts(family):\n            if context is None:\n                continue\n            result.extend(context.get_styles(family=family))\n        return result\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Element | None = None,\n        display_name: str | None = None,\n    ) -&gt; Style | None:\n        \"\"\"Return the style uniquely identified by the name/family pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is None, the default style is fetched.\n\n        If the name is not the internal name but the name you gave in the\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                      'number'\n\n            name_or_element -- str or Style\n\n            display_name -- str\n\n        Return: Style or None if not found\n        \"\"\"\n        for context in self._get_style_contexts(family):\n            if context is None:\n                continue\n            style = context.get_style(\n                family,\n                name_or_element=name_or_element,\n                display_name=display_name,\n            )\n            if style is not None:\n                return style\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Content.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the name/family pair. If the argument is already a style object, it will return it.</p> <p>If the name is None, the default style is fetched.</p> <p>If the name is not the internal name but the name you gave in the desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n          'number'\n\nname_or_element -- str or Style\n\ndisplay_name -- str\n</code></pre> <p>Return: Style or None if not found</p> Source code in <code>odfdo/content.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Element | None = None,\n    display_name: str | None = None,\n) -&gt; Style | None:\n    \"\"\"Return the style uniquely identified by the name/family pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is None, the default style is fetched.\n\n    If the name is not the internal name but the name you gave in the\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                  'number'\n\n        name_or_element -- str or Style\n\n        display_name -- str\n\n    Return: Style or None if not found\n    \"\"\"\n    for context in self._get_style_contexts(family):\n        if context is None:\n            continue\n        style = context.get_style(\n            family,\n            name_or_element=name_or_element,\n            display_name=display_name,\n        )\n        if style is not None:\n            return style\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Content.get_styles","title":"<code>get_styles(family=None)</code>","text":"<p>Return the list of styles in the Content part, optionally limited to the given family.</p> <p>Arguments:</p> <pre><code>family -- str or None\n</code></pre> <p>Return: list of Style</p> Source code in <code>odfdo/content.py</code> <pre><code>def get_styles(self, family: str | None = None) -&gt; list[Style]:\n    \"\"\"Return the list of styles in the Content part, optionally limited\n    to the given family.\n\n    Arguments:\n\n        family -- str or None\n\n    Return: list of Style\n    \"\"\"\n    result: list[Style] = []\n    for context in self._get_style_contexts(family):\n        if context is None:\n            continue\n        result.extend(context.get_styles(family=family))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Database","title":"<code>Database</code>","text":"<p>             Bases: <code>Body</code></p> <p>Database, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Database(Body):\n    \"\"\"Database, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:database\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.Document","title":"<code>Document</code>","text":"<p>Abstraction of the ODF document.</p> <p>To create a new Document, several possibilities:</p> <pre><code>- Document() or Document(\"text\") -&gt; an \"empty\" document of type text\n- Document(\"spreadsheet\") -&gt; an \"empty\" document of type spreadsheet\n- Document(\"presentation\") -&gt; an \"empty\" document of type presentation\n- Document(\"drawing\") -&gt; an \"empty\" document of type drawing\n\nMeaning of \u201cempty\u201d: these documents are copies of the default\ntemplates documents provided with this library, which, as templates,\nare not really empty. It may be useful to clear the newly created\ndocument: document.body.clear(), or adjust meta informations like\ndescription or default language: document.meta.language = 'fr-FR'\n</code></pre> <p>If the argument is not a known template type, or is a Path, Document(file) will load the content of the ODF file.</p> <p>To explicitly create a document from a custom template, use the Document.new(path) method whose argument is the path to the template file.</p> Source code in <code>odfdo/document.py</code> <pre><code>class Document:\n    \"\"\"Abstraction of the ODF document.\n\n    To create a new Document, several possibilities:\n\n        - Document() or Document(\"text\") -&gt; an \"empty\" document of type text\n        - Document(\"spreadsheet\") -&gt; an \"empty\" document of type spreadsheet\n        - Document(\"presentation\") -&gt; an \"empty\" document of type presentation\n        - Document(\"drawing\") -&gt; an \"empty\" document of type drawing\n\n        Meaning of \u201cempty\u201d: these documents are copies of the default\n        templates documents provided with this library, which, as templates,\n        are not really empty. It may be useful to clear the newly created\n        document: document.body.clear(), or adjust meta informations like\n        description or default language: document.meta.language = 'fr-FR'\n\n    If the argument is not a known template type, or is a Path,\n    Document(file) will load the content of the ODF file.\n\n    To explicitly create a document from a custom template, use the\n    Document.new(path) method whose argument is the path to the template file.\n    \"\"\"\n\n    def __init__(\n        self,\n        target: str | bytes | Path | Container | io.BytesIO | None = \"text\",\n    ) -&gt; None:\n        # Cache of XML parts\n        self.__xmlparts: dict[str, XmlPart] = {}\n        # Cache of the body\n        self.__body: Element | None = None\n        self.container: Container | None = None\n        if isinstance(target, bytes):\n            # eager conversion\n            target = bytes_to_str(target)\n        if target is None:\n            # empty document, you probably don't wnat this.\n            self.container = Container()\n            return\n        if isinstance(target, Path):\n            # let's assume we open a container on existing file\n            self.container = Container(target)\n            return\n        if isinstance(target, Container):\n            # special internal case, use an existing container\n            self.container = target\n            return\n        if isinstance(target, str):\n            if target in ODF_TEMPLATES:\n                # assuming a new document from templates\n                self.container = container_from_template(target)\n                return\n            # let's assume we open a container on existing file\n            self.container = Container(target)\n            return\n        if isinstance(target, io.BytesIO):\n            self.container = Container(target)\n            return\n        raise TypeError(f\"Unknown Document source type: '{target!r}'\")\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} type={self.get_type()} path={self.path}&gt;\"\n\n    def __str__(self) -&gt; str:\n        try:\n            return str(self.get_formatted_text())\n        except NotImplementedError:\n            return self.body.text_recursive\n\n    @classmethod\n    def new(cls, template: str | Path | io.BytesIO = \"text\") -&gt; Document:\n        \"\"\"Create a Document from a template.\n\n        The template argument is expected to be the path to a ODF template.\n\n        Arguments:\n\n            template -- str or Path or file-like (io.BytesIO)\n\n        Return : ODF document -- Document\n        \"\"\"\n        container = container_from_template(template)\n        return cls(container)\n\n    # Public API\n\n    @property\n    def path(self) -&gt; Path | None:\n        \"\"\"Shortcut to Document.Container.path.\"\"\"\n        if not self.container:\n            return None\n        return self.container.path\n\n    @path.setter\n    def path(self, path_or_str: str | Path) -&gt; None:\n        \"\"\"Shortcut to Document.Container.path\n\n        Only accepting str or Path.\"\"\"\n        if not self.container:\n            return\n        self.container.path = Path(path_or_str)\n\n    def get_parts(self) -&gt; list[str]:\n        \"\"\"Return available part names with path inside the archive, e.g.\n        ['content.xml', ..., 'Pictures/100000000000032000000258912EB1C3.jpg']\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        return self.container.parts\n\n    @property\n    def parts(self) -&gt; list[str]:\n        \"\"\"Return available part names with path inside the archive, e.g.\n        ['content.xml', ..., 'Pictures/100000000000032000000258912EB1C3.jpg']\n        \"\"\"\n        return self.get_parts()\n\n    def get_part(self, path: str) -&gt; XmlPart | str | bytes | None:\n        \"\"\"Return the bytes of the given part. The path is relative to the\n        archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n        'content', 'meta', 'settings', 'styles' and 'manifest' are shortcuts\n        to the real path, e.g. content.xml, and return a dedicated object with\n        its own API.\n\n        path formated as URI, so always use '/' separator\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        # \"./ObjectReplacements/Object 1\"\n        path = path.lstrip(\"./\")\n        path = _get_part_path(path)\n        cls = _get_part_class(path)\n        # Raw bytes\n        if cls is None:\n            return self.container.get_part(path)\n        # XML part\n        part = self.__xmlparts.get(path)\n        if part is None:\n            self.__xmlparts[path] = part = cls(path, self.container)\n        return part\n\n    def set_part(self, path: str, data: bytes) -&gt; None:\n        \"\"\"Set the bytes of the given part. The path is relative to the\n        archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n        path formated as URI, so always use '/' separator\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        # \"./ObjectReplacements/Object 1\"\n        path = path.lstrip(\"./\")\n        path = _get_part_path(path)\n        cls = _get_part_class(path)\n        # XML part overwritten\n        if cls is not None:\n            with suppress(KeyError):\n                self.__xmlparts[path]\n        self.container.set_part(path, data)\n\n    def del_part(self, path: str) -&gt; None:\n        \"\"\"Mark a part for deletion. The path is relative to the archive,\n        e.g. \"Pictures/1003200258912EB1C3.jpg\"\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        path = _get_part_path(path)\n        cls = _get_part_class(path)\n        if path == ODF_MANIFEST or cls is not None:\n            raise ValueError(f\"part '{path}' is mandatory\")\n        self.container.del_part(path)\n\n    @property\n    def mimetype(self) -&gt; str:\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        return self.container.mimetype\n\n    @mimetype.setter\n    def mimetype(self, mimetype: str) -&gt; None:\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        self.container.mimetype = mimetype\n\n    def get_type(self) -&gt; str:\n        \"\"\"Get the ODF type (also called class) of this document.\n\n        Return: 'chart', 'database', 'formula', 'graphics',\n            'graphics-template', 'image', 'presentation',\n            'presentation-template', 'spreadsheet', 'spreadsheet-template',\n            'text', 'text-master', 'text-template' or 'text-web'\n        \"\"\"\n        # The mimetype must be with the form:\n        # application/vnd.oasis.opendocument.text\n\n        # Isolate and return the last part\n        return self.mimetype.rsplit(\".\", 1)[-1]\n\n    @property\n    def body(self) -&gt; Element:\n        \"\"\"Return the body element of the content part, where actual content\n        is stored.\n        \"\"\"\n        if self.__body is None:\n            self.__body = self.content.body\n        return self.__body\n\n    @property\n    def meta(self) -&gt; Meta:\n        \"\"\"Return the meta part (meta.xml) of the document, where meta data\n        are stored.\"\"\"\n        metadata = self.get_part(ODF_META)\n        if metadata is None or not isinstance(metadata, Meta):\n            raise ValueError(\"Empty Meta\")\n        return metadata\n\n    @property\n    def manifest(self) -&gt; Manifest:\n        \"\"\"Return the manifest part (manifest.xml) of the document.\"\"\"\n        manifest = self.get_part(ODF_MANIFEST)\n        if manifest is None or not isinstance(manifest, Manifest):\n            raise ValueError(\"Empty Manifest\")\n        return manifest\n\n    def _get_formatted_text_footnotes(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Separate text from notes\n        if rst_mode:\n            result.append(\"\\n\")\n        else:\n            result.append(\"----\\n\")\n        for citation, body in context[\"footnotes\"]:\n            if rst_mode:\n                result.append(f\".. [#] {body}\\n\")\n            else:\n                result.append(f\"[{citation}] {body}\\n\")\n        # Append a \\n after the notes\n        result.append(\"\\n\")\n        # Reset for the next paragraph\n        context[\"footnotes\"] = []\n\n    def _get_formatted_text_annotations(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Insert the annotations\n        # With a separation\n        if rst_mode:\n            result.append(\"\\n\")\n        else:\n            result.append(\"----\\n\")\n        for annotation in context[\"annotations\"]:\n            if rst_mode:\n                result.append(f\".. [#] {annotation}\\n\")\n            else:\n                result.append(f\"[*] {annotation}\\n\")\n        context[\"annotations\"] = []\n\n    def _get_formatted_text_images(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Insert the images ref, only in rst mode\n        result.append(\"\\n\")\n        for ref, filename, (width, height) in context[\"images\"]:\n            result.append(f\".. {ref} image:: {filename}\\n\")\n            if width is not None:\n                result.append(f\"   :width: {width}\\n\")\n            if height is not None:\n                result.append(f\"   :height: {height}\\n\")\n        context[\"images\"] = []\n\n    def _get_formatted_text_endnotes(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Append the end notes\n        if rst_mode:\n            result.append(\"\\n\\n\")\n        else:\n            result.append(\"\\n========\\n\")\n        for citation, body in context[\"endnotes\"]:\n            if rst_mode:\n                result.append(f\".. [*] {body}\\n\")\n            else:\n                result.append(f\"({citation}) {body}\\n\")\n\n    def get_formatted_text(self, rst_mode: bool = False) -&gt; str:\n        \"\"\"Return content as text, with some formatting.\"\"\"\n        # For the moment, only \"type='text'\"\n        doc_type = self.get_type()\n        if doc_type == \"spreadsheet\":\n            return self._tables_csv()\n        if doc_type in {\n            \"text\",\n            \"text-template\",\n            \"presentation\",\n            \"presentation-template\",\n        }:\n            return self._formatted_text(rst_mode)\n        raise NotImplementedError(f\"Type of document '{doc_type}' not supported yet\")\n\n    def _tables_csv(self) -&gt; str:\n        return \"\\n\\n\".join(str(table) for table in self.body.tables)\n\n    def _formatted_text(self, rst_mode: bool) -&gt; str:\n        # Initialize an empty context\n        context = {\n            \"document\": self,\n            \"footnotes\": [],\n            \"endnotes\": [],\n            \"annotations\": [],\n            \"rst_mode\": rst_mode,\n            \"img_counter\": 0,\n            \"images\": [],\n            \"no_img_level\": 0,\n        }\n        body = self.body\n        # Get the text\n        result = []\n        for child in body.children:\n            # self._get_formatted_text_child(result, element, context, rst_mode)\n            # if child.tag == \"table:table\":\n            #     result.append(child.get_formatted_text(context))\n            #     return\n            result.append(child.get_formatted_text(context))\n            if context[\"footnotes\"]:\n                self._get_formatted_text_footnotes(result, context, rst_mode)\n            if context[\"annotations\"]:\n                self._get_formatted_text_annotations(result, context, rst_mode)\n            # Insert the images ref, only in rst mode\n            if context[\"images\"]:\n                self._get_formatted_text_images(result, context, rst_mode)\n        if context[\"endnotes\"]:\n            self._get_formatted_text_endnotes(result, context, rst_mode)\n        return \"\".join(result)\n\n    def get_formated_meta(self) -&gt; str:\n        \"\"\"Return meta informations as text, with some formatting.\"\"\"\n        result: list[str] = []\n\n        # Simple values\n        def print_info(name: str, value: Any) -&gt; None:\n            if value:\n                result.append(f\"{name}: {value}\")\n\n        meta = self.meta\n        print_info(\"Title\", meta.title)\n        print_info(\"Subject\", meta.subject)\n        print_info(\"Description\", meta.description)\n        print_info(\"Language\", meta.language)\n        print_info(\"Modification date\", meta.date)\n        print_info(\"Creation date\", meta.creation_date)\n        print_info(\"Initial creator\", meta.initial_creator)\n        print_info(\"Keyword\", meta.keyword)\n        print_info(\"Editing duration\", meta.editing_duration)\n        print_info(\"Editing cycles\", meta.editing_cycles)\n        print_info(\"Generator\", meta.generator)\n\n        # Statistic\n        result.append(\"Statistic:\")\n        statistic = meta.statistic\n        if statistic:\n            for name, data in statistic.items():\n                result.append(f\"  - {name[5:].replace('-', ' ').capitalize()}: {data}\")\n\n        # User defined metadata\n        result.append(\"User defined metadata:\")\n        user_metadata = meta.user_defined_metadata\n        for name, data2 in user_metadata.items():\n            result.append(f\"  - {name}: {data2}\")\n\n        # And the description\n        print_info(\"Description\", meta.get_description())\n\n        return \"\\n\".join(result) + \"\\n\"\n\n    def add_file(self, path_or_file: str | Path) -&gt; str:\n        \"\"\"Insert a file from a path or a file-like object in the container.\n\n        Return the full path to reference in the content.\n\n        Arguments:\n\n            path_or_file -- str or Path or file-like\n\n        Return: str (URI)\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        name = \"\"\n        # Folder for added files (FIXME hard-coded and copied)\n        manifest = self.manifest\n        medias = manifest.get_paths()\n        # uuid = str(uuid4())\n\n        if isinstance(path_or_file, (str, Path)):\n            path = Path(path_or_file)\n            extension = path.suffix.lower()\n            name = f\"{path.stem}{extension}\"\n            if posixpath.join(\"Pictures\", name) in medias:\n                name = f\"{path.stem}_{uuid4()}{extension}\"\n        else:\n            path = None\n            name = getattr(path_or_file, \"name\", None)\n            if not name:\n                name = str(uuid4())\n        media_type, _encoding = guess_type(name)\n        if not media_type:\n            media_type = \"application/octet-stream\"\n        if manifest.get_media_type(\"Pictures/\") is None:\n            manifest.add_full_path(\"Pictures/\")\n        full_path = posixpath.join(\"Pictures\", name)\n        if path is None:\n            self.container.set_part(full_path, path_or_file.read())  # type:ignore\n        else:\n            self.container.set_part(full_path, path.read_bytes())\n        manifest.add_full_path(full_path, media_type)\n        return full_path\n\n    @property\n    def clone(self) -&gt; Document:\n        \"\"\"Return an exact copy of the document.\n\n        Return: Document\n        \"\"\"\n        clone = object.__new__(self.__class__)\n        for name in self.__dict__:\n            if name == \"_Document__body\":\n                setattr(clone, name, None)\n            elif name == \"_Document__xmlparts\":\n                setattr(clone, name, {})\n            elif name == \"container\":\n                if not self.container:\n                    raise ValueError(\"Empty Container\")\n                setattr(clone, name, self.container.clone)\n            else:\n                value = deepcopy(getattr(self, name))\n                setattr(clone, name, value)\n        return clone\n\n    def save(\n        self,\n        target: str | Path | io.BytesIO | None = None,\n        packaging: str = ZIP,\n        pretty: bool = False,\n        backup: bool = False,\n    ) -&gt; None:\n        \"\"\"Save the document, at the same place it was opened or at the given\n        target path. Target can also be a file-like object. It can be saved\n        as a Zip file (default), flat XML format or as files in a folder\n        (for debugging purpose). XML parts can be pretty printed.\n\n        Arguments:\n\n            target -- str or file-like object\n\n            packaging -- 'zip', 'folder', 'xml'\n\n            pretty -- bool\n\n            backup -- bool\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        # Some advertising\n        self.meta.set_generator_default()\n        # Synchronize data with container\n        container = self.container\n        for path, part in self.__xmlparts.items():\n            if part is not None:\n                container.set_part(path, part.serialize(pretty))\n        # Save the container\n        container.save(target, packaging=packaging, backup=backup)\n\n    @property\n    def content(self) -&gt; Content:\n        content: Content | None = self.get_part(ODF_CONTENT)  # type:ignore\n        if content is None:\n            raise ValueError(\"Empty Content\")\n        return content\n\n    @property\n    def styles(self) -&gt; Styles:\n        styles: Styles | None = self.get_part(ODF_STYLES)  # type:ignore\n        if styles is None:\n            raise ValueError(\"Empty Styles\")\n        return styles\n\n    # Styles over several parts\n\n    def get_styles(\n        self,\n        family: str | bytes = \"\",\n        automatic: bool = False,\n    ) -&gt; list[Style | Element]:\n        # compatibility with old versions:\n\n        if isinstance(family, bytes):\n            family = bytes_to_str(family)\n        return self.content.get_styles(family=family) + self.styles.get_styles(\n            family=family, automatic=automatic\n        )\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Style | None = None,\n        display_name: str | None = None,\n    ) -&gt; Style | None:\n        \"\"\"Return the style uniquely identified by the name/family pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is None, the default style is fetched.\n\n        If the name is not the internal name but the name you gave in a\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                      'number', 'page-layout', 'master-page'\n\n            name -- str or Element or None\n\n            display_name -- str\n\n        Return: Style or None if not found.\n        \"\"\"\n        # 1. content.xml\n        element = self.content.get_style(\n            family, name_or_element=name_or_element, display_name=display_name\n        )\n        if element is not None:\n            return element\n        # 2. styles.xml\n        return self.styles.get_style(\n            family,\n            name_or_element=name_or_element,\n            display_name=display_name,\n        )\n\n    @staticmethod\n    def _pseudo_style_attribute(style_element: Style | Element, attribute: str) -&gt; Any:\n        if hasattr(style_element, attribute):\n            return getattr(style_element, attribute)\n        return \"\"\n\n    def _set_automatic_name(self, style: Style, family: str) -&gt; None:\n        \"\"\"Generate a name for the new automatic style.\"\"\"\n        if not hasattr(style, \"name\"):\n            # do nothing\n            return\n        styles = self.get_styles(family=family, automatic=True)\n        max_index = 0\n        for existing_style in styles:\n            if not hasattr(existing_style, \"name\"):\n                continue\n            if not existing_style.name.startswith(AUTOMATIC_PREFIX):\n                continue\n            try:\n                index = int(existing_style.name[len(AUTOMATIC_PREFIX) :])  # type: ignore\n            except ValueError:\n                continue\n            max_index = max(max_index, index)\n\n        style.name = f\"{AUTOMATIC_PREFIX}{max_index+1}\"\n\n    def _insert_style_get_common_styles(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:styles\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_automatic_styles(\n        self,\n        style: Style,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.content.get_element(\"office:automatic-styles\")\n        # A name ?\n        if name:\n            if hasattr(style, \"name\"):\n                style.name = name\n            existing = self.content.get_style(family, name)\n        else:\n            self._set_automatic_name(style, family)\n            existing = None\n        return existing, style_container\n\n    def _insert_style_get_default_styles(\n        self,\n        style: Style,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:styles\")\n        style.tag = \"style:default-style\"\n        if name:\n            style.del_attribute(\"style:name\")\n        existing = self.styles.get_style(family)\n        return existing, style_container\n\n    def _insert_style_get_master_page(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:master-styles\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_font_face_default(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:font-face-decls\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_font_face(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.content.get_element(\"office:font-face-decls\")\n        existing = self.content.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_page_layout(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        # force to automatic\n        style_container = self.styles.get_element(\"office:automatic-styles\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_draw_fill_image(\n        self,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        # special case for 'draw:fill-image' pseudo style\n        # not family and style_element.__class__.__name__ == \"DrawFillImage\"\n        style_container = self.styles.get_element(\"office:styles\")\n        existing = self.styles.get_style(\"\", name)\n        return existing, style_container\n\n    def _insert_style_standard(\n        self,\n        style: Style,\n        name: str,\n        family: str,\n        automatic: bool,\n        default: bool,\n    ) -&gt; tuple[Any, Any]:\n        # Common style\n        if name and automatic is False and default is False:\n            return self._insert_style_get_common_styles(family, name)\n        # Automatic style\n        elif automatic is True and default is False:\n            return self._insert_style_get_automatic_styles(style, family, name)\n        # Default style\n        elif automatic is False and default is True:\n            return self._insert_style_get_default_styles(style, family, name)\n        else:\n            raise AttributeError(\"Invalid combination of arguments\")\n\n    def insert_style(  # noqa: C901\n        self,\n        style: Style | str,\n        name: str = \"\",\n        automatic: bool = False,\n        default: bool = False,\n    ) -&gt; Any:\n        \"\"\"Insert the given style object in the document, as required by the\n        style family and type.\n\n        The style is expected to be a common style with a name. In case it\n        was created with no name, the given can be set on the fly.\n\n        If automatic is True, the style will be inserted as an automatic\n        style.\n\n        If default is True, the style will be inserted as a default style and\n        would replace any existing default style of the same family. Any name\n        or display name would be ignored.\n\n        Automatic and default arguments are mutually exclusive.\n\n        All styles can't be used as default styles. Default styles are\n        allowed for the following families: paragraph, text, section, table,\n        table-column, table-row, table-cell, table-page, chart, drawing-page,\n        graphic, presentation, control and ruby.\n\n        Arguments:\n\n            style -- Style or str\n\n            name -- str\n\n            automatic -- bool\n\n            default -- bool\n\n        Return : style name -- str\n        \"\"\"\n\n        # if style is a str, assume it is the Style definition\n        if isinstance(style, str):\n            style_element: Style = Element.from_tag(style)  # type: ignore\n        else:\n            style_element = style\n        if not isinstance(style_element, Element):\n            raise TypeError(f\"Unknown Style type: '{style!r}'\")\n\n        # Get family and name\n        family = self._pseudo_style_attribute(style_element, \"family\")\n        if not name:\n            name = self._pseudo_style_attribute(style_element, \"name\")\n\n        # Master page style\n        if family == \"master-page\":\n            existing, style_container = self._insert_style_get_master_page(family, name)\n        # Font face declarations\n        elif family == \"font-face\":\n            if default:\n                existing, style_container = self._insert_style_get_font_face_default(\n                    family, name\n                )\n            else:\n                existing, style_container = self._insert_style_get_font_face(\n                    family, name\n                )\n        # page layout style\n        elif family == \"page-layout\":\n            existing, style_container = self._insert_style_get_page_layout(family, name)\n        # Common style\n        elif family in FAMILY_ODF_STD or family in {\"number\"}:\n            existing, style_container = self._insert_style_standard(\n                style_element, name, family, automatic, default\n            )\n        elif not family and style_element.__class__.__name__ == \"DrawFillImage\":\n            # special case for 'draw:fill-image' pseudo style\n            existing, style_container = self._insert_style_get_draw_fill_image(name)\n        # Invalid style\n        else:\n            raise ValueError(\n                \"Invalid style: \"\n                f\"{style_element}, tag:{style_element.tag}, family:{family}\"\n            )\n\n        # Insert it!\n        if existing is not None:\n            style_container.delete(existing)\n        style_container.append(style_element)\n        return self._pseudo_style_attribute(style_element, \"name\")\n\n    def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n        \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n        name (or all by default).\n\n        Arguments:\n\n            name -- str\n\n        Return: list\n        \"\"\"\n        # Header, footer, etc. have styles too\n        return self.content.root.get_styled_elements(\n            name\n        ) + self.styles.root.get_styled_elements(name)\n\n    def show_styles(\n        self,\n        automatic: bool = True,\n        common: bool = True,\n        properties: bool = False,\n    ) -&gt; str:\n        infos = []\n        for style in self.get_styles():\n            try:\n                name = style.name  # type: ignore\n            except AttributeError:\n                print(\"--------------\")\n                print(style.__class__)\n                print(style.serialize())\n                raise\n            if style.__class__.__name__ == \"DrawFillImage\":\n                family = \"\"\n            else:\n                family = str(style.family)  # type: ignore\n            parent = style.parent\n            is_auto = parent and parent.tag == \"office:automatic-styles\"\n            if is_auto and automatic is False or not is_auto and common is False:\n                continue\n            is_used = bool(self.get_styled_elements(name))\n            infos.append(\n                {\n                    \"type\": \"auto  \" if is_auto else \"common\",\n                    \"used\": \"y\" if is_used else \"n\",\n                    \"family\": family,\n                    \"parent\": self._pseudo_style_attribute(style, \"parent_style\") or \"\",\n                    \"name\": name or \"\",\n                    \"display_name\": self._pseudo_style_attribute(style, \"display_name\")\n                    or \"\",\n                    \"properties\": style.get_properties() if properties else None,  # type: ignore\n                }\n            )\n        if not infos:\n            return \"\"\n        # Sort by family and name\n        infos.sort(key=itemgetter(\"family\", \"name\"))\n        # Show common and used first\n        infos.sort(key=itemgetter(\"type\", \"used\"), reverse=True)\n        max_family = str(max([len(x[\"family\"]) for x in infos]))  # type: ignore\n        max_parent = str(max([len(x[\"parent\"]) for x in infos]))  # type: ignore\n        formater = (\n            \"%(type)s used:%(used)s family:%(family)-0\"\n            + max_family\n            + \"s parent:%(parent)-0\"\n            + max_parent\n            + \"s name:%(name)s\"\n        )\n        output = []\n        for info in infos:\n            line = formater % info\n            if info[\"display_name\"]:\n                line += \" display_name:\" + info[\"display_name\"]  # type: ignore\n            output.append(line)\n            if info[\"properties\"]:\n                for name, value in info[\"properties\"].items():  # type: ignore\n                    output.append(f\"   - {name}: {value}\")\n        output.append(\"\")\n        return \"\\n\".join(output)\n\n    def delete_styles(self) -&gt; int:\n        \"\"\"Remove all style information from content and all styles.\n\n        Return: number of deleted styles\n        \"\"\"\n        # First remove references to styles\n        for element in self.get_styled_elements():\n            for attribute in (\n                \"text:style-name\",\n                \"draw:style-name\",\n                \"draw:text-style-name\",\n                \"table:style-name\",\n                \"style:page-layout-name\",\n            ):\n                try:\n                    element.del_attribute(attribute)\n                except KeyError:\n                    continue\n        # Then remove supposedly orphaned styles\n        deleted = 0\n        for style in self.get_styles():\n            if style.name is None:  # type: ignore\n                # Don't delete default styles\n                continue\n            # elif type(style) is odf_master_page:\n            #    # Don't suppress header and footer, just styling was removed\n            #    continue\n            style.delete()\n            deleted += 1\n        return deleted\n\n    def merge_styles_from(self, document: Document) -&gt; None:\n        \"\"\"Copy all the styles of a document into ourself.\n\n        Styles with the same type and name will be replaced, so only unique\n        styles will be preserved.\n        \"\"\"\n        manifest = self.manifest\n        document_manifest = document.manifest\n        for style in document.get_styles():\n            tagname = style.tag\n            family = self._pseudo_style_attribute(style, \"family\")\n            stylename = style.name  # type: ignore\n            container = style.parent\n            container_name = container.tag  # type: ignore\n            partname = container.parent.tag  # type: ignore\n            # The destination part\n            if partname == \"office:document-styles\":\n                part: Content | Styles = self.styles\n            elif partname == \"office:document-content\":\n                part = self.content\n            else:\n                raise NotImplementedError(partname)\n            # Implemented containers\n            if container_name not in {\n                \"office:styles\",\n                \"office:automatic-styles\",\n                \"office:master-styles\",\n                \"office:font-face-decls\",\n            }:\n                raise NotImplementedError(container_name)\n            dest = part.get_element(f\"//{container_name}\")\n            # Implemented style types\n            # if tagname not in registered_styles:\n            #    raise NotImplementedError(tagname)\n            duplicate = part.get_style(family, stylename)\n            if duplicate is not None:\n                duplicate.delete()\n            dest.append(style)\n            # Copy images from the header/footer\n            if tagname == \"style:master-page\":\n                query = \"descendant::draw:image\"\n                for image in style.get_elements(query):\n                    url = image.url  # type: ignore\n                    part_url = document.get_part(url)\n                    # Manually add the part to keep the name\n                    self.set_part(url, part_url)  # type: ignore\n                    media_type = document_manifest.get_media_type(url)\n                    manifest.add_full_path(url, media_type)  # type: ignore\n            # Copy images from the fill-image\n            elif tagname == \"draw:fill-image\":\n                url = style.url  # type: ignore\n                part_url = document.get_part(url)\n                self.set_part(url, part_url)  # type: ignore\n                media_type = document_manifest.get_media_type(url)\n                manifest.add_full_path(url, media_type)  # type: ignore\n\n    def add_page_break_style(self) -&gt; None:\n        \"\"\"Ensure that the document contains the style required for a manual page break.\n\n        Then a manual page break can be added to the document with:\n            from paragraph import PageBreak\n            ...\n            document.body.append(PageBreak())\n\n        Note: this style uses the property 'fo:break-after', another\n        possibility could be the property 'fo:break-before'\n        \"\"\"\n        if existing := self.get_style(  # noqa: SIM102\n            family=\"paragraph\",\n            name_or_element=\"odfdopagebreak\",\n        ):\n            if properties := existing.get_properties():  # noqa: SIM102\n                if properties[\"fo:break-after\"] == \"page\":\n                    return\n        style = (\n            '&lt;style:style style:family=\"paragraph\" style:parent-style-name=\"Standard\" '\n            'style:name=\"odfdopagebreak\"&gt;'\n            '&lt;style:paragraph-properties fo:break-after=\"page\"/&gt;&lt;/style:style&gt;'\n        )\n        self.insert_style(style, automatic=False)\n\n    def get_style_properties(\n        self, family: str, name: str, area: str | None = None\n    ) -&gt; dict[str, str] | None:\n        \"\"\"Return the properties of the required style as a dict.\"\"\"\n        style = self.get_style(family, name)\n        if style is None:\n            return None\n        return style.get_properties(area=area)  # type: ignore\n\n    def get_cell_style_properties(  # noqa: C901\n        self, table: str | int, coord: tuple | list | str\n    ) -&gt; dict[str, str]:  # type: ignore\n        \"\"\"Return the style properties of a table cell of a .ods document,\n        from the cell style or from the row style.\"\"\"\n\n        def _get_table(table: int | str) -&gt; Table | None:\n            table_pos = 0\n            table_name = None\n            if isinstance(table, int):\n                table_pos = table\n            elif isinstance(table, str):\n                table_name = table_name\n            else:\n                raise TypeError(f\"Table parameter must be int or str: {table!r}\")\n            return self.body.get_table(\n                position=table_pos, name=table_name  # type: ignore\n            )\n\n        if not (sheet := _get_table(table)):\n            return {}\n        cell = sheet.get_cell(coord, clone=False)\n        if cell.style:\n            return (\n                self.get_style_properties(\"table-cell\", cell.style, \"table-cell\") or {}\n            )\n        try:\n            row = sheet.get_row(cell.y, clone=False, create=False)  # type: ignore\n            if row.style:  # noqa: SIM102\n                if props := self.get_style_properties(\n                    \"table-row\", row.style, \"table-cell\"\n                ):\n                    return props\n            column = sheet.get_column(cell.x)  # type: ignore\n            style = column.default_cell_style\n            if style:  # noqa: SIM102\n                if props := self.get_style_properties(\n                    \"table-cell\", style, \"table-cell\"\n                ):\n                    return props\n        except ValueError:\n            pass\n        return {}\n\n    def get_cell_background_color(\n        self,\n        table: str | int,\n        coord: tuple | list | str,\n        default: str = \"#ffffff\",\n    ) -&gt; str:\n        \"\"\"Return the background color of a table cell of a .ods document,\n        from the cell style, or from the row or column.\n\n        If color is not defined, return default value..\"\"\"\n        found = self.get_cell_style_properties(table, coord).get(\"fo:background-color\")\n        return found or default\n</code></pre>"},{"location":"reference.html#odfdo.Document.body","title":"<code>body: Element</code>  <code>property</code>","text":"<p>Return the body element of the content part, where actual content is stored.</p>"},{"location":"reference.html#odfdo.Document.clone","title":"<code>clone: Document</code>  <code>property</code>","text":"<p>Return an exact copy of the document.</p> <p>Return: Document</p>"},{"location":"reference.html#odfdo.Document.manifest","title":"<code>manifest: Manifest</code>  <code>property</code>","text":"<p>Return the manifest part (manifest.xml) of the document.</p>"},{"location":"reference.html#odfdo.Document.meta","title":"<code>meta: Meta</code>  <code>property</code>","text":"<p>Return the meta part (meta.xml) of the document, where meta data are stored.</p>"},{"location":"reference.html#odfdo.Document.parts","title":"<code>parts: list[str]</code>  <code>property</code>","text":"<p>Return available part names with path inside the archive, e.g. [\u2018content.xml\u2019, \u2026, \u2018Pictures/100000000000032000000258912EB1C3.jpg\u2019]</p>"},{"location":"reference.html#odfdo.Document.path","title":"<code>path: Path | None</code>  <code>property</code> <code>writable</code>","text":"<p>Shortcut to Document.Container.path.</p>"},{"location":"reference.html#odfdo.Document.add_file","title":"<code>add_file(path_or_file)</code>","text":"<p>Insert a file from a path or a file-like object in the container.</p> <p>Return the full path to reference in the content.</p> <p>Arguments:</p> <pre><code>path_or_file -- str or Path or file-like\n</code></pre> <p>Return: str (URI)</p> Source code in <code>odfdo/document.py</code> <pre><code>def add_file(self, path_or_file: str | Path) -&gt; str:\n    \"\"\"Insert a file from a path or a file-like object in the container.\n\n    Return the full path to reference in the content.\n\n    Arguments:\n\n        path_or_file -- str or Path or file-like\n\n    Return: str (URI)\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    name = \"\"\n    # Folder for added files (FIXME hard-coded and copied)\n    manifest = self.manifest\n    medias = manifest.get_paths()\n    # uuid = str(uuid4())\n\n    if isinstance(path_or_file, (str, Path)):\n        path = Path(path_or_file)\n        extension = path.suffix.lower()\n        name = f\"{path.stem}{extension}\"\n        if posixpath.join(\"Pictures\", name) in medias:\n            name = f\"{path.stem}_{uuid4()}{extension}\"\n    else:\n        path = None\n        name = getattr(path_or_file, \"name\", None)\n        if not name:\n            name = str(uuid4())\n    media_type, _encoding = guess_type(name)\n    if not media_type:\n        media_type = \"application/octet-stream\"\n    if manifest.get_media_type(\"Pictures/\") is None:\n        manifest.add_full_path(\"Pictures/\")\n    full_path = posixpath.join(\"Pictures\", name)\n    if path is None:\n        self.container.set_part(full_path, path_or_file.read())  # type:ignore\n    else:\n        self.container.set_part(full_path, path.read_bytes())\n    manifest.add_full_path(full_path, media_type)\n    return full_path\n</code></pre>"},{"location":"reference.html#odfdo.Document.add_page_break_style","title":"<code>add_page_break_style()</code>","text":"<p>Ensure that the document contains the style required for a manual page break.</p> Then a manual page break can be added to the document with <p>from paragraph import PageBreak \u2026 document.body.append(PageBreak())</p> <p>Note: this style uses the property \u2018fo:break-after\u2019, another possibility could be the property \u2018fo:break-before\u2019</p> Source code in <code>odfdo/document.py</code> <pre><code>def add_page_break_style(self) -&gt; None:\n    \"\"\"Ensure that the document contains the style required for a manual page break.\n\n    Then a manual page break can be added to the document with:\n        from paragraph import PageBreak\n        ...\n        document.body.append(PageBreak())\n\n    Note: this style uses the property 'fo:break-after', another\n    possibility could be the property 'fo:break-before'\n    \"\"\"\n    if existing := self.get_style(  # noqa: SIM102\n        family=\"paragraph\",\n        name_or_element=\"odfdopagebreak\",\n    ):\n        if properties := existing.get_properties():  # noqa: SIM102\n            if properties[\"fo:break-after\"] == \"page\":\n                return\n    style = (\n        '&lt;style:style style:family=\"paragraph\" style:parent-style-name=\"Standard\" '\n        'style:name=\"odfdopagebreak\"&gt;'\n        '&lt;style:paragraph-properties fo:break-after=\"page\"/&gt;&lt;/style:style&gt;'\n    )\n    self.insert_style(style, automatic=False)\n</code></pre>"},{"location":"reference.html#odfdo.Document.del_part","title":"<code>del_part(path)</code>","text":"<p>Mark a part for deletion. The path is relative to the archive, e.g. \u201cPictures/1003200258912EB1C3.jpg\u201d</p> Source code in <code>odfdo/document.py</code> <pre><code>def del_part(self, path: str) -&gt; None:\n    \"\"\"Mark a part for deletion. The path is relative to the archive,\n    e.g. \"Pictures/1003200258912EB1C3.jpg\"\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    path = _get_part_path(path)\n    cls = _get_part_class(path)\n    if path == ODF_MANIFEST or cls is not None:\n        raise ValueError(f\"part '{path}' is mandatory\")\n    self.container.del_part(path)\n</code></pre>"},{"location":"reference.html#odfdo.Document.delete_styles","title":"<code>delete_styles()</code>","text":"<p>Remove all style information from content and all styles.</p> <p>Return: number of deleted styles</p> Source code in <code>odfdo/document.py</code> <pre><code>def delete_styles(self) -&gt; int:\n    \"\"\"Remove all style information from content and all styles.\n\n    Return: number of deleted styles\n    \"\"\"\n    # First remove references to styles\n    for element in self.get_styled_elements():\n        for attribute in (\n            \"text:style-name\",\n            \"draw:style-name\",\n            \"draw:text-style-name\",\n            \"table:style-name\",\n            \"style:page-layout-name\",\n        ):\n            try:\n                element.del_attribute(attribute)\n            except KeyError:\n                continue\n    # Then remove supposedly orphaned styles\n    deleted = 0\n    for style in self.get_styles():\n        if style.name is None:  # type: ignore\n            # Don't delete default styles\n            continue\n        # elif type(style) is odf_master_page:\n        #    # Don't suppress header and footer, just styling was removed\n        #    continue\n        style.delete()\n        deleted += 1\n    return deleted\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_cell_background_color","title":"<code>get_cell_background_color(table, coord, default='#ffffff')</code>","text":"<p>Return the background color of a table cell of a .ods document, from the cell style, or from the row or column.</p> <p>If color is not defined, return default value..</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_cell_background_color(\n    self,\n    table: str | int,\n    coord: tuple | list | str,\n    default: str = \"#ffffff\",\n) -&gt; str:\n    \"\"\"Return the background color of a table cell of a .ods document,\n    from the cell style, or from the row or column.\n\n    If color is not defined, return default value..\"\"\"\n    found = self.get_cell_style_properties(table, coord).get(\"fo:background-color\")\n    return found or default\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_cell_style_properties","title":"<code>get_cell_style_properties(table, coord)</code>","text":"<p>Return the style properties of a table cell of a .ods document, from the cell style or from the row style.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_cell_style_properties(  # noqa: C901\n    self, table: str | int, coord: tuple | list | str\n) -&gt; dict[str, str]:  # type: ignore\n    \"\"\"Return the style properties of a table cell of a .ods document,\n    from the cell style or from the row style.\"\"\"\n\n    def _get_table(table: int | str) -&gt; Table | None:\n        table_pos = 0\n        table_name = None\n        if isinstance(table, int):\n            table_pos = table\n        elif isinstance(table, str):\n            table_name = table_name\n        else:\n            raise TypeError(f\"Table parameter must be int or str: {table!r}\")\n        return self.body.get_table(\n            position=table_pos, name=table_name  # type: ignore\n        )\n\n    if not (sheet := _get_table(table)):\n        return {}\n    cell = sheet.get_cell(coord, clone=False)\n    if cell.style:\n        return (\n            self.get_style_properties(\"table-cell\", cell.style, \"table-cell\") or {}\n        )\n    try:\n        row = sheet.get_row(cell.y, clone=False, create=False)  # type: ignore\n        if row.style:  # noqa: SIM102\n            if props := self.get_style_properties(\n                \"table-row\", row.style, \"table-cell\"\n            ):\n                return props\n        column = sheet.get_column(cell.x)  # type: ignore\n        style = column.default_cell_style\n        if style:  # noqa: SIM102\n            if props := self.get_style_properties(\n                \"table-cell\", style, \"table-cell\"\n            ):\n                return props\n    except ValueError:\n        pass\n    return {}\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_formated_meta","title":"<code>get_formated_meta()</code>","text":"<p>Return meta informations as text, with some formatting.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_formated_meta(self) -&gt; str:\n    \"\"\"Return meta informations as text, with some formatting.\"\"\"\n    result: list[str] = []\n\n    # Simple values\n    def print_info(name: str, value: Any) -&gt; None:\n        if value:\n            result.append(f\"{name}: {value}\")\n\n    meta = self.meta\n    print_info(\"Title\", meta.title)\n    print_info(\"Subject\", meta.subject)\n    print_info(\"Description\", meta.description)\n    print_info(\"Language\", meta.language)\n    print_info(\"Modification date\", meta.date)\n    print_info(\"Creation date\", meta.creation_date)\n    print_info(\"Initial creator\", meta.initial_creator)\n    print_info(\"Keyword\", meta.keyword)\n    print_info(\"Editing duration\", meta.editing_duration)\n    print_info(\"Editing cycles\", meta.editing_cycles)\n    print_info(\"Generator\", meta.generator)\n\n    # Statistic\n    result.append(\"Statistic:\")\n    statistic = meta.statistic\n    if statistic:\n        for name, data in statistic.items():\n            result.append(f\"  - {name[5:].replace('-', ' ').capitalize()}: {data}\")\n\n    # User defined metadata\n    result.append(\"User defined metadata:\")\n    user_metadata = meta.user_defined_metadata\n    for name, data2 in user_metadata.items():\n        result.append(f\"  - {name}: {data2}\")\n\n    # And the description\n    print_info(\"Description\", meta.get_description())\n\n    return \"\\n\".join(result) + \"\\n\"\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_formatted_text","title":"<code>get_formatted_text(rst_mode=False)</code>","text":"<p>Return content as text, with some formatting.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_formatted_text(self, rst_mode: bool = False) -&gt; str:\n    \"\"\"Return content as text, with some formatting.\"\"\"\n    # For the moment, only \"type='text'\"\n    doc_type = self.get_type()\n    if doc_type == \"spreadsheet\":\n        return self._tables_csv()\n    if doc_type in {\n        \"text\",\n        \"text-template\",\n        \"presentation\",\n        \"presentation-template\",\n    }:\n        return self._formatted_text(rst_mode)\n    raise NotImplementedError(f\"Type of document '{doc_type}' not supported yet\")\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_part","title":"<code>get_part(path)</code>","text":"<p>Return the bytes of the given part. The path is relative to the archive, e.g. \u201cPictures/1003200258912EB1C3.jpg\u201d.</p> <p>\u2018content\u2019, \u2018meta\u2019, \u2018settings\u2019, \u2018styles\u2019 and \u2018manifest\u2019 are shortcuts to the real path, e.g. content.xml, and return a dedicated object with its own API.</p> <p>path formated as URI, so always use \u2018/\u2019 separator</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_part(self, path: str) -&gt; XmlPart | str | bytes | None:\n    \"\"\"Return the bytes of the given part. The path is relative to the\n    archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n    'content', 'meta', 'settings', 'styles' and 'manifest' are shortcuts\n    to the real path, e.g. content.xml, and return a dedicated object with\n    its own API.\n\n    path formated as URI, so always use '/' separator\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    # \"./ObjectReplacements/Object 1\"\n    path = path.lstrip(\"./\")\n    path = _get_part_path(path)\n    cls = _get_part_class(path)\n    # Raw bytes\n    if cls is None:\n        return self.container.get_part(path)\n    # XML part\n    part = self.__xmlparts.get(path)\n    if part is None:\n        self.__xmlparts[path] = part = cls(path, self.container)\n    return part\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_parts","title":"<code>get_parts()</code>","text":"<p>Return available part names with path inside the archive, e.g. [\u2018content.xml\u2019, \u2026, \u2018Pictures/100000000000032000000258912EB1C3.jpg\u2019]</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_parts(self) -&gt; list[str]:\n    \"\"\"Return available part names with path inside the archive, e.g.\n    ['content.xml', ..., 'Pictures/100000000000032000000258912EB1C3.jpg']\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    return self.container.parts\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the name/family pair. If the argument is already a style object, it will return it.</p> <p>If the name is None, the default style is fetched.</p> <p>If the name is not the internal name but the name you gave in a desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n          'number', 'page-layout', 'master-page'\n\nname -- str or Element or None\n\ndisplay_name -- str\n</code></pre> <p>Return: Style or None if not found.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Style | None = None,\n    display_name: str | None = None,\n) -&gt; Style | None:\n    \"\"\"Return the style uniquely identified by the name/family pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is None, the default style is fetched.\n\n    If the name is not the internal name but the name you gave in a\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                  'number', 'page-layout', 'master-page'\n\n        name -- str or Element or None\n\n        display_name -- str\n\n    Return: Style or None if not found.\n    \"\"\"\n    # 1. content.xml\n    element = self.content.get_style(\n        family, name_or_element=name_or_element, display_name=display_name\n    )\n    if element is not None:\n        return element\n    # 2. styles.xml\n    return self.styles.get_style(\n        family,\n        name_or_element=name_or_element,\n        display_name=display_name,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_style_properties","title":"<code>get_style_properties(family, name, area=None)</code>","text":"<p>Return the properties of the required style as a dict.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_style_properties(\n    self, family: str, name: str, area: str | None = None\n) -&gt; dict[str, str] | None:\n    \"\"\"Return the properties of the required style as a dict.\"\"\"\n    style = self.get_style(family, name)\n    if style is None:\n        return None\n    return style.get_properties(area=area)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_styled_elements","title":"<code>get_styled_elements(name='')</code>","text":"<p>Brute-force to find paragraphs, tables, etc. using the given style name (or all by default).</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: list</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n    \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n    name (or all by default).\n\n    Arguments:\n\n        name -- str\n\n    Return: list\n    \"\"\"\n    # Header, footer, etc. have styles too\n    return self.content.root.get_styled_elements(\n        name\n    ) + self.styles.root.get_styled_elements(name)\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_type","title":"<code>get_type()</code>","text":"<p>Get the ODF type (also called class) of this document.</p> \u2018chart\u2019, \u2018database\u2019, \u2018formula\u2019, \u2018graphics\u2019, <p>\u2018graphics-template\u2019, \u2018image\u2019, \u2018presentation\u2019, \u2018presentation-template\u2019, \u2018spreadsheet\u2019, \u2018spreadsheet-template\u2019, \u2018text\u2019, \u2018text-master\u2019, \u2018text-template\u2019 or \u2018text-web\u2019</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_type(self) -&gt; str:\n    \"\"\"Get the ODF type (also called class) of this document.\n\n    Return: 'chart', 'database', 'formula', 'graphics',\n        'graphics-template', 'image', 'presentation',\n        'presentation-template', 'spreadsheet', 'spreadsheet-template',\n        'text', 'text-master', 'text-template' or 'text-web'\n    \"\"\"\n    # The mimetype must be with the form:\n    # application/vnd.oasis.opendocument.text\n\n    # Isolate and return the last part\n    return self.mimetype.rsplit(\".\", 1)[-1]\n</code></pre>"},{"location":"reference.html#odfdo.Document.insert_style","title":"<code>insert_style(style, name='', automatic=False, default=False)</code>","text":"<p>Insert the given style object in the document, as required by the style family and type.</p> <p>The style is expected to be a common style with a name. In case it was created with no name, the given can be set on the fly.</p> <p>If automatic is True, the style will be inserted as an automatic style.</p> <p>If default is True, the style will be inserted as a default style and would replace any existing default style of the same family. Any name or display name would be ignored.</p> <p>Automatic and default arguments are mutually exclusive.</p> <p>All styles can\u2019t be used as default styles. Default styles are allowed for the following families: paragraph, text, section, table, table-column, table-row, table-cell, table-page, chart, drawing-page, graphic, presentation, control and ruby.</p> <p>Arguments:</p> <pre><code>style -- Style or str\n\nname -- str\n\nautomatic -- bool\n\ndefault -- bool\n</code></pre> <p>Return : style name \u2013 str</p> Source code in <code>odfdo/document.py</code> <pre><code>def insert_style(  # noqa: C901\n    self,\n    style: Style | str,\n    name: str = \"\",\n    automatic: bool = False,\n    default: bool = False,\n) -&gt; Any:\n    \"\"\"Insert the given style object in the document, as required by the\n    style family and type.\n\n    The style is expected to be a common style with a name. In case it\n    was created with no name, the given can be set on the fly.\n\n    If automatic is True, the style will be inserted as an automatic\n    style.\n\n    If default is True, the style will be inserted as a default style and\n    would replace any existing default style of the same family. Any name\n    or display name would be ignored.\n\n    Automatic and default arguments are mutually exclusive.\n\n    All styles can't be used as default styles. Default styles are\n    allowed for the following families: paragraph, text, section, table,\n    table-column, table-row, table-cell, table-page, chart, drawing-page,\n    graphic, presentation, control and ruby.\n\n    Arguments:\n\n        style -- Style or str\n\n        name -- str\n\n        automatic -- bool\n\n        default -- bool\n\n    Return : style name -- str\n    \"\"\"\n\n    # if style is a str, assume it is the Style definition\n    if isinstance(style, str):\n        style_element: Style = Element.from_tag(style)  # type: ignore\n    else:\n        style_element = style\n    if not isinstance(style_element, Element):\n        raise TypeError(f\"Unknown Style type: '{style!r}'\")\n\n    # Get family and name\n    family = self._pseudo_style_attribute(style_element, \"family\")\n    if not name:\n        name = self._pseudo_style_attribute(style_element, \"name\")\n\n    # Master page style\n    if family == \"master-page\":\n        existing, style_container = self._insert_style_get_master_page(family, name)\n    # Font face declarations\n    elif family == \"font-face\":\n        if default:\n            existing, style_container = self._insert_style_get_font_face_default(\n                family, name\n            )\n        else:\n            existing, style_container = self._insert_style_get_font_face(\n                family, name\n            )\n    # page layout style\n    elif family == \"page-layout\":\n        existing, style_container = self._insert_style_get_page_layout(family, name)\n    # Common style\n    elif family in FAMILY_ODF_STD or family in {\"number\"}:\n        existing, style_container = self._insert_style_standard(\n            style_element, name, family, automatic, default\n        )\n    elif not family and style_element.__class__.__name__ == \"DrawFillImage\":\n        # special case for 'draw:fill-image' pseudo style\n        existing, style_container = self._insert_style_get_draw_fill_image(name)\n    # Invalid style\n    else:\n        raise ValueError(\n            \"Invalid style: \"\n            f\"{style_element}, tag:{style_element.tag}, family:{family}\"\n        )\n\n    # Insert it!\n    if existing is not None:\n        style_container.delete(existing)\n    style_container.append(style_element)\n    return self._pseudo_style_attribute(style_element, \"name\")\n</code></pre>"},{"location":"reference.html#odfdo.Document.merge_styles_from","title":"<code>merge_styles_from(document)</code>","text":"<p>Copy all the styles of a document into ourself.</p> <p>Styles with the same type and name will be replaced, so only unique styles will be preserved.</p> Source code in <code>odfdo/document.py</code> <pre><code>def merge_styles_from(self, document: Document) -&gt; None:\n    \"\"\"Copy all the styles of a document into ourself.\n\n    Styles with the same type and name will be replaced, so only unique\n    styles will be preserved.\n    \"\"\"\n    manifest = self.manifest\n    document_manifest = document.manifest\n    for style in document.get_styles():\n        tagname = style.tag\n        family = self._pseudo_style_attribute(style, \"family\")\n        stylename = style.name  # type: ignore\n        container = style.parent\n        container_name = container.tag  # type: ignore\n        partname = container.parent.tag  # type: ignore\n        # The destination part\n        if partname == \"office:document-styles\":\n            part: Content | Styles = self.styles\n        elif partname == \"office:document-content\":\n            part = self.content\n        else:\n            raise NotImplementedError(partname)\n        # Implemented containers\n        if container_name not in {\n            \"office:styles\",\n            \"office:automatic-styles\",\n            \"office:master-styles\",\n            \"office:font-face-decls\",\n        }:\n            raise NotImplementedError(container_name)\n        dest = part.get_element(f\"//{container_name}\")\n        # Implemented style types\n        # if tagname not in registered_styles:\n        #    raise NotImplementedError(tagname)\n        duplicate = part.get_style(family, stylename)\n        if duplicate is not None:\n            duplicate.delete()\n        dest.append(style)\n        # Copy images from the header/footer\n        if tagname == \"style:master-page\":\n            query = \"descendant::draw:image\"\n            for image in style.get_elements(query):\n                url = image.url  # type: ignore\n                part_url = document.get_part(url)\n                # Manually add the part to keep the name\n                self.set_part(url, part_url)  # type: ignore\n                media_type = document_manifest.get_media_type(url)\n                manifest.add_full_path(url, media_type)  # type: ignore\n        # Copy images from the fill-image\n        elif tagname == \"draw:fill-image\":\n            url = style.url  # type: ignore\n            part_url = document.get_part(url)\n            self.set_part(url, part_url)  # type: ignore\n            media_type = document_manifest.get_media_type(url)\n            manifest.add_full_path(url, media_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Document.new","title":"<code>new(template='text')</code>  <code>classmethod</code>","text":"<p>Create a Document from a template.</p> <p>The template argument is expected to be the path to a ODF template.</p> <p>Arguments:</p> <pre><code>template -- str or Path or file-like (io.BytesIO)\n</code></pre> <p>Return : ODF document \u2013 Document</p> Source code in <code>odfdo/document.py</code> <pre><code>@classmethod\ndef new(cls, template: str | Path | io.BytesIO = \"text\") -&gt; Document:\n    \"\"\"Create a Document from a template.\n\n    The template argument is expected to be the path to a ODF template.\n\n    Arguments:\n\n        template -- str or Path or file-like (io.BytesIO)\n\n    Return : ODF document -- Document\n    \"\"\"\n    container = container_from_template(template)\n    return cls(container)\n</code></pre>"},{"location":"reference.html#odfdo.Document.save","title":"<code>save(target=None, packaging=ZIP, pretty=False, backup=False)</code>","text":"<p>Save the document, at the same place it was opened or at the given target path. Target can also be a file-like object. It can be saved as a Zip file (default), flat XML format or as files in a folder (for debugging purpose). XML parts can be pretty printed.</p> <p>Arguments:</p> <pre><code>target -- str or file-like object\n\npackaging -- 'zip', 'folder', 'xml'\n\npretty -- bool\n\nbackup -- bool\n</code></pre> Source code in <code>odfdo/document.py</code> <pre><code>def save(\n    self,\n    target: str | Path | io.BytesIO | None = None,\n    packaging: str = ZIP,\n    pretty: bool = False,\n    backup: bool = False,\n) -&gt; None:\n    \"\"\"Save the document, at the same place it was opened or at the given\n    target path. Target can also be a file-like object. It can be saved\n    as a Zip file (default), flat XML format or as files in a folder\n    (for debugging purpose). XML parts can be pretty printed.\n\n    Arguments:\n\n        target -- str or file-like object\n\n        packaging -- 'zip', 'folder', 'xml'\n\n        pretty -- bool\n\n        backup -- bool\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    # Some advertising\n    self.meta.set_generator_default()\n    # Synchronize data with container\n    container = self.container\n    for path, part in self.__xmlparts.items():\n        if part is not None:\n            container.set_part(path, part.serialize(pretty))\n    # Save the container\n    container.save(target, packaging=packaging, backup=backup)\n</code></pre>"},{"location":"reference.html#odfdo.Document.set_part","title":"<code>set_part(path, data)</code>","text":"<p>Set the bytes of the given part. The path is relative to the archive, e.g. \u201cPictures/1003200258912EB1C3.jpg\u201d.</p> <p>path formated as URI, so always use \u2018/\u2019 separator</p> Source code in <code>odfdo/document.py</code> <pre><code>def set_part(self, path: str, data: bytes) -&gt; None:\n    \"\"\"Set the bytes of the given part. The path is relative to the\n    archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n    path formated as URI, so always use '/' separator\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    # \"./ObjectReplacements/Object 1\"\n    path = path.lstrip(\"./\")\n    path = _get_part_path(path)\n    cls = _get_part_class(path)\n    # XML part overwritten\n    if cls is not None:\n        with suppress(KeyError):\n            self.__xmlparts[path]\n    self.container.set_part(path, data)\n</code></pre>"},{"location":"reference.html#odfdo.DrawFillImage","title":"<code>DrawFillImage</code>","text":"<p>             Bases: <code>DrawImage</code></p> Source code in <code>odfdo/image.py</code> <pre><code>class DrawFillImage(DrawImage):\n    _tag = \"draw:fill-image\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"display_name\", \"draw:display-name\"),\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"height\", \"svg:height\"),\n        PropDef(\"width\", \"svg:width\"),\n    )\n\n    def __init__(\n        self,\n        name: str | None = None,\n        display_name: str | None = None,\n        height: str | None = None,\n        width: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"The \"draw:fill-image\" element specifies a link to a bitmap\n        resource. Fill image are not available as automatic styles.\n        The \"draw:fill-image\" element is usable within the following element:\n        \"office:styles\"\n\n        Arguments:\n\n            name -- str\n\n            display_name -- str\n\n            height -- str\n\n            width -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n            self.display_name = display_name\n            self.height = height\n            self.width = width\n</code></pre>"},{"location":"reference.html#odfdo.DrawFillImage.__init__","title":"<code>__init__(name=None, display_name=None, height=None, width=None, **kwargs)</code>","text":"<p>The \u201cdraw:fill-image\u201d element specifies a link to a bitmap resource. Fill image are not available as automatic styles. The \u201cdraw:fill-image\u201d element is usable within the following element: \u201coffice:styles\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n\ndisplay_name -- str\n\nheight -- str\n\nwidth -- str\n</code></pre> Source code in <code>odfdo/image.py</code> <pre><code>def __init__(\n    self,\n    name: str | None = None,\n    display_name: str | None = None,\n    height: str | None = None,\n    width: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"The \"draw:fill-image\" element specifies a link to a bitmap\n    resource. Fill image are not available as automatic styles.\n    The \"draw:fill-image\" element is usable within the following element:\n    \"office:styles\"\n\n    Arguments:\n\n        name -- str\n\n        display_name -- str\n\n        height -- str\n\n        width -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n        self.display_name = display_name\n        self.height = height\n        self.width = width\n</code></pre>"},{"location":"reference.html#odfdo.DrawGroup","title":"<code>DrawGroup</code>","text":"<p>             Bases: <code>Element</code>, <code>AnchorMix</code>, <code>ZMix</code>, <code>PosMix</code></p> <p>The DrawGroup \u201cdraw:g\u201d element represents a group of drawing shapes.</p> <p>Warning: implementation is currently minimal.</p> <p>Drawing shapes contained by a \u201cdraw:g\u201d element that is itself contained by a \u201cdraw:a\u201d element, act as hyperlinks using the xlink:href attribute of the containing \u201cdraw:a\u201d element. If the included drawing shapes are themselves contained within \u201cdraw:a\u201d elements, then the xlink:href attributes of those \u201cdraw:a\u201d elements act as the hyperlink information for the shapes they contain.</p> <p>The \u201cdraw:g\u201d element has the following attributes: draw:caption-id, draw:class-names, draw:id, draw:name, draw:style-name, draw:z-index, presentation:class-names, presentation:style-name, svg:y, table:end-cell-address, table:end-x, table:end-y, table:table-background, text:anchor-page-number, text:anchor-type, and xml:id.</p> <p>The \u201cdraw:g\u201d element has the following child elements: \u201cdr3d:scene\u201d, \u201cdraw:a\u201d, \u201cdraw:caption\u201d, \u201cdraw:circle\u201d, \u201cdraw:connector\u201d, \u201cdraw:control\u201d, \u201cdraw:custom-shape\u201d, \u201cdraw:ellipse\u201d, \u201cdraw:frame\u201d, \u201cdraw:g\u201d, \u201cdraw:glue-point\u201d, \u201cdraw:line\u201d, \u201cdraw:measure\u201d, \u201cdraw:page-thumbnail\u201d, \u201cdraw:path\u201d, \u201cdraw:polygon\u201d, \u201cdraw:polyline\u201d, \u201cdraw:rect\u201d, \u201cdraw:regular-polygon\u201d, \u201coffice:event-listeners\u201d, \u201csvg:desc\u201d and \u201csvg:title\u201d.</p> Source code in <code>odfdo/shapes.py</code> <pre><code>class DrawGroup(Element, AnchorMix, ZMix, PosMix):\n    \"\"\"The DrawGroup \"draw:g\" element represents a group of drawing shapes.\n\n    Warning: implementation is currently minimal.\n\n    Drawing shapes contained by a \"draw:g\" element that is itself\n    contained by a \"draw:a\" element, act as hyperlinks using the\n    xlink:href attribute of the containing \"draw:a\" element. If the\n    included drawing shapes are themselves contained within \"draw:a\"\n    elements, then the xlink:href attributes of those \"draw:a\" elements\n    act as the hyperlink information for the shapes they contain.\n\n    The \"draw:g\" element has the following attributes: draw:caption-id,\n    draw:class-names, draw:id, draw:name, draw:style-name, draw:z-index,\n    presentation:class-names, presentation:style-name, svg:y,\n    table:end-cell-address, table:end-x, table:end-y,\n    table:table-background, text:anchor-page-number, text:anchor-type,\n    and xml:id.\n\n    The \"draw:g\" element has the following child elements: \"dr3d:scene\",\n    \"draw:a\", \"draw:caption\", \"draw:circle\", \"draw:connector\",\n    \"draw:control\", \"draw:custom-shape\", \"draw:ellipse\", \"draw:frame\",\n    \"draw:g\", \"draw:glue-point\", \"draw:line\", \"draw:measure\",\n    \"draw:page-thumbnail\", \"draw:path\", \"draw:polygon\", \"draw:polyline\",\n    \"draw:rect\", \"draw:regular-polygon\", \"office:event-listeners\",\n    \"svg:desc\" and \"svg:title\".\n    \"\"\"\n\n    _tag = \"draw:g\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"draw_id\", \"draw:id\"),\n        PropDef(\"caption_id\", \"draw:caption-id\"),\n        PropDef(\"draw_class_names\", \"draw:class-names\"),\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"style\", \"draw:style-name\"),\n        # ('z_index', 'draw:z-index'),\n        PropDef(\"presentation_class_names\", \"presentation:class-names\"),\n        PropDef(\"presentation_style\", \"presentation:style-name\"),\n        PropDef(\"table_end_cell\", \"table:end-cell-address\"),\n        PropDef(\"table_end_x\", \"table:end-x\"),\n        PropDef(\"table_end_y\", \"table:end-y\"),\n        PropDef(\"table_background\", \"table:table-background\"),\n        # ('anchor_page', 'text:anchor-page-number'),\n        # ('anchor_type', 'text:anchor-type'),\n        PropDef(\"xml_id\", \"xml:id\"),\n        PropDef(\"pos_x\", \"svg:x\"),\n        PropDef(\"pos_y\", \"svg:y\"),\n    )\n\n    def __init__(\n        self,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        z_index: int = 0,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if z_index is not None:\n                self.z_index = z_index\n            if name:\n                self.name = name\n            if draw_id is not None:\n                self.draw_id = draw_id\n            if style is not None:\n                self.style = style\n            if position is not None:\n                self.position = position\n            if anchor_type:\n                self.anchor_type = anchor_type\n            if anchor_page is not None:\n                self.anchor_page = anchor_page\n            if presentation_style is not None:\n                self.presentation_style = presentation_style\n</code></pre>"},{"location":"reference.html#odfdo.DrawImage","title":"<code>DrawImage</code>","text":"<p>             Bases: <code>Element</code></p> <p>The \u201cdraw:image\u201d element represents an image. An image can be either: - A link to an external resource or - Embedded in the document (Not implemented in this version)</p> <p>Warning: image elements must be stored in a frame \u201cdraw:frame\u201d, see Frame().</p> Source code in <code>odfdo/image.py</code> <pre><code>class DrawImage(Element):\n    \"\"\"The \"draw:image\" element represents an image. An image can be\n    either:\n    - A link to an external resource or\n    - Embedded in the document (Not implemented in this version)\n\n    Warning: image elements must be stored in a frame \"draw:frame\",\n    see Frame().\n    \"\"\"\n\n    _tag = \"draw:image\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"url\", \"xlink:href\"),\n        PropDef(\"type\", \"xlink:type\"),\n        PropDef(\"show\", \"xlink:show\"),\n        PropDef(\"actuate\", \"xlink:actuate\"),\n        PropDef(\"filter_name\", \"draw:filter-name\"),\n    )\n\n    def __init__(\n        self,\n        url: str = \"\",\n        xlink_type: str = \"simple\",\n        show: str = \"embed\",\n        actuate: str = \"onLoad\",\n        filter_name: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Initialisation of an DrawImage.\n\n        Arguments:\n\n            url -- str\n\n            type -- str\n\n            show -- str\n\n            actuate -- str\n\n            filter_name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.url = url\n            self.type = xlink_type\n            self.show = show\n            self.actuate = actuate\n            self.filter_name = filter_name\n</code></pre>"},{"location":"reference.html#odfdo.DrawImage.__init__","title":"<code>__init__(url='', xlink_type='simple', show='embed', actuate='onLoad', filter_name=None, **kwargs)</code>","text":"<p>Initialisation of an DrawImage.</p> <p>Arguments:</p> <pre><code>url -- str\n\ntype -- str\n\nshow -- str\n\nactuate -- str\n\nfilter_name -- str\n</code></pre> Source code in <code>odfdo/image.py</code> <pre><code>def __init__(\n    self,\n    url: str = \"\",\n    xlink_type: str = \"simple\",\n    show: str = \"embed\",\n    actuate: str = \"onLoad\",\n    filter_name: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Initialisation of an DrawImage.\n\n    Arguments:\n\n        url -- str\n\n        type -- str\n\n        show -- str\n\n        actuate -- str\n\n        filter_name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.url = url\n        self.type = xlink_type\n        self.show = show\n        self.actuate = actuate\n        self.filter_name = filter_name\n</code></pre>"},{"location":"reference.html#odfdo.DrawPage","title":"<code>DrawPage</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF draw page \u201cdraw:page\u201d, for pages of presentation and drawings.</p> Source code in <code>odfdo/draw_page.py</code> <pre><code>class DrawPage(Element):\n    \"\"\"ODF draw page \"draw:page\", for pages of presentation and drawings.\"\"\"\n\n    _tag = \"draw:page\"\n    _properties = (\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"draw_id\", \"draw:id\"),\n        PropDef(\"master_page\", \"draw:master-page-name\"),\n        PropDef(\n            \"presentation_page_layout\", \"presentation:presentation-page-layout-name\"\n        ),\n        PropDef(\"style\", \"draw:style-name\"),\n    )\n\n    def __init__(\n        self,\n        draw_id: str | None = None,\n        name: str | None = None,\n        master_page: str | None = None,\n        presentation_page_layout: str | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            draw_id -- str\n\n            name -- str\n\n            master_page -- str\n\n            presentation_page_layout -- str\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if draw_id:\n                self.draw_id = draw_id\n            if name:\n                self.name = name\n            if master_page:\n                self.master_page = master_page\n            if presentation_page_layout:\n                self.presentation_page_layout = presentation_page_layout\n            if style:\n                self.style = style\n\n    def set_transition(\n        self,\n        smil_type: str,\n        subtype: str | None = None,\n        dur: str = \"2s\",\n    ) -&gt; None:\n        # Create the new animation\n        anim_page = AnimPar(presentation_node_type=\"timing-root\")\n        anim_begin = AnimPar(smil_begin=f\"{self.draw_id}.begin\")\n        transition = AnimTransFilter(\n            smil_dur=dur, smil_type=smil_type, smil_subtype=subtype\n        )\n        anim_page.append(anim_begin)\n        anim_begin.append(transition)\n\n        # Replace when already a transition:\n        #   anim:seq =&gt; After the frame's transition\n        #   cf page 349 of OpenDocument-v1.0-os.pdf\n        #   Conclusion: We must delete the first child 'anim:par'\n        existing = self.get_element(\"anim:par\")\n        if existing:\n            self.delete(existing)\n        self.append(anim_page)\n\n    def get_shapes(self) -&gt; list[Element]:\n        query = \"(descendant::\" + \"|descendant::\".join(registered_shapes) + \")\"\n        return self.get_elements(query)\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        result: list[str] = []\n        for child in self.children:\n            if child.tag == \"presentation:notes\":\n                # No need for an advanced odf_notes.get_formatted_text()\n                # because the text seems to be only contained in paragraphs\n                # and frames, that we already handle\n                for sub_child in child.children:\n                    result.append(sub_child.get_formatted_text(context))\n                result.append(\"\\n\")\n            result.append(child.get_formatted_text(context))\n        result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.DrawPage.__init__","title":"<code>__init__(draw_id=None, name=None, master_page=None, presentation_page_layout=None, style=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>draw_id -- str\n\nname -- str\n\nmaster_page -- str\n\npresentation_page_layout -- str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/draw_page.py</code> <pre><code>def __init__(\n    self,\n    draw_id: str | None = None,\n    name: str | None = None,\n    master_page: str | None = None,\n    presentation_page_layout: str | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        draw_id -- str\n\n        name -- str\n\n        master_page -- str\n\n        presentation_page_layout -- str\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if draw_id:\n            self.draw_id = draw_id\n        if name:\n            self.name = name\n        if master_page:\n            self.master_page = master_page\n        if presentation_page_layout:\n            self.presentation_page_layout = presentation_page_layout\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Drawing","title":"<code>Drawing</code>","text":"<p>             Bases: <code>Body</code></p> <p>Drawing, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Drawing(Body):\n    \"\"\"Drawing, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:drawing\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.EText","title":"<code>EText</code>","text":"<p>             Bases: <code>str</code></p> <p>Representation of an XML text node. Created to hide the specifics of lxml in searching text nodes using XPath.</p> <p>Constructed like any str object but only accepts lxml text objects.</p> Source code in <code>odfdo/element.py</code> <pre><code>class EText(str):\n    \"\"\"Representation of an XML text node. Created to hide the specifics of\n    lxml in searching text nodes using XPath.\n\n    Constructed like any str object but only accepts lxml text objects.\n    \"\"\"\n\n    # There's some black magic in inheriting from str\n    def __init__(\n        self,\n        text_result: str | bytes,\n    ) -&gt; None:\n        self.__parent = text_result.getparent()  # type: ignore\n        self.__is_text = text_result.is_text\n        self.__is_tail = text_result.is_tail\n\n    @property\n    def parent(self) -&gt; Element | None:\n        parent = self.__parent\n        # XXX happens just because of the unit test\n        if parent is None:\n            return None\n        return Element.from_tag(tag_or_elem=parent)\n\n    def is_text(self) -&gt; bool:\n        return self.__is_text\n\n    def is_tail(self) -&gt; bool:\n        return self.__is_tail\n</code></pre>"},{"location":"reference.html#odfdo.Element","title":"<code>Element</code>","text":"<p>             Bases: <code>CachedElement</code></p> <p>Super class of all ODF classes.</p> <p>Representation of an XML element. Abstraction of the XML library behind.</p> Source code in <code>odfdo/element.py</code> <pre><code>class Element(CachedElement):\n    \"\"\"Super class of all ODF classes.\n\n    Representation of an XML element. Abstraction of the XML library behind.\n    \"\"\"\n\n    _tag: str = \"\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n\n    def __init__(self, **kwargs: Any) -&gt; None:\n        tag_or_elem = kwargs.pop(\"tag_or_elem\", None)\n        if tag_or_elem is None:\n            # Instance for newly created object: create new lxml element and\n            # continue by subclass __init__\n            # If the tag key word exists, make a custom element\n            self._do_init = True\n            tag = kwargs.pop(\"tag\", self._tag)\n            self.__element = self.make_etree_element(tag)\n        else:\n            # called with an existing lxml element, sould be a result of\n            # from_tag() casting, do not execute the subclass __init__\n            if not isinstance(tag_or_elem, _Element):\n                raise TypeError(f'\"{type(tag_or_elem)}\" is not an element node')\n            self._do_init = False\n            self.__element = tag_or_elem\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag}&gt;\"\n\n    def __str__(self) -&gt; str:\n        return self.text_recursive\n\n    @classmethod\n    def from_tag(cls, tag_or_elem: str | _Element) -&gt; Element:\n        \"\"\"Element class and subclass factory.\n\n        Turn an lxml Element or ODF string tag into an ODF XML Element\n        of the relevant class.\n\n        Arguments:\n\n            tag_or_elem -- ODF str tag or lxml.Element\n\n        Return: Element (or subclass) instance\n        \"\"\"\n        if isinstance(tag_or_elem, str):\n            # assume the argument is a prefix:name tag\n            elem = cls.make_etree_element(tag_or_elem)\n        else:\n            elem = tag_or_elem\n        klass = _class_registry.get(elem.tag, cls)\n        return klass(tag_or_elem=elem)\n\n    @classmethod\n    def from_tag_for_clone(\n        cls: type,\n        tree_element: _Element,\n        cache: tuple | None,\n    ) -&gt; Element:\n        tag = to_str(tree_element.tag)\n        klass = _class_registry.get(tag, cls)\n        element = klass(tag_or_elem=tree_element)\n        if cache and element._caching:\n            element._tmap = cache[0]\n            element._cmap = cache[1]\n            if len(cache) == 3:\n                element._rmap = cache[2]\n        return element\n\n    @staticmethod\n    def make_etree_element(tag: str) -&gt; _Element:\n        if not isinstance(tag, str):\n            raise TypeError(f\"Tag is not str: {tag!r}\")\n        tag = tag.strip()\n        if not tag:\n            raise ValueError(\"Tag is empty\")\n        if \"&lt;\" not in tag:\n            # Qualified name\n            # XXX don't build the element from scratch or lxml will pollute with\n            # repeated namespace declarations\n            tag = f\"&lt;{tag}/&gt;\"\n        # XML fragment\n        root = fromstring(NAMESPACES_XML % str_to_bytes(tag))\n        return root[0]\n\n    @staticmethod\n    def _generic_attrib_getter(attr_name: str, family: str | None = None) -&gt; Callable:\n        name = _get_lxml_tag(attr_name)\n\n        def getter(self: Element) -&gt; str | bool | None:\n            try:\n                if family and self.family != family:  # type: ignore\n                    return None\n            except AttributeError:\n                return None\n            value = self.__element.get(name)\n            if value is None:\n                return None\n            elif value in (\"true\", \"false\"):\n                return Boolean.decode(value)\n            return str(value)\n\n        return getter\n\n    @staticmethod\n    def _generic_attrib_setter(attr_name: str, family: str | None = None) -&gt; Callable:\n        name = _get_lxml_tag(attr_name)\n\n        def setter(self: Element, value: Any) -&gt; None:\n            try:\n                if family and self.family != family:  # type: ignore\n                    return None\n            except AttributeError:\n                return None\n            if value is None:\n                with contextlib.suppress(KeyError):\n                    del self.__element.attrib[name]\n                return\n            if isinstance(value, bool):\n                value = Boolean.encode(value)\n            self.__element.set(name, str(value))\n\n        return setter\n\n    @classmethod\n    def _define_attribut_property(cls: type[Element]) -&gt; None:\n        for prop in cls._properties:\n            setattr(\n                cls,\n                prop.name,\n                property(\n                    cls._generic_attrib_getter(prop.attr, prop.family or None),\n                    cls._generic_attrib_setter(prop.attr, prop.family or None),\n                    None,\n                    f\"Get/set the attribute {prop.attr}\",\n                ),\n            )\n\n    @staticmethod\n    def _make_before_regex(\n        before: str | None,\n        after: str | None,\n    ) -&gt; re.Pattern:\n        # 1) before xor after is not None\n        if before is not None:\n            return re.compile(before)\n        else:\n            if after is None:\n                raise ValueError(\"Both 'before' and 'after' are None\")\n            return re.compile(after)\n\n    @staticmethod\n    def _search_negative_position(\n        xpath_result: list,\n        regex: re.Pattern,\n    ) -&gt; tuple[str, re.Match]:\n        # Found the last text that matches the regex\n        text = None\n        for a_text in xpath_result:\n            if regex.search(str(a_text)) is not None:\n                text = a_text\n        if text is None:\n            raise ValueError(f\"Text not found: '{xpath_result}'\")\n        if not isinstance(text, str):\n            raise TypeError(f\"Text not found or text not of type str: '{text}'\")\n        return text, list(regex.finditer(text))[-1]\n\n    @staticmethod\n    def _search_positive_position(\n        xpath_result: list,\n        regex: re.Pattern,\n        position: int,\n    ) -&gt; tuple[str, re.Match]:\n        # Found the last text that matches the regex\n        count = 0\n        for text in xpath_result:\n            found_nb = len(regex.findall(str(text)))\n            if found_nb + count &gt;= position + 1:\n                break\n            count += found_nb\n        else:\n            raise ValueError(f\"Text not found: '{xpath_result}'\")\n        if not isinstance(text, str):\n            raise TypeError(f\"Text not found or text not of type str: '{text}'\")\n        return text, list(regex.finditer(text))[position - count]\n\n    def _insert_before_after(\n        self,\n        current: _Element,\n        element: _Element,\n        before: str | None,\n        after: str | None,\n        position: int,\n        xpath_text: XPath,\n    ) -&gt; tuple[int, str]:\n        regex = self._make_before_regex(before, after)\n        xpath_result = xpath_text(current)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n        # position = -1\n        if position &lt; 0:\n            text, sre = self._search_negative_position(xpath_result, regex)\n        # position &gt;= 0\n        else:\n            text, sre = self._search_positive_position(xpath_result, regex, position)\n        # Compute pos\n        if before is None:\n            pos = sre.end()\n        else:\n            pos = sre.start()\n        return pos, text\n\n    def _insert_find_text(\n        self,\n        current: _Element,\n        element: _Element,\n        before: str | None,\n        after: str | None,\n        position: int,\n        xpath_text: XPath,\n    ) -&gt; tuple[int, str]:\n        # Find the text\n        xpath_result = xpath_text(current)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n        count = 0\n        for text in xpath_result:\n            if not isinstance(text, str):\n                continue\n            found_nb = len(text)\n            if found_nb + count &gt;= position:\n                break\n            count += found_nb\n        else:\n            raise ValueError(\"Text not found\")\n        # We insert before the character\n        pos = position - count\n        return pos, text\n\n    def _insert(\n        self,\n        element: Element,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n        main_text: bool = False,\n    ) -&gt; None:\n        \"\"\"Insert an element before or after the characters in the text which\n        match the regex before/after.\n\n        When the regex matches more of one part of the text, position can be\n        set to choice which part must be used. If before and after are None,\n        we use only position that is the number of characters. If position is\n        positive and before=after=None, we insert before the position\n        character. But if position=-1, we insert after the last character.\n\n\n        Arguments:\n\n        element -- Element\n\n        before -- str regex\n\n        after -- str regex\n\n        position -- int\n        \"\"\"\n        # not implemented: if main_text is True, filter out the annotations texts in computation.\n        current = self.__element\n        xelement = element.__element\n\n        if main_text:\n            xpath_text = _xpath_text_main_descendant\n        else:\n            xpath_text = _xpath_text_descendant\n\n        # 1) before xor after is not None\n        if (before is not None) ^ (after is not None):\n            pos, text = self._insert_before_after(\n                current,\n                xelement,\n                before,\n                after,\n                position,\n                xpath_text,\n            )\n        # 2) before=after=None =&gt; only with position\n        elif before is None and after is None:\n            # Hack if position is negative =&gt; quickly\n            if position &lt; 0:\n                current.append(xelement)\n                return\n            pos, text = self._insert_find_text(\n                current,\n                xelement,\n                before,\n                after,\n                position,\n                xpath_text,\n            )\n        else:\n            raise ValueError(\"bad combination of arguments\")\n\n        # Compute new texts\n        text_before = text[:pos] if text[:pos] else None\n        text_after = text[pos:] if text[pos:] else None\n\n        # Insert!\n        parent = text.getparent()  # type: ignore\n        if text.is_text:  # type: ignore\n            parent.text = text_before\n            element.tail = text_after\n            parent.insert(0, xelement)\n        else:\n            parent.addnext(xelement)\n            parent.tail = text_before\n            element.tail = text_after\n\n    def _insert_between(  # noqa: C901\n        self,\n        element: Element,\n        from_: str,\n        to: str,\n    ) -&gt; None:\n        \"\"\"Insert the given empty element to wrap the text beginning with\n        \"from_\" and ending with \"to\".\n\n        Example 1: '&lt;p&gt;toto tata titi&lt;/p&gt;\n\n        We want to insert a link around \"tata\".\n\n        Result 1: '&lt;p&gt;toto &lt;a&gt;tata&lt;/a&gt; titi&lt;/p&gt;\n\n        Example 2: '&lt;p&gt;&lt;span&gt;toto&lt;/span&gt; tata titi&lt;/p&gt;\n\n        We want to insert a link around \"tata\".\n\n        Result 2: '&lt;p&gt;&lt;span&gt;toto&lt;/span&gt; &lt;a&gt;tata&lt;/a&gt; titi&lt;/p&gt;\n\n        Example 3: '&lt;p&gt;toto &lt;span&gt; tata &lt;/span&gt; titi&lt;/p&gt;'\n\n        We want to insert a link from \"tata\" to \"titi\" included.\n\n        Result 3: '&lt;p&gt;toto &lt;span&gt; &lt;/span&gt;'\n                  '&lt;a&gt;&lt;span&gt;tata &lt;/span&gt; titi&lt;/a&gt;&lt;/p&gt;'\n\n        Example 4: '&lt;p&gt;toto &lt;span&gt;tata titi&lt;/span&gt; tutu&lt;/p&gt;'\n\n        We want to insert a link from \"titi\" to \"tutu\"\n\n        Result 4: '&lt;p&gt;toto &lt;span&gt;tata &lt;/span&gt;&lt;a&gt;&lt;span&gt;titi&lt;/span&gt;&lt;/a&gt;'\n                  '&lt;a&gt; tutu&lt;/a&gt;&lt;/p&gt;'\n\n        Example 5: '&lt;p&gt;toto &lt;span&gt;tata titi&lt;/span&gt; '\n                   '&lt;span&gt;tutu tyty&lt;/span&gt;&lt;/p&gt;'\n\n        We want to insert a link from \"titi\" to \"tutu\"\n\n        Result 5: '&lt;p&gt;toto &lt;span&gt;tata &lt;/span&gt;&lt;a&gt;&lt;span&gt;titi&lt;/span&gt;&lt;a&gt; '\n                  '&lt;a&gt; &lt;span&gt;tutu&lt;/span&gt;&lt;/a&gt;&lt;span&gt; tyty&lt;/span&gt;&lt;/p&gt;'\n        \"\"\"\n        current = self.__element\n        wrapper = element.__element\n\n        xpath_result = _xpath_text_descendant(current)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n\n        for text in xpath_result:\n            if not isinstance(text, str):\n                raise TypeError(\"Text not found or text not of type str\")\n            if from_ not in text:\n                continue\n            from_index = text.index(from_)\n            text_before = text[:from_index]\n            text_after = text[from_index:]\n            from_container = text.getparent()  # type: ignore\n            if not isinstance(from_container, _Element):\n                raise TypeError(\"Bad XPath result\")\n            # Include from_index to match a single word\n            to_index = text.find(to, from_index)\n            if to_index &gt;= 0:\n                # Simple case: \"from\" and \"to\" in the same element\n                to_end = to_index + len(to)\n                if text.is_text:  # type: ignore\n                    from_container.text = text_before\n                    wrapper.text = text[to_index:to_end]\n                    wrapper.tail = text[to_end:]\n                    from_container.insert(0, wrapper)\n                else:\n                    from_container.tail = text_before\n                    wrapper.text = text[to_index:to_end]\n                    wrapper.tail = text[to_end:]\n                    parent = from_container.getparent()\n                    index = parent.index(from_container)  # type: ignore\n                    parent.insert(index + 1, wrapper)  # type: ignore\n                return\n            else:\n                # Exit to the second part where we search for the end text\n                break\n        else:\n            raise ValueError(\"Start text not found\")\n\n        # The container is split in two\n        container2 = deepcopy(from_container)\n        if text.is_text:  # type: ignore\n            from_container.text = text_before\n            from_container.tail = None\n            container2.text = text_after\n            from_container.tail = None\n        else:\n            from_container.tail = text_before\n            container2.tail = text_after\n        # Stack the copy into the surrounding element\n        wrapper.append(container2)\n        parent = from_container.getparent()\n        index = parent.index(from_container)  # type: ignore\n        parent.insert(index + 1, wrapper)  # type: ignore\n\n        xpath_result = _xpath_text_descendant(wrapper)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n\n        for text in xpath_result:\n            if not isinstance(text, str):\n                raise TypeError(\"Text not found or text not of type str\")\n            if to not in text:\n                continue\n            to_end = text.index(to) + len(to)\n            text_before = text[:to_end]\n            text_after = text[to_end:]\n            container_to = text.getparent()  # type: ignore\n            if not isinstance(container_to, _Element):\n                raise TypeError(\"Bad XPath result\")\n            if text.is_text:  # type: ignore\n                container_to.text = text_before\n                container_to.tail = text_after\n            else:\n                container_to.tail = text_before\n                next_one = container_to.getnext()\n                if next_one is None:\n                    next_one = container_to.getparent()\n                next_one.tail = text_after  # type: ignore\n            return\n        raise ValueError(\"End text not found\")\n\n    @property\n    def tag(self) -&gt; str:\n        \"\"\"Get/set the underlying xml tag with the given qualified name.\n\n        Warning: direct change of tag does not change the element class.\n\n        Arguments:\n\n            qname -- str (e.g. \"text:span\")\n        \"\"\"\n        return _get_prefixed_name(self.__element.tag)\n\n    @tag.setter\n    def tag(self, qname: str) -&gt; None:\n        self.__element.tag = _get_lxml_tag(qname)\n\n    def elements_repeated_sequence(\n        self,\n        xpath_instance: XPath,\n        name: str,\n    ) -&gt; list[tuple[int, int]]:\n        \"\"\"Utility method for table module.\"\"\"\n        lxml_tag = _get_lxml_tag_or_name(name)\n        element = self.__element\n        sub_elements = xpath_instance(element)\n        if not isinstance(sub_elements, list):\n            raise TypeError(\"Bad XPath result.\")\n        result: list[tuple[int, int]] = []\n        idx = -1\n        for sub_element in sub_elements:\n            if not isinstance(sub_element, _Element):\n                continue\n            idx += 1\n            value = sub_element.get(lxml_tag)\n            if value is None:\n                result.append((idx, 1))\n                continue\n            try:\n                int_value = int(value)\n            except ValueError:\n                int_value = 1\n            result.append((idx, max(int_value, 1)))\n        return result\n\n    def get_elements(self, xpath_query: XPath | str) -&gt; list[Element]:\n        cache: tuple | None = None\n        element = self.__element\n        if isinstance(xpath_query, str):\n            new_xpath_query = xpath_compile(xpath_query)\n            result = new_xpath_query(element)\n        else:\n            result = xpath_query(element)\n        if not isinstance(result, list):\n            raise TypeError(\"Bad XPath result\")\n\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                cache = (self._tmap, self._cmap, self._rmap)\n            else:\n                cache = (self._tmap, self._cmap)\n        return [\n            Element.from_tag_for_clone(e, cache)\n            for e in result\n            if isinstance(e, _Element)\n        ]\n\n    # fixme : need original get_element as wrapper of get_elements\n\n    def get_element(self, xpath_query: XPath | str) -&gt; Element | None:\n        element = self.__element\n        result = element.xpath(f\"({xpath_query})[1]\", namespaces=ODF_NAMESPACES)\n        if result:\n            return Element.from_tag(result[0])  # type:ignore\n        return None\n\n    def _get_element_idx(self, xpath_query: XPath | str, idx: int) -&gt; Element | None:\n        element = self.__element\n        result = element.xpath(f\"({xpath_query})[{idx + 1}]\", namespaces=ODF_NAMESPACES)\n        if result:\n            return Element.from_tag(result[0])  # type:ignore\n        return None\n\n    def _get_element_idx2(self, xpath_instance: XPath, idx: int) -&gt; Element | None:\n        element = self.__element\n        result = xpath_instance(element, idx=idx + 1)\n        if result:\n            return Element.from_tag(result[0])  # type:ignore\n        return None\n\n    @property\n    def attributes(self) -&gt; dict[str, str]:\n        return {\n            _get_prefixed_name(str(key)): str(value)\n            for key, value in self.__element.attrib.items()\n        }\n\n    def get_attribute(self, name: str) -&gt; str | bool | None:\n        \"\"\"Return the attribute value as type str | bool | None.\"\"\"\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        value = element.get(lxml_tag)\n        if value is None:\n            return None\n        elif value in (\"true\", \"false\"):\n            return Boolean.decode(value)\n        return str(value)\n\n    def get_attribute_integer(self, name: str) -&gt; int | None:\n        \"\"\"Return either the attribute as type int, or None.\"\"\"\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        value = element.get(lxml_tag)\n        if value is None:\n            return None\n        try:\n            return int(value)\n        except ValueError:\n            return None\n\n    def get_attribute_string(self, name: str) -&gt; str | None:\n        \"\"\"Return either the attribute as type str, or None.\"\"\"\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        value = element.get(lxml_tag)\n        if value is None:\n            return None\n        return str(value)\n\n    def set_attribute(\n        self, name: str, value: bool | str | tuple[int, int, int] | None\n    ) -&gt; None:\n        if name in ODF_COLOR_PROPERTY:\n            if isinstance(value, bool):\n                raise TypeError(f\"Wrong color type {value!r}\")\n            if value != \"transparent\":\n                value = hexa_color(value)\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        if isinstance(value, bool):\n            value = Boolean.encode(value)\n        elif value is None:\n            with contextlib.suppress(KeyError):\n                del element.attrib[lxml_tag]\n            return\n        element.set(lxml_tag, str(value))\n\n    def set_style_attribute(self, name: str, value: Element | str) -&gt; None:\n        \"\"\"Shortcut to accept a style object as a value.\"\"\"\n        if isinstance(value, Element):\n            value = str(value.name)  # type:ignore\n        return self.set_attribute(name, value)\n\n    def del_attribute(self, name: str) -&gt; None:\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        del element.attrib[lxml_tag]\n\n    @property\n    def text(self) -&gt; str:\n        \"\"\"Get / set the text content of the element.\"\"\"\n        return self.__element.text or \"\"\n\n    @text.setter\n    def text(self, text: str | None) -&gt; None:\n        if text is None:\n            text = \"\"\n        try:\n            self.__element.text = text\n        except TypeError as e:\n            raise TypeError(f'Str type expected: \"{type(text)}\"') from e\n\n    @property\n    def text_recursive(self) -&gt; str:\n        return \"\".join(str(x) for x in self.__element.itertext())\n\n    @property\n    def tail(self) -&gt; str | None:\n        \"\"\"Get / set the text immediately following the element.\"\"\"\n        return self.__element.tail\n\n    @tail.setter\n    def tail(self, text: str | None) -&gt; None:\n        self.__element.tail = text or \"\"\n\n    def search(self, pattern: str) -&gt; int | None:\n        \"\"\"Return the first position of the pattern in the text content of\n        the element, or None if not found.\n\n        Python regular expression syntax applies.\n\n        Arguments:\n\n            pattern -- str\n\n        Return: int or None\n        \"\"\"\n        match = re.search(pattern, self.text_recursive)\n        if match is None:\n            return None\n        return match.start()\n\n    def match(self, pattern: str) -&gt; bool:\n        \"\"\"return True if the pattern is found one or more times anywhere in\n        the text content of the element.\n\n        Python regular expression syntax applies.\n\n        Arguments:\n\n            pattern -- str\n\n        Return: bool\n        \"\"\"\n        return self.search(pattern) is not None\n\n    def replace(self, pattern: str, new: str | None = None) -&gt; int:\n        \"\"\"Replace the pattern with the given text, or delete if text is an\n        empty string, and return the number of replacements. By default, only\n        return the number of occurences that would be replaced.\n\n        It cannot replace patterns found across several element, like a word\n        split into two consecutive spans.\n\n        Python regular expression syntax applies.\n\n        Arguments:\n\n            pattern -- str\n\n            new -- str\n\n        Return: int\n        \"\"\"\n        if not isinstance(pattern, str):\n            # Fail properly if the pattern is an non-ascii bytestring\n            pattern = str(pattern)\n        cpattern = re.compile(pattern)\n        count = 0\n        for text in self.xpath(\"descendant::text()\"):\n            if new is None:\n                count += len(cpattern.findall(str(text)))\n            else:\n                new_text, number = cpattern.subn(new, str(text))\n                container = text.parent\n                if text.is_text():  # type: ignore\n                    container.text = new_text  # type: ignore\n                else:\n                    container.tail = new_text  # type: ignore\n                count += number\n        return count\n\n    @property\n    def root(self) -&gt; Element:\n        element = self.__element\n        tree = element.getroottree()\n        root = tree.getroot()\n        return Element.from_tag(root)\n\n    @property\n    def parent(self) -&gt; Element | None:\n        element = self.__element\n        parent = element.getparent()\n        if parent is None:\n            # Already at root\n            return None\n        return Element.from_tag(parent)\n\n    @property\n    def is_bound(self) -&gt; bool:\n        return self.parent is not None\n\n    # def get_next_sibling(self):\n    #     element = self.__element\n    #     next_one = element.getnext()\n    #     if next_one is None:\n    #         return None\n    #     return Element.from_tag(next_one)\n    #\n    # def get_prev_sibling(self):\n    #     element = self.__element\n    #     prev = element.getprevious()\n    #     if prev is None:\n    #         return None\n    #     return Element.from_tag(prev)\n\n    @property\n    def children(self) -&gt; list[Element]:\n        element = self.__element\n        return [\n            Element.from_tag(e)\n            for e in element.iterchildren()\n            if isinstance(e, _Element)\n        ]\n\n    def index(self, child: Element) -&gt; int:\n        \"\"\"Return the position of the child in this element.\n\n        Inspired by lxml\n        \"\"\"\n        return self.__element.index(child.__element)\n\n    @property\n    def text_content(self) -&gt; str:\n        \"\"\"Get / set the text of the embedded paragraph, including embeded\n        annotations, cells...\n\n        Set create a paragraph if missing\n        \"\"\"\n        return \"\\n\".join(\n            child.text_recursive for child in self.get_elements(\"descendant::text:p\")\n        )\n\n    @text_content.setter\n    def text_content(self, text: str | None) -&gt; None:\n        paragraphs = self.get_elements(\"text:p\")\n        if not paragraphs:\n            # E.g., text:p in draw:text-box in draw:frame\n            paragraphs = self.get_elements(\"*/text:p\")\n        if paragraphs:\n            paragraph = paragraphs.pop(0)\n            for obsolete in paragraphs:\n                obsolete.delete()\n        else:\n            paragraph = Element.from_tag(\"text:p\")\n            self.insert(paragraph, FIRST_CHILD)\n        # As \"text_content\" returned all text nodes, \"text_content\"\n        # will overwrite all text nodes and children that may contain them\n        element = paragraph.__element\n        # Clear but the attributes\n        del element[:]\n        element.text = text\n\n    def _erase_text_content(self) -&gt; None:\n        paragraphs = self.get_elements(\"text:p\")\n        if not paragraphs:\n            # E.g., text:p in draw:text-box in draw:frame\n            paragraphs = self.get_elements(\"*/text:p\")\n        if paragraphs:\n            paragraphs.pop(0)\n            for obsolete in paragraphs:\n                obsolete.delete()\n\n    def is_empty(self) -&gt; bool:\n        \"\"\"Check if the element is empty : no text, no children, no tail.\n\n        Return: Boolean\n        \"\"\"\n        element = self.__element\n        if element.tail is not None:\n            return False\n        if element.text is not None:\n            return False\n        if list(element.iterchildren()):\n            return False\n        return True\n\n    def _get_successor(self, target: Element) -&gt; tuple[Element | None, Element | None]:\n        element = self.__element\n        next_one = element.getnext()\n        if next_one is not None:\n            return Element.from_tag(next_one), target\n        parent = self.parent\n        if parent is None:\n            return None, None\n        return parent._get_successor(target.parent)  # type:ignore\n\n    def _get_between_base(  # noqa:C901\n        self,\n        tag1: Element,\n        tag2: Element,\n    ) -&gt; list[Element]:\n        def find_any_id(elem: Element) -&gt; tuple[str, str, str]:\n            elem_tag = elem.tag\n            for attribute in (\n                \"text:id\",\n                \"text:change-id\",\n                \"text:name\",\n                \"office:name\",\n                \"text:ref-name\",\n                \"xml:id\",\n            ):\n                idx = elem.get_attribute(attribute)\n                if idx is not None:\n                    return elem_tag, attribute, str(idx)\n            raise ValueError(f\"No Id found in {elem.serialize()}\")\n\n        def common_ancestor(\n            tag1: str,\n            attr1: str,\n            val1: str,\n            tag2: str,\n            attr2: str,\n            val2: str,\n        ) -&gt; Element | None:\n            root = self.root\n            request1 = f'descendant::{tag1}[@{attr1}=\"{val1}\"]'\n            request2 = f'descendant::{tag2}[@{attr2}=\"{val2}\"]'\n            ancestor = root.xpath(request1)[0]\n            if ancestor is None:\n                return None\n            while True:\n                # print \"up\",\n                new_ancestor = ancestor.parent\n                if new_ancestor is None:\n                    return None\n                has_tag2 = new_ancestor.xpath(request2)\n                ancestor = new_ancestor\n                if not has_tag2:\n                    continue\n                # print 'found'\n                break\n            # print up.serialize()\n            return ancestor\n\n        elem1_tag, elem1_attr, elem1_val = find_any_id(tag1)\n        elem2_tag, elem2_attr, elem2_val = find_any_id(tag2)\n        ancestor_result = common_ancestor(\n            elem1_tag,\n            elem1_attr,\n            elem1_val,\n            elem2_tag,\n            elem2_attr,\n            elem2_val,\n        )\n        if ancestor_result is None:\n            raise RuntimeError(f\"No common ancestor for {elem1_tag} {elem2_tag}\")\n        ancestor = ancestor_result.clone\n        path1 = f'{elem1_tag}[@{elem1_attr}=\"{elem1_val}\"]'\n        path2 = f'{elem2_tag}[@{elem2_attr}=\"{elem2_val}\"]'\n        result = ancestor.clone\n        for child in result.children:\n            result.delete(child)\n        result.text = \"\"\n        result.tail = \"\"\n        target = result\n        current = ancestor.children[0]\n\n        state = 0\n        while True:\n            if current is None:\n                raise RuntimeError(f\"No current ancestor for {elem1_tag} {elem2_tag}\")\n            # print 'current', state, current.serialize()\n            if state == 0:  # before tag 1\n                if current.xpath(f\"descendant-or-self::{path1}\"):\n                    if current.xpath(f\"self::{path1}\"):\n                        tail = current.tail\n                        if tail:\n                            # got a tail =&gt; the parent should be either t:p or t:h\n                            target.text = tail  # type: ignore\n                        current, target = current._get_successor(target)  # type: ignore\n                        state = 1\n                        continue\n                    # got T1 in chidren, need further analysis\n                    new_target = current.clone\n                    for child in new_target.children:\n                        new_target.delete(child)\n                    new_target.text = \"\"\n                    new_target.tail = \"\"\n                    target.append(new_target)  # type: ignore\n                    target = new_target\n                    current = current.children[0]\n                    continue\n                else:\n                    # before tag1 : forget element, go to next one\n                    current, target = current._get_successor(target)  # type: ignore\n                    continue\n            elif state == 1:  # collect elements\n                further = False\n                if current.xpath(f\"descendant-or-self::{path2}\"):\n                    if current.xpath(f\"self::{path2}\"):\n                        # end of trip\n                        break\n                    # got T2 in chidren, need further analysis\n                    further = True\n                # further analysis needed :\n                if further:\n                    new_target = current.clone\n                    for child in new_target.children:\n                        new_target.delete(child)\n                    new_target.text = \"\"\n                    new_target.tail = \"\"\n                    target.append(new_target)  # type: ignore\n                    target = new_target\n                    current = current.children[0]\n                    continue\n                # collect\n                target.append(current.clone)  # type: ignore\n                current, target = current._get_successor(target)  # type: ignore\n                continue\n        # Now resu should be the \"parent\" of inserted parts\n        # - a text:h or text:p sigle item (simple case)\n        # - a upper element, with some text:p, text:h in it =&gt; need to be\n        #   stripped to have a list of text:p, text:h\n        if result.tag in {\"text:p\", \"text:h\"}:\n            inner = [result]\n        else:\n            inner = result.children\n        return inner\n\n    def get_between(\n        self,\n        tag1: Element,\n        tag2: Element,\n        as_text: bool = False,\n        clean: bool = True,\n        no_header: bool = True,\n    ) -&gt; list | Element | str:\n        \"\"\"Returns elements between tag1 and tag2, tag1 and tag2 shall\n        be unique and having an id attribute.\n        (WARN: buggy if tag1/tag2 defines a malformed odf xml.)\n        If as_text is True: returns the text content.\n        If clean is True: suppress unwanted tags (deletions marks, ...)\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of Element, cleaned and without headers.\n\n        Implementation and standard retrictions:\n        Only text:h and text:p sould be 'cut' by an insert tag, so inner parts\n        of insert tags are:\n\n            - any text:h, text:p or sub tag of these\n\n            - some text, part of a parent text:h or text:p\n\n        Arguments:\n\n            tag1 -- Element\n\n            tag2 -- Element\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list of odf_paragraph or odf_header\n        \"\"\"\n        inner = self._get_between_base(tag1, tag2)\n\n        if clean:\n            clean_tags = (\n                \"text:change\",\n                \"text:change-start\",\n                \"text:change-end\",\n                \"text:reference-mark\",\n                \"text:reference-mark-start\",\n                \"text:reference-mark-end\",\n            )\n            request_self = \" | \".join([f\"self::{tag}\" for tag in clean_tags])\n            inner = [e for e in inner if not e.xpath(request_self)]\n            request = \" | \".join([f\"descendant::{tag}\" for tag in clean_tags])\n            for element in inner:\n                to_del = element.xpath(request)\n                for elem in to_del:\n                    if isinstance(elem, Element):\n                        element.delete(elem)\n        if no_header:  # crude replace t:h by t:p\n            new_inner = []\n            for element in inner:\n                if element.tag == \"text:h\":\n                    children = element.children\n                    text = element.__element.text\n                    para = Element.from_tag(\"text:p\")\n                    para.text = text or \"\"\n                    for c in children:\n                        para.append(c)\n                    new_inner.append(para)\n                else:\n                    new_inner.append(element)\n            inner = new_inner\n        if as_text:\n            return \"\\n\".join([e.get_formatted_text() for e in inner])\n        else:\n            return inner\n\n    def insert(\n        self,\n        element: Element,\n        xmlposition: int | None = None,\n        position: int | None = None,\n        start: bool = False,\n    ) -&gt; None:\n        \"\"\"Insert an element relatively to ourself.\n\n        Insert either using DOM vocabulary or by numeric position.\n        If text start is True, insert the element before any existing text.\n\n        Position start at 0.\n\n        Arguments:\n\n            element -- Element\n\n            xmlposition -- FIRST_CHILD, LAST_CHILD, NEXT_SIBLING\n                           or PREV_SIBLING\n\n            start -- Boolean\n\n            position -- int\n        \"\"\"\n        # child_tag = element.tag\n        current = self.__element\n        _element = element.__element\n        if start:\n            text = current.text\n            if text is not None:\n                current.text = None\n                tail = _element.tail\n                if tail is None:\n                    tail = text\n                else:\n                    tail = tail + text\n                _element.tail = tail\n            position = 0\n        if position is not None:\n            current.insert(position, _element)\n        elif xmlposition is FIRST_CHILD:\n            current.insert(0, _element)\n        elif xmlposition is LAST_CHILD:\n            current.append(_element)\n        elif xmlposition is NEXT_SIBLING:\n            parent = current.getparent()\n            index = parent.index(current)  # type: ignore\n            parent.insert(index + 1, _element)  # type: ignore\n        elif xmlposition is PREV_SIBLING:\n            parent = current.getparent()\n            index = parent.index(current)  # type: ignore\n            parent.insert(index, _element)  # type: ignore\n        else:\n            raise ValueError(\"(xml)position must be defined\")\n\n    def extend(self, odf_elements: Iterable[Element]) -&gt; None:\n        \"\"\"Fast append elements at the end of ourself using extend.\"\"\"\n        if odf_elements:\n            current = self.__element\n            elements = [element.__element for element in odf_elements]\n            current.extend(elements)\n\n    def append(self, str_or_element: str | Element) -&gt; None:\n        \"\"\"Insert element or text in the last position.\"\"\"\n        current = self.__element\n        if isinstance(str_or_element, str):\n            # Has children ?\n            children = list(current.iterchildren())\n            if children:\n                # Append to tail of the last child\n                last_child = children[-1]\n                text = last_child.tail\n                text = text if text is not None else \"\"\n                text += str_or_element\n                last_child.tail = text\n            else:\n                # Append to text of the element\n                text = current.text\n                text = text if text is not None else \"\"\n                text += str_or_element\n                current.text = text\n        elif isinstance(str_or_element, Element):\n            current.append(str_or_element.__element)\n        else:\n            raise TypeError(f'Element or string expected, not \"{type(str_or_element)}\"')\n\n    def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        if keep_tail is True (default), the tail text is not erased.\n\n        Arguments:\n\n            child -- Element\n\n            keep_tail -- boolean (default to True), True for most usages.\n        \"\"\"\n        if child is None:\n            parent = self.parent\n            if parent is None:\n                raise ValueError(f\"Can't delete the root element\\n{self.serialize()}\")\n            child = self\n        else:\n            parent = self\n        if keep_tail and child.__element.tail is not None:\n            current = child.__element\n            tail = str(current.tail)\n            current.tail = None\n            prev = current.getprevious()\n            if prev is not None:\n                if prev.tail is None:\n                    prev.tail = tail\n                else:\n                    prev.tail += tail\n            else:\n                if parent.__element.text is None:\n                    parent.__element.text = tail\n                else:\n                    parent.__element.text += tail\n        parent.__element.remove(child.__element)\n\n    def replace_element(self, old_element: Element, new_element: Element) -&gt; None:\n        \"\"\"Replaces in place a sub element with the element passed as second\n        argument.\n\n        Warning : no clone for old element.\n        \"\"\"\n        current = self.__element\n        current.replace(old_element.__element, new_element.__element)\n\n    def strip_elements(\n        self,\n        sub_elements: Element | Iterable[Element],\n    ) -&gt; Element | list:\n        \"\"\"Remove the tags of provided elements, keeping inner childs and text.\n\n        Return : the striped element.\n\n        Warning : no clone in sub_elements list.\n\n        Arguments:\n\n            sub_elements -- Element or list of Element\n        \"\"\"\n        if not sub_elements:\n            return self\n        if isinstance(sub_elements, Element):\n            sub_elements = (sub_elements,)\n        replacer = _get_lxml_tag(\"text:this-will-be-removed\")\n        for element in sub_elements:\n            element.__element.tag = replacer\n        strip = (\"text:this-will-be-removed\",)\n        return self.strip_tags(strip=strip, default=None)\n\n    def strip_tags(\n        self,\n        strip: Iterable[str] | None = None,\n        protect: Iterable[str] | None = None,\n        default: str | None = \"text:p\",\n    ) -&gt; Element | list:\n        \"\"\"Remove the tags listed in strip, recursively, keeping inner childs\n        and text. Tags listed in protect stop the removal one level depth. If\n        the first level element is stripped, default is used to embed the\n        content in the default element. If default is None and first level is\n        striped, a list of text and children is returned. Return : the striped\n        element.\n\n        strip_tags should be used by on purpose methods (strip_span ...)\n        (Method name taken from lxml).\n\n        Arguments:\n\n            strip -- iterable list of str odf tags, or None\n\n            protect -- iterable list of str odf tags, or None\n\n            default -- str odf tag, or None\n\n        Return:\n\n            Element.\n        \"\"\"\n        if not strip:\n            return self\n        if not protect:\n            protect = ()\n        protected = False\n        element, modified = Element._strip_tags(self, strip, protect, protected)\n        if modified and isinstance(element, list) and default:\n            new = Element.from_tag(default)\n            for content in element:\n                if isinstance(content, Element):\n                    new.append(content)\n                else:\n                    new.text = content\n            element = new\n        return element\n\n    @staticmethod\n    def _strip_tags(  # noqa:C901\n        element: Element,\n        strip: Iterable[str],\n        protect: Iterable[str],\n        protected: bool,\n    ) -&gt; tuple[Element | list, bool]:\n        \"\"\"Sub method for strip_tags().\"\"\"\n        element_clone = element.clone\n        modified = False\n        children = []\n        if protect and element.tag in protect:\n            protect_below = True\n        else:\n            protect_below = False\n        for child in element_clone.children:\n            striped_child, is_modified = Element._strip_tags(\n                child, strip, protect, protect_below\n            )\n            if is_modified:\n                modified = True\n            if isinstance(striped_child, list):\n                children.extend(striped_child)\n            else:\n                children.append(striped_child)\n\n        text = element_clone.text\n        tail = element_clone.tail\n        if not protected and strip and element.tag in strip:\n            element_result: list[Element | str] = []\n            if text is not None:\n                element_result.append(text)\n            for child in children:\n                element_result.append(child)\n            if tail is not None:\n                element_result.append(tail)\n            return (element_result, True)\n        else:\n            if not modified:\n                return (element, False)\n            element.clear()\n            try:\n                for key, value in element_clone.attributes.items():\n                    element.set_attribute(key, value)\n            except ValueError:\n                sys.stderr.write(f\"strip_tags(): bad attribute in {element_clone}\\n\")\n            if text is not None:\n                element.append(text)\n            for child in children:\n                element.append(child)\n            if tail is not None:\n                element.tail = tail\n            return (element, True)\n\n    def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n        \"\"\"Apply XPath query to the element and its subtree. Return list of\n        Element or EText instances translated from the nodes found.\n        \"\"\"\n        element = self.__element\n        xpath_instance = xpath_compile(xpath_query)\n        elements = xpath_instance(element)\n        result: list[Element | EText] = []\n        if hasattr(elements, \"__iter__\"):\n            for obj in elements:  # type: ignore\n                if isinstance(obj, (str, bytes)):\n                    result.append(EText(obj))\n                elif isinstance(obj, _Element):\n                    result.append(Element.from_tag(obj))\n                # else:\n                #     result.append(obj)\n        return result\n\n    def clear(self) -&gt; None:\n        \"\"\"Remove text, children and attributes from the element.\"\"\"\n        self.__element.clear()\n        if hasattr(self, \"_tmap\"):\n            self._tmap: list[int] = []\n        if hasattr(self, \"_cmap\"):\n            self._cmap: list[int] = []\n        if hasattr(self, \"_rmap\"):\n            self._rmap: list[int] = []\n        if hasattr(self, \"_indexes\"):\n            remember = False\n            if \"_rmap\" in self._indexes:\n                remember = True\n            self._indexes: dict[str, dict] = {}\n            self._indexes[\"_cmap\"] = {}\n            self._indexes[\"_tmap\"] = {}\n            if remember:\n                self._indexes[\"_rmap\"] = {}\n\n    @property\n    def clone(self) -&gt; Element:\n        clone = deepcopy(self.__element)\n        root = lxml_Element(\"ROOT\", nsmap=ODF_NAMESPACES)\n        root.append(clone)\n        return self.from_tag(clone)\n\n        # slow data = tostring(self.__element, encoding='unicode')\n        # return self.from_tag(data)\n\n    @staticmethod\n    def _strip_namespaces(data: str) -&gt; str:\n        \"\"\"Remove xmlns:* fields from serialized XML.\"\"\"\n        return re.sub(r' xmlns:\\w*=\"[\\w:\\-\\/\\.#]*\"', \"\", data)\n\n    def serialize(self, pretty: bool = False, with_ns: bool = False) -&gt; str:\n        \"\"\"Return text serialization of XML element.\"\"\"\n        # This copy bypasses serialization side-effects in lxml\n        native = deepcopy(self.__element)\n        data = tostring(\n            native, with_tail=False, pretty_print=pretty, encoding=\"unicode\"\n        )\n        if with_ns:\n            return data\n        # Remove namespaces\n        return self._strip_namespaces(data)\n\n    # Element helpers usable from any context\n\n    @property\n    def document_body(self) -&gt; Element | None:\n        \"\"\"Return the first children of document body if any: 'office:body/*[1]'\"\"\"\n        return self.get_element(\"//office:body/*[1]\")\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        \"\"\"This function should return a beautiful version of the text.\"\"\"\n        return \"\"\n\n    def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n        \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n        name (or all by default).\n\n        Arguments:\n\n            name -- str\n\n        Return: list\n        \"\"\"\n        # FIXME incomplete (and possibly inaccurate)\n        return (\n            self._filtered_elements(\"descendant::*\", text_style=name)\n            + self._filtered_elements(\"descendant::*\", draw_style=name)\n            + self._filtered_elements(\"descendant::*\", draw_text_style=name)\n            + self._filtered_elements(\"descendant::*\", table_style=name)\n            + self._filtered_elements(\"descendant::*\", page_layout=name)\n            + self._filtered_elements(\"descendant::*\", master_page=name)\n            + self._filtered_elements(\"descendant::*\", parent_style=name)\n        )\n\n    # Common attributes\n\n    def _get_inner_text(self, tag: str) -&gt; str | None:\n        element = self.get_element(tag)\n        if element is None:\n            return None\n        return element.text\n\n    def _set_inner_text(self, tag: str, text: str) -&gt; None:\n        element = self.get_element(tag)\n        if element is None:\n            element = Element.from_tag(tag)\n            self.append(element)\n        element.text = text\n\n    # SVG\n\n    @property\n    def svg_title(self) -&gt; str | None:\n        return self._get_inner_text(\"svg:title\")\n\n    @svg_title.setter\n    def svg_title(self, title: str) -&gt; None:\n        self._set_inner_text(\"svg:title\", title)\n\n    @property\n    def svg_description(self) -&gt; str | None:\n        return self._get_inner_text(\"svg:desc\")\n\n    @svg_description.setter\n    def svg_description(self, description: str) -&gt; None:\n        self._set_inner_text(\"svg:desc\", description)\n\n    # Sections\n\n    def get_sections(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the sections that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"text:section\", text_style=style, content=content\n        )\n\n    @property\n    def sections(\n        self,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the sections.\n\n        Return: list of Element\n        \"\"\"\n        return self.get_elements(\"text:section\")\n\n    def get_section(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the section that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:section\", position, content=content\n        )\n\n    # Paragraphs\n\n    def get_paragraphs(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the paragraphs that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Paragraph\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:p\", text_style=style, content=content\n        )\n\n    @property\n    def paragraphs(self) -&gt; list[Element]:\n        \"\"\"Return all the paragraphs.\n\n        Return: list of Paragraph\n        \"\"\"\n        return self.get_elements(\"descendant::text:p\")\n\n    def get_paragraph(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the paragraph that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Paragraph or None if not found\n        \"\"\"\n        return self._filtered_element(\"descendant::text:p\", position, content=content)\n\n    # Span\n\n    def get_spans(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the spans that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Span\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:span\", text_style=style, content=content\n        )\n\n    @property\n    def spans(self) -&gt; list[Element]:\n        \"\"\"Return all the spans.\n\n        Return: list of Span\n        \"\"\"\n        return self.get_elements(\"descendant::text:span\")\n\n    def get_span(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the span that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Span or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:span\", position, content=content\n        )\n\n    # Headers\n\n    def get_headers(\n        self,\n        style: str | None = None,\n        outline_level: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the Headers that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Header\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:h\",\n            text_style=style,\n            outline_level=outline_level,\n            content=content,\n        )\n\n    @property\n    def headers(self) -&gt; list[Element]:\n        \"\"\"Return all the Headers.\n\n        Return: list of Header\n        \"\"\"\n        return self.get_elements(\"descendant::text:h\")\n\n    def get_header(\n        self,\n        position: int = 0,\n        outline_level: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the Header that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Header or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:h\",\n            position,\n            outline_level=outline_level,\n            content=content,\n        )\n\n    # Lists\n\n    def get_lists(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the lists that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of List\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:list\", text_style=style, content=content\n        )\n\n    @property\n    def lists(self) -&gt; list[Element]:\n        \"\"\"Return all the lists.\n\n        Return: list of List\n        \"\"\"\n        return self.get_elements(\"descendant::text:list\")\n\n    def get_list(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the list that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: List or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:list\", position, content=content\n        )\n\n    # Frames\n\n    def get_frames(\n        self,\n        presentation_class: str | None = None,\n        style: str | None = None,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the frames that match the criteria.\n\n        Arguments:\n\n            presentation_class -- str\n\n            style -- str\n\n            title -- str regex\n\n            description -- str regex\n\n            content -- str regex\n\n        Return: list of Frame\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:frame\",\n            presentation_class=presentation_class,\n            draw_style=style,\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    @property\n    def frames(self) -&gt; list[Element]:\n        \"\"\"Return all the frames.\n\n        Return: list of Frame\n        \"\"\"\n        return self.get_elements(\"descendant::draw:frame\")\n\n    def get_frame(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        presentation_class: str | None = None,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the section that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            presentation_class -- str\n\n            title -- str regex\n\n            description -- str regex\n\n            content -- str regex\n\n        Return: Frame or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:frame\",\n            position,\n            draw_name=name,\n            presentation_class=presentation_class,\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    # Images\n\n    def get_images(\n        self,\n        style: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the images matching the criteria.\n\n        Arguments:\n\n            style -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:image\", text_style=style, url=url, content=content\n        )\n\n    @property\n    def images(self) -&gt; list[Element]:\n        \"\"\"Return all the images.\n\n        Return: list of Element\n        \"\"\"\n        return self.get_elements(\"descendant::draw:image\")\n\n    def get_image(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the image matching the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        # The frame is holding the name\n        if name is not None:\n            frame = self._filtered_element(\n                \"descendant::draw:frame\", position, draw_name=name\n            )\n            if frame is None:\n                return None\n            # The name is supposedly unique\n            return frame.get_element(\"draw:image\")\n        return self._filtered_element(\n            \"descendant::draw:image\", position, url=url, content=content\n        )\n\n    # Named Range\n\n    def get_named_ranges(self) -&gt; list[Element]:\n        \"\"\"Return all the tables named ranges.\n\n        Return: list of odf_named_range\n        \"\"\"\n        named_ranges = self.get_elements(\n            \"descendant::table:named-expressions/table:named-range\"\n        )\n        return named_ranges\n\n    def get_named_range(self, name: str) -&gt; Element | None:\n        \"\"\"Return the named range of specified name, or None if not found.\n\n        Arguments:\n\n            name -- str\n\n        Return: NamedRange\n        \"\"\"\n        named_range = self.get_elements(\n            f'descendant::table:named-expressions/table:named-range[@table:name=\"{name}\"][1]'\n        )\n        if named_range:\n            return named_range[0]\n        else:\n            return None\n\n    def append_named_range(self, named_range: Element) -&gt; None:\n        \"\"\"Append the named range to the spreadsheet, replacing existing named\n        range of same name if any.\n\n        Arguments:\n\n            named_range --  NamedRange\n        \"\"\"\n        if self.tag != \"office:spreadsheet\":\n            raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n        named_expressions = self.get_element(\"table:named-expressions\")\n        if not named_expressions:\n            named_expressions = Element.from_tag(\"table:named-expressions\")\n            self.append(named_expressions)\n        # exists ?\n        current = named_expressions.get_element(\n            f'table:named-range[@table:name=\"{named_range.name}\"][1]'  # type:ignore\n        )\n        if current:\n            named_expressions.delete(current)\n        named_expressions.append(named_range)\n\n    def delete_named_range(self, name: str) -&gt; None:\n        \"\"\"Delete the Named Range of specified name from the spreadsheet.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        if self.tag != \"office:spreadsheet\":\n            raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n        named_range = self.get_named_range(name)\n        if not named_range:\n            return\n        named_range.delete()\n        named_expressions = self.get_element(\"table:named-expressions\")\n        if not named_expressions:\n            return\n        element = named_expressions.__element\n        children = list(element.iterchildren())\n        if not children:\n            self.delete(named_expressions)\n\n    # Notes\n\n    def get_notes(\n        self,\n        note_class: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the notes that match the criteria.\n\n        Arguments:\n\n            note_class -- 'footnote' or 'endnote'\n\n            content -- str regex\n\n        Return: list of Note\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:note\", note_class=note_class, content=content\n        )\n\n    def get_note(\n        self,\n        position: int = 0,\n        note_id: str | None = None,\n        note_class: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the note that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            note_id -- str\n\n            note_class -- 'footnote' or 'endnote'\n\n            content -- str regex\n\n        Return: Note or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:note\",\n            position,\n            text_id=note_id,\n            note_class=note_class,\n            content=content,\n        )\n\n    # Annotations\n\n    def get_annotations(\n        self,\n        creator: str | None = None,\n        start_date: datetime | None = None,\n        end_date: datetime | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the annotations that match the criteria.\n\n        Arguments:\n\n            creator -- str\n\n            start_date -- datetime instance\n\n            end_date --  datetime instance\n\n            content -- str regex\n\n        Return: list of Annotation\n        \"\"\"\n        annotations = []\n        for annotation in self._filtered_elements(\n            \"descendant::office:annotation\", content=content\n        ):\n            if creator is not None and creator != annotation.dc_creator:\n                continue\n            date = annotation.date\n            if date is None:\n                continue\n            if start_date is not None and date &lt; start_date:\n                continue\n            if end_date is not None and date &gt;= end_date:\n                continue\n            annotations.append(annotation)\n        return annotations\n\n    def get_annotation(\n        self,\n        position: int = 0,\n        creator: str | None = None,\n        start_date: datetime | None = None,\n        end_date: datetime | None = None,\n        content: str | None = None,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the annotation that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            creator -- str\n\n            start_date -- datetime instance\n\n            end_date -- datetime instance\n\n            content -- str regex\n\n            name -- str\n\n        Return: Annotation or None if not found\n        \"\"\"\n        if name is not None:\n            return self._filtered_element(\n                \"descendant::office:annotation\", 0, office_name=name\n            )\n        annotations = self.get_annotations(\n            creator=creator, start_date=start_date, end_date=end_date, content=content\n        )\n        if not annotations:\n            return None\n        try:\n            return annotations[position]\n        except IndexError:\n            return None\n\n    def get_annotation_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the annotation ends.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::office:annotation-end\")\n\n    def get_annotation_end(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the annotation end that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::office:annotation-end\", position, office_name=name\n        )\n\n    # office:names\n\n    def get_office_names(self) -&gt; list[str]:\n        \"\"\"Return all the used office:name tags values of the element.\n\n        Return: list of unique str\n        \"\"\"\n        name_xpath_query = xpath_compile(\"//@office:name\")\n        response = name_xpath_query(self.__element)\n        if not isinstance(response, list):\n            return []\n        return list({str(name) for name in response if name})\n\n    # Variables\n\n    def get_variable_decls(self) -&gt; Element:\n        \"\"\"Return the container for variable declarations. Created if not\n        found.\n\n        Return: Element\n        \"\"\"\n        variable_decls = self.get_element(\"//text:variable-decls\")\n        if variable_decls is None:\n            body = self.document_body\n            if not body:\n                raise ValueError(\"Empty document.body\")\n            body.insert(Element.from_tag(\"text:variable-decls\"), FIRST_CHILD)\n            variable_decls = body.get_element(\"//text:variable-decls\")\n\n        return variable_decls  # type:ignore\n\n    def get_variable_decl_list(self) -&gt; list[Element]:\n        \"\"\"Return all the variable declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:variable-decl\")\n\n    def get_variable_decl(self, name: str, position: int = 0) -&gt; Element | None:\n        \"\"\"return the variable declaration for the given name.\n\n        Arguments:\n\n            name -- str\n\n            position -- int\n\n        return: Element or none if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:variable-decl\", position, text_name=name\n        )\n\n    def get_variable_sets(self, name: str | None = None) -&gt; list[Element]:\n        \"\"\"Return all the variable sets that match the criteria.\n\n        Arguments:\n\n            name -- str\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:variable-set\", text_name=name)\n\n    def get_variable_set(self, name: str, position: int = -1) -&gt; Element | None:\n        \"\"\"Return the variable set for the given name (last one by default).\n\n        Arguments:\n\n            name -- str\n\n            position -- int\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:variable-set\", position, text_name=name\n        )\n\n    def get_variable_set_value(\n        self,\n        name: str,\n        value_type: str | None = None,\n    ) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n        \"\"\"Return the last value of the given variable name.\n\n        Arguments:\n\n            name -- str\n\n            value_type -- 'boolean', 'currency', 'date', 'float',\n                          'percentage', 'string', 'time' or automatic\n\n        Return: most appropriate Python type\n        \"\"\"\n        variable_set = self.get_variable_set(name)\n        if not variable_set:\n            return None\n        return variable_set.get_value(value_type)  # type: ignore\n\n    # User fields\n\n    def get_user_field_decls(self) -&gt; Element | None:\n        \"\"\"Return the container for user field declarations. Created if not\n        found.\n\n        Return: Element\n        \"\"\"\n        user_field_decls = self.get_element(\"//text:user-field-decls\")\n        if user_field_decls is None:\n            body = self.document_body\n            if not body:\n                raise ValueError(\"Empty document.body\")\n            body.insert(Element.from_tag(\"text:user-field-decls\"), FIRST_CHILD)\n            user_field_decls = body.get_element(\"//text:user-field-decls\")\n\n        return user_field_decls\n\n    def get_user_field_decl_list(self) -&gt; list[Element]:\n        \"\"\"Return all the user field declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:user-field-decl\")\n\n    def get_user_field_decl(self, name: str, position: int = 0) -&gt; Element | None:\n        \"\"\"return the user field declaration for the given name.\n\n        return: Element or none if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:user-field-decl\", position, text_name=name\n        )\n\n    def get_user_field_value(\n        self, name: str, value_type: str | None = None\n    ) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n        \"\"\"Return the value of the given user field name.\n\n        Arguments:\n\n            name -- str\n\n            value_type -- 'boolean', 'currency', 'date', 'float',\n                          'percentage', 'string', 'time' or automatic\n\n        Return: most appropriate Python type\n        \"\"\"\n        user_field_decl = self.get_user_field_decl(name)\n        if user_field_decl is None:\n            return None\n        return user_field_decl.get_value(value_type)  # type: ignore\n\n    # User defined fields\n    # They are fields who should contain a copy of a user defined medtadata\n\n    def get_user_defined_list(self) -&gt; list[Element]:\n        \"\"\"Return all the user defined field declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:user-defined\")\n\n    @property\n    def user_defined_list(self) -&gt; list[Element]:\n        \"\"\"Return all the user defined field declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self.get_user_defined_list()\n\n    def get_user_defined(self, name: str, position: int = 0) -&gt; Element | None:\n        \"\"\"return the user defined declaration for the given name.\n\n        return: Element or none if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:user-defined\", position, text_name=name\n        )\n\n    def get_user_defined_value(\n        self, name: str, value_type: str | None = None\n    ) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n        \"\"\"Return the value of the given user defined field name.\n\n        Arguments:\n\n            name -- str\n\n            value_type -- 'boolean', 'date', 'float',\n                          'string', 'time' or automatic\n\n        Return: most appropriate Python type\n        \"\"\"\n        user_defined = self.get_user_defined(name)\n        if user_defined is None:\n            return None\n        return user_defined.get_value(value_type)  # type: ignore\n\n    # Draw Pages\n\n    def get_draw_pages(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw pages that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of DrawPage\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:page\", draw_style=style, content=content\n        )\n\n    def get_draw_page(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw page that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            content -- str regex\n\n        Return: DrawPage or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:page\", position, draw_name=name, content=content\n        )\n\n    # Links\n\n    def get_links(\n        self,\n        name: str | None = None,\n        title: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the links that match the criteria.\n\n        Arguments:\n\n            name -- str\n\n            title -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:a\",\n            office_name=name,\n            office_title=title,\n            url=url,\n            content=content,\n        )\n\n    def get_link(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        title: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the link that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            title -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:a\",\n            position,\n            office_name=name,\n            office_title=title,\n            url=url,\n            content=content,\n        )\n\n    # Bookmarks\n\n    def get_bookmarks(self) -&gt; list[Element]:\n        \"\"\"Return all the bookmarks.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:bookmark\")\n\n    def get_bookmark(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the bookmark that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Bookmark or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:bookmark\", position, text_name=name\n        )\n\n    def get_bookmark_starts(self) -&gt; list[Element]:\n        \"\"\"Return all the bookmark starts.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:bookmark-start\")\n\n    def get_bookmark_start(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the bookmark start that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:bookmark-start\", position, text_name=name\n        )\n\n    def get_bookmark_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the bookmark ends.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:bookmark-end\")\n\n    def get_bookmark_end(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the bookmark end that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:bookmark-end\", position, text_name=name\n        )\n\n    # Reference marks\n\n    def get_reference_marks_single(self) -&gt; list[Element]:\n        \"\"\"Return all the reference marks. Search only the tags\n        text:reference-mark.\n        Consider using : get_reference_marks()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:reference-mark\")\n\n    def get_reference_mark_single(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark that matches the criteria. Search only the\n        tags text:reference-mark.\n        Consider using : get_reference_mark()\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:reference-mark\", position, text_name=name\n        )\n\n    def get_reference_mark_starts(self) -&gt; list[Element]:\n        \"\"\"Return all the reference mark starts. Search only the tags\n        text:reference-mark-start.\n        Consider using : get_reference_marks()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:reference-mark-start\")\n\n    def get_reference_mark_start(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark start that matches the criteria. Search\n        only the tags text:reference-mark-start.\n        Consider using : get_reference_mark()\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:reference-mark-start\", position, text_name=name\n        )\n\n    def get_reference_mark_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the reference mark ends. Search only the tags\n        text:reference-mark-end.\n        Consider using : get_reference_marks()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:reference-mark-end\")\n\n    def get_reference_mark_end(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark end that matches the criteria. Search only\n        the tags text:reference-mark-end.\n        Consider using : get_reference_marks()\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:reference-mark-end\", position, text_name=name\n        )\n\n    def get_reference_marks(self) -&gt; list[Element]:\n        \"\"\"Return all the reference marks, either single position reference\n        (text:reference-mark) or start of range reference\n        (text:reference-mark-start).\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n        )\n\n    def get_reference_mark(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark that match the criteria. Either single\n        position reference mark (text:reference-mark) or start of range\n        reference (text:reference-mark-start).\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        if name:\n            request = (\n                f\"descendant::text:reference-mark-start\"\n                f'[@text:name=\"{name}\"] '\n                f\"| descendant::text:reference-mark\"\n                f'[@text:name=\"{name}\"]'\n            )\n            return self._filtered_element(request, position=0)\n        request = (\n            \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n        )\n        return self._filtered_element(request, position)\n\n    def get_references(self, name: str | None = None) -&gt; list[Element]:\n        \"\"\"Return all the references (text:reference-ref). If name is\n        provided, returns the references of that name.\n\n        Return: list of Element\n\n        Arguments:\n\n            name -- str or None\n        \"\"\"\n        if name is None:\n            return self._filtered_elements(\"descendant::text:reference-ref\")\n        request = f'descendant::text:reference-ref[@text:ref-name=\"{name}\"]'\n        return self._filtered_elements(request)\n\n    # Shapes elements\n\n    # Groups\n\n    def get_draw_groups(\n        self,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        return self._filtered_elements(\n            \"descendant::draw:g\",\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    def get_draw_group(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        return self._filtered_element(\n            \"descendant::draw:g\",\n            position,\n            draw_name=name,\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    # Lines\n\n    def get_draw_lines(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw lines that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:line\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_line(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw line that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:line\", position, draw_id=id, content=content\n        )\n\n    # Rectangles\n\n    def get_draw_rectangles(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw rectangles that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:rect\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_rectangle(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw rectangle that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:rect\", position, draw_id=id, content=content\n        )\n\n    # Ellipse\n\n    def get_draw_ellipses(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw ellipses that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:ellipse\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_ellipse(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw ellipse that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:ellipse\", position, draw_id=id, content=content\n        )\n\n    # Connectors\n\n    def get_draw_connectors(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw connectors that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:connector\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_connector(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw connector that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:connector\", position, draw_id=id, content=content\n        )\n\n    def get_orphan_draw_connectors(self) -&gt; list[Element]:\n        \"\"\"Return a list of connectors which don't have any shape connected\n        to them.\n        \"\"\"\n        connectors = []\n        for connector in self.get_draw_connectors():\n            start_shape = connector.get_attribute(\"draw:start-shape\")\n            end_shape = connector.get_attribute(\"draw:end-shape\")\n            if start_shape is None and end_shape is None:\n                connectors.append(connector)\n        return connectors\n\n    # Tracked changes and text change\n\n    def get_tracked_changes(self) -&gt; Element | None:\n        \"\"\"Return the tracked-changes part in the text body.\n\n        Return: Element or None\n        \"\"\"\n        return self.get_element(\"//text:tracked-changes\")\n\n    @property\n    def tracked_changes(self) -&gt; Element | None:\n        \"\"\"Return the tracked-changes part in the text body.\n\n        Return: Element or None\n        \"\"\"\n        return self.get_tracked_changes()\n\n    def get_changes_ids(self) -&gt; list[Element | EText]:\n        \"\"\"Return a list of ids that refers to a change region in the tracked\n        changes list.\n        \"\"\"\n        # Insertion changes\n        xpath_query = \"descendant::text:change-start/@text:change-id\"\n        # Deletion changes\n        xpath_query += \" | descendant::text:change/@text:change-id\"\n        return self.xpath(xpath_query)\n\n    def get_text_change_deletions(self) -&gt; list[Element]:\n        \"\"\"Return all the text changes of deletion kind: the tags text:change.\n        Consider using : get_text_changes()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:text:change\")\n\n    def get_text_change_deletion(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change of deletion kind that matches the criteria.\n        Search only for the tags text:change.\n        Consider using : get_text_change()\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:change\", position, change_id=idx\n        )\n\n    def get_text_change_starts(self) -&gt; list[Element]:\n        \"\"\"Return all the text change-start. Search only for the tags\n        text:change-start.\n        Consider using : get_text_changes()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:change-start\")\n\n    def get_text_change_start(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change-start that matches the criteria. Search\n        only the tags text:change-start.\n        Consider using : get_text_change()\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:change-start\", position, change_id=idx\n        )\n\n    def get_text_change_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the text change-end. Search only the tags\n        text:change-end.\n        Consider using : get_text_changes()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:change-end\")\n\n    def get_text_change_end(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change-end that matches the criteria. Search only\n        the tags text:change-end.\n        Consider using : get_text_change()\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:change-end\", position, change_id=idx\n        )\n\n    def get_text_changes(self) -&gt; list[Element]:\n        \"\"\"Return all the text changes, either single deletion\n        (text:change) or start of range of changes (text:change-start).\n\n        Return: list of Element\n        \"\"\"\n        request = \"descendant::text:change-start | descendant::text:change\"\n        return self._filtered_elements(request)\n\n    @property\n    def text_changes(self) -&gt; list[Element]:\n        \"\"\"Return all the text changes, either single deletion\n        (text:change) or start of range of changes (text:change-start).\n\n        Return: list of Element\n        \"\"\"\n        return self.get_text_changes()\n\n    def get_text_change(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change that matches the criteria. Either single\n        deletion (text:change) or start of range of changes (text:change-start).\n        position : index of the element to retrieve if several matches, default\n        is 0.\n        idx : change-id of the element.\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        if idx:\n            request = (\n                f'descendant::text:change-start[@text:change-id=\"{idx}\"] '\n                f'| descendant::text:change[@text:change-id=\"{idx}\"]'\n            )\n            return self._filtered_element(request, 0)\n        request = \"descendant::text:change-start | descendant::text:change\"\n        return self._filtered_element(request, position)\n\n    # Table Of Content\n\n    def get_tocs(self) -&gt; list[Element]:\n        \"\"\"Return all the tables of contents.\n\n        Return: list of odf_toc\n        \"\"\"\n        return self.get_elements(\"text:table-of-content\")\n\n    @property\n    def tocs(self) -&gt; list[Element]:\n        \"\"\"Return all the tables of contents.\n\n        Return: list of odf_toc\n        \"\"\"\n        return self.get_elements(\"text:table-of-content\")\n\n    def get_toc(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the table of contents that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: odf_toc or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"text:table-of-content\", position, content=content\n        )\n\n    @property\n    def toc(self) -&gt; Element | None:\n        \"\"\"Return the first table of contents.\n\n        Return: odf_toc or None if not found\n        \"\"\"\n        return self.get_toc()\n\n    # Styles\n\n    @staticmethod\n    def _get_style_tagname(family: str | None, is_default: bool = False) -&gt; str:\n        \"\"\"Widely match possible tag names given the family (or not).\"\"\"\n        if not family:\n            tagname = \"(style:default-style|*[@style:name]|draw:fill-image|draw:marker)\"\n        elif is_default:\n            # Default style\n            tagname = \"style:default-style\"\n        else:\n            tagname = _family_style_tagname(family)\n            # if famattr:\n            #    # Include family default style\n            #    tagname = '(%s|style:default-style)' % tagname\n            if family in FAMILY_ODF_STD:\n                # Include family default style\n                tagname = f\"({tagname}|style:default-style)\"\n        return tagname\n\n    def get_styles(self, family: str | None = None) -&gt; list[Element]:\n        # Both common and default styles\n        tagname = self._get_style_tagname(family)\n        return self._filtered_elements(tagname, family=family)\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Element | None = None,\n        display_name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the style uniquely identified by the family/name pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is not the internal name but the name you gave in the\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                      'number'\n\n            name_or_element -- str or Style\n\n            display_name -- str\n\n        Return: odf_style or None if not found\n        \"\"\"\n        if isinstance(name_or_element, Element):\n            name = self.get_attribute(\"style:name\")\n            if name is not None:\n                return name_or_element\n            else:\n                raise ValueError(f\"Not a odf_style ? {name_or_element!r}\")\n        style_name = name_or_element\n        is_default = not (style_name or display_name)\n        tagname = self._get_style_tagname(family, is_default=is_default)\n        # famattr became None if no \"style:family\" attribute\n        if family:\n            return self._filtered_element(\n                tagname,\n                0,\n                style_name=style_name,\n                display_name=display_name,\n                family=family,\n            )\n        else:\n            return self._filtered_element(\n                tagname,\n                0,\n                draw_name=style_name or display_name,\n                family=family,\n            )\n\n    def _filtered_element(\n        self,\n        query_string: str,\n        position: int,\n        **kwargs: Any,\n    ) -&gt; Element | None:\n        results = self._filtered_elements(query_string, **kwargs)\n        try:\n            return results[position]\n        except IndexError:\n            return None\n\n    def _filtered_elements(\n        self,\n        query_string: str,\n        content: str | None = None,\n        url: str | None = None,\n        svg_title: str | None = None,\n        svg_desc: str | None = None,\n        dc_creator: str | None = None,\n        dc_date: datetime | None = None,\n        **kwargs: Any,\n    ) -&gt; list[Element]:\n        query = make_xpath_query(query_string, **kwargs)\n        elements = self.get_elements(query)\n        # Filter the elements with the regex (TODO use XPath)\n        if content is not None:\n            elements = [element for element in elements if element.match(content)]\n        if url is not None:\n            filtered = []\n            for element in elements:\n                url_attr = element.get_attribute(\"xlink:href\")\n                if isinstance(url_attr, str) and search(url, url_attr) is not None:\n                    filtered.append(element)\n            elements = filtered\n        if dc_date is None:\n            dt_dc_date = None\n        else:\n            dt_dc_date = DateTime.encode(dc_date)\n        for variable, childname in [\n            (svg_title, \"svg:title\"),\n            (svg_desc, \"svg:desc\"),\n            (dc_creator, \"descendant::dc:creator\"),\n            (dt_dc_date, \"descendant::dc:date\"),\n        ]:\n            if not variable:\n                continue\n            filtered = []\n            for element in elements:\n                child = element.get_element(childname)\n                if child and child.match(variable):\n                    filtered.append(element)\n            elements = filtered\n        return elements\n</code></pre>"},{"location":"reference.html#odfdo.Element.document_body","title":"<code>document_body: Element | None</code>  <code>property</code>","text":"<p>Return the first children of document body if any: \u2018office:body/*[1]\u2019</p>"},{"location":"reference.html#odfdo.Element.frames","title":"<code>frames: list[Element]</code>  <code>property</code>","text":"<p>Return all the frames.</p> <p>Return: list of Frame</p>"},{"location":"reference.html#odfdo.Element.headers","title":"<code>headers: list[Element]</code>  <code>property</code>","text":"<p>Return all the Headers.</p> <p>Return: list of Header</p>"},{"location":"reference.html#odfdo.Element.images","title":"<code>images: list[Element]</code>  <code>property</code>","text":"<p>Return all the images.</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.lists","title":"<code>lists: list[Element]</code>  <code>property</code>","text":"<p>Return all the lists.</p> <p>Return: list of List</p>"},{"location":"reference.html#odfdo.Element.paragraphs","title":"<code>paragraphs: list[Element]</code>  <code>property</code>","text":"<p>Return all the paragraphs.</p> <p>Return: list of Paragraph</p>"},{"location":"reference.html#odfdo.Element.sections","title":"<code>sections: list[Element]</code>  <code>property</code>","text":"<p>Return all the sections.</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.spans","title":"<code>spans: list[Element]</code>  <code>property</code>","text":"<p>Return all the spans.</p> <p>Return: list of Span</p>"},{"location":"reference.html#odfdo.Element.tag","title":"<code>tag: str</code>  <code>property</code> <code>writable</code>","text":"<p>Get/set the underlying xml tag with the given qualified name.</p> <p>Warning: direct change of tag does not change the element class.</p> <p>Arguments:</p> <pre><code>qname -- str (e.g. \"text:span\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.tail","title":"<code>tail: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the text immediately following the element.</p>"},{"location":"reference.html#odfdo.Element.text","title":"<code>text: str</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the text content of the element.</p>"},{"location":"reference.html#odfdo.Element.text_changes","title":"<code>text_changes: list[Element]</code>  <code>property</code>","text":"<p>Return all the text changes, either single deletion (text:change) or start of range of changes (text:change-start).</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.text_content","title":"<code>text_content: str</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the text of the embedded paragraph, including embeded annotations, cells\u2026</p> <p>Set create a paragraph if missing</p>"},{"location":"reference.html#odfdo.Element.toc","title":"<code>toc: Element | None</code>  <code>property</code>","text":"<p>Return the first table of contents.</p> <p>Return: odf_toc or None if not found</p>"},{"location":"reference.html#odfdo.Element.tocs","title":"<code>tocs: list[Element]</code>  <code>property</code>","text":"<p>Return all the tables of contents.</p> <p>Return: list of odf_toc</p>"},{"location":"reference.html#odfdo.Element.tracked_changes","title":"<code>tracked_changes: Element | None</code>  <code>property</code>","text":"<p>Return the tracked-changes part in the text body.</p> <p>Return: Element or None</p>"},{"location":"reference.html#odfdo.Element.user_defined_list","title":"<code>user_defined_list: list[Element]</code>  <code>property</code>","text":"<p>Return all the user defined field declarations.</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.append","title":"<code>append(str_or_element)</code>","text":"<p>Insert element or text in the last position.</p> Source code in <code>odfdo/element.py</code> <pre><code>def append(self, str_or_element: str | Element) -&gt; None:\n    \"\"\"Insert element or text in the last position.\"\"\"\n    current = self.__element\n    if isinstance(str_or_element, str):\n        # Has children ?\n        children = list(current.iterchildren())\n        if children:\n            # Append to tail of the last child\n            last_child = children[-1]\n            text = last_child.tail\n            text = text if text is not None else \"\"\n            text += str_or_element\n            last_child.tail = text\n        else:\n            # Append to text of the element\n            text = current.text\n            text = text if text is not None else \"\"\n            text += str_or_element\n            current.text = text\n    elif isinstance(str_or_element, Element):\n        current.append(str_or_element.__element)\n    else:\n        raise TypeError(f'Element or string expected, not \"{type(str_or_element)}\"')\n</code></pre>"},{"location":"reference.html#odfdo.Element.append_named_range","title":"<code>append_named_range(named_range)</code>","text":"<p>Append the named range to the spreadsheet, replacing existing named range of same name if any.</p> <p>Arguments:</p> <pre><code>named_range --  NamedRange\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def append_named_range(self, named_range: Element) -&gt; None:\n    \"\"\"Append the named range to the spreadsheet, replacing existing named\n    range of same name if any.\n\n    Arguments:\n\n        named_range --  NamedRange\n    \"\"\"\n    if self.tag != \"office:spreadsheet\":\n        raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n    named_expressions = self.get_element(\"table:named-expressions\")\n    if not named_expressions:\n        named_expressions = Element.from_tag(\"table:named-expressions\")\n        self.append(named_expressions)\n    # exists ?\n    current = named_expressions.get_element(\n        f'table:named-range[@table:name=\"{named_range.name}\"][1]'  # type:ignore\n    )\n    if current:\n        named_expressions.delete(current)\n    named_expressions.append(named_range)\n</code></pre>"},{"location":"reference.html#odfdo.Element.clear","title":"<code>clear()</code>","text":"<p>Remove text, children and attributes from the element.</p> Source code in <code>odfdo/element.py</code> <pre><code>def clear(self) -&gt; None:\n    \"\"\"Remove text, children and attributes from the element.\"\"\"\n    self.__element.clear()\n    if hasattr(self, \"_tmap\"):\n        self._tmap: list[int] = []\n    if hasattr(self, \"_cmap\"):\n        self._cmap: list[int] = []\n    if hasattr(self, \"_rmap\"):\n        self._rmap: list[int] = []\n    if hasattr(self, \"_indexes\"):\n        remember = False\n        if \"_rmap\" in self._indexes:\n            remember = True\n        self._indexes: dict[str, dict] = {}\n        self._indexes[\"_cmap\"] = {}\n        self._indexes[\"_tmap\"] = {}\n        if remember:\n            self._indexes[\"_rmap\"] = {}\n</code></pre>"},{"location":"reference.html#odfdo.Element.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>if keep_tail is True (default), the tail text is not erased.</p> <p>Arguments:</p> <pre><code>child -- Element\n\nkeep_tail -- boolean (default to True), True for most usages.\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    if keep_tail is True (default), the tail text is not erased.\n\n    Arguments:\n\n        child -- Element\n\n        keep_tail -- boolean (default to True), True for most usages.\n    \"\"\"\n    if child is None:\n        parent = self.parent\n        if parent is None:\n            raise ValueError(f\"Can't delete the root element\\n{self.serialize()}\")\n        child = self\n    else:\n        parent = self\n    if keep_tail and child.__element.tail is not None:\n        current = child.__element\n        tail = str(current.tail)\n        current.tail = None\n        prev = current.getprevious()\n        if prev is not None:\n            if prev.tail is None:\n                prev.tail = tail\n            else:\n                prev.tail += tail\n        else:\n            if parent.__element.text is None:\n                parent.__element.text = tail\n            else:\n                parent.__element.text += tail\n    parent.__element.remove(child.__element)\n</code></pre>"},{"location":"reference.html#odfdo.Element.delete_named_range","title":"<code>delete_named_range(name)</code>","text":"<p>Delete the Named Range of specified name from the spreadsheet.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def delete_named_range(self, name: str) -&gt; None:\n    \"\"\"Delete the Named Range of specified name from the spreadsheet.\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    if self.tag != \"office:spreadsheet\":\n        raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n    named_range = self.get_named_range(name)\n    if not named_range:\n        return\n    named_range.delete()\n    named_expressions = self.get_element(\"table:named-expressions\")\n    if not named_expressions:\n        return\n    element = named_expressions.__element\n    children = list(element.iterchildren())\n    if not children:\n        self.delete(named_expressions)\n</code></pre>"},{"location":"reference.html#odfdo.Element.elements_repeated_sequence","title":"<code>elements_repeated_sequence(xpath_instance, name)</code>","text":"<p>Utility method for table module.</p> Source code in <code>odfdo/element.py</code> <pre><code>def elements_repeated_sequence(\n    self,\n    xpath_instance: XPath,\n    name: str,\n) -&gt; list[tuple[int, int]]:\n    \"\"\"Utility method for table module.\"\"\"\n    lxml_tag = _get_lxml_tag_or_name(name)\n    element = self.__element\n    sub_elements = xpath_instance(element)\n    if not isinstance(sub_elements, list):\n        raise TypeError(\"Bad XPath result.\")\n    result: list[tuple[int, int]] = []\n    idx = -1\n    for sub_element in sub_elements:\n        if not isinstance(sub_element, _Element):\n            continue\n        idx += 1\n        value = sub_element.get(lxml_tag)\n        if value is None:\n            result.append((idx, 1))\n            continue\n        try:\n            int_value = int(value)\n        except ValueError:\n            int_value = 1\n        result.append((idx, max(int_value, 1)))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Element.extend","title":"<code>extend(odf_elements)</code>","text":"<p>Fast append elements at the end of ourself using extend.</p> Source code in <code>odfdo/element.py</code> <pre><code>def extend(self, odf_elements: Iterable[Element]) -&gt; None:\n    \"\"\"Fast append elements at the end of ourself using extend.\"\"\"\n    if odf_elements:\n        current = self.__element\n        elements = [element.__element for element in odf_elements]\n        current.extend(elements)\n</code></pre>"},{"location":"reference.html#odfdo.Element.from_tag","title":"<code>from_tag(tag_or_elem)</code>  <code>classmethod</code>","text":"<p>Element class and subclass factory.</p> <p>Turn an lxml Element or ODF string tag into an ODF XML Element of the relevant class.</p> <p>Arguments:</p> <pre><code>tag_or_elem -- ODF str tag or lxml.Element\n</code></pre> <p>Return: Element (or subclass) instance</p> Source code in <code>odfdo/element.py</code> <pre><code>@classmethod\ndef from_tag(cls, tag_or_elem: str | _Element) -&gt; Element:\n    \"\"\"Element class and subclass factory.\n\n    Turn an lxml Element or ODF string tag into an ODF XML Element\n    of the relevant class.\n\n    Arguments:\n\n        tag_or_elem -- ODF str tag or lxml.Element\n\n    Return: Element (or subclass) instance\n    \"\"\"\n    if isinstance(tag_or_elem, str):\n        # assume the argument is a prefix:name tag\n        elem = cls.make_etree_element(tag_or_elem)\n    else:\n        elem = tag_or_elem\n    klass = _class_registry.get(elem.tag, cls)\n    return klass(tag_or_elem=elem)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotation","title":"<code>get_annotation(position=0, creator=None, start_date=None, end_date=None, content=None, name=None)</code>","text":"<p>Return the annotation that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncreator -- str\n\nstart_date -- datetime instance\n\nend_date -- datetime instance\n\ncontent -- str regex\n\nname -- str\n</code></pre> <p>Return: Annotation or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotation(\n    self,\n    position: int = 0,\n    creator: str | None = None,\n    start_date: datetime | None = None,\n    end_date: datetime | None = None,\n    content: str | None = None,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the annotation that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        creator -- str\n\n        start_date -- datetime instance\n\n        end_date -- datetime instance\n\n        content -- str regex\n\n        name -- str\n\n    Return: Annotation or None if not found\n    \"\"\"\n    if name is not None:\n        return self._filtered_element(\n            \"descendant::office:annotation\", 0, office_name=name\n        )\n    annotations = self.get_annotations(\n        creator=creator, start_date=start_date, end_date=end_date, content=content\n    )\n    if not annotations:\n        return None\n    try:\n        return annotations[position]\n    except IndexError:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotation_end","title":"<code>get_annotation_end(position=0, name=None)</code>","text":"<p>Return the annotation end that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotation_end(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the annotation end that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::office:annotation-end\", position, office_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotation_ends","title":"<code>get_annotation_ends()</code>","text":"<p>Return all the annotation ends.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotation_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the annotation ends.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::office:annotation-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotations","title":"<code>get_annotations(creator=None, start_date=None, end_date=None, content=None)</code>","text":"<p>Return all the annotations that match the criteria.</p> <p>Arguments:</p> <pre><code>creator -- str\n\nstart_date -- datetime instance\n\nend_date --  datetime instance\n\ncontent -- str regex\n</code></pre> <p>Return: list of Annotation</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotations(\n    self,\n    creator: str | None = None,\n    start_date: datetime | None = None,\n    end_date: datetime | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the annotations that match the criteria.\n\n    Arguments:\n\n        creator -- str\n\n        start_date -- datetime instance\n\n        end_date --  datetime instance\n\n        content -- str regex\n\n    Return: list of Annotation\n    \"\"\"\n    annotations = []\n    for annotation in self._filtered_elements(\n        \"descendant::office:annotation\", content=content\n    ):\n        if creator is not None and creator != annotation.dc_creator:\n            continue\n        date = annotation.date\n        if date is None:\n            continue\n        if start_date is not None and date &lt; start_date:\n            continue\n        if end_date is not None and date &gt;= end_date:\n            continue\n        annotations.append(annotation)\n    return annotations\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_attribute","title":"<code>get_attribute(name)</code>","text":"<p>Return the attribute value as type str | bool | None.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_attribute(self, name: str) -&gt; str | bool | None:\n    \"\"\"Return the attribute value as type str | bool | None.\"\"\"\n    element = self.__element\n    lxml_tag = _get_lxml_tag_or_name(name)\n    value = element.get(lxml_tag)\n    if value is None:\n        return None\n    elif value in (\"true\", \"false\"):\n        return Boolean.decode(value)\n    return str(value)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_attribute_integer","title":"<code>get_attribute_integer(name)</code>","text":"<p>Return either the attribute as type int, or None.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_attribute_integer(self, name: str) -&gt; int | None:\n    \"\"\"Return either the attribute as type int, or None.\"\"\"\n    element = self.__element\n    lxml_tag = _get_lxml_tag_or_name(name)\n    value = element.get(lxml_tag)\n    if value is None:\n        return None\n    try:\n        return int(value)\n    except ValueError:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_attribute_string","title":"<code>get_attribute_string(name)</code>","text":"<p>Return either the attribute as type str, or None.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_attribute_string(self, name: str) -&gt; str | None:\n    \"\"\"Return either the attribute as type str, or None.\"\"\"\n    element = self.__element\n    lxml_tag = _get_lxml_tag_or_name(name)\n    value = element.get(lxml_tag)\n    if value is None:\n        return None\n    return str(value)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_between","title":"<code>get_between(tag1, tag2, as_text=False, clean=True, no_header=True)</code>","text":"<p>Returns elements between tag1 and tag2, tag1 and tag2 shall be unique and having an id attribute. (WARN: buggy if tag1/tag2 defines a malformed odf xml.) If as_text is True: returns the text content. If clean is True: suppress unwanted tags (deletions marks, \u2026) If no_header is True: existing text:h are changed in text:p By default: returns a list of Element, cleaned and without headers.</p> <p>Implementation and standard retrictions: Only text:h and text:p sould be \u2018cut\u2019 by an insert tag, so inner parts of insert tags are:</p> <pre><code>- any text:h, text:p or sub tag of these\n\n- some text, part of a parent text:h or text:p\n</code></pre> <p>Arguments:</p> <pre><code>tag1 -- Element\n\ntag2 -- Element\n\nas_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list of odf_paragraph or odf_header</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_between(\n    self,\n    tag1: Element,\n    tag2: Element,\n    as_text: bool = False,\n    clean: bool = True,\n    no_header: bool = True,\n) -&gt; list | Element | str:\n    \"\"\"Returns elements between tag1 and tag2, tag1 and tag2 shall\n    be unique and having an id attribute.\n    (WARN: buggy if tag1/tag2 defines a malformed odf xml.)\n    If as_text is True: returns the text content.\n    If clean is True: suppress unwanted tags (deletions marks, ...)\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of Element, cleaned and without headers.\n\n    Implementation and standard retrictions:\n    Only text:h and text:p sould be 'cut' by an insert tag, so inner parts\n    of insert tags are:\n\n        - any text:h, text:p or sub tag of these\n\n        - some text, part of a parent text:h or text:p\n\n    Arguments:\n\n        tag1 -- Element\n\n        tag2 -- Element\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list of odf_paragraph or odf_header\n    \"\"\"\n    inner = self._get_between_base(tag1, tag2)\n\n    if clean:\n        clean_tags = (\n            \"text:change\",\n            \"text:change-start\",\n            \"text:change-end\",\n            \"text:reference-mark\",\n            \"text:reference-mark-start\",\n            \"text:reference-mark-end\",\n        )\n        request_self = \" | \".join([f\"self::{tag}\" for tag in clean_tags])\n        inner = [e for e in inner if not e.xpath(request_self)]\n        request = \" | \".join([f\"descendant::{tag}\" for tag in clean_tags])\n        for element in inner:\n            to_del = element.xpath(request)\n            for elem in to_del:\n                if isinstance(elem, Element):\n                    element.delete(elem)\n    if no_header:  # crude replace t:h by t:p\n        new_inner = []\n        for element in inner:\n            if element.tag == \"text:h\":\n                children = element.children\n                text = element.__element.text\n                para = Element.from_tag(\"text:p\")\n                para.text = text or \"\"\n                for c in children:\n                    para.append(c)\n                new_inner.append(para)\n            else:\n                new_inner.append(element)\n        inner = new_inner\n    if as_text:\n        return \"\\n\".join([e.get_formatted_text() for e in inner])\n    else:\n        return inner\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark","title":"<code>get_bookmark(position=0, name=None)</code>","text":"<p>Return the bookmark that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Bookmark or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the bookmark that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Bookmark or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:bookmark\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_end","title":"<code>get_bookmark_end(position=0, name=None)</code>","text":"<p>Return the bookmark end that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_end(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the bookmark end that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:bookmark-end\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_ends","title":"<code>get_bookmark_ends()</code>","text":"<p>Return all the bookmark ends.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the bookmark ends.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:bookmark-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_start","title":"<code>get_bookmark_start(position=0, name=None)</code>","text":"<p>Return the bookmark start that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_start(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the bookmark start that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:bookmark-start\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_starts","title":"<code>get_bookmark_starts()</code>","text":"<p>Return all the bookmark starts.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_starts(self) -&gt; list[Element]:\n    \"\"\"Return all the bookmark starts.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:bookmark-start\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmarks","title":"<code>get_bookmarks()</code>","text":"<p>Return all the bookmarks.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmarks(self) -&gt; list[Element]:\n    \"\"\"Return all the bookmarks.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:bookmark\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_changes_ids","title":"<code>get_changes_ids()</code>","text":"<p>Return a list of ids that refers to a change region in the tracked changes list.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_changes_ids(self) -&gt; list[Element | EText]:\n    \"\"\"Return a list of ids that refers to a change region in the tracked\n    changes list.\n    \"\"\"\n    # Insertion changes\n    xpath_query = \"descendant::text:change-start/@text:change-id\"\n    # Deletion changes\n    xpath_query += \" | descendant::text:change/@text:change-id\"\n    return self.xpath(xpath_query)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_connector","title":"<code>get_draw_connector(position=0, id=None, content=None)</code>","text":"<p>Return the draw connector that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_connector(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw connector that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:connector\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_connectors","title":"<code>get_draw_connectors(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw connectors that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_connectors(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw connectors that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:connector\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_ellipse","title":"<code>get_draw_ellipse(position=0, id=None, content=None)</code>","text":"<p>Return the draw ellipse that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_ellipse(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw ellipse that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:ellipse\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_ellipses","title":"<code>get_draw_ellipses(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw ellipses that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_ellipses(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw ellipses that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:ellipse\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_line","title":"<code>get_draw_line(position=0, id=None, content=None)</code>","text":"<p>Return the draw line that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_line(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw line that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:line\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_lines","title":"<code>get_draw_lines(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw lines that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_lines(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw lines that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:line\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_page","title":"<code>get_draw_page(position=0, name=None, content=None)</code>","text":"<p>Return the draw page that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\ncontent -- str regex\n</code></pre> <p>Return: DrawPage or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_page(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw page that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        content -- str regex\n\n    Return: DrawPage or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:page\", position, draw_name=name, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_pages","title":"<code>get_draw_pages(style=None, content=None)</code>","text":"<p>Return all the draw pages that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of DrawPage</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_pages(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw pages that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of DrawPage\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:page\", draw_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_rectangle","title":"<code>get_draw_rectangle(position=0, id=None, content=None)</code>","text":"<p>Return the draw rectangle that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_rectangle(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw rectangle that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:rect\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_rectangles","title":"<code>get_draw_rectangles(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw rectangles that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_rectangles(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw rectangles that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:rect\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_formatted_text","title":"<code>get_formatted_text(context=None)</code>","text":"<p>This function should return a beautiful version of the text.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_formatted_text(self, context: dict | None = None) -&gt; str:\n    \"\"\"This function should return a beautiful version of the text.\"\"\"\n    return \"\"\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_frame","title":"<code>get_frame(position=0, name=None, presentation_class=None, title=None, description=None, content=None)</code>","text":"<p>Return the section that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\npresentation_class -- str\n\ntitle -- str regex\n\ndescription -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: Frame or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_frame(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    presentation_class: str | None = None,\n    title: str | None = None,\n    description: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the section that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        presentation_class -- str\n\n        title -- str regex\n\n        description -- str regex\n\n        content -- str regex\n\n    Return: Frame or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:frame\",\n        position,\n        draw_name=name,\n        presentation_class=presentation_class,\n        svg_title=title,\n        svg_desc=description,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_frames","title":"<code>get_frames(presentation_class=None, style=None, title=None, description=None, content=None)</code>","text":"<p>Return all the frames that match the criteria.</p> <p>Arguments:</p> <pre><code>presentation_class -- str\n\nstyle -- str\n\ntitle -- str regex\n\ndescription -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: list of Frame</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_frames(\n    self,\n    presentation_class: str | None = None,\n    style: str | None = None,\n    title: str | None = None,\n    description: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the frames that match the criteria.\n\n    Arguments:\n\n        presentation_class -- str\n\n        style -- str\n\n        title -- str regex\n\n        description -- str regex\n\n        content -- str regex\n\n    Return: list of Frame\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:frame\",\n        presentation_class=presentation_class,\n        draw_style=style,\n        svg_title=title,\n        svg_desc=description,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_header","title":"<code>get_header(position=0, outline_level=None, content=None)</code>","text":"<p>Return the Header that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Header or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_header(\n    self,\n    position: int = 0,\n    outline_level: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the Header that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Header or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:h\",\n        position,\n        outline_level=outline_level,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_headers","title":"<code>get_headers(style=None, outline_level=None, content=None)</code>","text":"<p>Return all the Headers that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Header</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_headers(\n    self,\n    style: str | None = None,\n    outline_level: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the Headers that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Header\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:h\",\n        text_style=style,\n        outline_level=outline_level,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_image","title":"<code>get_image(position=0, name=None, url=None, content=None)</code>","text":"<p>Return the image matching the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_image(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the image matching the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    # The frame is holding the name\n    if name is not None:\n        frame = self._filtered_element(\n            \"descendant::draw:frame\", position, draw_name=name\n        )\n        if frame is None:\n            return None\n        # The name is supposedly unique\n        return frame.get_element(\"draw:image\")\n    return self._filtered_element(\n        \"descendant::draw:image\", position, url=url, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_images","title":"<code>get_images(style=None, url=None, content=None)</code>","text":"<p>Return all the images matching the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_images(\n    self,\n    style: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the images matching the criteria.\n\n    Arguments:\n\n        style -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:image\", text_style=style, url=url, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_link","title":"<code>get_link(position=0, name=None, title=None, url=None, content=None)</code>","text":"<p>Return the link that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\ntitle -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_link(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    title: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the link that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        title -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:a\",\n        position,\n        office_name=name,\n        office_title=title,\n        url=url,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_links","title":"<code>get_links(name=None, title=None, url=None, content=None)</code>","text":"<p>Return all the links that match the criteria.</p> <p>Arguments:</p> <pre><code>name -- str\n\ntitle -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_links(\n    self,\n    name: str | None = None,\n    title: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the links that match the criteria.\n\n    Arguments:\n\n        name -- str\n\n        title -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:a\",\n        office_name=name,\n        office_title=title,\n        url=url,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_list","title":"<code>get_list(position=0, content=None)</code>","text":"<p>Return the list that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: List or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_list(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the list that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: List or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:list\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_lists","title":"<code>get_lists(style=None, content=None)</code>","text":"<p>Return all the lists that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of List</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_lists(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the lists that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of List\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:list\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_named_range","title":"<code>get_named_range(name)</code>","text":"<p>Return the named range of specified name, or None if not found.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: NamedRange</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_named_range(self, name: str) -&gt; Element | None:\n    \"\"\"Return the named range of specified name, or None if not found.\n\n    Arguments:\n\n        name -- str\n\n    Return: NamedRange\n    \"\"\"\n    named_range = self.get_elements(\n        f'descendant::table:named-expressions/table:named-range[@table:name=\"{name}\"][1]'\n    )\n    if named_range:\n        return named_range[0]\n    else:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_named_ranges","title":"<code>get_named_ranges()</code>","text":"<p>Return all the tables named ranges.</p> <p>Return: list of odf_named_range</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_named_ranges(self) -&gt; list[Element]:\n    \"\"\"Return all the tables named ranges.\n\n    Return: list of odf_named_range\n    \"\"\"\n    named_ranges = self.get_elements(\n        \"descendant::table:named-expressions/table:named-range\"\n    )\n    return named_ranges\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_note","title":"<code>get_note(position=0, note_id=None, note_class=None, content=None)</code>","text":"<p>Return the note that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nnote_id -- str\n\nnote_class -- 'footnote' or 'endnote'\n\ncontent -- str regex\n</code></pre> <p>Return: Note or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_note(\n    self,\n    position: int = 0,\n    note_id: str | None = None,\n    note_class: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the note that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        note_id -- str\n\n        note_class -- 'footnote' or 'endnote'\n\n        content -- str regex\n\n    Return: Note or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:note\",\n        position,\n        text_id=note_id,\n        note_class=note_class,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_notes","title":"<code>get_notes(note_class=None, content=None)</code>","text":"<p>Return all the notes that match the criteria.</p> <p>Arguments:</p> <pre><code>note_class -- 'footnote' or 'endnote'\n\ncontent -- str regex\n</code></pre> <p>Return: list of Note</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_notes(\n    self,\n    note_class: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the notes that match the criteria.\n\n    Arguments:\n\n        note_class -- 'footnote' or 'endnote'\n\n        content -- str regex\n\n    Return: list of Note\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:note\", note_class=note_class, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_office_names","title":"<code>get_office_names()</code>","text":"<p>Return all the used office:name tags values of the element.</p> <p>Return: list of unique str</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_office_names(self) -&gt; list[str]:\n    \"\"\"Return all the used office:name tags values of the element.\n\n    Return: list of unique str\n    \"\"\"\n    name_xpath_query = xpath_compile(\"//@office:name\")\n    response = name_xpath_query(self.__element)\n    if not isinstance(response, list):\n        return []\n    return list({str(name) for name in response if name})\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_orphan_draw_connectors","title":"<code>get_orphan_draw_connectors()</code>","text":"<p>Return a list of connectors which don\u2019t have any shape connected to them.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_orphan_draw_connectors(self) -&gt; list[Element]:\n    \"\"\"Return a list of connectors which don't have any shape connected\n    to them.\n    \"\"\"\n    connectors = []\n    for connector in self.get_draw_connectors():\n        start_shape = connector.get_attribute(\"draw:start-shape\")\n        end_shape = connector.get_attribute(\"draw:end-shape\")\n        if start_shape is None and end_shape is None:\n            connectors.append(connector)\n    return connectors\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_paragraph","title":"<code>get_paragraph(position=0, content=None)</code>","text":"<p>Return the paragraph that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Paragraph or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_paragraph(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the paragraph that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Paragraph or None if not found\n    \"\"\"\n    return self._filtered_element(\"descendant::text:p\", position, content=content)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_paragraphs","title":"<code>get_paragraphs(style=None, content=None)</code>","text":"<p>Return all the paragraphs that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Paragraph</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_paragraphs(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the paragraphs that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Paragraph\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:p\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark","title":"<code>get_reference_mark(position=0, name=None)</code>","text":"<p>Return the reference mark that match the criteria. Either single position reference mark (text:reference-mark) or start of range reference (text:reference-mark-start).</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark that match the criteria. Either single\n    position reference mark (text:reference-mark) or start of range\n    reference (text:reference-mark-start).\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    if name:\n        request = (\n            f\"descendant::text:reference-mark-start\"\n            f'[@text:name=\"{name}\"] '\n            f\"| descendant::text:reference-mark\"\n            f'[@text:name=\"{name}\"]'\n        )\n        return self._filtered_element(request, position=0)\n    request = (\n        \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n    )\n    return self._filtered_element(request, position)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_end","title":"<code>get_reference_mark_end(position=0, name=None)</code>","text":"<p>Return the reference mark end that matches the criteria. Search only the tags text:reference-mark-end. Consider using : get_reference_marks()</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_end(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark end that matches the criteria. Search only\n    the tags text:reference-mark-end.\n    Consider using : get_reference_marks()\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:reference-mark-end\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_ends","title":"<code>get_reference_mark_ends()</code>","text":"<p>Return all the reference mark ends. Search only the tags text:reference-mark-end. Consider using : get_reference_marks()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the reference mark ends. Search only the tags\n    text:reference-mark-end.\n    Consider using : get_reference_marks()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:reference-mark-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_single","title":"<code>get_reference_mark_single(position=0, name=None)</code>","text":"<p>Return the reference mark that matches the criteria. Search only the tags text:reference-mark. Consider using : get_reference_mark()</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_single(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark that matches the criteria. Search only the\n    tags text:reference-mark.\n    Consider using : get_reference_mark()\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:reference-mark\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_start","title":"<code>get_reference_mark_start(position=0, name=None)</code>","text":"<p>Return the reference mark start that matches the criteria. Search only the tags text:reference-mark-start. Consider using : get_reference_mark()</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_start(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark start that matches the criteria. Search\n    only the tags text:reference-mark-start.\n    Consider using : get_reference_mark()\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:reference-mark-start\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_starts","title":"<code>get_reference_mark_starts()</code>","text":"<p>Return all the reference mark starts. Search only the tags text:reference-mark-start. Consider using : get_reference_marks()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_starts(self) -&gt; list[Element]:\n    \"\"\"Return all the reference mark starts. Search only the tags\n    text:reference-mark-start.\n    Consider using : get_reference_marks()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:reference-mark-start\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_marks","title":"<code>get_reference_marks()</code>","text":"<p>Return all the reference marks, either single position reference (text:reference-mark) or start of range reference (text:reference-mark-start).</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_marks(self) -&gt; list[Element]:\n    \"\"\"Return all the reference marks, either single position reference\n    (text:reference-mark) or start of range reference\n    (text:reference-mark-start).\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_marks_single","title":"<code>get_reference_marks_single()</code>","text":"<p>Return all the reference marks. Search only the tags text:reference-mark. Consider using : get_reference_marks()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_marks_single(self) -&gt; list[Element]:\n    \"\"\"Return all the reference marks. Search only the tags\n    text:reference-mark.\n    Consider using : get_reference_marks()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:reference-mark\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_references","title":"<code>get_references(name=None)</code>","text":"<p>Return all the references (text:reference-ref). If name is provided, returns the references of that name.</p> <p>Return: list of Element</p> <p>Arguments:</p> <pre><code>name -- str or None\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def get_references(self, name: str | None = None) -&gt; list[Element]:\n    \"\"\"Return all the references (text:reference-ref). If name is\n    provided, returns the references of that name.\n\n    Return: list of Element\n\n    Arguments:\n\n        name -- str or None\n    \"\"\"\n    if name is None:\n        return self._filtered_elements(\"descendant::text:reference-ref\")\n    request = f'descendant::text:reference-ref[@text:ref-name=\"{name}\"]'\n    return self._filtered_elements(request)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_section","title":"<code>get_section(position=0, content=None)</code>","text":"<p>Return the section that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_section(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the section that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:section\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_sections","title":"<code>get_sections(style=None, content=None)</code>","text":"<p>Return all the sections that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_sections(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the sections that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"text:section\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_span","title":"<code>get_span(position=0, content=None)</code>","text":"<p>Return the span that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Span or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_span(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the span that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Span or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:span\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_spans","title":"<code>get_spans(style=None, content=None)</code>","text":"<p>Return all the spans that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Span</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_spans(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the spans that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Span\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:span\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the family/name pair. If the argument is already a style object, it will return it.</p> <p>If the name is not the internal name but the name you gave in the desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n          'number'\n\nname_or_element -- str or Style\n\ndisplay_name -- str\n</code></pre> <p>Return: odf_style or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Element | None = None,\n    display_name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the style uniquely identified by the family/name pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is not the internal name but the name you gave in the\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                  'number'\n\n        name_or_element -- str or Style\n\n        display_name -- str\n\n    Return: odf_style or None if not found\n    \"\"\"\n    if isinstance(name_or_element, Element):\n        name = self.get_attribute(\"style:name\")\n        if name is not None:\n            return name_or_element\n        else:\n            raise ValueError(f\"Not a odf_style ? {name_or_element!r}\")\n    style_name = name_or_element\n    is_default = not (style_name or display_name)\n    tagname = self._get_style_tagname(family, is_default=is_default)\n    # famattr became None if no \"style:family\" attribute\n    if family:\n        return self._filtered_element(\n            tagname,\n            0,\n            style_name=style_name,\n            display_name=display_name,\n            family=family,\n        )\n    else:\n        return self._filtered_element(\n            tagname,\n            0,\n            draw_name=style_name or display_name,\n            family=family,\n        )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_styled_elements","title":"<code>get_styled_elements(name='')</code>","text":"<p>Brute-force to find paragraphs, tables, etc. using the given style name (or all by default).</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: list</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n    \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n    name (or all by default).\n\n    Arguments:\n\n        name -- str\n\n    Return: list\n    \"\"\"\n    # FIXME incomplete (and possibly inaccurate)\n    return (\n        self._filtered_elements(\"descendant::*\", text_style=name)\n        + self._filtered_elements(\"descendant::*\", draw_style=name)\n        + self._filtered_elements(\"descendant::*\", draw_text_style=name)\n        + self._filtered_elements(\"descendant::*\", table_style=name)\n        + self._filtered_elements(\"descendant::*\", page_layout=name)\n        + self._filtered_elements(\"descendant::*\", master_page=name)\n        + self._filtered_elements(\"descendant::*\", parent_style=name)\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change","title":"<code>get_text_change(position=0, idx=None)</code>","text":"<p>Return the text change that matches the criteria. Either single deletion (text:change) or start of range of changes (text:change-start). position : index of the element to retrieve if several matches, default is 0. idx : change-id of the element.</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change that matches the criteria. Either single\n    deletion (text:change) or start of range of changes (text:change-start).\n    position : index of the element to retrieve if several matches, default\n    is 0.\n    idx : change-id of the element.\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    if idx:\n        request = (\n            f'descendant::text:change-start[@text:change-id=\"{idx}\"] '\n            f'| descendant::text:change[@text:change-id=\"{idx}\"]'\n        )\n        return self._filtered_element(request, 0)\n    request = \"descendant::text:change-start | descendant::text:change\"\n    return self._filtered_element(request, position)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_deletion","title":"<code>get_text_change_deletion(position=0, idx=None)</code>","text":"<p>Return the text change of deletion kind that matches the criteria. Search only for the tags text:change. Consider using : get_text_change()</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_deletion(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change of deletion kind that matches the criteria.\n    Search only for the tags text:change.\n    Consider using : get_text_change()\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:change\", position, change_id=idx\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_deletions","title":"<code>get_text_change_deletions()</code>","text":"<p>Return all the text changes of deletion kind: the tags text:change. Consider using : get_text_changes()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_deletions(self) -&gt; list[Element]:\n    \"\"\"Return all the text changes of deletion kind: the tags text:change.\n    Consider using : get_text_changes()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:text:change\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_end","title":"<code>get_text_change_end(position=0, idx=None)</code>","text":"<p>Return the text change-end that matches the criteria. Search only the tags text:change-end. Consider using : get_text_change()</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_end(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change-end that matches the criteria. Search only\n    the tags text:change-end.\n    Consider using : get_text_change()\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:change-end\", position, change_id=idx\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_ends","title":"<code>get_text_change_ends()</code>","text":"<p>Return all the text change-end. Search only the tags text:change-end. Consider using : get_text_changes()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the text change-end. Search only the tags\n    text:change-end.\n    Consider using : get_text_changes()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:change-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_start","title":"<code>get_text_change_start(position=0, idx=None)</code>","text":"<p>Return the text change-start that matches the criteria. Search only the tags text:change-start. Consider using : get_text_change()</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_start(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change-start that matches the criteria. Search\n    only the tags text:change-start.\n    Consider using : get_text_change()\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:change-start\", position, change_id=idx\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_starts","title":"<code>get_text_change_starts()</code>","text":"<p>Return all the text change-start. Search only for the tags text:change-start. Consider using : get_text_changes()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_starts(self) -&gt; list[Element]:\n    \"\"\"Return all the text change-start. Search only for the tags\n    text:change-start.\n    Consider using : get_text_changes()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:change-start\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_changes","title":"<code>get_text_changes()</code>","text":"<p>Return all the text changes, either single deletion (text:change) or start of range of changes (text:change-start).</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_changes(self) -&gt; list[Element]:\n    \"\"\"Return all the text changes, either single deletion\n    (text:change) or start of range of changes (text:change-start).\n\n    Return: list of Element\n    \"\"\"\n    request = \"descendant::text:change-start | descendant::text:change\"\n    return self._filtered_elements(request)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_toc","title":"<code>get_toc(position=0, content=None)</code>","text":"<p>Return the table of contents that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: odf_toc or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_toc(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the table of contents that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: odf_toc or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"text:table-of-content\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_tocs","title":"<code>get_tocs()</code>","text":"<p>Return all the tables of contents.</p> <p>Return: list of odf_toc</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_tocs(self) -&gt; list[Element]:\n    \"\"\"Return all the tables of contents.\n\n    Return: list of odf_toc\n    \"\"\"\n    return self.get_elements(\"text:table-of-content\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_tracked_changes","title":"<code>get_tracked_changes()</code>","text":"<p>Return the tracked-changes part in the text body.</p> <p>Return: Element or None</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_tracked_changes(self) -&gt; Element | None:\n    \"\"\"Return the tracked-changes part in the text body.\n\n    Return: Element or None\n    \"\"\"\n    return self.get_element(\"//text:tracked-changes\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_defined","title":"<code>get_user_defined(name, position=0)</code>","text":"<p>return the user defined declaration for the given name.</p> <p>return: Element or none if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_defined(self, name: str, position: int = 0) -&gt; Element | None:\n    \"\"\"return the user defined declaration for the given name.\n\n    return: Element or none if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:user-defined\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_defined_list","title":"<code>get_user_defined_list()</code>","text":"<p>Return all the user defined field declarations.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_defined_list(self) -&gt; list[Element]:\n    \"\"\"Return all the user defined field declarations.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:user-defined\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_defined_value","title":"<code>get_user_defined_value(name, value_type=None)</code>","text":"<p>Return the value of the given user defined field name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nvalue_type -- 'boolean', 'date', 'float',\n              'string', 'time' or automatic\n</code></pre> <p>Return: most appropriate Python type</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_defined_value(\n    self, name: str, value_type: str | None = None\n) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n    \"\"\"Return the value of the given user defined field name.\n\n    Arguments:\n\n        name -- str\n\n        value_type -- 'boolean', 'date', 'float',\n                      'string', 'time' or automatic\n\n    Return: most appropriate Python type\n    \"\"\"\n    user_defined = self.get_user_defined(name)\n    if user_defined is None:\n        return None\n    return user_defined.get_value(value_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_decl","title":"<code>get_user_field_decl(name, position=0)</code>","text":"<p>return the user field declaration for the given name.</p> <p>return: Element or none if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_decl(self, name: str, position: int = 0) -&gt; Element | None:\n    \"\"\"return the user field declaration for the given name.\n\n    return: Element or none if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:user-field-decl\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_decl_list","title":"<code>get_user_field_decl_list()</code>","text":"<p>Return all the user field declarations.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_decl_list(self) -&gt; list[Element]:\n    \"\"\"Return all the user field declarations.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:user-field-decl\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_decls","title":"<code>get_user_field_decls()</code>","text":"<p>Return the container for user field declarations. Created if not found.</p> <p>Return: Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_decls(self) -&gt; Element | None:\n    \"\"\"Return the container for user field declarations. Created if not\n    found.\n\n    Return: Element\n    \"\"\"\n    user_field_decls = self.get_element(\"//text:user-field-decls\")\n    if user_field_decls is None:\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Empty document.body\")\n        body.insert(Element.from_tag(\"text:user-field-decls\"), FIRST_CHILD)\n        user_field_decls = body.get_element(\"//text:user-field-decls\")\n\n    return user_field_decls\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_value","title":"<code>get_user_field_value(name, value_type=None)</code>","text":"<p>Return the value of the given user field name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nvalue_type -- 'boolean', 'currency', 'date', 'float',\n              'percentage', 'string', 'time' or automatic\n</code></pre> <p>Return: most appropriate Python type</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_value(\n    self, name: str, value_type: str | None = None\n) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n    \"\"\"Return the value of the given user field name.\n\n    Arguments:\n\n        name -- str\n\n        value_type -- 'boolean', 'currency', 'date', 'float',\n                      'percentage', 'string', 'time' or automatic\n\n    Return: most appropriate Python type\n    \"\"\"\n    user_field_decl = self.get_user_field_decl(name)\n    if user_field_decl is None:\n        return None\n    return user_field_decl.get_value(value_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_decl","title":"<code>get_variable_decl(name, position=0)</code>","text":"<p>return the variable declaration for the given name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nposition -- int\n</code></pre> <p>return: Element or none if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_decl(self, name: str, position: int = 0) -&gt; Element | None:\n    \"\"\"return the variable declaration for the given name.\n\n    Arguments:\n\n        name -- str\n\n        position -- int\n\n    return: Element or none if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:variable-decl\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_decl_list","title":"<code>get_variable_decl_list()</code>","text":"<p>Return all the variable declarations.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_decl_list(self) -&gt; list[Element]:\n    \"\"\"Return all the variable declarations.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:variable-decl\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_decls","title":"<code>get_variable_decls()</code>","text":"<p>Return the container for variable declarations. Created if not found.</p> <p>Return: Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_decls(self) -&gt; Element:\n    \"\"\"Return the container for variable declarations. Created if not\n    found.\n\n    Return: Element\n    \"\"\"\n    variable_decls = self.get_element(\"//text:variable-decls\")\n    if variable_decls is None:\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Empty document.body\")\n        body.insert(Element.from_tag(\"text:variable-decls\"), FIRST_CHILD)\n        variable_decls = body.get_element(\"//text:variable-decls\")\n\n    return variable_decls  # type:ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_set","title":"<code>get_variable_set(name, position=-1)</code>","text":"<p>Return the variable set for the given name (last one by default).</p> <p>Arguments:</p> <pre><code>name -- str\n\nposition -- int\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_set(self, name: str, position: int = -1) -&gt; Element | None:\n    \"\"\"Return the variable set for the given name (last one by default).\n\n    Arguments:\n\n        name -- str\n\n        position -- int\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:variable-set\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_set_value","title":"<code>get_variable_set_value(name, value_type=None)</code>","text":"<p>Return the last value of the given variable name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nvalue_type -- 'boolean', 'currency', 'date', 'float',\n              'percentage', 'string', 'time' or automatic\n</code></pre> <p>Return: most appropriate Python type</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_set_value(\n    self,\n    name: str,\n    value_type: str | None = None,\n) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n    \"\"\"Return the last value of the given variable name.\n\n    Arguments:\n\n        name -- str\n\n        value_type -- 'boolean', 'currency', 'date', 'float',\n                      'percentage', 'string', 'time' or automatic\n\n    Return: most appropriate Python type\n    \"\"\"\n    variable_set = self.get_variable_set(name)\n    if not variable_set:\n        return None\n    return variable_set.get_value(value_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_sets","title":"<code>get_variable_sets(name=None)</code>","text":"<p>Return all the variable sets that match the criteria.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_sets(self, name: str | None = None) -&gt; list[Element]:\n    \"\"\"Return all the variable sets that match the criteria.\n\n    Arguments:\n\n        name -- str\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:variable-set\", text_name=name)\n</code></pre>"},{"location":"reference.html#odfdo.Element.index","title":"<code>index(child)</code>","text":"<p>Return the position of the child in this element.</p> <p>Inspired by lxml</p> Source code in <code>odfdo/element.py</code> <pre><code>def index(self, child: Element) -&gt; int:\n    \"\"\"Return the position of the child in this element.\n\n    Inspired by lxml\n    \"\"\"\n    return self.__element.index(child.__element)\n</code></pre>"},{"location":"reference.html#odfdo.Element.insert","title":"<code>insert(element, xmlposition=None, position=None, start=False)</code>","text":"<p>Insert an element relatively to ourself.</p> <p>Insert either using DOM vocabulary or by numeric position. If text start is True, insert the element before any existing text.</p> <p>Position start at 0.</p> <p>Arguments:</p> <pre><code>element -- Element\n\nxmlposition -- FIRST_CHILD, LAST_CHILD, NEXT_SIBLING\n               or PREV_SIBLING\n\nstart -- Boolean\n\nposition -- int\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def insert(\n    self,\n    element: Element,\n    xmlposition: int | None = None,\n    position: int | None = None,\n    start: bool = False,\n) -&gt; None:\n    \"\"\"Insert an element relatively to ourself.\n\n    Insert either using DOM vocabulary or by numeric position.\n    If text start is True, insert the element before any existing text.\n\n    Position start at 0.\n\n    Arguments:\n\n        element -- Element\n\n        xmlposition -- FIRST_CHILD, LAST_CHILD, NEXT_SIBLING\n                       or PREV_SIBLING\n\n        start -- Boolean\n\n        position -- int\n    \"\"\"\n    # child_tag = element.tag\n    current = self.__element\n    _element = element.__element\n    if start:\n        text = current.text\n        if text is not None:\n            current.text = None\n            tail = _element.tail\n            if tail is None:\n                tail = text\n            else:\n                tail = tail + text\n            _element.tail = tail\n        position = 0\n    if position is not None:\n        current.insert(position, _element)\n    elif xmlposition is FIRST_CHILD:\n        current.insert(0, _element)\n    elif xmlposition is LAST_CHILD:\n        current.append(_element)\n    elif xmlposition is NEXT_SIBLING:\n        parent = current.getparent()\n        index = parent.index(current)  # type: ignore\n        parent.insert(index + 1, _element)  # type: ignore\n    elif xmlposition is PREV_SIBLING:\n        parent = current.getparent()\n        index = parent.index(current)  # type: ignore\n        parent.insert(index, _element)  # type: ignore\n    else:\n        raise ValueError(\"(xml)position must be defined\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.is_empty","title":"<code>is_empty()</code>","text":"<p>Check if the element is empty : no text, no children, no tail.</p> <p>Return: Boolean</p> Source code in <code>odfdo/element.py</code> <pre><code>def is_empty(self) -&gt; bool:\n    \"\"\"Check if the element is empty : no text, no children, no tail.\n\n    Return: Boolean\n    \"\"\"\n    element = self.__element\n    if element.tail is not None:\n        return False\n    if element.text is not None:\n        return False\n    if list(element.iterchildren()):\n        return False\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Element.match","title":"<code>match(pattern)</code>","text":"<p>return True if the pattern is found one or more times anywhere in the text content of the element.</p> <p>Python regular expression syntax applies.</p> <p>Arguments:</p> <pre><code>pattern -- str\n</code></pre> <p>Return: bool</p> Source code in <code>odfdo/element.py</code> <pre><code>def match(self, pattern: str) -&gt; bool:\n    \"\"\"return True if the pattern is found one or more times anywhere in\n    the text content of the element.\n\n    Python regular expression syntax applies.\n\n    Arguments:\n\n        pattern -- str\n\n    Return: bool\n    \"\"\"\n    return self.search(pattern) is not None\n</code></pre>"},{"location":"reference.html#odfdo.Element.replace","title":"<code>replace(pattern, new=None)</code>","text":"<p>Replace the pattern with the given text, or delete if text is an empty string, and return the number of replacements. By default, only return the number of occurences that would be replaced.</p> <p>It cannot replace patterns found across several element, like a word split into two consecutive spans.</p> <p>Python regular expression syntax applies.</p> <p>Arguments:</p> <pre><code>pattern -- str\n\nnew -- str\n</code></pre> <p>Return: int</p> Source code in <code>odfdo/element.py</code> <pre><code>def replace(self, pattern: str, new: str | None = None) -&gt; int:\n    \"\"\"Replace the pattern with the given text, or delete if text is an\n    empty string, and return the number of replacements. By default, only\n    return the number of occurences that would be replaced.\n\n    It cannot replace patterns found across several element, like a word\n    split into two consecutive spans.\n\n    Python regular expression syntax applies.\n\n    Arguments:\n\n        pattern -- str\n\n        new -- str\n\n    Return: int\n    \"\"\"\n    if not isinstance(pattern, str):\n        # Fail properly if the pattern is an non-ascii bytestring\n        pattern = str(pattern)\n    cpattern = re.compile(pattern)\n    count = 0\n    for text in self.xpath(\"descendant::text()\"):\n        if new is None:\n            count += len(cpattern.findall(str(text)))\n        else:\n            new_text, number = cpattern.subn(new, str(text))\n            container = text.parent\n            if text.is_text():  # type: ignore\n                container.text = new_text  # type: ignore\n            else:\n                container.tail = new_text  # type: ignore\n            count += number\n    return count\n</code></pre>"},{"location":"reference.html#odfdo.Element.replace_element","title":"<code>replace_element(old_element, new_element)</code>","text":"<p>Replaces in place a sub element with the element passed as second argument.</p> <p>Warning : no clone for old element.</p> Source code in <code>odfdo/element.py</code> <pre><code>def replace_element(self, old_element: Element, new_element: Element) -&gt; None:\n    \"\"\"Replaces in place a sub element with the element passed as second\n    argument.\n\n    Warning : no clone for old element.\n    \"\"\"\n    current = self.__element\n    current.replace(old_element.__element, new_element.__element)\n</code></pre>"},{"location":"reference.html#odfdo.Element.search","title":"<code>search(pattern)</code>","text":"<p>Return the first position of the pattern in the text content of the element, or None if not found.</p> <p>Python regular expression syntax applies.</p> <p>Arguments:</p> <pre><code>pattern -- str\n</code></pre> <p>Return: int or None</p> Source code in <code>odfdo/element.py</code> <pre><code>def search(self, pattern: str) -&gt; int | None:\n    \"\"\"Return the first position of the pattern in the text content of\n    the element, or None if not found.\n\n    Python regular expression syntax applies.\n\n    Arguments:\n\n        pattern -- str\n\n    Return: int or None\n    \"\"\"\n    match = re.search(pattern, self.text_recursive)\n    if match is None:\n        return None\n    return match.start()\n</code></pre>"},{"location":"reference.html#odfdo.Element.serialize","title":"<code>serialize(pretty=False, with_ns=False)</code>","text":"<p>Return text serialization of XML element.</p> Source code in <code>odfdo/element.py</code> <pre><code>def serialize(self, pretty: bool = False, with_ns: bool = False) -&gt; str:\n    \"\"\"Return text serialization of XML element.\"\"\"\n    # This copy bypasses serialization side-effects in lxml\n    native = deepcopy(self.__element)\n    data = tostring(\n        native, with_tail=False, pretty_print=pretty, encoding=\"unicode\"\n    )\n    if with_ns:\n        return data\n    # Remove namespaces\n    return self._strip_namespaces(data)\n</code></pre>"},{"location":"reference.html#odfdo.Element.set_style_attribute","title":"<code>set_style_attribute(name, value)</code>","text":"<p>Shortcut to accept a style object as a value.</p> Source code in <code>odfdo/element.py</code> <pre><code>def set_style_attribute(self, name: str, value: Element | str) -&gt; None:\n    \"\"\"Shortcut to accept a style object as a value.\"\"\"\n    if isinstance(value, Element):\n        value = str(value.name)  # type:ignore\n    return self.set_attribute(name, value)\n</code></pre>"},{"location":"reference.html#odfdo.Element.strip_elements","title":"<code>strip_elements(sub_elements)</code>","text":"<p>Remove the tags of provided elements, keeping inner childs and text.</p> <p>Return : the striped element.</p> <p>Warning : no clone in sub_elements list.</p> <p>Arguments:</p> <pre><code>sub_elements -- Element or list of Element\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def strip_elements(\n    self,\n    sub_elements: Element | Iterable[Element],\n) -&gt; Element | list:\n    \"\"\"Remove the tags of provided elements, keeping inner childs and text.\n\n    Return : the striped element.\n\n    Warning : no clone in sub_elements list.\n\n    Arguments:\n\n        sub_elements -- Element or list of Element\n    \"\"\"\n    if not sub_elements:\n        return self\n    if isinstance(sub_elements, Element):\n        sub_elements = (sub_elements,)\n    replacer = _get_lxml_tag(\"text:this-will-be-removed\")\n    for element in sub_elements:\n        element.__element.tag = replacer\n    strip = (\"text:this-will-be-removed\",)\n    return self.strip_tags(strip=strip, default=None)\n</code></pre>"},{"location":"reference.html#odfdo.Element.strip_tags","title":"<code>strip_tags(strip=None, protect=None, default='text:p')</code>","text":"<p>Remove the tags listed in strip, recursively, keeping inner childs and text. Tags listed in protect stop the removal one level depth. If the first level element is stripped, default is used to embed the content in the default element. If default is None and first level is striped, a list of text and children is returned. Return : the striped element.</p> <p>strip_tags should be used by on purpose methods (strip_span \u2026) (Method name taken from lxml).</p> <p>Arguments:</p> <pre><code>strip -- iterable list of str odf tags, or None\n\nprotect -- iterable list of str odf tags, or None\n\ndefault -- str odf tag, or None\n</code></pre> <p>Return:</p> <pre><code>Element.\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def strip_tags(\n    self,\n    strip: Iterable[str] | None = None,\n    protect: Iterable[str] | None = None,\n    default: str | None = \"text:p\",\n) -&gt; Element | list:\n    \"\"\"Remove the tags listed in strip, recursively, keeping inner childs\n    and text. Tags listed in protect stop the removal one level depth. If\n    the first level element is stripped, default is used to embed the\n    content in the default element. If default is None and first level is\n    striped, a list of text and children is returned. Return : the striped\n    element.\n\n    strip_tags should be used by on purpose methods (strip_span ...)\n    (Method name taken from lxml).\n\n    Arguments:\n\n        strip -- iterable list of str odf tags, or None\n\n        protect -- iterable list of str odf tags, or None\n\n        default -- str odf tag, or None\n\n    Return:\n\n        Element.\n    \"\"\"\n    if not strip:\n        return self\n    if not protect:\n        protect = ()\n    protected = False\n    element, modified = Element._strip_tags(self, strip, protect, protected)\n    if modified and isinstance(element, list) and default:\n        new = Element.from_tag(default)\n        for content in element:\n            if isinstance(content, Element):\n                new.append(content)\n            else:\n                new.text = content\n        element = new\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Element.xpath","title":"<code>xpath(xpath_query)</code>","text":"<p>Apply XPath query to the element and its subtree. Return list of Element or EText instances translated from the nodes found.</p> Source code in <code>odfdo/element.py</code> <pre><code>def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n    \"\"\"Apply XPath query to the element and its subtree. Return list of\n    Element or EText instances translated from the nodes found.\n    \"\"\"\n    element = self.__element\n    xpath_instance = xpath_compile(xpath_query)\n    elements = xpath_instance(element)\n    result: list[Element | EText] = []\n    if hasattr(elements, \"__iter__\"):\n        for obj in elements:  # type: ignore\n            if isinstance(obj, (str, bytes)):\n                result.append(EText(obj))\n            elif isinstance(obj, _Element):\n                result.append(Element.from_tag(obj))\n            # else:\n            #     result.append(obj)\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.ElementTyped","title":"<code>ElementTyped</code>","text":"<p>             Bases: <code>Element</code></p> Source code in <code>odfdo/element_typed.py</code> <pre><code>class ElementTyped(Element):\n    def set_value_and_type(  # noqa: C901\n        self,\n        value: Any,\n        value_type: str | None = None,\n        text: str | None = None,\n        currency: str | None = None,\n    ) -&gt; str | None:\n        # Remove possible previous value and type\n        for name in (\n            \"office:value-type\",\n            \"office:boolean-value\",\n            \"office:value\",\n            \"office:date-value\",\n            \"office:string-value\",\n            \"office:time-value\",\n            \"table:formula\",\n            \"office:currency\",\n            \"calcext:value-type\",\n            \"loext:value-type\",\n        ):\n            with contextlib.suppress(KeyError):\n                self.del_attribute(name)\n        if isinstance(value, bytes):\n            value = bytes_to_str(value)\n        if isinstance(value_type, bytes):\n            value_type = bytes_to_str(value_type)\n        if isinstance(text, bytes):\n            text = bytes_to_str(text)\n        if isinstance(currency, bytes):\n            currency = bytes_to_str(currency)\n        if value is None:\n            self._erase_text_content()\n            return text\n        if isinstance(value, bool):\n            if value_type is None:\n                value_type = \"boolean\"\n            if text is None:\n                text = \"true\" if value else \"false\"\n            value = Boolean.encode(value)\n        elif isinstance(value, (int, float, Decimal)):\n            if value_type == \"percentage\":\n                text = \"%d %%\" % int(value * 100)\n            if value_type is None:\n                value_type = \"float\"\n            if text is None:\n                text = str(value)\n            value = str(value)\n        elif isinstance(value, datetime):\n            if value_type is None:\n                value_type = \"date\"\n            if text is None:\n                text = str(DateTime.encode(value))\n            value = DateTime.encode(value)\n        elif isinstance(value, date):\n            if value_type is None:\n                value_type = \"date\"\n            if text is None:\n                text = str(Date.encode(value))\n            value = Date.encode(value)\n        elif isinstance(value, str):\n            if value_type is None:\n                value_type = \"string\"\n            if text is None:\n                text = value\n        elif isinstance(value, timedelta):\n            if value_type is None:\n                value_type = \"time\"\n            if text is None:\n                text = str(Duration.encode(value))\n            value = Duration.encode(value)\n        elif value is not None:\n            raise TypeError(f\"Type unknown: '{value!r}'\")\n\n        if value_type is not None:\n            self.set_attribute(\"office:value-type\", value_type)\n            self.set_attribute(\"calcext:value-type\", value_type)\n        if value_type == \"boolean\":\n            self.set_attribute(\"office:boolean-value\", value)\n        elif value_type == \"currency\":\n            self.set_attribute(\"office:value\", value)\n            self.set_attribute(\"office:currency\", currency)\n        elif value_type == \"date\":\n            self.set_attribute(\"office:date-value\", value)\n        elif value_type in (\"float\", \"percentage\"):\n            self.set_attribute(\"office:value\", value)\n            self.set_attribute(\"calcext:value\", value)\n        elif value_type == \"string\":\n            self.set_attribute(\"office:string-value\", value)\n        elif value_type == \"time\":\n            self.set_attribute(\"office:time-value\", value)\n\n        return text\n\n    def _get_typed_value(  # noqa: C901\n        self,\n        value_type: str | None = None,\n        try_get_text: bool = True,\n    ) -&gt; tuple[Any, str | None]:\n        \"\"\"Return Python typed value.\n\n        Only for \"with office:value-type\" elements, not for meta fields.\"\"\"\n        value: Decimal | str | bool | None = None\n        if value_type is None:\n            read_value_type = self.get_attribute(\"office:value-type\")\n            if isinstance(read_value_type, bool):\n                raise TypeError(\n                    f'Wrong type for \"office:value-type\": {type(read_value_type)}'\n                )\n            value_type = read_value_type\n        # value_type = to_str(value_type)\n        if value_type == \"boolean\":\n            value = self.get_attribute(\"office:boolean-value\")\n            return (value, value_type)\n        if value_type in {\"float\", \"percentage\", \"currency\"}:\n            read_number = self.get_attribute(\"office:value\")\n            if not isinstance(read_number, (Decimal, str)):\n                raise TypeError(f'Wrong type for \"office:value\": {type(read_number)}')\n            value = Decimal(read_number)\n            # Return 3 instead of 3.0 if possible\n            with contextlib.suppress(ValueError):\n                if int(value) == value:\n                    return (int(value), value_type)\n            return (value, value_type)\n        if value_type == \"date\":\n            read_attribute = self.get_attribute(\"office:date-value\")\n            if not isinstance(read_attribute, str):\n                raise TypeError(\n                    f'Wrong type for \"office:date-value\": {type(read_attribute)}'\n                )\n            if \"T\" in read_attribute:\n                return (DateTime.decode(read_attribute), value_type)\n            return (Date.decode(read_attribute), value_type)\n        if value_type == \"string\":\n            value = self.get_attribute(\"office:string-value\")\n            if value is not None:\n                return (str(value), value_type)\n            if try_get_text:\n                list_value = [\n                    para.text_recursive for para in self.get_elements(\"text:p\")\n                ]\n                if list_value:\n                    return (\"\\n\".join(list_value), value_type)\n            return (None, value_type)\n        if value_type == \"time\":\n            read_value = self.get_attribute(\"office:time-value\")\n            if not isinstance(read_value, str):\n                raise TypeError(\n                    f'Wrong type for \"office:time-value\": {type(read_value)}'\n                )\n            time_value = Duration.decode(read_value)\n            return (time_value, value_type)\n        if value_type is None:\n            return (None, None)\n        raise ValueError(f'Unexpected value type: \"{value_type}\"')\n\n    def get_value(\n        self,\n        value_type: str | None = None,\n        try_get_text: bool = True,\n        get_type: bool = False,\n    ) -&gt; Any | tuple[Any, str]:\n        \"\"\"Return Python typed value.\n\n        Only for \"with office:value-type\" elements, not for meta fields.\"\"\"\n        if get_type:\n            return self._get_typed_value(\n                value_type=value_type,\n                try_get_text=try_get_text,\n            )\n        return self._get_typed_value(\n            value_type=value_type,\n            try_get_text=try_get_text,\n        )[0]\n</code></pre>"},{"location":"reference.html#odfdo.ElementTyped.get_value","title":"<code>get_value(value_type=None, try_get_text=True, get_type=False)</code>","text":"<p>Return Python typed value.</p> <p>Only for \u201cwith office:value-type\u201d elements, not for meta fields.</p> Source code in <code>odfdo/element_typed.py</code> <pre><code>def get_value(\n    self,\n    value_type: str | None = None,\n    try_get_text: bool = True,\n    get_type: bool = False,\n) -&gt; Any | tuple[Any, str]:\n    \"\"\"Return Python typed value.\n\n    Only for \"with office:value-type\" elements, not for meta fields.\"\"\"\n    if get_type:\n        return self._get_typed_value(\n            value_type=value_type,\n            try_get_text=try_get_text,\n        )\n    return self._get_typed_value(\n        value_type=value_type,\n        try_get_text=try_get_text,\n    )[0]\n</code></pre>"},{"location":"reference.html#odfdo.EllipseShape","title":"<code>EllipseShape</code>","text":"<p>             Bases: <code>ShapeBase</code></p> <p>Create a ellipse shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\nposition -- (str, str)\n\nsize -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class EllipseShape(ShapeBase):\n    \"\"\"Create a ellipse shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        position -- (str, str)\n\n        size -- (str, str)\n\n    \"\"\"\n\n    _tag = \"draw:ellipse\"\n    _properties: tuple[PropDef, ...] = ()\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        position: tuple | None = None,\n        size: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n                \"size\": size,\n                \"position\": position,\n            }\n        )\n        super().__init__(**kwargs)\n</code></pre>"},{"location":"reference.html#odfdo.Frame","title":"<code>Frame</code>","text":"<p>             Bases: <code>Element</code>, <code>AnchorMix</code>, <code>PosMix</code>, <code>ZMix</code>, <code>SizeMix</code></p> <p>ODF Frame \u201cdraw:frame\u201d</p> <p>Frames are not useful by themselves. You should consider calling Frame.image_frame() or Frame.text_frame directly.</p> Source code in <code>odfdo/frame.py</code> <pre><code>class Frame(Element, AnchorMix, PosMix, ZMix, SizeMix):\n    \"\"\"ODF Frame \"draw:frame\"\n\n    Frames are not useful by themselves. You should consider calling\n    Frame.image_frame() or Frame.text_frame directly.\n    \"\"\"\n\n    _tag = \"draw:frame\"\n    _properties = (\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"draw_id\", \"draw:id\"),\n        PropDef(\"width\", \"svg:width\"),\n        PropDef(\"height\", \"svg:height\"),\n        PropDef(\"style\", \"draw:style-name\"),\n        PropDef(\"pos_x\", \"svg:x\"),\n        PropDef(\"pos_y\", \"svg:y\"),\n        PropDef(\"presentation_class\", \"presentation:class\"),\n        PropDef(\"layer\", \"draw:layer\"),\n        PropDef(\"presentation_style\", \"presentation:style-name\"),\n    )\n\n    def __init__(  # noqa:  C901\n        self,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        size: tuple = (\"1cm\", \"1cm\"),\n        z_index: int = 0,\n        presentation_class: str | None = None,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        layer: str | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a frame element of the given size. Position is relative to the\n        context the frame is inserted in. If positioned by page, give the page\n        number and the x, y position.\n\n        Size is a (width, height) tuple and position is a (left, top) tuple; items\n        are strings including the unit, e.g. ('10cm', '15cm').\n\n        Frames are not useful by themselves. You should consider calling:\n            Frame.image_frame()\n        or\n            Frame.text_frame()\n\n\n        Arguments:\n\n            name -- str\n\n            draw_id -- str\n\n            style -- str\n\n            position -- (str, str)\n\n            size -- (str, str)\n\n            z_index -- int (default 0)\n\n            presentation_class -- str\n\n            anchor_type -- 'page', 'frame', 'paragraph', 'char' or 'as-char'\n\n            anchor_page -- int, page number is anchor_type is 'page'\n\n            layer -- str\n\n            presentation_style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.size = size\n            self.z_index = z_index\n            if name:\n                self.name = name\n            if draw_id is not None:\n                self.draw_id = draw_id\n            if style is not None:\n                self.style = style\n            if position is not None:\n                self.position = position\n            if presentation_class is not None:\n                self.presentation_class = presentation_class\n            if anchor_type:\n                self.anchor_type = anchor_type\n            if position and not anchor_type:\n                self.anchor_type = \"paragraph\"\n            if anchor_page is not None:\n                self.anchor_page = anchor_page\n            if layer is not None:\n                self.layer = layer\n            if presentation_style is not None:\n                self.presentation_style = presentation_style\n\n    @classmethod\n    def image_frame(\n        cls,\n        image: Element | str,\n        text: str | None = None,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        size: tuple = (\"1cm\", \"1cm\"),\n        z_index: int = 0,\n        presentation_class: str | None = None,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        layer: str | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; Element:\n        \"\"\"Create a ready-to-use image, since image must be embedded in a\n        frame.\n\n        The optionnal text will appear above the image.\n\n        Arguments:\n\n            image -- DrawImage or str, DrawImage element or URL of the image\n\n            text -- str, text for the image\n\n            See Frame() initialization for the other arguments\n\n        Return: Frame\n        \"\"\"\n        frame = cls(\n            name=name,\n            draw_id=draw_id,\n            style=style,\n            position=position,\n            size=size,\n            z_index=z_index,\n            presentation_class=presentation_class,\n            anchor_type=anchor_type,\n            anchor_page=anchor_page,\n            layer=layer,\n            presentation_style=presentation_style,\n            **kwargs,\n        )\n        image_element = frame.set_image(image)\n        if text:\n            image_element.text_content = text\n        return frame\n\n    @classmethod\n    def text_frame(\n        cls,\n        text_or_element: Iterable[Element] | Element | str,\n        text_style: str | None = None,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        size: tuple = (\"1cm\", \"1cm\"),\n        z_index: int = 0,\n        presentation_class: str | None = None,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        layer: str | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; Element:\n        \"\"\"Create a ready-to-use text box, since text box must be embedded in\n        a frame.\n\n        The optionnal text will appear above the image.\n\n        Arguments:\n\n            text_or_element -- str or Element, or list of them, text content\n                               of the text box.\n\n            text_style -- str, name of the style for the text\n\n            See Frame() initialization for the other arguments\n\n        Return: Frame\n        \"\"\"\n        frame = cls(\n            name=name,\n            draw_id=draw_id,\n            style=style,\n            position=position,\n            size=size,\n            z_index=z_index,\n            presentation_class=presentation_class,\n            anchor_type=anchor_type,\n            anchor_page=anchor_page,\n            layer=layer,\n            presentation_style=presentation_style,\n            **kwargs,\n        )\n        frame.set_text_box(text_or_element, text_style)\n        return frame\n\n    @property\n    def text_content(self) -&gt; str:\n        text_box = self.get_element(\"draw:text-box\")\n        if text_box is None:\n            return \"\"\n        return text_box.text_content\n\n    @text_content.setter\n    def text_content(self, text_or_element: Element | str) -&gt; None:\n        text_box = self.get_element(\"draw:text-box\")\n        if text_box is None:\n            text_box = Element.from_tag(\"draw:text-box\")\n            self.append(text_box)\n        if isinstance(text_or_element, Element):\n            text_box.clear()\n            text_box.append(text_or_element)\n        else:\n            text_box.text_content = text_or_element\n\n    def get_image(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        return self.get_element(\"draw:image\")\n\n    def set_image(self, url_or_element: Element | str) -&gt; Element:\n        image = self.get_image()\n        if image is None:\n            if isinstance(url_or_element, Element):\n                image = url_or_element\n                self.append(image)\n            else:\n                image = DrawImage(url_or_element)\n                self.append(image)\n        else:\n            if isinstance(url_or_element, Element):\n                image.delete()\n                image = url_or_element\n                self.append(image)\n            else:\n                image.set_url(url_or_element)  # type: ignore\n        return image\n\n    def get_text_box(self) -&gt; Element | None:\n        return self.get_element(\"draw:text-box\")\n\n    def set_text_box(\n        self,\n        text_or_element: Iterable[Element | str] | Element | str,\n        text_style: str | None = None,\n    ) -&gt; Element:\n        text_box = self.get_text_box()\n        if text_box is None:\n            text_box = Element.from_tag(\"draw:text-box\")\n            self.append(text_box)\n        else:\n            text_box.clear()\n        if isinstance(text_or_element, (Element, str)):\n            text_or_element_list: Iterable[Element | str] = [text_or_element]\n        else:\n            text_or_element_list = text_or_element\n        for item in text_or_element_list:\n            if isinstance(item, str):\n                text_box.append(Paragraph(item, style=text_style))\n            else:\n                text_box.append(item)\n        return text_box\n\n    @staticmethod\n    def _get_formatted_text_subresult(context: dict, element: Element) -&gt; str:\n        str_list = [\"  \"]\n        for child in element.children:\n            str_list.append(child.get_formatted_text(context))\n        subresult = \"\".join(str_list)\n        subresult = subresult.replace(\"\\n\", \"\\n  \")\n        return subresult.rstrip(\" \")\n\n    def get_formatted_text(  # noqa:  C901\n        self,\n        context: dict | None = None,\n    ) -&gt; str:\n        if not context:\n            context = {}\n        result = []\n        for element in self.children:\n            tag = element.tag\n            if tag == \"draw:image\":\n                if context[\"rst_mode\"]:\n                    filename = element.get_attribute(\"xlink:href\")\n\n                    # Compute width and height\n                    width, height = self.size\n                    if width is not None:\n                        width = Unit(width)\n                        width = width.convert(\"px\", DPI)\n                    if height is not None:\n                        height = Unit(height)\n                        height = height.convert(\"px\", DPI)\n\n                    # Insert or not ?\n                    if context[\"no_img_level\"]:\n                        context[\"img_counter\"] += 1\n                        ref = f\"|img{context['img_counter']}|\"\n                        result.append(ref)\n                        context[\"images\"].append((ref, filename, (width, height)))\n                    else:\n                        result.append(f\"\\n.. image:: {filename}\\n\")\n                        if width is not None:\n                            result.append(f\"   :width: {width}\\n\")\n                        if height is not None:\n                            result.append(f\"   :height: {height}\\n\")\n                else:\n                    result.append(f\"[Image {element.get_attribute('xlink:href')}]\\n\")\n            elif tag == \"draw:text-box\":\n                result.append(self._get_formatted_text_subresult(context, element))\n            else:\n                result.append(element.get_formatted_text(context))\n        result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.Frame.__init__","title":"<code>__init__(name=None, draw_id=None, style=None, position=None, size=('1cm', '1cm'), z_index=0, presentation_class=None, anchor_type=None, anchor_page=None, layer=None, presentation_style=None, **kwargs)</code>","text":"<p>Create a frame element of the given size. Position is relative to the context the frame is inserted in. If positioned by page, give the page number and the x, y position.</p> <p>Size is a (width, height) tuple and position is a (left, top) tuple; items are strings including the unit, e.g. (\u201810cm\u2019, \u201815cm\u2019).</p> <p>Frames are not useful by themselves. You should consider calling:     Frame.image_frame() or     Frame.text_frame()</p> <p>Arguments:</p> <pre><code>name -- str\n\ndraw_id -- str\n\nstyle -- str\n\nposition -- (str, str)\n\nsize -- (str, str)\n\nz_index -- int (default 0)\n\npresentation_class -- str\n\nanchor_type -- 'page', 'frame', 'paragraph', 'char' or 'as-char'\n\nanchor_page -- int, page number is anchor_type is 'page'\n\nlayer -- str\n\npresentation_style -- str\n</code></pre> Source code in <code>odfdo/frame.py</code> <pre><code>def __init__(  # noqa:  C901\n    self,\n    name: str | None = None,\n    draw_id: str | None = None,\n    style: str | None = None,\n    position: tuple | None = None,\n    size: tuple = (\"1cm\", \"1cm\"),\n    z_index: int = 0,\n    presentation_class: str | None = None,\n    anchor_type: str | None = None,\n    anchor_page: int | None = None,\n    layer: str | None = None,\n    presentation_style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a frame element of the given size. Position is relative to the\n    context the frame is inserted in. If positioned by page, give the page\n    number and the x, y position.\n\n    Size is a (width, height) tuple and position is a (left, top) tuple; items\n    are strings including the unit, e.g. ('10cm', '15cm').\n\n    Frames are not useful by themselves. You should consider calling:\n        Frame.image_frame()\n    or\n        Frame.text_frame()\n\n\n    Arguments:\n\n        name -- str\n\n        draw_id -- str\n\n        style -- str\n\n        position -- (str, str)\n\n        size -- (str, str)\n\n        z_index -- int (default 0)\n\n        presentation_class -- str\n\n        anchor_type -- 'page', 'frame', 'paragraph', 'char' or 'as-char'\n\n        anchor_page -- int, page number is anchor_type is 'page'\n\n        layer -- str\n\n        presentation_style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.size = size\n        self.z_index = z_index\n        if name:\n            self.name = name\n        if draw_id is not None:\n            self.draw_id = draw_id\n        if style is not None:\n            self.style = style\n        if position is not None:\n            self.position = position\n        if presentation_class is not None:\n            self.presentation_class = presentation_class\n        if anchor_type:\n            self.anchor_type = anchor_type\n        if position and not anchor_type:\n            self.anchor_type = \"paragraph\"\n        if anchor_page is not None:\n            self.anchor_page = anchor_page\n        if layer is not None:\n            self.layer = layer\n        if presentation_style is not None:\n            self.presentation_style = presentation_style\n</code></pre>"},{"location":"reference.html#odfdo.Frame.image_frame","title":"<code>image_frame(image, text=None, name=None, draw_id=None, style=None, position=None, size=('1cm', '1cm'), z_index=0, presentation_class=None, anchor_type=None, anchor_page=None, layer=None, presentation_style=None, **kwargs)</code>  <code>classmethod</code>","text":"<p>Create a ready-to-use image, since image must be embedded in a frame.</p> <p>The optionnal text will appear above the image.</p> <p>Arguments:</p> <pre><code>image -- DrawImage or str, DrawImage element or URL of the image\n\ntext -- str, text for the image\n\nSee Frame() initialization for the other arguments\n</code></pre> <p>Return: Frame</p> Source code in <code>odfdo/frame.py</code> <pre><code>@classmethod\ndef image_frame(\n    cls,\n    image: Element | str,\n    text: str | None = None,\n    name: str | None = None,\n    draw_id: str | None = None,\n    style: str | None = None,\n    position: tuple | None = None,\n    size: tuple = (\"1cm\", \"1cm\"),\n    z_index: int = 0,\n    presentation_class: str | None = None,\n    anchor_type: str | None = None,\n    anchor_page: int | None = None,\n    layer: str | None = None,\n    presentation_style: str | None = None,\n    **kwargs: Any,\n) -&gt; Element:\n    \"\"\"Create a ready-to-use image, since image must be embedded in a\n    frame.\n\n    The optionnal text will appear above the image.\n\n    Arguments:\n\n        image -- DrawImage or str, DrawImage element or URL of the image\n\n        text -- str, text for the image\n\n        See Frame() initialization for the other arguments\n\n    Return: Frame\n    \"\"\"\n    frame = cls(\n        name=name,\n        draw_id=draw_id,\n        style=style,\n        position=position,\n        size=size,\n        z_index=z_index,\n        presentation_class=presentation_class,\n        anchor_type=anchor_type,\n        anchor_page=anchor_page,\n        layer=layer,\n        presentation_style=presentation_style,\n        **kwargs,\n    )\n    image_element = frame.set_image(image)\n    if text:\n        image_element.text_content = text\n    return frame\n</code></pre>"},{"location":"reference.html#odfdo.Frame.text_frame","title":"<code>text_frame(text_or_element, text_style=None, name=None, draw_id=None, style=None, position=None, size=('1cm', '1cm'), z_index=0, presentation_class=None, anchor_type=None, anchor_page=None, layer=None, presentation_style=None, **kwargs)</code>  <code>classmethod</code>","text":"<p>Create a ready-to-use text box, since text box must be embedded in a frame.</p> <p>The optionnal text will appear above the image.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or Element, or list of them, text content\n                   of the text box.\n\ntext_style -- str, name of the style for the text\n\nSee Frame() initialization for the other arguments\n</code></pre> <p>Return: Frame</p> Source code in <code>odfdo/frame.py</code> <pre><code>@classmethod\ndef text_frame(\n    cls,\n    text_or_element: Iterable[Element] | Element | str,\n    text_style: str | None = None,\n    name: str | None = None,\n    draw_id: str | None = None,\n    style: str | None = None,\n    position: tuple | None = None,\n    size: tuple = (\"1cm\", \"1cm\"),\n    z_index: int = 0,\n    presentation_class: str | None = None,\n    anchor_type: str | None = None,\n    anchor_page: int | None = None,\n    layer: str | None = None,\n    presentation_style: str | None = None,\n    **kwargs: Any,\n) -&gt; Element:\n    \"\"\"Create a ready-to-use text box, since text box must be embedded in\n    a frame.\n\n    The optionnal text will appear above the image.\n\n    Arguments:\n\n        text_or_element -- str or Element, or list of them, text content\n                           of the text box.\n\n        text_style -- str, name of the style for the text\n\n        See Frame() initialization for the other arguments\n\n    Return: Frame\n    \"\"\"\n    frame = cls(\n        name=name,\n        draw_id=draw_id,\n        style=style,\n        position=position,\n        size=size,\n        z_index=z_index,\n        presentation_class=presentation_class,\n        anchor_type=anchor_type,\n        anchor_page=anchor_page,\n        layer=layer,\n        presentation_style=presentation_style,\n        **kwargs,\n    )\n    frame.set_text_box(text_or_element, text_style)\n    return frame\n</code></pre>"},{"location":"reference.html#odfdo.Header","title":"<code>Header</code>","text":"<p>             Bases: <code>Paragraph</code></p> <p>Specialised paragraph for headings \u201ctext:h\u201d.</p> Source code in <code>odfdo/header.py</code> <pre><code>class Header(Paragraph):\n    \"\"\"Specialised paragraph for headings \"text:h\".\"\"\"\n\n    _tag = \"text:h\"\n    _properties = (\n        PropDef(\"level\", \"text:outline-level\"),\n        PropDef(\"restart_numbering\", \"text:restart-numbering\"),\n        PropDef(\"start_value\", \"text:start-value\"),\n        PropDef(\"suppress_numbering\", \"text:suppress-numbering\"),\n    )\n\n    def __init__(\n        self,\n        level: int = 1,\n        text: str | None = None,\n        restart_numbering: bool = False,\n        start_value: int | None = None,\n        suppress_numbering: bool = False,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a header element of the given style and level, containing the\n        optional given text.\n\n        Level count begins at 1.\n\n        Arguments:\n\n            level -- int\n\n            text -- str\n\n            restart_numbering -- bool\n\n            start_value -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.level = int(level)\n            if text:\n                self.text = text\n            if restart_numbering:\n                self.restart_numbering = True\n            if start_value is not None:\n                self.start_value = start_value\n            if suppress_numbering:\n                self.suppress_numbering = True\n            if style:\n                self.style = style\n\n    def get_formatted_text(\n        self,\n        context: dict | None = None,\n        simple: bool = False,\n    ) -&gt; str:\n        if not context:\n            context = {\n                \"document\": None,\n                \"footnotes\": [],\n                \"endnotes\": [],\n                \"annotations\": [],\n                \"rst_mode\": False,\n                \"img_counter\": 0,\n                \"images\": [],\n                \"no_img_level\": 0,\n            }\n        context[\"no_img_level\"] += 1\n        title = super().get_formatted_text(context)\n        context[\"no_img_level\"] -= 1\n        title = title.strip()\n        title = sub(r\"\\s+\", \" \", title)\n\n        # No rst_mode ?\n        if not context[\"rst_mode\"]:\n            return title\n        # If here in rst_mode!\n\n        # Get the level, max 5!\n        LEVEL_STYLES = \"#=-~`+^\u00b0'.\"\n        level = int(self.level)\n        if level &gt; len(LEVEL_STYLES):\n            raise ValueError(\"Too many levels of heading\")\n\n        # And return the result\n        result = [\"\\n\", title, \"\\n\", LEVEL_STYLES[level - 1] * len(title), \"\\n\"]\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.Header.__init__","title":"<code>__init__(level=1, text=None, restart_numbering=False, start_value=None, suppress_numbering=False, style=None, **kwargs)</code>","text":"<p>Create a header element of the given style and level, containing the optional given text.</p> <p>Level count begins at 1.</p> <p>Arguments:</p> <pre><code>level -- int\n\ntext -- str\n\nrestart_numbering -- bool\n\nstart_value -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/header.py</code> <pre><code>def __init__(\n    self,\n    level: int = 1,\n    text: str | None = None,\n    restart_numbering: bool = False,\n    start_value: int | None = None,\n    suppress_numbering: bool = False,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a header element of the given style and level, containing the\n    optional given text.\n\n    Level count begins at 1.\n\n    Arguments:\n\n        level -- int\n\n        text -- str\n\n        restart_numbering -- bool\n\n        start_value -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.level = int(level)\n        if text:\n            self.text = text\n        if restart_numbering:\n            self.restart_numbering = True\n        if start_value is not None:\n            self.start_value = start_value\n        if suppress_numbering:\n            self.suppress_numbering = True\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Image","title":"<code>Image</code>","text":"<p>             Bases: <code>Body</code></p> <p>Image, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Image(Body):\n    \"\"\"Image, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:image\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.IndexTitle","title":"<code>IndexTitle</code>","text":"<p>             Bases: <code>Element</code></p> <p>The \u201ctext:index-title\u201d element contains the title of an index.</p> <p>The element has the following attributes: text:name, text:protected, text:protection-key, text:protection-key-digest-algorithm, text:style-name, xml:id.</p> <p>The actual title is stored in a child element</p> Source code in <code>odfdo/toc.py</code> <pre><code>class IndexTitle(Element):\n    \"\"\"The \"text:index-title\" element contains the title of an index.\n\n    The element has the following attributes:\n    text:name, text:protected, text:protection-key,\n    text:protection-key-digest-algorithm, text:style-name, xml:id.\n\n    The actual title is stored in a child element\n    \"\"\"\n\n    _tag = \"text:index-title\"\n    _properties = (\n        PropDef(\"name\", \"text:name\"),\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"xml_id\", \"xml:id\"),\n        PropDef(\"protected\", \"text:protected\"),\n        PropDef(\"protection_key\", \"text:protection-key\"),\n        PropDef(\n            \"protection_key_digest_algorithm\", \"text:protection-key-digest-algorithm\"\n        ),\n    )\n\n    def __init__(\n        self,\n        name: str | None = None,\n        style: str | None = None,\n        title_text: str | None = None,\n        title_text_style: str | None = None,\n        xml_id: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if name:\n                self.name = name\n            if style:\n                self.style = style\n            if xml_id:\n                self.xml_id = xml_id\n            if title_text:\n                self.set_title_text(title_text, title_text_style)\n\n    def set_title_text(\n        self,\n        title_text: str,\n        title_text_style: str | None = None,\n    ) -&gt; None:\n        title = Paragraph(title_text, style=title_text_style)\n        self.append(title)\n</code></pre>"},{"location":"reference.html#odfdo.IndexTitleTemplate","title":"<code>IndexTitleTemplate</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF \u201ctext:index-title-template\u201d</p> <p>Arguments:</p> <pre><code>style -- str\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>class IndexTitleTemplate(Element):\n    \"\"\"ODF \"text:index-title-template\"\n\n    Arguments:\n\n        style -- str\n    \"\"\"\n\n    _tag = \"text:index-title-template\"\n    _properties = (PropDef(\"style\", \"text:style-name\"),)\n\n    def __init__(self, style: str | None = None, **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init and style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.LineBreak","title":"<code>LineBreak</code>","text":"<p>             Bases: <code>Element</code></p> <p>This element represents a line break \u201ctext:line-break\u201d</p> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>class LineBreak(Element):\n    \"\"\"This element represents a line break \"text:line-break\" \"\"\"\n\n    _tag = \"text:line-break\"\n\n    def __init__(self, **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n</code></pre>"},{"location":"reference.html#odfdo.LineShape","title":"<code>LineShape</code>","text":"<p>             Bases: <code>ShapeBase</code></p> <p>Create a line shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\np1 -- (str, str)\n\np2 -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class LineShape(ShapeBase):\n    \"\"\"Create a line shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        p1 -- (str, str)\n\n        p2 -- (str, str)\n    \"\"\"\n\n    _tag = \"draw:line\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"x1\", \"svg:x1\"),\n        PropDef(\"y1\", \"svg:y1\"),\n        PropDef(\"x2\", \"svg:x2\"),\n        PropDef(\"y2\", \"svg:y2\"),\n    )\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        p1: tuple | None = None,\n        p2: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n            }\n        )\n        super().__init__(**kwargs)\n        if self._do_init:\n            if p1:\n                self.x1 = p1[0]\n                self.y1 = p1[1]\n            if p2:\n                self.x2 = p2[0]\n                self.y2 = p2[1]\n</code></pre>"},{"location":"reference.html#odfdo.Link","title":"<code>Link</code>","text":"<p>             Bases: <code>ParagraphBase</code></p> <p>Link class, \u201ctext:a\u201d ODF element.</p> Source code in <code>odfdo/link.py</code> <pre><code>class Link(ParagraphBase):\n    \"\"\"Link class, \"text:a\" ODF element.\"\"\"\n\n    _tag = \"text:a\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"url\", \"xlink:href\"),\n        PropDef(\"name\", \"office:name\"),\n        PropDef(\"title\", \"office:title\"),\n        PropDef(\"target_frame\", \"office:target-frame-name\"),\n        PropDef(\"show\", \"xlink:show\"),\n        PropDef(\"visited_style\", \"text:visited-style-name\"),\n        PropDef(\"style\", \"text:style-name\"),\n    )\n\n    def __init__(\n        self,\n        url: str | None = \"\",\n        name: str | None = None,\n        title: str | None = None,\n        text: str | None = None,\n        target_frame: str | None = None,\n        style: str | None = None,\n        visited_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            url -- str\n\n            name -- str\n\n            title -- str\n\n            text -- str\n\n            target_frame -- '_self', '_blank', '_parent', '_top'\n\n            style -- str\n\n            visited_style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.url = url\n            if name is not None:\n                self.name = name\n            if title is not None:\n                self.title = title\n            if text is not None:\n                self.text = text\n            if target_frame is not None:\n                self.target_frame = target_frame\n                # show can be: 'new' or 'replace'\"\n                if target_frame == \"_blank\":\n                    self.show = \"new\"\n                else:\n                    self.show = \"replace\"\n            if style is not None:\n                self.style = style\n            if visited_style is not None:\n                self.visited_style = visited_style\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag} link={self.url}&gt;\"\n\n    def __str__(self) -&gt; str:\n        if self.name:\n            return f\"[{self.name}]({self.url})\"\n        return f\"({self.url})\"\n</code></pre>"},{"location":"reference.html#odfdo.Link.__init__","title":"<code>__init__(url='', name=None, title=None, text=None, target_frame=None, style=None, visited_style=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>url -- str\n\nname -- str\n\ntitle -- str\n\ntext -- str\n\ntarget_frame -- '_self', '_blank', '_parent', '_top'\n\nstyle -- str\n\nvisited_style -- str\n</code></pre> Source code in <code>odfdo/link.py</code> <pre><code>def __init__(\n    self,\n    url: str | None = \"\",\n    name: str | None = None,\n    title: str | None = None,\n    text: str | None = None,\n    target_frame: str | None = None,\n    style: str | None = None,\n    visited_style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        url -- str\n\n        name -- str\n\n        title -- str\n\n        text -- str\n\n        target_frame -- '_self', '_blank', '_parent', '_top'\n\n        style -- str\n\n        visited_style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.url = url\n        if name is not None:\n            self.name = name\n        if title is not None:\n            self.title = title\n        if text is not None:\n            self.text = text\n        if target_frame is not None:\n            self.target_frame = target_frame\n            # show can be: 'new' or 'replace'\"\n            if target_frame == \"_blank\":\n                self.show = \"new\"\n            else:\n                self.show = \"replace\"\n        if style is not None:\n            self.style = style\n        if visited_style is not None:\n            self.visited_style = visited_style\n</code></pre>"},{"location":"reference.html#odfdo.List","title":"<code>List</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF List \u201ctext:list\u201d.</p> Source code in <code>odfdo/list.py</code> <pre><code>class List(Element):\n    \"\"\"ODF List \"text:list\".\"\"\"\n\n    _tag = \"text:list\"\n    _properties = (PropDef(\"style\", \"text:style-name\"),)\n\n    def __init__(\n        self,\n        list_content: str | Element | Iterable[str | Element] | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a list element, optionaly loading the list by a list of\n        item (str or elements).\n\n        The list_content argument is just a shortcut for the most common case.\n        To create more complex lists, first create an empty list, and fill it\n        afterwards.\n\n        Arguments:\n\n            list_content -- str or Element, or a list of str or Element\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if list_content:\n                if isinstance(list_content, (Element, str)):\n                    self.append(ListItem(list_content))\n                elif hasattr(list_content, \"__iter__\"):\n                    for item in list_content:\n                        self.append(ListItem(item))\n            if style is not None:\n                self.style = style\n\n    def get_items(self, content: str | None = None) -&gt; list[Element]:\n        \"\"\"Return all the list items that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"text:list-item\", content=content)\n\n    def get_item(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the list item that matches the criteria. In nested lists,\n        return the list item that really contains that content.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        # Custom implementation because of nested lists\n        if content:\n            # Don't search recursively but on the very own paragraph(s) of\n            # each list item\n            for paragraph in self.get_elements(\"descendant::text:p\"):\n                if paragraph.match(content):\n                    return paragraph.get_element(\"parent::text:list-item\")\n            return None\n        return self._filtered_element(\"text:list-item\", position)\n\n    def set_list_header(\n        self,\n        text_or_element: str | Element | Iterable[str | Element],\n    ) -&gt; None:\n        if isinstance(text_or_element, (str, Element)):\n            actual_list: list[str | Element] | tuple = [text_or_element]\n        elif isinstance(text_or_element, (list, tuple)):\n            actual_list = text_or_element\n        else:\n            raise TypeError\n        # Remove existing header\n        for element in self.get_elements(\"text:p\"):\n            self.delete(element)\n        for paragraph in reversed(actual_list):\n            if isinstance(paragraph, str):\n                paragraph = Paragraph(paragraph)\n            self.insert(paragraph, FIRST_CHILD)\n\n    def insert_item(\n        self,\n        item: ListItem | str | Element | None,\n        position: int | None = None,\n        before: Element | None = None,\n        after: Element | None = None,\n    ) -&gt; None:\n        if not isinstance(item, ListItem):\n            item = ListItem(item)\n        if before is not None:\n            before.insert(item, xmlposition=PREV_SIBLING)\n        elif after is not None:\n            after.insert(item, xmlposition=NEXT_SIBLING)\n        elif position is not None:\n            self.insert(item, position=position)\n        else:\n            raise ValueError(\"Position must be defined\")\n\n    def append_item(\n        self,\n        item: ListItem | str | Element | None,\n    ) -&gt; None:\n        if not isinstance(item, ListItem):\n            item = ListItem(item)\n        self.append(item)\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        if context is None:\n            context = {}\n        rst_mode = context[\"rst_mode\"]\n        result = []\n        if rst_mode:\n            result.append(\"\\n\")\n        for list_item in self.get_elements(\"text:list-item\"):\n            textbuf = []\n            for child in list_item.children:\n                text = child.get_formatted_text(context)\n                tag = child.tag\n                if tag == \"text:h\":\n                    # A title in a list is a bug\n                    return text\n                if tag == \"text:list\" and not text.lstrip().startswith(\"-\"):\n                    # If the list didn't indent, don't either\n                    # (inner title)\n                    return text\n                textbuf.append(text)\n            text_sum = \"\".join(textbuf)\n            text_sum = text_sum.strip(\"\\n\")\n            # Indent the text\n            text_sum = text_sum.replace(\"\\n\", \"\\n  \")\n            text_sum = f\"- {text_sum}\\n\"\n            result.append(text_sum)\n        if rst_mode:\n            result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.List.__init__","title":"<code>__init__(list_content=None, style=None, **kwargs)</code>","text":"<p>Create a list element, optionaly loading the list by a list of item (str or elements).</p> <p>The list_content argument is just a shortcut for the most common case. To create more complex lists, first create an empty list, and fill it afterwards.</p> <p>Arguments:</p> <pre><code>list_content -- str or Element, or a list of str or Element\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/list.py</code> <pre><code>def __init__(\n    self,\n    list_content: str | Element | Iterable[str | Element] | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a list element, optionaly loading the list by a list of\n    item (str or elements).\n\n    The list_content argument is just a shortcut for the most common case.\n    To create more complex lists, first create an empty list, and fill it\n    afterwards.\n\n    Arguments:\n\n        list_content -- str or Element, or a list of str or Element\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if list_content:\n            if isinstance(list_content, (Element, str)):\n                self.append(ListItem(list_content))\n            elif hasattr(list_content, \"__iter__\"):\n                for item in list_content:\n                    self.append(ListItem(item))\n        if style is not None:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.List.get_item","title":"<code>get_item(position=0, content=None)</code>","text":"<p>Return the list item that matches the criteria. In nested lists, return the list item that really contains that content.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/list.py</code> <pre><code>def get_item(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the list item that matches the criteria. In nested lists,\n    return the list item that really contains that content.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    # Custom implementation because of nested lists\n    if content:\n        # Don't search recursively but on the very own paragraph(s) of\n        # each list item\n        for paragraph in self.get_elements(\"descendant::text:p\"):\n            if paragraph.match(content):\n                return paragraph.get_element(\"parent::text:list-item\")\n        return None\n    return self._filtered_element(\"text:list-item\", position)\n</code></pre>"},{"location":"reference.html#odfdo.List.get_items","title":"<code>get_items(content=None)</code>","text":"<p>Return all the list items that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/list.py</code> <pre><code>def get_items(self, content: str | None = None) -&gt; list[Element]:\n    \"\"\"Return all the list items that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"text:list-item\", content=content)\n</code></pre>"},{"location":"reference.html#odfdo.ListItem","title":"<code>ListItem</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF element \u201ctext:list-item\u201d, item of a List.</p> Source code in <code>odfdo/list.py</code> <pre><code>class ListItem(Element):\n    \"\"\"ODF element \"text:list-item\", item of a List.\"\"\"\n\n    _tag = \"text:list-item\"\n\n    def __init__(\n        self,\n        text_or_element: str | Element | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a list item element, optionaly passing at creation time a\n        string or Element as content.\n\n        Arguments:\n\n            text_or_element -- str or ODF Element\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if isinstance(text_or_element, str):\n                self.text_content = text_or_element\n            elif isinstance(text_or_element, Element):\n                self.append(text_or_element)\n            elif text_or_element is not None:\n                raise TypeError(\"Expected str or Element\")\n</code></pre>"},{"location":"reference.html#odfdo.ListItem.__init__","title":"<code>__init__(text_or_element=None, **kwargs)</code>","text":"<p>Create a list item element, optionaly passing at creation time a string or Element as content.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or ODF Element\n</code></pre> Source code in <code>odfdo/list.py</code> <pre><code>def __init__(\n    self,\n    text_or_element: str | Element | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a list item element, optionaly passing at creation time a\n    string or Element as content.\n\n    Arguments:\n\n        text_or_element -- str or ODF Element\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if isinstance(text_or_element, str):\n            self.text_content = text_or_element\n        elif isinstance(text_or_element, Element):\n            self.append(text_or_element)\n        elif text_or_element is not None:\n            raise TypeError(\"Expected str or Element\")\n</code></pre>"},{"location":"reference.html#odfdo.Manifest","title":"<code>Manifest</code>","text":"<p>             Bases: <code>XmlPart</code></p> Source code in <code>odfdo/manifest.py</code> <pre><code>class Manifest(XmlPart):\n    def get_paths(self) -&gt; list[Element | EText]:\n        \"\"\"Return the list of full paths in the manifest.\n\n        Return: list of str\n        \"\"\"\n        xpath_query = \"//manifest:file-entry/attribute::manifest:full-path\"\n        return self.xpath(xpath_query)\n\n    def _file_entry(self, full_path: str) -&gt; Element:\n        xpath_query = (\n            f'//manifest:file-entry[attribute::manifest:full-path=\"{full_path}\"]'\n        )\n        result = self.xpath(xpath_query)\n        if not result:\n            raise KeyError(f\"Path not found: '{full_path}'\")\n        return result[0]  # type: ignore\n\n    def get_path_medias(self) -&gt; list[tuple]:\n        \"\"\"Return the list of (full_path, media_type) pairs in the manifest.\n\n        Return: list of str tuples\n        \"\"\"\n        xpath_query = \"//manifest:file-entry\"\n        result = []\n        for file_entry in self.xpath(xpath_query):\n            if not isinstance(file_entry, Element):\n                continue\n            result.append(\n                (\n                    file_entry.get_attribute_string(\"manifest:full-path\"),\n                    file_entry.get_attribute_string(\"manifest:media-type\"),\n                )\n            )\n        return result\n\n    def get_media_type(self, full_path: str) -&gt; str | None:\n        \"\"\"Get the media type of an existing path.\n\n        Return: str\n        \"\"\"\n        xpath_query = (\n            f'//manifest:file-entry[attribute::manifest:full-path=\"{full_path}\"]'\n            \"/attribute::manifest:media-type\"\n        )\n        result = self.xpath(xpath_query)\n        if not result:\n            return None\n        return str(result[0])\n\n    def set_media_type(self, full_path: str, media_type: str) -&gt; None:\n        \"\"\"Set the media type of an existing path.\n\n        Arguments:\n\n            full_path -- str\n\n            media_type -- str\n        \"\"\"\n        file_entry = self._file_entry(full_path)\n        file_entry.set_attribute(\"manifest:media-type\", media_type)\n\n    @staticmethod\n    def make_file_entry(full_path: str, media_type: str) -&gt; Element:\n        tag = (\n            f\"&lt;manifest:file-entry \"\n            f'manifest:media-type=\"{media_type}\" '\n            f'manifest:full-path=\"{full_path}\"/&gt;'\n        )\n        return Element.from_tag(tag)\n\n    def add_full_path(self, full_path: str, media_type: str = \"\") -&gt; None:\n        # Existing?\n        existing = self.get_media_type(full_path)\n        if existing is not None:\n            self.set_media_type(full_path, media_type)\n        root = self.root\n        root.append(self.make_file_entry(full_path, media_type))\n\n    def del_full_path(self, full_path: str) -&gt; None:\n        file_entry = self._file_entry(full_path)\n        self.root.delete(file_entry)\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.get_media_type","title":"<code>get_media_type(full_path)</code>","text":"<p>Get the media type of an existing path.</p> <p>Return: str</p> Source code in <code>odfdo/manifest.py</code> <pre><code>def get_media_type(self, full_path: str) -&gt; str | None:\n    \"\"\"Get the media type of an existing path.\n\n    Return: str\n    \"\"\"\n    xpath_query = (\n        f'//manifest:file-entry[attribute::manifest:full-path=\"{full_path}\"]'\n        \"/attribute::manifest:media-type\"\n    )\n    result = self.xpath(xpath_query)\n    if not result:\n        return None\n    return str(result[0])\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.get_path_medias","title":"<code>get_path_medias()</code>","text":"<p>Return the list of (full_path, media_type) pairs in the manifest.</p> <p>Return: list of str tuples</p> Source code in <code>odfdo/manifest.py</code> <pre><code>def get_path_medias(self) -&gt; list[tuple]:\n    \"\"\"Return the list of (full_path, media_type) pairs in the manifest.\n\n    Return: list of str tuples\n    \"\"\"\n    xpath_query = \"//manifest:file-entry\"\n    result = []\n    for file_entry in self.xpath(xpath_query):\n        if not isinstance(file_entry, Element):\n            continue\n        result.append(\n            (\n                file_entry.get_attribute_string(\"manifest:full-path\"),\n                file_entry.get_attribute_string(\"manifest:media-type\"),\n            )\n        )\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.get_paths","title":"<code>get_paths()</code>","text":"<p>Return the list of full paths in the manifest.</p> <p>Return: list of str</p> Source code in <code>odfdo/manifest.py</code> <pre><code>def get_paths(self) -&gt; list[Element | EText]:\n    \"\"\"Return the list of full paths in the manifest.\n\n    Return: list of str\n    \"\"\"\n    xpath_query = \"//manifest:file-entry/attribute::manifest:full-path\"\n    return self.xpath(xpath_query)\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.set_media_type","title":"<code>set_media_type(full_path, media_type)</code>","text":"<p>Set the media type of an existing path.</p> <p>Arguments:</p> <pre><code>full_path -- str\n\nmedia_type -- str\n</code></pre> Source code in <code>odfdo/manifest.py</code> <pre><code>def set_media_type(self, full_path: str, media_type: str) -&gt; None:\n    \"\"\"Set the media type of an existing path.\n\n    Arguments:\n\n        full_path -- str\n\n        media_type -- str\n    \"\"\"\n    file_entry = self._file_entry(full_path)\n    file_entry.set_attribute(\"manifest:media-type\", media_type)\n</code></pre>"},{"location":"reference.html#odfdo.Meta","title":"<code>Meta</code>","text":"<p>             Bases: <code>XmlPart</code>, <code>DcCreatorMixin</code>, <code>DcDateMixin</code></p> Source code in <code>odfdo/meta.py</code> <pre><code>class Meta(XmlPart, DcCreatorMixin, DcDateMixin):\n    def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n        super().__init__(*args, **kwargs)\n        self._generator_modified: bool = False\n\n    def get_meta_body(self) -&gt; Element:\n        return self.get_element(\"//office:meta\")\n\n    def get_title(self) -&gt; str | None:\n        \"\"\"Get the title of the document.\n\n        This is not the first heading but the title metadata.\n\n        (Also available as \"self.title\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//dc:title\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_title(self, title: str) -&gt; None:\n        \"\"\"Set the title of the document.\n\n        This is not the first heading but the title metadata.\n\n        (Also available as \"self.title\" property.)\n\n        Arguments:\n\n            title -- str\n        \"\"\"\n        element = self.get_element(\"//dc:title\")\n        if element is None:\n            element = Element.from_tag(\"dc:title\")\n            self.get_meta_body().append(element)\n        element.text = title\n\n    @property\n    def title(self) -&gt; str | None:\n        \"\"\"Get or set the title of the document &lt;dc:title&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_title()\n\n    @title.setter\n    def title(self, title: str) -&gt; None:\n        return self.set_title(title)\n\n    def get_description(self) -&gt; str | None:\n        \"\"\"Get the description of the document. Also known as comments.\n\n        (Also available as \"self.description\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//dc:description\")\n        if element is None:\n            return None\n        return element.text\n\n    # As named in OOo\n    get_comments = get_description\n\n    def set_description(self, description: str) -&gt; None:\n        \"\"\"Set the description of the document. Also known as comments.\n\n        (Also available as \"self.description\" property.)\n\n        Arguments:\n\n            description -- str\n        \"\"\"\n        element = self.get_element(\"//dc:description\")\n        if element is None:\n            element = Element.from_tag(\"dc:description\")\n            self.get_meta_body().append(element)\n        element.text = description\n\n    set_comments = set_description\n\n    @property\n    def description(self) -&gt; str | None:\n        \"\"\"Get or set the description of a document &lt;dc:description&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_description()\n\n    @description.setter\n    def description(self, description: str) -&gt; None:\n        return self.set_description(description)\n\n    def get_subject(self) -&gt; str | None:\n        \"\"\"Get the subject of the document.\n\n        (Also available as \"self.subject\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//dc:subject\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_subject(self, subject: str) -&gt; None:\n        \"\"\"Set the subject of the document.\n\n        (Also available as \"self.subject\" property.)\n\n        Arguments:\n\n            subject -- str\n        \"\"\"\n        element = self.get_element(\"//dc:subject\")\n        if element is None:\n            element = Element.from_tag(\"dc:subject\")\n            self.get_meta_body().append(element)\n        element.text = subject\n\n    @property\n    def subject(self) -&gt; str | None:\n        \"\"\"Get or set the subject of a document &lt;dc:subject&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_subject()\n\n    @subject.setter\n    def subject(self, subject: str) -&gt; None:\n        return self.set_subject(subject)\n\n    def get_language(self) -&gt; str | None:\n        \"\"\"Get the default language of the document.\n\n        (Also available as \"self.language\" property.)\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.get_language()\n            fr-FR\n        \"\"\"\n        element = self.get_element(\"//dc:language\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_language(self, language: str) -&gt; None:\n        \"\"\"Set the default language of the document.\n\n        (Also available as \"self.language\" property.)\n\n        Arguments:\n\n            language -- str\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_language('fr-FR')\n        \"\"\"\n        language = str(language)\n        if not self._is_RFC3066(language):\n            raise TypeError(\n                'Language must be \"xx\" lang or \"xx-YY\" lang-COUNTRY code (RFC3066)'\n            )\n        element = self.get_element(\"//dc:language\")\n        if element is None:\n            element = Element.from_tag(\"dc:language\")\n            self.get_meta_body().append(element)\n        element.text = language\n\n    @staticmethod\n    def _is_RFC3066(lang: str) -&gt; bool:\n        def test_part1(part1: str) -&gt; bool:\n            if not 2 &lt;= len(part1) &lt;= 3:\n                return False\n            return all(x in ascii_letters for x in part1)\n\n        def test_part2(part2: str) -&gt; bool:\n            return all(x in ascii_letters or x in digits for x in part2)\n\n        if not lang or not isinstance(lang, str):\n            return False\n        if \"-\" not in lang:\n            return test_part1(lang)\n        parts = lang.split(\"-\")\n        if len(parts) &gt; 3:\n            return False\n        if not test_part1(parts[0]):\n            return False\n        return all(test_part2(p) for p in parts[1:])\n\n    @property\n    def language(self) -&gt; str | None:\n        \"\"\"Get or set the default language of the document &lt;dc:language&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_language()\n\n    @language.setter\n    def language(self, language: str) -&gt; None:\n        return self.set_language(language)\n\n    def get_creation_date(self) -&gt; datetime | None:\n        \"\"\"Get the creation date of the document.\n\n        (Also available as \"self.creation_date\" property.)\n\n        Return: datetime (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:creation-date\")\n        if element is None:\n            return None\n        creation_date = element.text\n        return DateTime.decode(creation_date)\n\n    def set_creation_date(self, date: datetime | None = None) -&gt; None:\n        \"\"\"Set the creation date of the document.\n\n        If provided datetime is None, use current time.\n\n        (Also available as \"self.creation_date\" property.)\n\n        Arguments:\n\n            date -- datetime\n        \"\"\"\n        element = self.get_element(\"//meta:creation-date\")\n        if element is None:\n            element = Element.from_tag(\"meta:creation-date\")\n            self.get_meta_body().append(element)\n        if date is None:\n            date = datetime.now()\n        element.text = DateTime.encode(date)\n\n    @property\n    def creation_date(self) -&gt; datetime | None:\n        \"\"\"Get or set the date and time when a document was created\n        &lt;meta:creation-date&gt;.\n\n        If provided datetime is None, use current time.\n\n        Return: datetime (or None if inexistant)\n        \"\"\"\n        return self.get_creation_date()\n\n    @creation_date.setter\n    def creation_date(self, date: datetime | None = None) -&gt; None:\n        return self.set_creation_date(date)\n\n    @property\n    def print_date(self) -&gt; datetime | None:\n        \"\"\"Get or set the date and time when a document when a document was last printed\n        &lt;meta:print-date&gt;\n\n        If provided datetime is None, use current time.\n\n        Return: datetime (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:print-date\")\n        if element is None:\n            return None\n        date = element.text\n        return DateTime.decode(date)\n\n    @print_date.setter\n    def print_date(self, date: datetime | None = None) -&gt; None:\n        element = self.get_element(\"//meta:print-date\")\n        if element is None:\n            element = Element.from_tag(\"meta:print-date\")\n            self.get_meta_body().append(element)\n        if date is None:\n            date = datetime.now()\n        element.text = DateTime.encode(date)\n\n    def get_template(self) -&gt; MetaTemplate | None:\n        \"\"\"Get the MetaTemplate &lt;meta:template&gt; element or None.\"\"\"\n        element = self.get_element(\"//meta:template\")\n        if element is None:\n            return None\n        return element\n\n    @property\n    def template(self) -&gt; MetaTemplate | None:\n        \"\"\"Get the MetaTemplate &lt;meta:template&gt; element or None.\"\"\"\n        return self.get_template()\n\n    def set_template(\n        self,\n        date: datetime | None = None,\n        href: str = \"\",\n        title: str = \"\",\n    ) -&gt; None:\n        \"\"\"Set the MetaTemplate &lt;meta:template&gt; element.\"\"\"\n        template = MetaTemplate(date=date, href=href, title=title)\n        current = self.template\n        if isinstance(current, MetaTemplate):\n            current.delete()\n        self.get_meta_body().append(template)\n\n    def get_auto_reload(self) -&gt; MetaAutoReload | None:\n        \"\"\"Get the MetaAutoReload &lt;meta:auto-reload&gt; element or None.\"\"\"\n        element = self.get_element(\"//meta:auto-reload\")\n        if element is None:\n            return None\n        return element\n\n    @property\n    def auto_reload(self) -&gt; MetaAutoReload | None:\n        \"\"\"Get the MetaAutoReload &lt;meta:auto-reload&gt; element or None.\"\"\"\n        return self.get_auto_reload()\n\n    def set_auto_reload(self, delay: timedelta, href: str = \"\") -&gt; None:\n        \"\"\"Set the MetaAutoReload &lt;meta:auto-reload&gt; element.\"\"\"\n        autoreload = MetaAutoReload(delay=delay, href=href)\n        current = self.auto_reload\n        if isinstance(current, MetaAutoReload):\n            current.delete()\n        self.get_meta_body().append(autoreload)\n\n    def get_hyperlink_behaviour(self) -&gt; MetaHyperlinkBehaviour | None:\n        \"\"\"Get the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element or None.\"\"\"\n        element = self.get_element(\"//meta:hyperlink-behaviour\")\n        if element is None:\n            return None\n        return element\n\n    @property\n    def hyperlink_behaviour(self) -&gt; MetaAutoReload | None:\n        \"\"\"Get the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element or None.\"\"\"\n        return self.get_hyperlink_behaviour()\n\n    def set_hyperlink_behaviour(\n        self,\n        target_frame_name: str = \"_blank\",\n        show: str = \"replace\",\n    ) -&gt; None:\n        \"\"\"Set the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element.\"\"\"\n        behaviour = MetaHyperlinkBehaviour(\n            target_frame_name=target_frame_name, show=show\n        )\n        current = self.hyperlink_behaviour\n        if isinstance(current, MetaHyperlinkBehaviour):\n            current.delete()\n        self.get_meta_body().append(behaviour)\n\n    def get_initial_creator(self) -&gt; str | None:\n        \"\"\"Get the first creator of the document.\n\n        (Also available as \"self.initial_creator\" property.)\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.get_initial_creator()\n            Unknown\n        \"\"\"\n        element = self.get_element(\"//meta:initial-creator\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_initial_creator(self, creator: str) -&gt; None:\n        \"\"\"Set the first creator of the document.\n\n        (Also available as \"self.initial_creator\" property.)\n\n        Arguments:\n\n            creator -- str\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_initial_creator(\"Plato\")\n        \"\"\"\n        element = self.get_element(\"//meta:initial-creator\")\n        if element is None:\n            element = Element.from_tag(\"meta:initial-creator\")\n            self.get_meta_body().append(element)\n        element.text = creator\n\n    @property\n    def initial_creator(self) -&gt; str | None:\n        \"\"\"Get or set the initial creator of a document\n        &lt;meta:initial-creator&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_initial_creator()\n\n    @initial_creator.setter\n    def initial_creator(self, creator: str) -&gt; None:\n        return self.set_initial_creator(creator)\n\n    @property\n    def printed_by(self) -&gt; str | None:\n        \"\"\"Get or set the name of the last person who printed a document.\n        &lt;meta:printed-by&gt;\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:printed-by\")\n        if element is None:\n            return None\n        return element.text\n\n    @printed_by.setter\n    def printed_by(self, printed_by: str) -&gt; None:\n        element = self.get_element(\"//meta:printed-by\")\n        if element is None:\n            element = Element.from_tag(\"meta:printed-by\")\n            self.get_meta_body().append(element)\n        element.text = printed_by\n\n    def get_keywords(self) -&gt; str | None:\n        \"\"\"Get the keywords of the document. Return the field as-is, without\n        any assumption on the keyword separator.\n\n        (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:keyword\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_keywords(self, keywords: str) -&gt; None:\n        \"\"\"Set the keywords of the document. Although the name is plural, a\n        str string is required, so join your list first.\n\n        (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n        Arguments:\n\n            keywords -- str\n        \"\"\"\n        element = self.get_element(\"//meta:keyword\")\n        if element is None:\n            element = Element.from_tag(\"meta:keyword\")\n            self.get_meta_body().append(element)\n        element.text = keywords\n\n    @property\n    def keyword(self) -&gt; str | None:\n        \"\"\"Get or set some keyword(s) keyword pertaining to a document\n        &lt;dc:keyword&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_keywords()\n\n    @keyword.setter\n    def keyword(self, keyword: str) -&gt; None:\n        return self.set_keywords(keyword)\n\n    keywords = keyword\n\n    def get_editing_duration(self) -&gt; timedelta | None:\n        \"\"\"Get the time the document was edited, as reported by the\n        generator.\n\n        (Also available as \"self.editing_duration\" property.)\n\n        Return: timedelta (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:editing-duration\")\n        if element is None:\n            return None\n        duration = element.text\n        return Duration.decode(duration)\n\n    def set_editing_duration(self, duration: timedelta) -&gt; None:\n        \"\"\"Set the time the document was edited.\n\n        (Also available as \"self.editing_duration\" property.)\n\n        Arguments:\n\n            duration -- timedelta\n        \"\"\"\n        if not isinstance(duration, timedelta):\n            raise TypeError(\"duration must be a timedelta\")\n        element = self.get_element(\"//meta:editing-duration\")\n        if element is None:\n            element = Element.from_tag(\"meta:editing-duration\")\n            self.get_meta_body().append(element)\n        element.text = Duration.encode(duration)\n\n    @property\n    def editing_duration(self) -&gt; timedelta | None:\n        \"\"\"Get or set the total time spent editing a document\n        &lt;meta:editing-duration&gt;.\n\n        Return: timedelta (or None if inexistant)\n        \"\"\"\n        return self.get_editing_duration()\n\n    @editing_duration.setter\n    def editing_duration(self, duration: timedelta) -&gt; None:\n        return self.set_editing_duration(duration)\n\n    def get_editing_cycles(self) -&gt; int | None:\n        \"\"\"Get the number of times the document was edited, as reported by\n        the generator.\n\n        (Also available as \"self.editing_cycles\" property.)\n\n        Return: int (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:editing-cycles\")\n        if element is None:\n            return None\n        cycles = element.text\n        return int(cycles)\n\n    def set_editing_cycles(self, cycles: int) -&gt; None:\n        \"\"\"Set the number of times the document was edited.\n\n        (Also available as \"self.editing_cycles\" property.)\n\n        Arguments:\n\n            cycles -- int\n        \"\"\"\n        if not isinstance(cycles, int):\n            raise TypeError(\"cycles must be an int\")\n        if cycles &lt; 1:\n            raise ValueError(\"cycles must be a positive int\")\n        element = self.get_element(\"//meta:editing-cycles\")\n        if element is None:\n            element = Element.from_tag(\"meta:editing-cycles\")\n            self.get_meta_body().append(element)\n        element.text = str(cycles)\n\n    @property\n    def editing_cycles(self) -&gt; int | None:\n        \"\"\"Get or set the number of times a document has been edited\n        &lt;meta:editing-cycles&gt;.\n\n        When a document is created, this value is set to 1. Each time\n        a document is saved, the editing-cycles number is incremented by 1.\n\n        Return: int (or None if inexistant)\n        \"\"\"\n        return self.get_editing_cycles()\n\n    @editing_cycles.setter\n    def editing_cycles(self, cycles: int) -&gt; None:\n        return self.set_editing_cycles(cycles)\n\n    @property\n    def generator(self) -&gt; str | None:\n        \"\"\"Get or set the signature of the software that generated this\n        document.\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.generator\n            KOffice/2.0.0\n            &gt;&gt;&gt; document.meta.generator = \"Odfdo experiment\"\n        \"\"\"\n        element = self.get_element(\"//meta:generator\")\n        if element is None:\n            return None\n        return element.text\n\n    @generator.setter\n    def generator(self, generator: str) -&gt; None:\n        element = self.get_element(\"//meta:generator\")\n        if element is None:\n            element = Element.from_tag(\"meta:generator\")\n            self.get_meta_body().append(element)\n        element.text = generator\n        self._generator_modified = True\n\n    def get_generator(self) -&gt; str | None:\n        \"\"\"Get the signature of the software that generated this document.\n\n        (Also available as \"self.generator\" property.)\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.get_generator()\n            KOffice/2.0.0\n        \"\"\"\n        return self.generator\n\n    def set_generator(self, generator: str) -&gt; None:\n        \"\"\"Set the signature of the software that generated this document.\n\n        (Also available as \"self.generator\" property.)\n\n        Arguments:\n\n            generator -- str\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_generator(\"Odfdo experiment\")\n        \"\"\"\n        self.generator = generator\n\n    def set_generator_default(self) -&gt; None:\n        \"\"\"Set the signature of the software that generated this document\n        to ourself.\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_generator_default()\n        \"\"\"\n        if not self._generator_modified:\n            self.generator = GENERATOR\n\n    def get_statistic(self) -&gt; dict[str, int] | None:\n        \"\"\"Get the statistics about a document.\n\n        (Also available as \"self.statistic\" property.)\n\n        Return: dict (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.get_statistic():\n            {'meta:table-count': 1,\n             'meta:image-count': 2,\n             'meta:object-count': 3,\n             'meta:page-count': 4,\n             'meta:paragraph-count': 5,\n             'meta:word-count': 6,\n             'meta:character-count': 7}\n        \"\"\"\n        element = self.get_element(\"//meta:document-statistic\")\n        if element is None:\n            return None\n        statistic = {}\n        for key, value in element.attributes.items():\n            statistic[to_str(key)] = int(value)\n        return statistic\n\n    def set_statistic(self, statistic: dict[str, int]) -&gt; None:\n        \"\"\"Set the statistics about a document.\n\n        (Also available as \"self.statistic\" property.)\n\n        Arguments:\n\n            statistic -- dict\n\n        Example::\n\n            &gt;&gt;&gt; statistic = {'meta:table-count': 1,\n                             'meta:image-count': 2,\n                             'meta:object-count': 3,\n                             'meta:page-count': 4,\n                             'meta:paragraph-count': 5,\n                             'meta:word-count': 6,\n                             'meta:character-count': 7}\n            &gt;&gt;&gt; document.meta.set_statistic(statistic)\n        \"\"\"\n        if not isinstance(statistic, dict):\n            raise TypeError(\"Statistic must be a dict\")\n        element = self.get_element(\"//meta:document-statistic\")\n        for key, value in statistic.items():\n            try:\n                ivalue = int(value)\n            except ValueError as e:\n                raise TypeError(\"Statistic value must be a int\") from e\n            element.set_attribute(to_str(key), str(ivalue))\n\n    @property\n    def statistic(self) -&gt; dict[str, int] | None:\n        \"\"\"Get or set the statistics about a document\n        &lt;meta:document-statistic&gt;.\n\n        Return: dict (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.get_statistic():\n            {'meta:table-count': 1,\n             'meta:image-count': 2,\n             'meta:object-count': 3,\n             'meta:page-count': 4,\n             'meta:paragraph-count': 5,\n             'meta:word-count': 6,\n             'meta:character-count': 7}\n        \"\"\"\n        return self.get_statistic()\n\n    @statistic.setter\n    def statistic(self, statistic: dict[str, int]) -&gt; None:\n        return self.set_statistic(statistic)\n\n    def get_user_defined_metadata(self) -&gt; dict[str, Any]:\n        \"\"\"Get all additional user-defined metadata for a document.\n\n        (Also available as \"self.user_defined_metadata\" property.)\n\n        Return a dict of str/value mapping.\n\n        Value types can be: Decimal, date, time, boolean or str.\n        \"\"\"\n        result: dict[str, Any] = {}\n        for item in self.get_elements(\"//meta:user-defined\"):\n            if not isinstance(item, Element):\n                continue\n            # Read the values\n            name = item.get_attribute_string(\"meta:name\")\n            if name is None:\n                continue\n            value = self._get_meta_value(item)\n            result[name] = value\n        return result\n\n    def clear_user_defined_metadata(self) -&gt; None:\n        \"\"\"Remove all user-defined metadata.\"\"\"\n        while True:\n            element = self.get_element(\"//meta:user-defined\")\n            if isinstance(element, Element):\n                element.delete()\n                continue\n            break\n\n    @property\n    def user_defined_metadata(self) -&gt; dict[str, Any]:\n        \"\"\"Get or set all additional user-defined metadata for a document.\n\n        Return a dict of str/value mapping.\n\n        Value types can be: Decimal, date, time, boolean or str.\n        \"\"\"\n        return self.get_user_defined_metadata()\n\n    @user_defined_metadata.setter\n    def user_defined_metadata(self, metadata: dict[str, Any]) -&gt; None:\n        self.clear_user_defined_metadata()\n        for key, val in metadata.items():\n            self.set_user_defined_metadata(name=key, value=val)\n\n    def get_user_defined_metadata_of_name(self, keyname: str) -&gt; dict[str, Any] | None:\n        \"\"\"Return the content of the user defined metadata of that name.\n        Return None if no name matchs or a dic of fields.\n\n        Arguments:\n\n            name -- string, name (meta:name content)\n        \"\"\"\n        result = {}\n        found = False\n        for item in self.get_elements(\"//meta:user-defined\"):\n            if not isinstance(item, Element):\n                continue\n            # Read the values\n            name = item.get_attribute(\"meta:name\")\n            if name == keyname:\n                found = True\n                break\n        if not found:\n            return None\n        result[\"name\"] = name\n        value, value_type, text = self._get_meta_value(item, full=True)  # type: ignore\n        result[\"value\"] = value\n        result[\"value_type\"] = value_type\n        result[\"text\"] = text\n        return result\n\n    def set_user_defined_metadata(self, name: str, value: Any) -&gt; None:\n        if isinstance(value, bool):\n            value_type = \"boolean\"\n            value = \"true\" if value else \"false\"\n        elif isinstance(value, (int, float, Decimal)):\n            value_type = \"float\"\n            value = str(value)\n        elif isinstance(value, dtdate):\n            value_type = \"date\"\n            value = str(Date.encode(value))\n        elif isinstance(value, datetime):\n            value_type = \"date\"\n            value = str(DateTime.encode(value))\n        elif isinstance(value, str):\n            value_type = \"string\"\n        elif isinstance(value, timedelta):\n            value_type = \"time\"\n            value = str(Duration.encode(value))\n        else:\n            raise TypeError(f'unexpected type \"{type(value)}\" for value')\n        # Already the same element ?\n        for metadata in self.get_elements(\"//meta:user-defined\"):\n            if not isinstance(metadata, Element):\n                continue\n            if metadata.get_attribute(\"meta:name\") == name:\n                break\n        else:\n            metadata = Element.from_tag(\"meta:user-defined\")\n            metadata.set_attribute(\"meta:name\", name)\n            self.get_meta_body().append(metadata)\n        metadata.set_attribute(\"meta:value-type\", value_type)\n        metadata.text = value\n\n    def _get_meta_value(\n        self, element: Element, full: bool = False\n    ) -&gt; Any | tuple[Any, str, str]:\n        \"\"\"get_value() deicated to the meta data part, for one meta element.\"\"\"\n        if full:\n            return self._get_meta_value_full(element)\n        else:\n            return self._get_meta_value_full(element)[0]\n\n    @staticmethod\n    def _get_meta_value_full(element: Element) -&gt; tuple[Any, str, str]:\n        \"\"\"get_value deicated to the meta data part, for one meta element.\"\"\"\n        # name = element.get_attribute('meta:name')\n        value_type = element.get_attribute_string(\"meta:value-type\")\n        if value_type is None:\n            value_type = \"string\"\n        text = element.text\n        # Interpretation\n        if value_type == \"boolean\":\n            return (Boolean.decode(text), value_type, text)\n        if value_type in (\"float\", \"percentage\", \"currency\"):\n            return (Decimal(text), value_type, text)\n        if value_type == \"date\":\n            if \"T\" in text:\n                return (DateTime.decode(text), value_type, text)\n            else:\n                return (Date.decode(text), value_type, text)\n        if value_type == \"string\":\n            return (text, value_type, text)\n        if value_type == \"time\":\n            return (Duration.decode(text), value_type, text)\n        raise TypeError(f\"Unknown value type: '{value_type!r}'\")\n</code></pre>"},{"location":"reference.html#odfdo.Meta.auto_reload","title":"<code>auto_reload: MetaAutoReload | None</code>  <code>property</code>","text":"<p>Get the MetaAutoReload  element or None."},{"location":"reference.html#odfdo.Meta.creation_date","title":"<code>creation_date: datetime | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the date and time when a document was created . <p>If provided datetime is None, use current time.</p> <p>Return: datetime (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.description","title":"<code>description: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the description of a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.editing_cycles","title":"<code>editing_cycles: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the number of times a document has been edited . <p>When a document is created, this value is set to 1. Each time a document is saved, the editing-cycles number is incremented by 1.</p> <p>Return: int (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.editing_duration","title":"<code>editing_duration: timedelta | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the total time spent editing a document . <p>Return: timedelta (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.generator","title":"<code>generator: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the signature of the software that generated this document.</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.generator\nKOffice/2.0.0\n&gt;&gt;&gt; document.meta.generator = \"Odfdo experiment\"\n</code></pre>"},{"location":"reference.html#odfdo.Meta.hyperlink_behaviour","title":"<code>hyperlink_behaviour: MetaAutoReload | None</code>  <code>property</code>","text":"<p>Get the MetaHyperlinkBehaviour  element or None."},{"location":"reference.html#odfdo.Meta.initial_creator","title":"<code>initial_creator: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the initial creator of a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.keyword","title":"<code>keyword: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set some keyword(s) keyword pertaining to a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.language","title":"<code>language: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the default language of the document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.print_date","title":"<code>print_date: datetime | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the date and time when a document when a document was last printed  <p>If provided datetime is None, use current time.</p> <p>Return: datetime (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.printed_by","title":"<code>printed_by: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the name of the last person who printed a document.  <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.statistic","title":"<code>statistic: dict[str, int] | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the statistics about a document . <p>Return: dict (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.get_statistic():\n{'meta:table-count': 1,\n 'meta:image-count': 2,\n 'meta:object-count': 3,\n 'meta:page-count': 4,\n 'meta:paragraph-count': 5,\n 'meta:word-count': 6,\n 'meta:character-count': 7}\n</code></pre>"},{"location":"reference.html#odfdo.Meta.subject","title":"<code>subject: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the subject of a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.template","title":"<code>template: MetaTemplate | None</code>  <code>property</code>","text":"<p>Get the MetaTemplate  element or None."},{"location":"reference.html#odfdo.Meta.title","title":"<code>title: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the title of the document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.user_defined_metadata","title":"<code>user_defined_metadata: dict[str, Any]</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set all additional user-defined metadata for a document.</p> <p>Return a dict of str/value mapping.</p> <p>Value types can be: Decimal, date, time, boolean or str.</p>"},{"location":"reference.html#odfdo.Meta.clear_user_defined_metadata","title":"<code>clear_user_defined_metadata()</code>","text":"<p>Remove all user-defined metadata.</p> Source code in <code>odfdo/meta.py</code> <pre><code>def clear_user_defined_metadata(self) -&gt; None:\n    \"\"\"Remove all user-defined metadata.\"\"\"\n    while True:\n        element = self.get_element(\"//meta:user-defined\")\n        if isinstance(element, Element):\n            element.delete()\n            continue\n        break\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_auto_reload","title":"<code>get_auto_reload()</code>","text":"<p>Get the MetaAutoReload  element or None. Source code in <code>odfdo/meta.py</code> <pre><code>def get_auto_reload(self) -&gt; MetaAutoReload | None:\n    \"\"\"Get the MetaAutoReload &lt;meta:auto-reload&gt; element or None.\"\"\"\n    element = self.get_element(\"//meta:auto-reload\")\n    if element is None:\n        return None\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_creation_date","title":"<code>get_creation_date()</code>","text":"<p>Get the creation date of the document.</p> <p>(Also available as \u201cself.creation_date\u201d property.)</p> <p>Return: datetime (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_creation_date(self) -&gt; datetime | None:\n    \"\"\"Get the creation date of the document.\n\n    (Also available as \"self.creation_date\" property.)\n\n    Return: datetime (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:creation-date\")\n    if element is None:\n        return None\n    creation_date = element.text\n    return DateTime.decode(creation_date)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_description","title":"<code>get_description()</code>","text":"<p>Get the description of the document. Also known as comments.</p> <p>(Also available as \u201cself.description\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_description(self) -&gt; str | None:\n    \"\"\"Get the description of the document. Also known as comments.\n\n    (Also available as \"self.description\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//dc:description\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_editing_cycles","title":"<code>get_editing_cycles()</code>","text":"<p>Get the number of times the document was edited, as reported by the generator.</p> <p>(Also available as \u201cself.editing_cycles\u201d property.)</p> <p>Return: int (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_editing_cycles(self) -&gt; int | None:\n    \"\"\"Get the number of times the document was edited, as reported by\n    the generator.\n\n    (Also available as \"self.editing_cycles\" property.)\n\n    Return: int (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:editing-cycles\")\n    if element is None:\n        return None\n    cycles = element.text\n    return int(cycles)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_editing_duration","title":"<code>get_editing_duration()</code>","text":"<p>Get the time the document was edited, as reported by the generator.</p> <p>(Also available as \u201cself.editing_duration\u201d property.)</p> <p>Return: timedelta (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_editing_duration(self) -&gt; timedelta | None:\n    \"\"\"Get the time the document was edited, as reported by the\n    generator.\n\n    (Also available as \"self.editing_duration\" property.)\n\n    Return: timedelta (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:editing-duration\")\n    if element is None:\n        return None\n    duration = element.text\n    return Duration.decode(duration)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_generator","title":"<code>get_generator()</code>","text":"<p>Get the signature of the software that generated this document.</p> <p>(Also available as \u201cself.generator\u201d property.)</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.get_generator()\nKOffice/2.0.0\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_generator(self) -&gt; str | None:\n    \"\"\"Get the signature of the software that generated this document.\n\n    (Also available as \"self.generator\" property.)\n\n    Return: str (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.get_generator()\n        KOffice/2.0.0\n    \"\"\"\n    return self.generator\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_hyperlink_behaviour","title":"<code>get_hyperlink_behaviour()</code>","text":"<p>Get the MetaHyperlinkBehaviour  element or None. Source code in <code>odfdo/meta.py</code> <pre><code>def get_hyperlink_behaviour(self) -&gt; MetaHyperlinkBehaviour | None:\n    \"\"\"Get the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element or None.\"\"\"\n    element = self.get_element(\"//meta:hyperlink-behaviour\")\n    if element is None:\n        return None\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_initial_creator","title":"<code>get_initial_creator()</code>","text":"<p>Get the first creator of the document.</p> <p>(Also available as \u201cself.initial_creator\u201d property.)</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.get_initial_creator()\nUnknown\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_initial_creator(self) -&gt; str | None:\n    \"\"\"Get the first creator of the document.\n\n    (Also available as \"self.initial_creator\" property.)\n\n    Return: str (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.get_initial_creator()\n        Unknown\n    \"\"\"\n    element = self.get_element(\"//meta:initial-creator\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_keywords","title":"<code>get_keywords()</code>","text":"<p>Get the keywords of the document. Return the field as-is, without any assumption on the keyword separator.</p> <p>(Also available as \u201cself.keyword\u201d and \u201cself.keywords\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_keywords(self) -&gt; str | None:\n    \"\"\"Get the keywords of the document. Return the field as-is, without\n    any assumption on the keyword separator.\n\n    (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:keyword\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_language","title":"<code>get_language()</code>","text":"<p>Get the default language of the document.</p> <p>(Also available as \u201cself.language\u201d property.)</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.get_language()\nfr-FR\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_language(self) -&gt; str | None:\n    \"\"\"Get the default language of the document.\n\n    (Also available as \"self.language\" property.)\n\n    Return: str (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.get_language()\n        fr-FR\n    \"\"\"\n    element = self.get_element(\"//dc:language\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_statistic","title":"<code>get_statistic()</code>","text":"<p>Get the statistics about a document.</p> <p>(Also available as \u201cself.statistic\u201d property.)</p> <p>Return: dict (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.get_statistic():\n{'meta:table-count': 1,\n 'meta:image-count': 2,\n 'meta:object-count': 3,\n 'meta:page-count': 4,\n 'meta:paragraph-count': 5,\n 'meta:word-count': 6,\n 'meta:character-count': 7}\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_statistic(self) -&gt; dict[str, int] | None:\n    \"\"\"Get the statistics about a document.\n\n    (Also available as \"self.statistic\" property.)\n\n    Return: dict (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.get_statistic():\n        {'meta:table-count': 1,\n         'meta:image-count': 2,\n         'meta:object-count': 3,\n         'meta:page-count': 4,\n         'meta:paragraph-count': 5,\n         'meta:word-count': 6,\n         'meta:character-count': 7}\n    \"\"\"\n    element = self.get_element(\"//meta:document-statistic\")\n    if element is None:\n        return None\n    statistic = {}\n    for key, value in element.attributes.items():\n        statistic[to_str(key)] = int(value)\n    return statistic\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_subject","title":"<code>get_subject()</code>","text":"<p>Get the subject of the document.</p> <p>(Also available as \u201cself.subject\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_subject(self) -&gt; str | None:\n    \"\"\"Get the subject of the document.\n\n    (Also available as \"self.subject\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//dc:subject\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_template","title":"<code>get_template()</code>","text":"<p>Get the MetaTemplate  element or None. Source code in <code>odfdo/meta.py</code> <pre><code>def get_template(self) -&gt; MetaTemplate | None:\n    \"\"\"Get the MetaTemplate &lt;meta:template&gt; element or None.\"\"\"\n    element = self.get_element(\"//meta:template\")\n    if element is None:\n        return None\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_title","title":"<code>get_title()</code>","text":"<p>Get the title of the document.</p> <p>This is not the first heading but the title metadata.</p> <p>(Also available as \u201cself.title\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_title(self) -&gt; str | None:\n    \"\"\"Get the title of the document.\n\n    This is not the first heading but the title metadata.\n\n    (Also available as \"self.title\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//dc:title\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_user_defined_metadata","title":"<code>get_user_defined_metadata()</code>","text":"<p>Get all additional user-defined metadata for a document.</p> <p>(Also available as \u201cself.user_defined_metadata\u201d property.)</p> <p>Return a dict of str/value mapping.</p> <p>Value types can be: Decimal, date, time, boolean or str.</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_user_defined_metadata(self) -&gt; dict[str, Any]:\n    \"\"\"Get all additional user-defined metadata for a document.\n\n    (Also available as \"self.user_defined_metadata\" property.)\n\n    Return a dict of str/value mapping.\n\n    Value types can be: Decimal, date, time, boolean or str.\n    \"\"\"\n    result: dict[str, Any] = {}\n    for item in self.get_elements(\"//meta:user-defined\"):\n        if not isinstance(item, Element):\n            continue\n        # Read the values\n        name = item.get_attribute_string(\"meta:name\")\n        if name is None:\n            continue\n        value = self._get_meta_value(item)\n        result[name] = value\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_user_defined_metadata_of_name","title":"<code>get_user_defined_metadata_of_name(keyname)</code>","text":"<p>Return the content of the user defined metadata of that name. Return None if no name matchs or a dic of fields.</p> <p>Arguments:</p> <pre><code>name -- string, name (meta:name content)\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_user_defined_metadata_of_name(self, keyname: str) -&gt; dict[str, Any] | None:\n    \"\"\"Return the content of the user defined metadata of that name.\n    Return None if no name matchs or a dic of fields.\n\n    Arguments:\n\n        name -- string, name (meta:name content)\n    \"\"\"\n    result = {}\n    found = False\n    for item in self.get_elements(\"//meta:user-defined\"):\n        if not isinstance(item, Element):\n            continue\n        # Read the values\n        name = item.get_attribute(\"meta:name\")\n        if name == keyname:\n            found = True\n            break\n    if not found:\n        return None\n    result[\"name\"] = name\n    value, value_type, text = self._get_meta_value(item, full=True)  # type: ignore\n    result[\"value\"] = value\n    result[\"value_type\"] = value_type\n    result[\"text\"] = text\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_auto_reload","title":"<code>set_auto_reload(delay, href='')</code>","text":"<p>Set the MetaAutoReload  element. Source code in <code>odfdo/meta.py</code> <pre><code>def set_auto_reload(self, delay: timedelta, href: str = \"\") -&gt; None:\n    \"\"\"Set the MetaAutoReload &lt;meta:auto-reload&gt; element.\"\"\"\n    autoreload = MetaAutoReload(delay=delay, href=href)\n    current = self.auto_reload\n    if isinstance(current, MetaAutoReload):\n        current.delete()\n    self.get_meta_body().append(autoreload)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_creation_date","title":"<code>set_creation_date(date=None)</code>","text":"<p>Set the creation date of the document.</p> <p>If provided datetime is None, use current time.</p> <p>(Also available as \u201cself.creation_date\u201d property.)</p> <p>Arguments:</p> <pre><code>date -- datetime\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_creation_date(self, date: datetime | None = None) -&gt; None:\n    \"\"\"Set the creation date of the document.\n\n    If provided datetime is None, use current time.\n\n    (Also available as \"self.creation_date\" property.)\n\n    Arguments:\n\n        date -- datetime\n    \"\"\"\n    element = self.get_element(\"//meta:creation-date\")\n    if element is None:\n        element = Element.from_tag(\"meta:creation-date\")\n        self.get_meta_body().append(element)\n    if date is None:\n        date = datetime.now()\n    element.text = DateTime.encode(date)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_description","title":"<code>set_description(description)</code>","text":"<p>Set the description of the document. Also known as comments.</p> <p>(Also available as \u201cself.description\u201d property.)</p> <p>Arguments:</p> <pre><code>description -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_description(self, description: str) -&gt; None:\n    \"\"\"Set the description of the document. Also known as comments.\n\n    (Also available as \"self.description\" property.)\n\n    Arguments:\n\n        description -- str\n    \"\"\"\n    element = self.get_element(\"//dc:description\")\n    if element is None:\n        element = Element.from_tag(\"dc:description\")\n        self.get_meta_body().append(element)\n    element.text = description\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_editing_cycles","title":"<code>set_editing_cycles(cycles)</code>","text":"<p>Set the number of times the document was edited.</p> <p>(Also available as \u201cself.editing_cycles\u201d property.)</p> <p>Arguments:</p> <pre><code>cycles -- int\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_editing_cycles(self, cycles: int) -&gt; None:\n    \"\"\"Set the number of times the document was edited.\n\n    (Also available as \"self.editing_cycles\" property.)\n\n    Arguments:\n\n        cycles -- int\n    \"\"\"\n    if not isinstance(cycles, int):\n        raise TypeError(\"cycles must be an int\")\n    if cycles &lt; 1:\n        raise ValueError(\"cycles must be a positive int\")\n    element = self.get_element(\"//meta:editing-cycles\")\n    if element is None:\n        element = Element.from_tag(\"meta:editing-cycles\")\n        self.get_meta_body().append(element)\n    element.text = str(cycles)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_editing_duration","title":"<code>set_editing_duration(duration)</code>","text":"<p>Set the time the document was edited.</p> <p>(Also available as \u201cself.editing_duration\u201d property.)</p> <p>Arguments:</p> <pre><code>duration -- timedelta\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_editing_duration(self, duration: timedelta) -&gt; None:\n    \"\"\"Set the time the document was edited.\n\n    (Also available as \"self.editing_duration\" property.)\n\n    Arguments:\n\n        duration -- timedelta\n    \"\"\"\n    if not isinstance(duration, timedelta):\n        raise TypeError(\"duration must be a timedelta\")\n    element = self.get_element(\"//meta:editing-duration\")\n    if element is None:\n        element = Element.from_tag(\"meta:editing-duration\")\n        self.get_meta_body().append(element)\n    element.text = Duration.encode(duration)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_generator","title":"<code>set_generator(generator)</code>","text":"<p>Set the signature of the software that generated this document.</p> <p>(Also available as \u201cself.generator\u201d property.)</p> <p>Arguments:</p> <pre><code>generator -- str\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_generator(\"Odfdo experiment\")\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_generator(self, generator: str) -&gt; None:\n    \"\"\"Set the signature of the software that generated this document.\n\n    (Also available as \"self.generator\" property.)\n\n    Arguments:\n\n        generator -- str\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_generator(\"Odfdo experiment\")\n    \"\"\"\n    self.generator = generator\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_generator_default","title":"<code>set_generator_default()</code>","text":"<p>Set the signature of the software that generated this document to ourself.</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_generator_default()\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_generator_default(self) -&gt; None:\n    \"\"\"Set the signature of the software that generated this document\n    to ourself.\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_generator_default()\n    \"\"\"\n    if not self._generator_modified:\n        self.generator = GENERATOR\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_hyperlink_behaviour","title":"<code>set_hyperlink_behaviour(target_frame_name='_blank', show='replace')</code>","text":"<p>Set the MetaHyperlinkBehaviour  element. Source code in <code>odfdo/meta.py</code> <pre><code>def set_hyperlink_behaviour(\n    self,\n    target_frame_name: str = \"_blank\",\n    show: str = \"replace\",\n) -&gt; None:\n    \"\"\"Set the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element.\"\"\"\n    behaviour = MetaHyperlinkBehaviour(\n        target_frame_name=target_frame_name, show=show\n    )\n    current = self.hyperlink_behaviour\n    if isinstance(current, MetaHyperlinkBehaviour):\n        current.delete()\n    self.get_meta_body().append(behaviour)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_initial_creator","title":"<code>set_initial_creator(creator)</code>","text":"<p>Set the first creator of the document.</p> <p>(Also available as \u201cself.initial_creator\u201d property.)</p> <p>Arguments:</p> <pre><code>creator -- str\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_initial_creator(\"Plato\")\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_initial_creator(self, creator: str) -&gt; None:\n    \"\"\"Set the first creator of the document.\n\n    (Also available as \"self.initial_creator\" property.)\n\n    Arguments:\n\n        creator -- str\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_initial_creator(\"Plato\")\n    \"\"\"\n    element = self.get_element(\"//meta:initial-creator\")\n    if element is None:\n        element = Element.from_tag(\"meta:initial-creator\")\n        self.get_meta_body().append(element)\n    element.text = creator\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_keywords","title":"<code>set_keywords(keywords)</code>","text":"<p>Set the keywords of the document. Although the name is plural, a str string is required, so join your list first.</p> <p>(Also available as \u201cself.keyword\u201d and \u201cself.keywords\u201d property.)</p> <p>Arguments:</p> <pre><code>keywords -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_keywords(self, keywords: str) -&gt; None:\n    \"\"\"Set the keywords of the document. Although the name is plural, a\n    str string is required, so join your list first.\n\n    (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n    Arguments:\n\n        keywords -- str\n    \"\"\"\n    element = self.get_element(\"//meta:keyword\")\n    if element is None:\n        element = Element.from_tag(\"meta:keyword\")\n        self.get_meta_body().append(element)\n    element.text = keywords\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_language","title":"<code>set_language(language)</code>","text":"<p>Set the default language of the document.</p> <p>(Also available as \u201cself.language\u201d property.)</p> <p>Arguments:</p> <pre><code>language -- str\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_language('fr-FR')\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_language(self, language: str) -&gt; None:\n    \"\"\"Set the default language of the document.\n\n    (Also available as \"self.language\" property.)\n\n    Arguments:\n\n        language -- str\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_language('fr-FR')\n    \"\"\"\n    language = str(language)\n    if not self._is_RFC3066(language):\n        raise TypeError(\n            'Language must be \"xx\" lang or \"xx-YY\" lang-COUNTRY code (RFC3066)'\n        )\n    element = self.get_element(\"//dc:language\")\n    if element is None:\n        element = Element.from_tag(\"dc:language\")\n        self.get_meta_body().append(element)\n    element.text = language\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_statistic","title":"<code>set_statistic(statistic)</code>","text":"<p>Set the statistics about a document.</p> <p>(Also available as \u201cself.statistic\u201d property.)</p> <p>Arguments:</p> <pre><code>statistic -- dict\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; statistic = {'meta:table-count': 1,\n                 'meta:image-count': 2,\n                 'meta:object-count': 3,\n                 'meta:page-count': 4,\n                 'meta:paragraph-count': 5,\n                 'meta:word-count': 6,\n                 'meta:character-count': 7}\n&gt;&gt;&gt; document.meta.set_statistic(statistic)\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_statistic(self, statistic: dict[str, int]) -&gt; None:\n    \"\"\"Set the statistics about a document.\n\n    (Also available as \"self.statistic\" property.)\n\n    Arguments:\n\n        statistic -- dict\n\n    Example::\n\n        &gt;&gt;&gt; statistic = {'meta:table-count': 1,\n                         'meta:image-count': 2,\n                         'meta:object-count': 3,\n                         'meta:page-count': 4,\n                         'meta:paragraph-count': 5,\n                         'meta:word-count': 6,\n                         'meta:character-count': 7}\n        &gt;&gt;&gt; document.meta.set_statistic(statistic)\n    \"\"\"\n    if not isinstance(statistic, dict):\n        raise TypeError(\"Statistic must be a dict\")\n    element = self.get_element(\"//meta:document-statistic\")\n    for key, value in statistic.items():\n        try:\n            ivalue = int(value)\n        except ValueError as e:\n            raise TypeError(\"Statistic value must be a int\") from e\n        element.set_attribute(to_str(key), str(ivalue))\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_subject","title":"<code>set_subject(subject)</code>","text":"<p>Set the subject of the document.</p> <p>(Also available as \u201cself.subject\u201d property.)</p> <p>Arguments:</p> <pre><code>subject -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_subject(self, subject: str) -&gt; None:\n    \"\"\"Set the subject of the document.\n\n    (Also available as \"self.subject\" property.)\n\n    Arguments:\n\n        subject -- str\n    \"\"\"\n    element = self.get_element(\"//dc:subject\")\n    if element is None:\n        element = Element.from_tag(\"dc:subject\")\n        self.get_meta_body().append(element)\n    element.text = subject\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_template","title":"<code>set_template(date=None, href='', title='')</code>","text":"<p>Set the MetaTemplate  element. Source code in <code>odfdo/meta.py</code> <pre><code>def set_template(\n    self,\n    date: datetime | None = None,\n    href: str = \"\",\n    title: str = \"\",\n) -&gt; None:\n    \"\"\"Set the MetaTemplate &lt;meta:template&gt; element.\"\"\"\n    template = MetaTemplate(date=date, href=href, title=title)\n    current = self.template\n    if isinstance(current, MetaTemplate):\n        current.delete()\n    self.get_meta_body().append(template)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_title","title":"<code>set_title(title)</code>","text":"<p>Set the title of the document.</p> <p>This is not the first heading but the title metadata.</p> <p>(Also available as \u201cself.title\u201d property.)</p> <p>Arguments:</p> <pre><code>title -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_title(self, title: str) -&gt; None:\n    \"\"\"Set the title of the document.\n\n    This is not the first heading but the title metadata.\n\n    (Also available as \"self.title\" property.)\n\n    Arguments:\n\n        title -- str\n    \"\"\"\n    element = self.get_element(\"//dc:title\")\n    if element is None:\n        element = Element.from_tag(\"dc:title\")\n        self.get_meta_body().append(element)\n    element.text = title\n</code></pre>"},{"location":"reference.html#odfdo.MetaAutoReload","title":"<code>MetaAutoReload</code>","text":"<p>             Bases: <code>Element</code></p> Source code in <code>odfdo/meta_auto_reload.py</code> <pre><code>class MetaAutoReload(Element):\n    _tag = \"meta:auto-reload\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"delay\", \"meta:delay\"),\n        PropDef(\"actuate\", \"xlink:actuate\"),\n        PropDef(\"href\", \"xlink:href\"),\n        PropDef(\"show\", \"xlink:show\"),\n        PropDef(\"type\", \"xlink:type\"),\n    )\n\n    def __init__(\n        self,\n        delay: timedelta | None = None,\n        href: str = \"\",\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        The &lt;meta:auto-reload&gt; element specifies whether a document is\n        reloaded or replaced by another document after a specified period\n        of time has elapsed.\n\n        Arguments:\n\n            delay -- timedelta\n\n            href -- str\n        \"\"\"\n        super().__init__(**kwargs)\n\n        self.actuate = \"onLoad\"\n        self.show = \"replace\"\n        self.type = \"simple\"\n        if self._do_init:\n            if not isinstance(delay, timedelta):\n                raise TypeError(\"delay must be a timedelta\")\n            self.delay = Duration.encode(delay)\n            self.href = href\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag} href={self.href} delay={Duration.decode(self.delay)}&gt;\"\n\n    def __str__(self) -&gt; str:\n        return f\"({self.href})\"\n</code></pre>"},{"location":"reference.html#odfdo.MetaAutoReload.__init__","title":"<code>__init__(delay=None, href='', **kwargs)</code>","text":"<p>The  element specifies whether a document is reloaded or replaced by another document after a specified period of time has elapsed. <p>Arguments:</p> <pre><code>delay -- timedelta\n\nhref -- str\n</code></pre> Source code in <code>odfdo/meta_auto_reload.py</code> <pre><code>def __init__(\n    self,\n    delay: timedelta | None = None,\n    href: str = \"\",\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    The &lt;meta:auto-reload&gt; element specifies whether a document is\n    reloaded or replaced by another document after a specified period\n    of time has elapsed.\n\n    Arguments:\n\n        delay -- timedelta\n\n        href -- str\n    \"\"\"\n    super().__init__(**kwargs)\n\n    self.actuate = \"onLoad\"\n    self.show = \"replace\"\n    self.type = \"simple\"\n    if self._do_init:\n        if not isinstance(delay, timedelta):\n            raise TypeError(\"delay must be a timedelta\")\n        self.delay = Duration.encode(delay)\n        self.href = href\n</code></pre>"},{"location":"reference.html#odfdo.MetaHyperlinkBehaviour","title":"<code>MetaHyperlinkBehaviour</code>","text":"<p>             Bases: <code>Element</code></p> Source code in <code>odfdo/meta_hyperlink_behaviour.py</code> <pre><code>class MetaHyperlinkBehaviour(Element):\n    _tag = \"meta:hyperlink-behaviour\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"target_frame_name\", \"office:target-frame-name\"),\n        PropDef(\"show\", \"xlink:show\"),\n    )\n\n    def __init__(\n        self,\n        target_frame_name: str = \"_blank\",\n        show: str = \"replace\",\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        The &lt;meta:hyperlink-behaviour&gt; element specifies the default behavior\n        for hyperlinks in a document.\n\n        Arguments:\n\n            target_frame_name -- str\n\n            show -- str\n        \"\"\"\n        super().__init__(**kwargs)\n\n        if self._do_init:\n            self.target_frame_name = target_frame_name\n            self.show = show\n\n    def __repr__(self) -&gt; str:\n        return (\n            f\"&lt;{self.__class__.__name__} tag={self.tag} \"\n            f\"target={self.target_frame_name} show={self.show}&gt;\"\n        )\n\n    def __str__(self) -&gt; str:\n        return f\"({self.target_frame_name})\"\n</code></pre>"},{"location":"reference.html#odfdo.MetaHyperlinkBehaviour.__init__","title":"<code>__init__(target_frame_name='_blank', show='replace', **kwargs)</code>","text":"<p>The  element specifies the default behavior for hyperlinks in a document. <p>Arguments:</p> <pre><code>target_frame_name -- str\n\nshow -- str\n</code></pre> Source code in <code>odfdo/meta_hyperlink_behaviour.py</code> <pre><code>def __init__(\n    self,\n    target_frame_name: str = \"_blank\",\n    show: str = \"replace\",\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    The &lt;meta:hyperlink-behaviour&gt; element specifies the default behavior\n    for hyperlinks in a document.\n\n    Arguments:\n\n        target_frame_name -- str\n\n        show -- str\n    \"\"\"\n    super().__init__(**kwargs)\n\n    if self._do_init:\n        self.target_frame_name = target_frame_name\n        self.show = show\n</code></pre>"},{"location":"reference.html#odfdo.MetaTemplate","title":"<code>MetaTemplate</code>","text":"<p>             Bases: <code>Element</code></p> Source code in <code>odfdo/meta_template.py</code> <pre><code>class MetaTemplate(Element):\n    _tag = \"meta:template\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"date\", \"meta:date\"),\n        PropDef(\"actuate\", \"xlink:actuate\"),\n        PropDef(\"href\", \"xlink:href\"),\n        PropDef(\"title\", \"xlink:title\"),\n        PropDef(\"type\", \"xlink:type\"),\n    )\n\n    def __init__(\n        self,\n        date: datetime | None = None,\n        href: str = \"\",\n        title: str = \"\",\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        The &lt;meta:template&gt; element specifies a IRI for the document template\n        that was used to create a document. The IRI is specified as an\n        Xlink.\n\n        Arguments:\n\n            date -- datetime or None\n\n            href -- str\n\n            title -- str\n        \"\"\"\n        super().__init__(**kwargs)\n\n        self.actuate = \"onRequest\"\n        self.type = \"simple\"\n        if self._do_init:\n            if date is None:\n                date = datetime.now()\n            self.date = DateTime.encode(date)\n            self.href = href\n            self.title = title\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag} href={self.href}&gt;\"\n\n    def __str__(self) -&gt; str:\n        if self.title:\n            return f\"[{self.title}]({self.href})\"\n        return f\"({self.href})\"\n</code></pre>"},{"location":"reference.html#odfdo.MetaTemplate.__init__","title":"<code>__init__(date=None, href='', title='', **kwargs)</code>","text":"<p>The  element specifies a IRI for the document template that was used to create a document. The IRI is specified as an Xlink. <p>Arguments:</p> <pre><code>date -- datetime or None\n\nhref -- str\n\ntitle -- str\n</code></pre> Source code in <code>odfdo/meta_template.py</code> <pre><code>def __init__(\n    self,\n    date: datetime | None = None,\n    href: str = \"\",\n    title: str = \"\",\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    The &lt;meta:template&gt; element specifies a IRI for the document template\n    that was used to create a document. The IRI is specified as an\n    Xlink.\n\n    Arguments:\n\n        date -- datetime or None\n\n        href -- str\n\n        title -- str\n    \"\"\"\n    super().__init__(**kwargs)\n\n    self.actuate = \"onRequest\"\n    self.type = \"simple\"\n    if self._do_init:\n        if date is None:\n            date = datetime.now()\n        self.date = DateTime.encode(date)\n        self.href = href\n        self.title = title\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange","title":"<code>NamedRange</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF Named Range \u201ctable:named-range\u201d. Identifies inside the spreadsheet a range of cells of a table by a name and the name of the table.</p> <p>Name Ranges have the following attributes:</p> <pre><code>name -- name of the named range\n\ntable_name -- name of the table\n\nstart -- first cell of the named range, tuple (x, y)\n\nend -- last cell of the named range, tuple (x, y)\n\ncrange -- range of the named range, tuple (x, y, z, t)\n\nusage -- None or str, usage of the named range.\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>class NamedRange(Element):\n    \"\"\"ODF Named Range \"table:named-range\". Identifies inside the spreadsheet\n    a range of cells of a table by a name and the name of the table.\n\n    Name Ranges have the following attributes:\n\n        name -- name of the named range\n\n        table_name -- name of the table\n\n        start -- first cell of the named range, tuple (x, y)\n\n        end -- last cell of the named range, tuple (x, y)\n\n        crange -- range of the named range, tuple (x, y, z, t)\n\n        usage -- None or str, usage of the named range.\n    \"\"\"\n\n    _tag = \"table:named-range\"\n\n    def __init__(\n        self,\n        name: str | None = None,\n        crange: str | tuple | list | None = None,\n        table_name: str | None = None,\n        usage: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a Named Range element. 'name' must contains only letters, digits\n           and '_', and must not be like a coordinate as 'A1'. 'table_name' must be\n           a correct table name (no \"'\" or \"/\" in it).\n\n        Arguments:\n\n             name -- str, name of the named range\n\n             crange -- str or tuple of int, cell or area coordinate\n\n             table_name -- str, name of the table\n\n             usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n        \"\"\"\n        super().__init__(**kwargs)\n        self.usage = None\n        if self._do_init:\n            self.name = name or \"\"\n            self.table_name = _table_name_check(table_name)\n            self.set_range(crange or \"\")\n            self.set_usage(usage)\n        cell_range_address = self.get_attribute_string(\"table:cell-range-address\") or \"\"\n        if not cell_range_address:\n            self.table_name = \"\"\n            self.start = None\n            self.end = None\n            self.crange = None\n            self.usage = None\n            return\n        self.usage = self.get_attribute(\"table:range-usable-as\")\n        name_range = cell_range_address.replace(\"$\", \"\")\n        name, crange = name_range.split(\".\", 1)\n        if name.startswith(\"'\") and name.endswith(\"'\"):\n            name = name[1:-1]\n        self.table_name = name\n        crange = crange.replace(\".\", \"\")\n        self._set_range(crange)\n\n    def set_usage(self, usage: str | None = None) -&gt; None:\n        \"\"\"Set the usage of the Named Range. Usage can be None (default) or one\n        of :\n            'print-range'\n            'filter'\n            'repeat-column'\n            'repeat-row'\n\n        Arguments:\n\n            usage -- None or str\n        \"\"\"\n        if usage is not None:\n            usage = usage.strip().lower()\n            if usage not in (\"print-range\", \"filter\", \"repeat-column\", \"repeat-row\"):\n                usage = None\n        if usage is None:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:range-usable-as\")\n            self.usage = None\n        else:\n            self.set_attribute(\"table:range-usable-as\", usage)\n            self.usage = usage\n\n    @property\n    def name(self) -&gt; str | None:\n        \"\"\"Get / set the name of the table.\"\"\"\n        return self.get_attribute_string(\"table:name\")\n\n    @name.setter\n    def name(self, name: str) -&gt; None:\n        \"\"\"Set the name of the Named Range. The name is mandatory, if a Named\n        Range of the same name exists, it will be replaced. Name must contains\n        only alphanumerics characters and '_', and can not be of a cell\n        coordinates form like 'AB12'.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        name = name.strip()\n        if not name:\n            raise ValueError(\"Name required.\")\n        for x in name:\n            if x in forbidden_in_named_range():\n                raise ValueError(f\"Character forbidden '{x}' \")\n        step = \"\"\n        for x in name:\n            if x in string.ascii_letters and step in (\"\", \"A\"):\n                step = \"A\"\n                continue\n            elif step in (\"A\", \"A1\") and x in string.digits:\n                step = \"A1\"\n                continue\n            else:\n                step = \"\"\n                break\n        if step == \"A1\":\n            raise ValueError(\"Name of the type 'ABC123' is not allowed.\")\n        with contextlib.suppress(Exception):\n            # we are not on an inserted in a document.\n            body = self.document_body\n            named_range = body.get_named_range(name)  # type: ignore\n            if named_range:\n                named_range.delete()\n        self.set_attribute(\"table:name\", name)\n\n    def set_table_name(self, name: str) -&gt; None:\n        \"\"\"Set the name of the table of the Named Range. The name is mandatory.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        self.table_name = _table_name_check(name)\n        self._update_attributes()\n\n    def _set_range(self, coord: tuple | list | str) -&gt; None:\n        digits = convert_coordinates(coord)\n        if len(digits) == 4:\n            x, y, z, t = digits\n        else:\n            x, y = digits\n            z, t = digits\n        self.start = x, y  # type: ignore\n        self.end = z, t  # type: ignore\n        self.crange = x, y, z, t  # type: ignore\n\n    def set_range(self, crange: str | tuple | list) -&gt; None:\n        \"\"\"Set the range of the named range. Range can be either one cell\n        (like 'A1') or an area ('A1:B2'). It can be provided as an alpha numeric\n        value like \"A1:B2' or a tuple like (0, 0, 1, 1) or (0, 0).\n\n        Arguments:\n\n            crange -- str or tuple of int, cell or area coordinate\n        \"\"\"\n        self._set_range(crange)\n        self._update_attributes()\n\n    def _update_attributes(self) -&gt; None:\n        self.set_attribute(\"table:base-cell-address\", self._make_base_cell_address())\n        self.set_attribute(\"table:cell-range-address\", self._make_cell_range_address())\n\n    def _make_base_cell_address(self) -&gt; str:\n        # assuming we got table_name and range\n        if \" \" in self.table_name:\n            name = f\"'{self.table_name}'\"\n        else:\n            name = self.table_name\n        return f\"${name}.${digit_to_alpha(self.start[0])}${self.start[1] + 1}\"  # type: ignore\n\n    def _make_cell_range_address(self) -&gt; str:\n        # assuming we got table_name and range\n        if \" \" in self.table_name:\n            name = f\"'{self.table_name}'\"\n        else:\n            name = self.table_name\n        if self.start == self.end:\n            return self._make_base_cell_address()\n        return (\n            f\"${name}.${digit_to_alpha(self.start[0])}${self.start[1] + 1}:\"  # type: ignore\n            f\".${digit_to_alpha(self.end[0])}${self.end[1] + 1}\"  # type: ignore\n        )\n\n    def get_values(\n        self,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n        flat: bool = False,\n    ) -&gt; list:\n        \"\"\"Shortcut to retrieve the values of the cells of the named range. See\n        table.get_values() for the arguments description and return format.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        return table.get_values(self.crange, cell_type, complete, get_type, flat)  # type: ignore\n\n    def get_value(self, get_type: bool = False) -&gt; Any:\n        \"\"\"Shortcut to retrieve the value of the first cell of the named range.\n        See table.get_value() for the arguments description and return format.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        return table.get_value(self.start, get_type)  # type: ignore\n\n    def set_values(\n        self,\n        values: list,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the values of the cells of the named range.\n        See table.set_values() for the arguments description.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        table.set_values(  # type: ignore\n            values,\n            coord=self.crange,\n            style=style,\n            cell_type=cell_type,\n            currency=currency,\n        )\n\n    def set_value(\n        self,\n        value: Any,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the value of the first cell of the named range.\n        See table.set_value() for the arguments description.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        table.set_value(  # type: ignore\n            coord=self.start,\n            value=value,\n            cell_type=cell_type,\n            currency=currency,\n            style=style,\n        )\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.name","title":"<code>name: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the name of the table.</p>"},{"location":"reference.html#odfdo.NamedRange.__init__","title":"<code>__init__(name=None, crange=None, table_name=None, usage=None, **kwargs)</code>","text":"<p>Create a Named Range element. \u2018name\u2019 must contains only letters, digits    and \u2018_\u2019, and must not be like a coordinate as \u2018A1\u2019. \u2018table_name\u2019 must be    a correct table name (no \u201c\u2019\u201d or \u201c/\u201d in it).</p> <p>Arguments:</p> <pre><code> name -- str, name of the named range\n\n crange -- str or tuple of int, cell or area coordinate\n\n table_name -- str, name of the table\n\n usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    name: str | None = None,\n    crange: str | tuple | list | None = None,\n    table_name: str | None = None,\n    usage: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a Named Range element. 'name' must contains only letters, digits\n       and '_', and must not be like a coordinate as 'A1'. 'table_name' must be\n       a correct table name (no \"'\" or \"/\" in it).\n\n    Arguments:\n\n         name -- str, name of the named range\n\n         crange -- str or tuple of int, cell or area coordinate\n\n         table_name -- str, name of the table\n\n         usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n    \"\"\"\n    super().__init__(**kwargs)\n    self.usage = None\n    if self._do_init:\n        self.name = name or \"\"\n        self.table_name = _table_name_check(table_name)\n        self.set_range(crange or \"\")\n        self.set_usage(usage)\n    cell_range_address = self.get_attribute_string(\"table:cell-range-address\") or \"\"\n    if not cell_range_address:\n        self.table_name = \"\"\n        self.start = None\n        self.end = None\n        self.crange = None\n        self.usage = None\n        return\n    self.usage = self.get_attribute(\"table:range-usable-as\")\n    name_range = cell_range_address.replace(\"$\", \"\")\n    name, crange = name_range.split(\".\", 1)\n    if name.startswith(\"'\") and name.endswith(\"'\"):\n        name = name[1:-1]\n    self.table_name = name\n    crange = crange.replace(\".\", \"\")\n    self._set_range(crange)\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.get_value","title":"<code>get_value(get_type=False)</code>","text":"<p>Shortcut to retrieve the value of the first cell of the named range. See table.get_value() for the arguments description and return format.</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_value(self, get_type: bool = False) -&gt; Any:\n    \"\"\"Shortcut to retrieve the value of the first cell of the named range.\n    See table.get_value() for the arguments description and return format.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    return table.get_value(self.start, get_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.get_values","title":"<code>get_values(cell_type=None, complete=True, get_type=False, flat=False)</code>","text":"<p>Shortcut to retrieve the values of the cells of the named range. See table.get_values() for the arguments description and return format.</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_values(\n    self,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n    flat: bool = False,\n) -&gt; list:\n    \"\"\"Shortcut to retrieve the values of the cells of the named range. See\n    table.get_values() for the arguments description and return format.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    return table.get_values(self.crange, cell_type, complete, get_type, flat)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_range","title":"<code>set_range(crange)</code>","text":"<p>Set the range of the named range. Range can be either one cell (like \u2018A1\u2019) or an area (\u2018A1:B2\u2019). It can be provided as an alpha numeric value like \u201cA1:B2\u2019 or a tuple like (0, 0, 1, 1) or (0, 0).</p> <p>Arguments:</p> <pre><code>crange -- str or tuple of int, cell or area coordinate\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_range(self, crange: str | tuple | list) -&gt; None:\n    \"\"\"Set the range of the named range. Range can be either one cell\n    (like 'A1') or an area ('A1:B2'). It can be provided as an alpha numeric\n    value like \"A1:B2' or a tuple like (0, 0, 1, 1) or (0, 0).\n\n    Arguments:\n\n        crange -- str or tuple of int, cell or area coordinate\n    \"\"\"\n    self._set_range(crange)\n    self._update_attributes()\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_table_name","title":"<code>set_table_name(name)</code>","text":"<p>Set the name of the table of the Named Range. The name is mandatory.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_table_name(self, name: str) -&gt; None:\n    \"\"\"Set the name of the table of the Named Range. The name is mandatory.\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    self.table_name = _table_name_check(name)\n    self._update_attributes()\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_usage","title":"<code>set_usage(usage=None)</code>","text":"<p>Set the usage of the Named Range. Usage can be None (default) or one of :     \u2018print-range\u2019     \u2018filter\u2019     \u2018repeat-column\u2019     \u2018repeat-row\u2019</p> <p>Arguments:</p> <pre><code>usage -- None or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_usage(self, usage: str | None = None) -&gt; None:\n    \"\"\"Set the usage of the Named Range. Usage can be None (default) or one\n    of :\n        'print-range'\n        'filter'\n        'repeat-column'\n        'repeat-row'\n\n    Arguments:\n\n        usage -- None or str\n    \"\"\"\n    if usage is not None:\n        usage = usage.strip().lower()\n        if usage not in (\"print-range\", \"filter\", \"repeat-column\", \"repeat-row\"):\n            usage = None\n    if usage is None:\n        with contextlib.suppress(KeyError):\n            self.del_attribute(\"table:range-usable-as\")\n        self.usage = None\n    else:\n        self.set_attribute(\"table:range-usable-as\", usage)\n        self.usage = usage\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_value","title":"<code>set_value(value, cell_type=None, currency=None, style=None)</code>","text":"<p>Shortcut to set the value of the first cell of the named range. See table.set_value() for the arguments description.</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_value(\n    self,\n    value: Any,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the value of the first cell of the named range.\n    See table.set_value() for the arguments description.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    table.set_value(  # type: ignore\n        coord=self.start,\n        value=value,\n        cell_type=cell_type,\n        currency=currency,\n        style=style,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_values","title":"<code>set_values(values, style=None, cell_type=None, currency=None)</code>","text":"<p>Shortcut to set the values of the cells of the named range. See table.set_values() for the arguments description.</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_values(\n    self,\n    values: list,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the values of the cells of the named range.\n    See table.set_values() for the arguments description.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    table.set_values(  # type: ignore\n        values,\n        coord=self.crange,\n        style=style,\n        cell_type=cell_type,\n        currency=currency,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Note","title":"<code>Note</code>","text":"<p>             Bases: <code>Element</code></p> <p>Either a footnote or a endnote element with the given text, optionally referencing it using the given note_id.</p> <p>Arguments:</p> <pre><code>note_class -- 'footnote' or 'endnote'\n\nnote_id -- str\n\ncitation -- str\n\nbody -- str or Element\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>class Note(Element):\n    \"\"\"Either a footnote or a endnote element with the given text,\n    optionally referencing it using the given note_id.\n\n    Arguments:\n\n        note_class -- 'footnote' or 'endnote'\n\n        note_id -- str\n\n        citation -- str\n\n        body -- str or Element\n    \"\"\"\n\n    _tag = \"text:note\"\n    _properties = (\n        PropDef(\"note_class\", \"text:note-class\"),\n        PropDef(\"note_id\", \"text:id\"),\n    )\n\n    def __init__(\n        self,\n        note_class: str = \"footnote\",\n        note_id: str | None = None,\n        citation: str | None = None,\n        body: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.insert(Element.from_tag(\"text:note-body\"), position=0)\n            self.insert(Element.from_tag(\"text:note-citation\"), position=0)\n            self.note_class = note_class\n            if note_id is not None:\n                self.note_id = note_id\n            if citation is not None:\n                self.citation = citation\n            if body is not None:\n                self.note_body = body\n\n    @property\n    def citation(self) -&gt; str:\n        note_citation = self.get_element(\"text:note-citation\")\n        if note_citation:\n            return note_citation.text\n        return \"\"\n\n    @citation.setter\n    def citation(self, text: str | None) -&gt; None:\n        note_citation = self.get_element(\"text:note-citation\")\n        if note_citation:\n            note_citation.text = text  # type:ignore\n\n    @property\n    def note_body(self) -&gt; str:\n        note_body = self.get_element(\"text:note-body\")\n        if note_body:\n            return note_body.text_content\n        return \"\"\n\n    @note_body.setter\n    def note_body(self, text_or_element: Element | str | None) -&gt; None:\n        note_body = self.get_element(\"text:note-body\")\n        if not note_body:\n            return None\n        if text_or_element is None:\n            note_body.text_content = \"\"\n        elif isinstance(text_or_element, str):\n            note_body.text_content = text_or_element\n        elif isinstance(text_or_element, Element):\n            note_body.clear()\n            note_body.append(text_or_element)\n        else:\n            raise TypeError(f'Unexpected type for body: \"{type(text_or_element)}\"')\n\n    def check_validity(self) -&gt; None:\n        if not self.note_class:\n            raise ValueError('Note class must be \"footnote\" or \"endnote\"')\n        if not self.note_id:\n            raise ValueError(\"Note must have an id\")\n        if not self.citation:\n            raise ValueError(\"Note must have a citation\")\n        if not self.note_body:\n            pass\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph","title":"<code>Paragraph</code>","text":"<p>             Bases: <code>ParagraphBase</code></p> <p>Specialised element for paragraphs \u201ctext:p\u201d. The \u201ctext:p\u201d element represents a paragraph, which is the basic unit of text in an OpenDocument file.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>class Paragraph(ParagraphBase):\n    \"\"\"Specialised element for paragraphs \"text:p\". The \"text:p\" element\n    represents a paragraph, which is the basic unit of text in an OpenDocument\n    file.\n    \"\"\"\n\n    _tag = \"text:p\"\n\n    def __init__(\n        self,\n        text_or_element: str | Element | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ):\n        \"\"\"Create a paragraph element of the given style containing the optional\n        given text.\n\n        Arguments:\n\n            text -- str or Element\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if isinstance(text_or_element, Element):\n                self.append(text_or_element)\n            else:\n                self.text = text_or_element  # type:ignore\n            if style is not None:\n                self.style = style\n\n    def insert_note(\n        self,\n        note_element: Note | None = None,\n        after: str | Element | None = None,\n        note_class: str = \"footnote\",\n        note_id: str | None = None,\n        citation: str | None = None,\n        body: str | None = None,\n    ) -&gt; None:\n        if note_element is None:\n            note_element = Note(\n                note_class=note_class, note_id=note_id, citation=citation, body=body\n            )\n        else:\n            # XXX clone or modify the argument?\n            if note_class:\n                note_element.note_class = note_class\n            if note_id:\n                note_element.note_id = note_id\n            if citation:\n                note_element.citation = citation\n            if body:\n                note_element.note_body = body\n        note_element.check_validity()\n        if isinstance(after, str):\n            self._insert(note_element, after=after, main_text=True)\n        elif isinstance(after, Element):\n            after.insert(note_element, FIRST_CHILD)\n        else:\n            self.insert(note_element, FIRST_CHILD)\n\n    def insert_annotation(  # noqa: C901\n        self,\n        annotation_element: Annotation | None = None,\n        before: str | None = None,\n        after: str | Element | None = None,\n        position: int | tuple = 0,\n        content: str | Element | None = None,\n        body: str | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n    ) -&gt; Annotation:\n        \"\"\"Insert an annotation, at the position defined by the regex (before,\n        after, content) or by positionnal argument (position). If content is\n        provided, the annotation covers the full content regex. Else, the\n        annotation is positionned either 'before' or 'after' provided regex.\n\n        If content is an odf element (ie: paragraph, span, ...), the full inner\n        content is covered by the annotation (of the position just after if\n        content is a single empty tag).\n\n        If content/before or after exists (regex) and return a group of matching\n        positions, the position value is the index of matching place to use.\n\n        annotation_element can contain a previously created annotation, else\n        the annotation is created from the body, creator and optional date\n        (current date by default).\n\n        Arguments:\n\n            annotation_element -- Annotation or None\n\n            before -- str regular expression or None\n\n            after -- str regular expression or Element or None\n\n            content -- str regular expression or None, or Element\n\n            position -- int or tuple of int\n\n            body -- str or Element\n\n            creator -- str\n\n            date -- datetime\n        \"\"\"\n\n        if annotation_element is None:\n            annotation_element = Annotation(\n                text_or_element=body, creator=creator, date=date, parent=self\n            )\n        else:\n            # XXX clone or modify the argument?\n            if body:\n                annotation_element.note_body = body\n            if creator:\n                annotation_element.creator = creator\n            if date:\n                annotation_element.date = date\n        annotation_element.check_validity()\n\n        # special case: content is an odf element (ie: a paragraph)\n        if isinstance(content, Element):\n            if content.is_empty():\n                content.insert(annotation_element, xmlposition=NEXT_SIBLING)\n                return annotation_element\n            content.insert(annotation_element, start=True)\n            annotation_end = AnnotationEnd(annotation_element)\n            content.append(annotation_end)\n            return annotation_element\n\n        # special case\n        if isinstance(after, Element):\n            after.insert(annotation_element, FIRST_CHILD)\n            return annotation_element\n\n        # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and content is not None\n            and isinstance(position, int)\n        ):\n            # Start tag\n            self._insert(\n                annotation_element, before=content, position=position, main_text=True\n            )\n            # End tag\n            annotation_end = AnnotationEnd(annotation_element)\n            self._insert(\n                annotation_end, after=content, position=position, main_text=True\n            )\n            return annotation_element\n\n        # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and content is None\n            and isinstance(position, tuple)\n        ):\n            # Start\n            self._insert(annotation_element, position=position[0], main_text=True)\n            # End\n            annotation_end = AnnotationEnd(annotation_element)\n            self._insert(annotation_end, position=position[1], main_text=True)\n            return annotation_element\n\n        # Without \"content\" nor \"position\"\n        if content is not None or not isinstance(position, int):\n            raise ValueError(\"Bad arguments\")\n\n        # Insert\n        self._insert(\n            annotation_element,\n            before=before,\n            after=after,\n            position=position,\n            main_text=True,\n        )\n        return annotation_element\n\n    def insert_annotation_end(\n        self,\n        annotation_element: Annotation,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n    ) -&gt; AnnotationEnd:\n        \"\"\"Insert an annotation end tag for an existing annotation. If some end\n        tag already exists, replace it. Annotation end tag is set at the\n        position defined by the regex (before or after).\n\n        If content/before or after (regex) returns a group of matching\n        positions, the position value is the index of matching place to use.\n\n        Arguments:\n\n            annotation_element -- Annotation (mandatory)\n\n            before -- str regular expression or None\n\n            after -- str regular expression or None\n\n            position -- int\n        \"\"\"\n\n        if annotation_element is None:\n            raise ValueError\n        if not isinstance(annotation_element, Annotation):\n            raise TypeError(\"Not a &lt;office:annotation&gt; Annotation\")\n\n        # remove existing end tag\n        name = annotation_element.name\n        existing_end_tag = self.get_annotation_end(name=name)\n        if existing_end_tag:\n            existing_end_tag.delete()\n\n        # create the end tag\n        end_tag = AnnotationEnd(annotation_element)\n\n        # Insert\n        self._insert(\n            end_tag, before=before, after=after, position=position, main_text=True\n        )\n        return end_tag\n\n    def set_reference_mark(\n        self,\n        name: str,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n        content: str | Element | None = None,\n    ) -&gt; Element:\n        \"\"\"Insert a reference mark, at the position defined by the regex\n        (before, after, content) or by positionnal argument (position). If\n        content is provided, the annotation covers the full range content regex\n        (instances of ReferenceMarkStart and ReferenceMarkEnd are\n        created). Else, an instance of ReferenceMark is positionned either\n        'before' or 'after' provided regex.\n\n        If content is an ODF Element (ie: Paragraph, Span, ...), the full inner\n        content is referenced (of the position just after if content is a single\n        empty tag).\n\n        If content/before or after exists (regex) and return a group of matching\n        positions, the position value is the index of matching place to use.\n\n        Name is mandatory and shall be unique in the document for the preference\n        mark range.\n\n        Arguments:\n\n            name -- str\n\n            before -- str regular expression or None\n\n            after -- str regular expression or None,\n\n            content -- str regular expression or None, or Element\n\n            position -- int or tuple of int\n\n        Return: the created ReferenceMark or ReferenceMarkStart\n        \"\"\"\n        # special case: content is an odf element (ie: a paragraph)\n        if isinstance(content, Element):\n            if content.is_empty():\n                reference = ReferenceMark(name)\n                content.insert(reference, xmlposition=NEXT_SIBLING)\n                return reference\n            reference_start = ReferenceMarkStart(name)\n            content.insert(reference_start, start=True)\n            reference_end = ReferenceMarkEnd(name)\n            content.append(reference_end)\n            return reference_start\n\n        # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n        # reference\n        if (\n            before is None\n            and after is None\n            and content is not None\n            and isinstance(position, int)\n        ):\n            # Start tag\n            reference_start = ReferenceMarkStart(name)\n            self._insert(\n                reference_start, before=content, position=position, main_text=True\n            )\n            # End tag\n            reference_end = ReferenceMarkEnd(name)\n            self._insert(\n                reference_end, after=content, position=position, main_text=True\n            )\n            return reference_start\n\n        # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n        if (\n            before is None\n            and after is None\n            and content is None\n            and isinstance(position, tuple)\n        ):\n            # Start\n            reference_start = ReferenceMarkStart(name)\n            self._insert(reference_start, position=position[0], main_text=True)\n            # End\n            reference_end = ReferenceMarkEnd(name)\n            self._insert(reference_end, position=position[1], main_text=True)\n            return reference_start\n\n        # Without \"content\" nor \"position\"\n        if content is not None or not isinstance(position, int):\n            raise ValueError(\"bad arguments\")\n\n        # Insert a positional reference mark\n        reference = ReferenceMark(name)\n        self._insert(\n            reference,\n            before=before,\n            after=after,\n            position=position,\n            main_text=True,\n        )\n        return reference\n\n    def set_reference_mark_end(\n        self,\n        reference_mark: Element,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n    ) -&gt; ReferenceMarkEnd:\n        \"\"\"Insert/move a ReferenceMarkEnd for an existing reference mark. If\n        some end tag already exists, replace it. Reference tag is set at the\n        position defined by the regex (before or after).\n\n        If content/before or after (regex) returns a group of matching\n        positions, the position value is the index of matching place to use.\n\n        Arguments:\n\n            reference_mark -- ReferenceMark or ReferenceMarkStart (mandatory)\n\n            before -- str regular expression or None\n\n            after -- str regular expression or None\n\n            position -- int\n        \"\"\"\n        if not isinstance(reference_mark, (ReferenceMark, ReferenceMarkStart)):\n            raise TypeError(\"Not a ReferenceMark or ReferenceMarkStart\")\n        name = reference_mark.name\n        if isinstance(reference_mark, ReferenceMark):\n            # change it to a range reference:\n            reference_mark.tag = ReferenceMarkStart._tag\n\n        existing_end_tag = self.get_reference_mark_end(name=name)\n        if existing_end_tag:\n            existing_end_tag.delete()\n\n        # create the end tag\n        end_tag = ReferenceMarkEnd(name)\n\n        # Insert\n        self._insert(\n            end_tag, before=before, after=after, position=position, main_text=True\n        )\n        return end_tag\n\n    def insert_variable(self, variable_element: Element, after: str | None) -&gt; None:\n        self._insert(variable_element, after=after, main_text=True)\n\n    @_by_regex_offset\n    def set_span(\n        self,\n        match: str,\n        tail: str,\n        style: str,\n        regex: str | None = None,\n        offset: int | None = None,\n        length: int = 0,\n    ) -&gt; Span:\n        \"\"\"\n        set_span(style, regex=None, offset=None, length=0)\n        Apply the given style to text content matching the regex OR the\n        positional arguments offset and length.\n\n        (match, tail: provided by regex decorator)\n\n        Arguments:\n\n            style -- str\n\n            regex -- str regular expression\n\n            offset -- int\n\n            length -- int\n        \"\"\"\n        span = Span(match, style=style)\n        span.tail = tail\n        return span\n\n    def remove_spans(self, keep_heading: bool = True) -&gt; Element | list:\n        \"\"\"Send back a copy of the element, without span styles.\n        If keep_heading is True (default), the first level heading style is left\n        unchanged.\n        \"\"\"\n        strip = (Span._tag,)\n        if keep_heading:\n            protect = (\"text:h\",)\n        else:\n            protect = None\n        return self.strip_tags(strip=strip, protect=protect)\n\n    def remove_span(self, spans: Element | list[Element]) -&gt; Element | list:\n        \"\"\"Send back a copy of the element, the spans (not a clone) removed.\n\n        Arguments:\n\n            spans -- Element or list of Element\n        \"\"\"\n        return self.strip_elements(spans)\n\n    @_by_regex_offset\n    def set_link(\n        self,\n        match: str,\n        tail: str,\n        url: str,\n        regex: str | None = None,\n        offset: int | None = None,\n        length: int = 0,\n    ) -&gt; Element:\n        \"\"\"\n        set_link(url, regex=None, offset=None, length=0)\n        Make a link to the provided url from text content matching the regex\n        OR the positional arguments offset and length.\n\n        (match, tail: provided by regex decorator)\n\n        Arguments:\n\n            url -- str\n\n            regex -- str regular expression\n\n            offset -- int\n\n            length -- int\n        \"\"\"\n        link = Link(url, text=match)\n        link.tail = tail\n        return link\n\n    def remove_links(self) -&gt; Element | list:\n        \"\"\"Send back a copy of the element, without links tags.\"\"\"\n        strip = (Link._tag,)\n        return self.strip_tags(strip=strip)\n\n    def remove_link(self, links: Link | list[Link]) -&gt; Element | list:\n        \"\"\"Send back a copy of the element (not a clone), with the sub links\n           removed.\n\n        Arguments:\n\n            links -- Link or list of Link\n        \"\"\"\n        return self.strip_elements(links)\n\n    def insert_reference(\n        self,\n        name: str,\n        ref_format: str = \"\",\n        before: str | None = None,\n        after: str | Element | None = None,\n        position: int = 0,\n        display: str | None = None,\n    ) -&gt; None:\n        \"\"\"Create and insert a reference to a content marked by a reference\n        mark. The Reference element (\"text:reference-ref\") represents a\n        field that references a \"text:reference-mark-start\" or\n        \"text:reference-mark\" element. Its \"text:reference-format\" attribute\n        specifies what is displayed from the referenced element. Default is\n        'page'. Actual content is not automatically updated except for the 'text'\n        format.\n\n        name is mandatory and should represent an existing reference mark of the\n        document.\n\n        ref_format is the argument for format reference (default is 'page').\n\n        The reference is inserted the position defined by the regex (before /\n        after), or by positionnal argument (position). If 'display' is provided,\n        it will be used as the text value for the reference.\n\n        If after is an ODF Element, the reference is inserted as first child of\n        this element.\n\n        Arguments:\n\n            name -- str\n\n            ref_format -- one of : 'chapter', 'direction', 'page', 'text',\n                                    'caption', 'category-and-value', 'value',\n                                    'number', 'number-all-superior',\n                                    'number-no-superior'\n\n            before -- str regular expression or None\n\n            after -- str regular expression or odf element or None\n\n            position -- int\n\n            display -- str or None\n        \"\"\"\n        reference = Reference(name, ref_format)\n        if display is None and ref_format == \"text\":\n            # get reference content\n            body = self.document_body\n            if not body:\n                body = self.root\n            mark = body.get_reference_mark(name=name)\n            if mark:\n                display = mark.referenced_text  # type: ignore\n        if not display:\n            display = \" \"\n        reference.text = display\n        if isinstance(after, Element):\n            after.insert(reference, FIRST_CHILD)\n        else:\n            self._insert(\n                reference, before=before, after=after, position=position, main_text=True\n            )\n\n    def set_bookmark(\n        self,\n        name: str,\n        before: str | None = None,\n        after: str | None = None,\n        position: int | tuple = 0,\n        role: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | tuple[Element, Element]:\n        \"\"\"Insert a bookmark before or after the characters in the text which\n        match the regex before/after. When the regex matches more of one part\n        of the text, position can be set to choose which part must be used.\n        If before and after are None, we use only position that is the number\n        of characters.\n\n        So, by default, this function inserts a bookmark before the first\n        character of the content. Role can be None, \"start\" or \"end\", we\n        insert respectively a position bookmark a bookmark-start or a\n        bookmark-end.\n\n        If content is not None these 2 calls are equivalent:\n\n          paragraph.set_bookmark(\"bookmark\", content=\"xyz\")\n\n        and:\n\n          paragraph.set_bookmark(\"bookmark\", before=\"xyz\", role=\"start\")\n          paragraph.set_bookmark(\"bookmark\", after=\"xyz\", role=\"end\")\n\n\n        If position is a 2-tuple, these 2 calls are equivalent:\n\n          paragraph.set_bookmark(\"bookmark\", position=(10, 20))\n\n        and:\n\n          paragraph.set_bookmark(\"bookmark\", position=10, role=\"start\")\n          paragraph.set_bookmark(\"bookmark\", position=20, role=\"end\")\n\n\n        Arguments:\n\n            name -- str\n\n            before -- str regex\n\n            after -- str regex\n\n            position -- int or (int, int)\n\n            role -- None, \"start\" or \"end\"\n\n            content -- str regex\n        \"\"\"\n        # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and role is None\n            and content is not None\n            and isinstance(position, int)\n        ):\n            # Start\n            start = BookmarkStart(name)\n            self._insert(start, before=content, position=position, main_text=True)\n            # End\n            end = BookmarkEnd(name)\n            self._insert(end, after=content, position=position, main_text=True)\n            return start, end\n\n        # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and role is None\n            and content is None\n            and isinstance(position, tuple)\n        ):\n            # Start\n            start = BookmarkStart(name)\n            self._insert(start, position=position[0], main_text=True)\n            # End\n            end = BookmarkEnd(name)\n            self._insert(end, position=position[1], main_text=True)\n            return start, end\n\n        # Without \"content\" nor \"position\"\n        if content is not None or not isinstance(position, int):\n            raise ValueError(\"bad arguments\")\n\n        # Role\n        if role is None:\n            bookmark: Element = Bookmark(name)\n        elif role == \"start\":\n            bookmark = BookmarkStart(name)\n        elif role == \"end\":\n            bookmark = BookmarkEnd(name)\n        else:\n            raise ValueError(\"bad arguments\")\n\n        # Insert\n        self._insert(\n            bookmark, before=before, after=after, position=position, main_text=True\n        )\n\n        return bookmark\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.__init__","title":"<code>__init__(text_or_element=None, style=None, **kwargs)</code>","text":"<p>Create a paragraph element of the given style containing the optional given text.</p> <p>Arguments:</p> <pre><code>text -- str or Element\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def __init__(\n    self,\n    text_or_element: str | Element | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n):\n    \"\"\"Create a paragraph element of the given style containing the optional\n    given text.\n\n    Arguments:\n\n        text -- str or Element\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if isinstance(text_or_element, Element):\n            self.append(text_or_element)\n        else:\n            self.text = text_or_element  # type:ignore\n        if style is not None:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.insert_annotation","title":"<code>insert_annotation(annotation_element=None, before=None, after=None, position=0, content=None, body=None, creator=None, date=None)</code>","text":"<p>Insert an annotation, at the position defined by the regex (before, after, content) or by positionnal argument (position). If content is provided, the annotation covers the full content regex. Else, the annotation is positionned either \u2018before\u2019 or \u2018after\u2019 provided regex.</p> <p>If content is an odf element (ie: paragraph, span, \u2026), the full inner content is covered by the annotation (of the position just after if content is a single empty tag).</p> <p>If content/before or after exists (regex) and return a group of matching positions, the position value is the index of matching place to use.</p> <p>annotation_element can contain a previously created annotation, else the annotation is created from the body, creator and optional date (current date by default).</p> <p>Arguments:</p> <pre><code>annotation_element -- Annotation or None\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or Element or None\n\ncontent -- str regular expression or None, or Element\n\nposition -- int or tuple of int\n\nbody -- str or Element\n\ncreator -- str\n\ndate -- datetime\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def insert_annotation(  # noqa: C901\n    self,\n    annotation_element: Annotation | None = None,\n    before: str | None = None,\n    after: str | Element | None = None,\n    position: int | tuple = 0,\n    content: str | Element | None = None,\n    body: str | None = None,\n    creator: str | None = None,\n    date: datetime | None = None,\n) -&gt; Annotation:\n    \"\"\"Insert an annotation, at the position defined by the regex (before,\n    after, content) or by positionnal argument (position). If content is\n    provided, the annotation covers the full content regex. Else, the\n    annotation is positionned either 'before' or 'after' provided regex.\n\n    If content is an odf element (ie: paragraph, span, ...), the full inner\n    content is covered by the annotation (of the position just after if\n    content is a single empty tag).\n\n    If content/before or after exists (regex) and return a group of matching\n    positions, the position value is the index of matching place to use.\n\n    annotation_element can contain a previously created annotation, else\n    the annotation is created from the body, creator and optional date\n    (current date by default).\n\n    Arguments:\n\n        annotation_element -- Annotation or None\n\n        before -- str regular expression or None\n\n        after -- str regular expression or Element or None\n\n        content -- str regular expression or None, or Element\n\n        position -- int or tuple of int\n\n        body -- str or Element\n\n        creator -- str\n\n        date -- datetime\n    \"\"\"\n\n    if annotation_element is None:\n        annotation_element = Annotation(\n            text_or_element=body, creator=creator, date=date, parent=self\n        )\n    else:\n        # XXX clone or modify the argument?\n        if body:\n            annotation_element.note_body = body\n        if creator:\n            annotation_element.creator = creator\n        if date:\n            annotation_element.date = date\n    annotation_element.check_validity()\n\n    # special case: content is an odf element (ie: a paragraph)\n    if isinstance(content, Element):\n        if content.is_empty():\n            content.insert(annotation_element, xmlposition=NEXT_SIBLING)\n            return annotation_element\n        content.insert(annotation_element, start=True)\n        annotation_end = AnnotationEnd(annotation_element)\n        content.append(annotation_end)\n        return annotation_element\n\n    # special case\n    if isinstance(after, Element):\n        after.insert(annotation_element, FIRST_CHILD)\n        return annotation_element\n\n    # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and content is not None\n        and isinstance(position, int)\n    ):\n        # Start tag\n        self._insert(\n            annotation_element, before=content, position=position, main_text=True\n        )\n        # End tag\n        annotation_end = AnnotationEnd(annotation_element)\n        self._insert(\n            annotation_end, after=content, position=position, main_text=True\n        )\n        return annotation_element\n\n    # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and content is None\n        and isinstance(position, tuple)\n    ):\n        # Start\n        self._insert(annotation_element, position=position[0], main_text=True)\n        # End\n        annotation_end = AnnotationEnd(annotation_element)\n        self._insert(annotation_end, position=position[1], main_text=True)\n        return annotation_element\n\n    # Without \"content\" nor \"position\"\n    if content is not None or not isinstance(position, int):\n        raise ValueError(\"Bad arguments\")\n\n    # Insert\n    self._insert(\n        annotation_element,\n        before=before,\n        after=after,\n        position=position,\n        main_text=True,\n    )\n    return annotation_element\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.insert_annotation_end","title":"<code>insert_annotation_end(annotation_element, before=None, after=None, position=0)</code>","text":"<p>Insert an annotation end tag for an existing annotation. If some end tag already exists, replace it. Annotation end tag is set at the position defined by the regex (before or after).</p> <p>If content/before or after (regex) returns a group of matching positions, the position value is the index of matching place to use.</p> <p>Arguments:</p> <pre><code>annotation_element -- Annotation (mandatory)\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or None\n\nposition -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def insert_annotation_end(\n    self,\n    annotation_element: Annotation,\n    before: str | None = None,\n    after: str | None = None,\n    position: int = 0,\n) -&gt; AnnotationEnd:\n    \"\"\"Insert an annotation end tag for an existing annotation. If some end\n    tag already exists, replace it. Annotation end tag is set at the\n    position defined by the regex (before or after).\n\n    If content/before or after (regex) returns a group of matching\n    positions, the position value is the index of matching place to use.\n\n    Arguments:\n\n        annotation_element -- Annotation (mandatory)\n\n        before -- str regular expression or None\n\n        after -- str regular expression or None\n\n        position -- int\n    \"\"\"\n\n    if annotation_element is None:\n        raise ValueError\n    if not isinstance(annotation_element, Annotation):\n        raise TypeError(\"Not a &lt;office:annotation&gt; Annotation\")\n\n    # remove existing end tag\n    name = annotation_element.name\n    existing_end_tag = self.get_annotation_end(name=name)\n    if existing_end_tag:\n        existing_end_tag.delete()\n\n    # create the end tag\n    end_tag = AnnotationEnd(annotation_element)\n\n    # Insert\n    self._insert(\n        end_tag, before=before, after=after, position=position, main_text=True\n    )\n    return end_tag\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.insert_reference","title":"<code>insert_reference(name, ref_format='', before=None, after=None, position=0, display=None)</code>","text":"<p>Create and insert a reference to a content marked by a reference mark. The Reference element (\u201ctext:reference-ref\u201d) represents a field that references a \u201ctext:reference-mark-start\u201d or \u201ctext:reference-mark\u201d element. Its \u201ctext:reference-format\u201d attribute specifies what is displayed from the referenced element. Default is \u2018page\u2019. Actual content is not automatically updated except for the \u2018text\u2019 format.</p> <p>name is mandatory and should represent an existing reference mark of the document.</p> <p>ref_format is the argument for format reference (default is \u2018page\u2019).</p> <p>The reference is inserted the position defined by the regex (before / after), or by positionnal argument (position). If \u2018display\u2019 is provided, it will be used as the text value for the reference.</p> <p>If after is an ODF Element, the reference is inserted as first child of this element.</p> <p>Arguments:</p> <pre><code>name -- str\n\nref_format -- one of : 'chapter', 'direction', 'page', 'text',\n                        'caption', 'category-and-value', 'value',\n                        'number', 'number-all-superior',\n                        'number-no-superior'\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or odf element or None\n\nposition -- int\n\ndisplay -- str or None\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def insert_reference(\n    self,\n    name: str,\n    ref_format: str = \"\",\n    before: str | None = None,\n    after: str | Element | None = None,\n    position: int = 0,\n    display: str | None = None,\n) -&gt; None:\n    \"\"\"Create and insert a reference to a content marked by a reference\n    mark. The Reference element (\"text:reference-ref\") represents a\n    field that references a \"text:reference-mark-start\" or\n    \"text:reference-mark\" element. Its \"text:reference-format\" attribute\n    specifies what is displayed from the referenced element. Default is\n    'page'. Actual content is not automatically updated except for the 'text'\n    format.\n\n    name is mandatory and should represent an existing reference mark of the\n    document.\n\n    ref_format is the argument for format reference (default is 'page').\n\n    The reference is inserted the position defined by the regex (before /\n    after), or by positionnal argument (position). If 'display' is provided,\n    it will be used as the text value for the reference.\n\n    If after is an ODF Element, the reference is inserted as first child of\n    this element.\n\n    Arguments:\n\n        name -- str\n\n        ref_format -- one of : 'chapter', 'direction', 'page', 'text',\n                                'caption', 'category-and-value', 'value',\n                                'number', 'number-all-superior',\n                                'number-no-superior'\n\n        before -- str regular expression or None\n\n        after -- str regular expression or odf element or None\n\n        position -- int\n\n        display -- str or None\n    \"\"\"\n    reference = Reference(name, ref_format)\n    if display is None and ref_format == \"text\":\n        # get reference content\n        body = self.document_body\n        if not body:\n            body = self.root\n        mark = body.get_reference_mark(name=name)\n        if mark:\n            display = mark.referenced_text  # type: ignore\n    if not display:\n        display = \" \"\n    reference.text = display\n    if isinstance(after, Element):\n        after.insert(reference, FIRST_CHILD)\n    else:\n        self._insert(\n            reference, before=before, after=after, position=position, main_text=True\n        )\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_link","title":"<code>remove_link(links)</code>","text":"<p>Send back a copy of the element (not a clone), with the sub links    removed.</p> <p>Arguments:</p> <pre><code>links -- Link or list of Link\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_link(self, links: Link | list[Link]) -&gt; Element | list:\n    \"\"\"Send back a copy of the element (not a clone), with the sub links\n       removed.\n\n    Arguments:\n\n        links -- Link or list of Link\n    \"\"\"\n    return self.strip_elements(links)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_links","title":"<code>remove_links()</code>","text":"<p>Send back a copy of the element, without links tags.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_links(self) -&gt; Element | list:\n    \"\"\"Send back a copy of the element, without links tags.\"\"\"\n    strip = (Link._tag,)\n    return self.strip_tags(strip=strip)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_span","title":"<code>remove_span(spans)</code>","text":"<p>Send back a copy of the element, the spans (not a clone) removed.</p> <p>Arguments:</p> <pre><code>spans -- Element or list of Element\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_span(self, spans: Element | list[Element]) -&gt; Element | list:\n    \"\"\"Send back a copy of the element, the spans (not a clone) removed.\n\n    Arguments:\n\n        spans -- Element or list of Element\n    \"\"\"\n    return self.strip_elements(spans)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_spans","title":"<code>remove_spans(keep_heading=True)</code>","text":"<p>Send back a copy of the element, without span styles. If keep_heading is True (default), the first level heading style is left unchanged.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_spans(self, keep_heading: bool = True) -&gt; Element | list:\n    \"\"\"Send back a copy of the element, without span styles.\n    If keep_heading is True (default), the first level heading style is left\n    unchanged.\n    \"\"\"\n    strip = (Span._tag,)\n    if keep_heading:\n        protect = (\"text:h\",)\n    else:\n        protect = None\n    return self.strip_tags(strip=strip, protect=protect)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_bookmark","title":"<code>set_bookmark(name, before=None, after=None, position=0, role=None, content=None)</code>","text":"<p>Insert a bookmark before or after the characters in the text which match the regex before/after. When the regex matches more of one part of the text, position can be set to choose which part must be used. If before and after are None, we use only position that is the number of characters.</p> <p>So, by default, this function inserts a bookmark before the first character of the content. Role can be None, \u201cstart\u201d or \u201cend\u201d, we insert respectively a position bookmark a bookmark-start or a bookmark-end.</p> <p>If content is not None these 2 calls are equivalent:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, content=\u201dxyz\u201d)</p> <p>and:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, before=\u201dxyz\u201d, role=\u201dstart\u201d)   paragraph.set_bookmark(\u201cbookmark\u201d, after=\u201dxyz\u201d, role=\u201dend\u201d)</p> <p>If position is a 2-tuple, these 2 calls are equivalent:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, position=(10, 20))</p> <p>and:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, position=10, role=\u201dstart\u201d)   paragraph.set_bookmark(\u201cbookmark\u201d, position=20, role=\u201dend\u201d)</p> <p>Arguments:</p> <pre><code>name -- str\n\nbefore -- str regex\n\nafter -- str regex\n\nposition -- int or (int, int)\n\nrole -- None, \"start\" or \"end\"\n\ncontent -- str regex\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def set_bookmark(\n    self,\n    name: str,\n    before: str | None = None,\n    after: str | None = None,\n    position: int | tuple = 0,\n    role: str | None = None,\n    content: str | None = None,\n) -&gt; Element | tuple[Element, Element]:\n    \"\"\"Insert a bookmark before or after the characters in the text which\n    match the regex before/after. When the regex matches more of one part\n    of the text, position can be set to choose which part must be used.\n    If before and after are None, we use only position that is the number\n    of characters.\n\n    So, by default, this function inserts a bookmark before the first\n    character of the content. Role can be None, \"start\" or \"end\", we\n    insert respectively a position bookmark a bookmark-start or a\n    bookmark-end.\n\n    If content is not None these 2 calls are equivalent:\n\n      paragraph.set_bookmark(\"bookmark\", content=\"xyz\")\n\n    and:\n\n      paragraph.set_bookmark(\"bookmark\", before=\"xyz\", role=\"start\")\n      paragraph.set_bookmark(\"bookmark\", after=\"xyz\", role=\"end\")\n\n\n    If position is a 2-tuple, these 2 calls are equivalent:\n\n      paragraph.set_bookmark(\"bookmark\", position=(10, 20))\n\n    and:\n\n      paragraph.set_bookmark(\"bookmark\", position=10, role=\"start\")\n      paragraph.set_bookmark(\"bookmark\", position=20, role=\"end\")\n\n\n    Arguments:\n\n        name -- str\n\n        before -- str regex\n\n        after -- str regex\n\n        position -- int or (int, int)\n\n        role -- None, \"start\" or \"end\"\n\n        content -- str regex\n    \"\"\"\n    # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and role is None\n        and content is not None\n        and isinstance(position, int)\n    ):\n        # Start\n        start = BookmarkStart(name)\n        self._insert(start, before=content, position=position, main_text=True)\n        # End\n        end = BookmarkEnd(name)\n        self._insert(end, after=content, position=position, main_text=True)\n        return start, end\n\n    # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and role is None\n        and content is None\n        and isinstance(position, tuple)\n    ):\n        # Start\n        start = BookmarkStart(name)\n        self._insert(start, position=position[0], main_text=True)\n        # End\n        end = BookmarkEnd(name)\n        self._insert(end, position=position[1], main_text=True)\n        return start, end\n\n    # Without \"content\" nor \"position\"\n    if content is not None or not isinstance(position, int):\n        raise ValueError(\"bad arguments\")\n\n    # Role\n    if role is None:\n        bookmark: Element = Bookmark(name)\n    elif role == \"start\":\n        bookmark = BookmarkStart(name)\n    elif role == \"end\":\n        bookmark = BookmarkEnd(name)\n    else:\n        raise ValueError(\"bad arguments\")\n\n    # Insert\n    self._insert(\n        bookmark, before=before, after=after, position=position, main_text=True\n    )\n\n    return bookmark\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_link","title":"<code>set_link(match, tail, url, regex=None, offset=None, length=0)</code>","text":"<p>set_link(url, regex=None, offset=None, length=0) Make a link to the provided url from text content matching the regex OR the positional arguments offset and length.</p> <p>(match, tail: provided by regex decorator)</p> <p>Arguments:</p> <pre><code>url -- str\n\nregex -- str regular expression\n\noffset -- int\n\nlength -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>@_by_regex_offset\ndef set_link(\n    self,\n    match: str,\n    tail: str,\n    url: str,\n    regex: str | None = None,\n    offset: int | None = None,\n    length: int = 0,\n) -&gt; Element:\n    \"\"\"\n    set_link(url, regex=None, offset=None, length=0)\n    Make a link to the provided url from text content matching the regex\n    OR the positional arguments offset and length.\n\n    (match, tail: provided by regex decorator)\n\n    Arguments:\n\n        url -- str\n\n        regex -- str regular expression\n\n        offset -- int\n\n        length -- int\n    \"\"\"\n    link = Link(url, text=match)\n    link.tail = tail\n    return link\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_reference_mark","title":"<code>set_reference_mark(name, before=None, after=None, position=0, content=None)</code>","text":"<p>Insert a reference mark, at the position defined by the regex (before, after, content) or by positionnal argument (position). If content is provided, the annotation covers the full range content regex (instances of ReferenceMarkStart and ReferenceMarkEnd are created). Else, an instance of ReferenceMark is positionned either \u2018before\u2019 or \u2018after\u2019 provided regex.</p> <p>If content is an ODF Element (ie: Paragraph, Span, \u2026), the full inner content is referenced (of the position just after if content is a single empty tag).</p> <p>If content/before or after exists (regex) and return a group of matching positions, the position value is the index of matching place to use.</p> <p>Name is mandatory and shall be unique in the document for the preference mark range.</p> <p>Arguments:</p> <pre><code>name -- str\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or None,\n\ncontent -- str regular expression or None, or Element\n\nposition -- int or tuple of int\n</code></pre> <p>Return: the created ReferenceMark or ReferenceMarkStart</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def set_reference_mark(\n    self,\n    name: str,\n    before: str | None = None,\n    after: str | None = None,\n    position: int = 0,\n    content: str | Element | None = None,\n) -&gt; Element:\n    \"\"\"Insert a reference mark, at the position defined by the regex\n    (before, after, content) or by positionnal argument (position). If\n    content is provided, the annotation covers the full range content regex\n    (instances of ReferenceMarkStart and ReferenceMarkEnd are\n    created). Else, an instance of ReferenceMark is positionned either\n    'before' or 'after' provided regex.\n\n    If content is an ODF Element (ie: Paragraph, Span, ...), the full inner\n    content is referenced (of the position just after if content is a single\n    empty tag).\n\n    If content/before or after exists (regex) and return a group of matching\n    positions, the position value is the index of matching place to use.\n\n    Name is mandatory and shall be unique in the document for the preference\n    mark range.\n\n    Arguments:\n\n        name -- str\n\n        before -- str regular expression or None\n\n        after -- str regular expression or None,\n\n        content -- str regular expression or None, or Element\n\n        position -- int or tuple of int\n\n    Return: the created ReferenceMark or ReferenceMarkStart\n    \"\"\"\n    # special case: content is an odf element (ie: a paragraph)\n    if isinstance(content, Element):\n        if content.is_empty():\n            reference = ReferenceMark(name)\n            content.insert(reference, xmlposition=NEXT_SIBLING)\n            return reference\n        reference_start = ReferenceMarkStart(name)\n        content.insert(reference_start, start=True)\n        reference_end = ReferenceMarkEnd(name)\n        content.append(reference_end)\n        return reference_start\n\n    # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n    # reference\n    if (\n        before is None\n        and after is None\n        and content is not None\n        and isinstance(position, int)\n    ):\n        # Start tag\n        reference_start = ReferenceMarkStart(name)\n        self._insert(\n            reference_start, before=content, position=position, main_text=True\n        )\n        # End tag\n        reference_end = ReferenceMarkEnd(name)\n        self._insert(\n            reference_end, after=content, position=position, main_text=True\n        )\n        return reference_start\n\n    # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n    if (\n        before is None\n        and after is None\n        and content is None\n        and isinstance(position, tuple)\n    ):\n        # Start\n        reference_start = ReferenceMarkStart(name)\n        self._insert(reference_start, position=position[0], main_text=True)\n        # End\n        reference_end = ReferenceMarkEnd(name)\n        self._insert(reference_end, position=position[1], main_text=True)\n        return reference_start\n\n    # Without \"content\" nor \"position\"\n    if content is not None or not isinstance(position, int):\n        raise ValueError(\"bad arguments\")\n\n    # Insert a positional reference mark\n    reference = ReferenceMark(name)\n    self._insert(\n        reference,\n        before=before,\n        after=after,\n        position=position,\n        main_text=True,\n    )\n    return reference\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_reference_mark_end","title":"<code>set_reference_mark_end(reference_mark, before=None, after=None, position=0)</code>","text":"<p>Insert/move a ReferenceMarkEnd for an existing reference mark. If some end tag already exists, replace it. Reference tag is set at the position defined by the regex (before or after).</p> <p>If content/before or after (regex) returns a group of matching positions, the position value is the index of matching place to use.</p> <p>Arguments:</p> <pre><code>reference_mark -- ReferenceMark or ReferenceMarkStart (mandatory)\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or None\n\nposition -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def set_reference_mark_end(\n    self,\n    reference_mark: Element,\n    before: str | None = None,\n    after: str | None = None,\n    position: int = 0,\n) -&gt; ReferenceMarkEnd:\n    \"\"\"Insert/move a ReferenceMarkEnd for an existing reference mark. If\n    some end tag already exists, replace it. Reference tag is set at the\n    position defined by the regex (before or after).\n\n    If content/before or after (regex) returns a group of matching\n    positions, the position value is the index of matching place to use.\n\n    Arguments:\n\n        reference_mark -- ReferenceMark or ReferenceMarkStart (mandatory)\n\n        before -- str regular expression or None\n\n        after -- str regular expression or None\n\n        position -- int\n    \"\"\"\n    if not isinstance(reference_mark, (ReferenceMark, ReferenceMarkStart)):\n        raise TypeError(\"Not a ReferenceMark or ReferenceMarkStart\")\n    name = reference_mark.name\n    if isinstance(reference_mark, ReferenceMark):\n        # change it to a range reference:\n        reference_mark.tag = ReferenceMarkStart._tag\n\n    existing_end_tag = self.get_reference_mark_end(name=name)\n    if existing_end_tag:\n        existing_end_tag.delete()\n\n    # create the end tag\n    end_tag = ReferenceMarkEnd(name)\n\n    # Insert\n    self._insert(\n        end_tag, before=before, after=after, position=position, main_text=True\n    )\n    return end_tag\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_span","title":"<code>set_span(match, tail, style, regex=None, offset=None, length=0)</code>","text":"<p>set_span(style, regex=None, offset=None, length=0) Apply the given style to text content matching the regex OR the positional arguments offset and length.</p> <p>(match, tail: provided by regex decorator)</p> <p>Arguments:</p> <pre><code>style -- str\n\nregex -- str regular expression\n\noffset -- int\n\nlength -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>@_by_regex_offset\ndef set_span(\n    self,\n    match: str,\n    tail: str,\n    style: str,\n    regex: str | None = None,\n    offset: int | None = None,\n    length: int = 0,\n) -&gt; Span:\n    \"\"\"\n    set_span(style, regex=None, offset=None, length=0)\n    Apply the given style to text content matching the regex OR the\n    positional arguments offset and length.\n\n    (match, tail: provided by regex decorator)\n\n    Arguments:\n\n        style -- str\n\n        regex -- str regular expression\n\n        offset -- int\n\n        length -- int\n    \"\"\"\n    span = Span(match, style=style)\n    span.tail = tail\n    return span\n</code></pre>"},{"location":"reference.html#odfdo.Presentation","title":"<code>Presentation</code>","text":"<p>             Bases: <code>Body</code></p> <p>Presentation, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Presentation(Body):\n    \"\"\"Presentation, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:presentation\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.RectangleShape","title":"<code>RectangleShape</code>","text":"<p>             Bases: <code>ShapeBase</code></p> <p>Create a rectangle shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\nposition -- (str, str)\n\nsize -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class RectangleShape(ShapeBase):\n    \"\"\"Create a rectangle shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        position -- (str, str)\n\n        size -- (str, str)\n\n    \"\"\"\n\n    _tag = \"draw:rect\"\n    _properties: tuple[PropDef, ...] = ()\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        position: tuple | None = None,\n        size: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n                \"size\": size,\n                \"position\": position,\n            }\n        )\n        super().__init__(**kwargs)\n</code></pre>"},{"location":"reference.html#odfdo.Reference","title":"<code>Reference</code>","text":"<p>             Bases: <code>Element</code></p> <p>A reference to a content marked by a reference mark. The odf_reference element (\u201ctext:reference-ref\u201d) represents a field that references a \u201ctext:reference-mark-start\u201d or \u201ctext:reference-mark\u201d element. Its text:reference-format attribute specifies what is displayed from the referenced element. Default is \u2018page\u2019 Actual content is not updated except for the \u2018text\u2019 format by the update() method.</p> <p>Creation of references can be tricky, consider using this method:     odfdo.paragraph.insert_reference()</p> <p>Values for text:reference-format :     The defined values for the text:reference-format attribute supported by     all reference fields are:       - \u2018chapter\u2019: displays the number of the chapter in which the         referenced item appears.       - \u2018direction\u2019: displays whether the referenced item is above or         below the reference field.       - \u2018page\u2019: displays the number of the page on which the referenced         item appears.       - \u2018text\u2019: displays the text of the referenced item.     Additional defined values for the text:reference-format attribute     supported by references to sequence fields are:       - \u2018caption\u2019: displays the caption in which the sequence is used.       - \u2018category-and-value\u2019: displays the name and value of the sequence.       - \u2018value\u2019: displays the value of the sequence.</p> <pre><code>References to bookmarks and other references support additional values,\nwhich display the list label of the referenced item. If the referenced\nitem is contained in a list or a numbered paragraph, the list label is\nthe formatted number of the paragraph which contains the referenced\nitem. If the referenced item is not contained in a list or numbered\nparagraph, the list label is empty, and the referenced field therefore\ndisplays nothing. If the referenced bookmark or reference contains more\nthan one paragraph, the list label of the paragraph at which the\nbookmark or reference starts is taken.\n\nAdditional defined values for the text:reference-format attribute\nsupported by all references to bookmark's or other reference fields\nare:\n  - 'number': displays the list label of the referenced item. [...]\n  - 'number-all-superior': displays the list label of the referenced\n    item and adds the contents of all list labels of superior levels\n    in front of it. [...]\n  - 'number-no-superior': displays the contents of the list label of\n    the referenced item.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>class Reference(Element):\n    \"\"\"A reference to a content marked by a reference mark.\n    The odf_reference element (\"text:reference-ref\") represents a field that\n    references a \"text:reference-mark-start\" or \"text:reference-mark\" element.\n    Its text:reference-format attribute specifies what is displayed from the\n    referenced element. Default is 'page'\n    Actual content is not updated except for the 'text' format by the\n    update() method.\n\n\n    Creation of references can be tricky, consider using this method:\n        odfdo.paragraph.insert_reference()\n\n    Values for text:reference-format :\n        The defined values for the text:reference-format attribute supported by\n        all reference fields are:\n          - 'chapter': displays the number of the chapter in which the\n            referenced item appears.\n          - 'direction': displays whether the referenced item is above or\n            below the reference field.\n          - 'page': displays the number of the page on which the referenced\n            item appears.\n          - 'text': displays the text of the referenced item.\n        Additional defined values for the text:reference-format attribute\n        supported by references to sequence fields are:\n          - 'caption': displays the caption in which the sequence is used.\n          - 'category-and-value': displays the name and value of the sequence.\n          - 'value': displays the value of the sequence.\n\n        References to bookmarks and other references support additional values,\n        which display the list label of the referenced item. If the referenced\n        item is contained in a list or a numbered paragraph, the list label is\n        the formatted number of the paragraph which contains the referenced\n        item. If the referenced item is not contained in a list or numbered\n        paragraph, the list label is empty, and the referenced field therefore\n        displays nothing. If the referenced bookmark or reference contains more\n        than one paragraph, the list label of the paragraph at which the\n        bookmark or reference starts is taken.\n\n        Additional defined values for the text:reference-format attribute\n        supported by all references to bookmark's or other reference fields\n        are:\n          - 'number': displays the list label of the referenced item. [...]\n          - 'number-all-superior': displays the list label of the referenced\n            item and adds the contents of all list labels of superior levels\n            in front of it. [...]\n          - 'number-no-superior': displays the contents of the list label of\n            the referenced item.\n    \"\"\"\n\n    _tag = \"text:reference-ref\"\n    _properties = (PropDef(\"name\", \"text:ref-name\"),)\n    format_allowed = (\n        \"chapter\",\n        \"direction\",\n        \"page\",\n        \"text\",\n        \"caption\",\n        \"category-and-value\",\n        \"value\",\n        \"number\",\n        \"number-all-superior\",\n        \"number-no-superior\",\n    )\n\n    def __init__(self, name: str = \"\", ref_format: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"Create a reference to a content marked by a reference mark. An\n        actual reference mark with the provided name should exist.\n\n        Consider using: odfdo.paragraph.insert_reference()\n\n        The text:ref-name attribute identifies a \"text:reference-mark\" or\n        \"text:referencemark-start\" element by the value of that element's\n        text:name attribute.\n        If ref_format is 'text', the current text content of the reference_mark\n        is retrieved.\n\n        Arguments:\n\n            name -- str : name of the reference mark\n\n            ref_format -- str : format of the field. Default is 'page', allowed\n                            values are 'chapter', 'direction', 'page', 'text',\n                            'caption', 'category-and-value', 'value', 'number',\n                            'number-all-superior', 'number-no-superior'.\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n            self.ref_format = ref_format\n\n    @property\n    def ref_format(self) -&gt; str | None:\n        reference = self.get_attribute(\"text:reference-format\")\n        if isinstance(reference, str):\n            return reference\n        return None\n\n    @ref_format.setter\n    def ref_format(self, ref_format: str) -&gt; None:\n        \"\"\"Set the text:reference-format attribute.\n\n        Arguments:\n\n            ref_format -- str\n        \"\"\"\n        if not ref_format or ref_format not in self.format_allowed:\n            ref_format = \"page\"\n        self.set_attribute(\"text:reference-format\", ref_format)\n\n    def update(self) -&gt; None:\n        \"\"\"Update the content of the reference text field. Currently only\n        'text' format is implemented. Other values, for example the 'page' text\n        field, may need to be refreshed through a visual ODF parser.\n        \"\"\"\n        ref_format = self.ref_format\n        if ref_format != \"text\":\n            # only 'text' is implemented\n            return None\n        body = self.document_body\n        if not body:\n            body = self.root\n        name = self.name\n        reference = body.get_reference_mark(name=name)\n        if not reference:\n            return None\n        # we know it is a ReferenceMarkStart:\n        self.text = reference.referenced_text()  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Reference.__init__","title":"<code>__init__(name='', ref_format='', **kwargs)</code>","text":"<p>Create a reference to a content marked by a reference mark. An actual reference mark with the provided name should exist.</p> <p>Consider using: odfdo.paragraph.insert_reference()</p> <p>The text:ref-name attribute identifies a \u201ctext:reference-mark\u201d or \u201ctext:referencemark-start\u201d element by the value of that element\u2019s text:name attribute. If ref_format is \u2018text\u2019, the current text content of the reference_mark is retrieved.</p> <p>Arguments:</p> <pre><code>name -- str : name of the reference mark\n\nref_format -- str : format of the field. Default is 'page', allowed\n                values are 'chapter', 'direction', 'page', 'text',\n                'caption', 'category-and-value', 'value', 'number',\n                'number-all-superior', 'number-no-superior'.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", ref_format: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"Create a reference to a content marked by a reference mark. An\n    actual reference mark with the provided name should exist.\n\n    Consider using: odfdo.paragraph.insert_reference()\n\n    The text:ref-name attribute identifies a \"text:reference-mark\" or\n    \"text:referencemark-start\" element by the value of that element's\n    text:name attribute.\n    If ref_format is 'text', the current text content of the reference_mark\n    is retrieved.\n\n    Arguments:\n\n        name -- str : name of the reference mark\n\n        ref_format -- str : format of the field. Default is 'page', allowed\n                        values are 'chapter', 'direction', 'page', 'text',\n                        'caption', 'category-and-value', 'value', 'number',\n                        'number-all-superior', 'number-no-superior'.\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n        self.ref_format = ref_format\n</code></pre>"},{"location":"reference.html#odfdo.Reference.update","title":"<code>update()</code>","text":"<p>Update the content of the reference text field. Currently only \u2018text\u2019 format is implemented. Other values, for example the \u2018page\u2019 text field, may need to be refreshed through a visual ODF parser.</p> Source code in <code>odfdo/reference.py</code> <pre><code>def update(self) -&gt; None:\n    \"\"\"Update the content of the reference text field. Currently only\n    'text' format is implemented. Other values, for example the 'page' text\n    field, may need to be refreshed through a visual ODF parser.\n    \"\"\"\n    ref_format = self.ref_format\n    if ref_format != \"text\":\n        # only 'text' is implemented\n        return None\n    body = self.document_body\n    if not body:\n        body = self.root\n    name = self.name\n    reference = body.get_reference_mark(name=name)\n    if not reference:\n        return None\n    # we know it is a ReferenceMarkStart:\n    self.text = reference.referenced_text()  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMark","title":"<code>ReferenceMark</code>","text":"<p>             Bases: <code>Element</code></p> <p>A point reference. A point reference marks a position in text and is represented by a single \u201ctext:reference-mark\u201d element.</p> Source code in <code>odfdo/reference.py</code> <pre><code>class ReferenceMark(Element):\n    \"\"\"A point reference.\n    A point reference marks a position in text and is represented by a single\n    \"text:reference-mark\" element.\n    \"\"\"\n\n    _tag = \"text:reference-mark\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"A point reference. A point reference marks a position in text and is\n        represented by a single \"text:reference-mark\" element.\n        Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMark.__init__","title":"<code>__init__(name='', **kwargs)</code>","text":"<p>A point reference. A point reference marks a position in text and is represented by a single \u201ctext:reference-mark\u201d element. Consider using the wrapper: odfdo.paragraph.set_reference_mark()</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"A point reference. A point reference marks a position in text and is\n    represented by a single \"text:reference-mark\" element.\n    Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkEnd","title":"<code>ReferenceMarkEnd</code>","text":"<p>             Bases: <code>Element</code></p> <p>The \u201ctext:reference-mark-end\u201d element represents the end of a range reference.</p> Source code in <code>odfdo/reference.py</code> <pre><code>class ReferenceMarkEnd(Element):\n    \"\"\"The \"text:reference-mark-end\" element represents the end of a range\n    reference.\n    \"\"\"\n\n    _tag = \"text:reference-mark-end\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"The \"text:reference-mark-end\" element represent the end of a range\n        reference.\n        Consider using the wrappers: odfdo.paragraph.set_reference_mark() and\n        odfdo.paragraph.set_reference_mark_end()\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n\n    def referenced_text(self) -&gt; str:\n        \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n        name = self.name\n        request = (\n            f\"//text()\"\n            f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n            f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n        )\n        result = \" \".join(str(x) for x in self.xpath(request))\n        return result\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkEnd.__init__","title":"<code>__init__(name='', **kwargs)</code>","text":"<p>The \u201ctext:reference-mark-end\u201d element represent the end of a range reference. Consider using the wrappers: odfdo.paragraph.set_reference_mark() and odfdo.paragraph.set_reference_mark_end()</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"The \"text:reference-mark-end\" element represent the end of a range\n    reference.\n    Consider using the wrappers: odfdo.paragraph.set_reference_mark() and\n    odfdo.paragraph.set_reference_mark_end()\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkEnd.referenced_text","title":"<code>referenced_text()</code>","text":"<p>Return the text between reference-mark-start and reference-mark-end.</p> Source code in <code>odfdo/reference.py</code> <pre><code>def referenced_text(self) -&gt; str:\n    \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n    name = self.name\n    request = (\n        f\"//text()\"\n        f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n        f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n    )\n    result = \" \".join(str(x) for x in self.xpath(request))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart","title":"<code>ReferenceMarkStart</code>","text":"<p>             Bases: <code>Element</code></p> <p>The \u201ctext:reference-mark-start\u201d element represents the start of a range reference.</p> Source code in <code>odfdo/reference.py</code> <pre><code>class ReferenceMarkStart(Element):\n    \"\"\"The \"text:reference-mark-start\" element represents the start of a\n    range reference.\n    \"\"\"\n\n    _tag = \"text:reference-mark-start\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"The \"text:reference-mark-start\" element represent the start of a range\n        reference.\n        Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n\n    def referenced_text(self) -&gt; str:\n        \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n        name = self.name\n        request = (\n            f\"//text()\"\n            f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n            f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n        )\n        result = \" \".join(str(x) for x in self.xpath(request))\n        return result\n\n    def get_referenced(\n        self,\n        no_header: bool = False,\n        clean: bool = True,\n        as_xml: bool = False,\n        as_list: bool = False,\n    ) -&gt; Element | list | str | None:\n        \"\"\"Return the document content between the start and end tags of the\n        reference. The content returned by this method can spread over several\n        headers and paragraphs.\n        By default, the content is returned as an \"office:text\" odf element.\n\n\n        Arguments:\n\n            no_header -- boolean (default to False), translate existing headers\n                         tags \"text:h\" into paragraphs \"text:p\".\n\n            clean -- boolean (default to True), suppress unwanted tags. Striped\n                     tags are : 'text:change', 'text:change-start',\n                     'text:change-end', 'text:reference-mark',\n                     'text:reference-mark-start', 'text:reference-mark-end'.\n\n            as_xml -- boolean (default to False), format the returned content as\n                      a XML string (serialization).\n\n            as_list -- boolean (default to False), do not embed the returned\n                       content in a \"office:text'\" element, instead simply\n                       return a raw list of odf elements.\n        \"\"\"\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Reference need some upper document part\")\n        body = self.document_body\n        if not body:\n            body = parent\n        end = body.get_reference_mark_end(name=name)\n        if end is None:\n            raise ValueError(\"No reference-end found\")\n        start = self\n        return _get_referenced(body, start, end, no_header, clean, as_xml, as_list)\n\n    def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        For odf_reference_mark_start : delete the reference-end tag if exists.\n\n        Arguments:\n\n            child -- Element\n\n            keep_tail -- boolean (default to True), True for most usages.\n        \"\"\"\n        if child is not None:  # act like normal delete\n            return super().delete(child, keep_tail)\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can't delete the root element\")\n        body = self.document_body\n        if not body:\n            body = parent\n        end = body.get_reference_mark_end(name=name)\n        if end:\n            end.delete()\n        # act like normal delete\n        return super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.__init__","title":"<code>__init__(name='', **kwargs)</code>","text":"<p>The \u201ctext:reference-mark-start\u201d element represent the start of a range reference. Consider using the wrapper: odfdo.paragraph.set_reference_mark()</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"The \"text:reference-mark-start\" element represent the start of a range\n    reference.\n    Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>For odf_reference_mark_start : delete the reference-end tag if exists.</p> <p>Arguments:</p> <pre><code>child -- Element\n\nkeep_tail -- boolean (default to True), True for most usages.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    For odf_reference_mark_start : delete the reference-end tag if exists.\n\n    Arguments:\n\n        child -- Element\n\n        keep_tail -- boolean (default to True), True for most usages.\n    \"\"\"\n    if child is not None:  # act like normal delete\n        return super().delete(child, keep_tail)\n    name = self.name\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Can't delete the root element\")\n    body = self.document_body\n    if not body:\n        body = parent\n    end = body.get_reference_mark_end(name=name)\n    if end:\n        end.delete()\n    # act like normal delete\n    return super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.get_referenced","title":"<code>get_referenced(no_header=False, clean=True, as_xml=False, as_list=False)</code>","text":"<p>Return the document content between the start and end tags of the reference. The content returned by this method can spread over several headers and paragraphs. By default, the content is returned as an \u201coffice:text\u201d odf element.</p> <p>Arguments:</p> <pre><code>no_header -- boolean (default to False), translate existing headers\n             tags \"text:h\" into paragraphs \"text:p\".\n\nclean -- boolean (default to True), suppress unwanted tags. Striped\n         tags are : 'text:change', 'text:change-start',\n         'text:change-end', 'text:reference-mark',\n         'text:reference-mark-start', 'text:reference-mark-end'.\n\nas_xml -- boolean (default to False), format the returned content as\n          a XML string (serialization).\n\nas_list -- boolean (default to False), do not embed the returned\n           content in a \"office:text'\" element, instead simply\n           return a raw list of odf elements.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def get_referenced(\n    self,\n    no_header: bool = False,\n    clean: bool = True,\n    as_xml: bool = False,\n    as_list: bool = False,\n) -&gt; Element | list | str | None:\n    \"\"\"Return the document content between the start and end tags of the\n    reference. The content returned by this method can spread over several\n    headers and paragraphs.\n    By default, the content is returned as an \"office:text\" odf element.\n\n\n    Arguments:\n\n        no_header -- boolean (default to False), translate existing headers\n                     tags \"text:h\" into paragraphs \"text:p\".\n\n        clean -- boolean (default to True), suppress unwanted tags. Striped\n                 tags are : 'text:change', 'text:change-start',\n                 'text:change-end', 'text:reference-mark',\n                 'text:reference-mark-start', 'text:reference-mark-end'.\n\n        as_xml -- boolean (default to False), format the returned content as\n                  a XML string (serialization).\n\n        as_list -- boolean (default to False), do not embed the returned\n                   content in a \"office:text'\" element, instead simply\n                   return a raw list of odf elements.\n    \"\"\"\n    name = self.name\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Reference need some upper document part\")\n    body = self.document_body\n    if not body:\n        body = parent\n    end = body.get_reference_mark_end(name=name)\n    if end is None:\n        raise ValueError(\"No reference-end found\")\n    start = self\n    return _get_referenced(body, start, end, no_header, clean, as_xml, as_list)\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.referenced_text","title":"<code>referenced_text()</code>","text":"<p>Return the text between reference-mark-start and reference-mark-end.</p> Source code in <code>odfdo/reference.py</code> <pre><code>def referenced_text(self) -&gt; str:\n    \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n    name = self.name\n    request = (\n        f\"//text()\"\n        f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n        f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n    )\n    result = \" \".join(str(x) for x in self.xpath(request))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Row","title":"<code>Row</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF table row \u201ctable:table-row\u201d</p> Source code in <code>odfdo/row.py</code> <pre><code>class Row(Element):\n    \"\"\"ODF table row \"table:table-row\" \"\"\"\n\n    _tag = \"table:table-row\"\n    _caching = True\n    _append = Element.append\n\n    def __init__(\n        self,\n        width: int | None = None,\n        repeated: int | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"create a Row, optionally filled with \"width\" number of cells.\n\n        Rows contain cells, their number determine the number of columns.\n\n        You don't generally have to create rows by hand, use the Table API.\n\n        Arguments:\n\n            width -- int\n\n            repeated -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self.y = None\n        if not hasattr(self, \"_indexes\"):\n            self._indexes = {}\n            self._indexes[\"_rmap\"] = {}\n        if not hasattr(self, \"_rmap\"):\n            self._compute_row_cache()\n            if not hasattr(self, \"_tmap\"):\n                self._tmap = []\n                self._cmap = []\n        if self._do_init:\n            if width is not None:\n                for _i in range(width):\n                    self.append(Cell())  # type:ignore\n            if repeated:\n                self.repeated = repeated\n            if style is not None:\n                self.style = style\n            self._compute_row_cache()\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} y={self.y}&gt;\"\n\n    def _get_cells(self) -&gt; list[Element]:\n        return self.get_elements(_xpath_cell)\n\n    def _translate_row_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, int | None]:\n        xyzt = convert_coordinates(coord)\n        if len(xyzt) == 2:\n            x, z = xyzt\n        else:\n            x, _, z, __ = xyzt\n        if x and x &lt; 0:\n            x = increment(x, self.width)\n        if z and z &lt; 0:\n            z = increment(z, self.width)\n        return (x, z)\n\n    def _compute_row_cache(self) -&gt; None:\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_cell, \"table:number-columns-repeated\"\n        )\n        self._rmap = make_cache_map(idx_repeated_seq)\n\n    # Public API\n\n    @property\n    def clone(self) -&gt; Row:\n        clone = Element.clone.fget(self)  # type: ignore\n        clone.y = self.y\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                clone._rmap = self._rmap[:]\n            clone._tmap = self._tmap[:]\n            clone._cmap = self._cmap[:]\n        return clone\n\n    def _set_repeated(self, repeated: int | None) -&gt; None:\n        \"\"\"Method Internal only. Set the numnber of times the row is\n        repeated, or None to delete it. Without changing cache.\n\n        Arguments:\n\n            repeated -- int\n        \"\"\"\n        if repeated is None or repeated &lt; 2:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:number-rows-repeated\")\n            return\n        self.set_attribute(\"table:number-rows-repeated\", str(repeated))\n\n    @property\n    def repeated(self) -&gt; int | None:\n        \"\"\"Get / set the number of times the row is repeated.\n\n        Always None when using the table API.\n\n        Return: int or None\n        \"\"\"\n        repeated = self.get_attribute(\"table:number-rows-repeated\")\n        if repeated is None:\n            return None\n        return int(repeated)\n\n    @repeated.setter\n    def repeated(self, repeated: int | None) -&gt; None:\n        self._set_repeated(repeated)\n        # update cache\n        current: Element = self\n        while True:\n            # look for Table, parent may be group of rows\n            upper = current.parent\n            if not upper:\n                # lonely row\n                return\n            # parent may be group of rows, not table\n            if isinstance(upper, Element) and upper._tag == \"table:table\":\n                break\n            current = upper\n        # fixme : need to optimize this\n        if isinstance(upper, Element) and upper._tag == \"table:table\":\n            upper._compute_table_cache()\n            if hasattr(self, \"_tmap\"):\n                del self._tmap[:]\n                self._tmap.extend(upper._tmap)\n            else:\n                self._tmap = upper._tmap\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get /set the style of the row itself.\n\n        Return: str\n        \"\"\"\n        return self.get_attribute(\"table:style-name\")  # type: ignore\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n\n    @property\n    def width(self) -&gt; int:\n        \"\"\"Get the number of expected cells in the row, i.e. addition\n        repetitions.\n\n        Return: int\n        \"\"\"\n        try:\n            value = self._rmap[-1] + 1\n        except Exception:\n            value = 0\n        return value\n\n    def _translate_x_from_any(self, x: str | int) -&gt; int:\n        return translate_from_any(x, self.width, 0)\n\n    def traverse(  # noqa: C901\n        self,\n        start: int | None = None,\n        end: int | None = None,\n    ) -&gt; Iterator[Cell]:\n        \"\"\"Yield as many cell elements as expected cells in the row, i.e.\n        expand repetitions by returning the same cell as many times as\n        necessary.\n\n            Arguments:\n\n                start -- int\n\n                end -- int\n\n        Copies are returned, use set_cell() to push them back.\n        \"\"\"\n        idx = -1\n        before = -1\n        x = 0\n        cell: Cell\n        if start is None and end is None:\n            for juska in self._rmap:\n                idx += 1\n                if idx in self._indexes[\"_rmap\"]:\n                    cell = self._indexes[\"_rmap\"][idx]\n                else:\n                    cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                    if not isinstance(cell, Cell):\n                        raise TypeError(f\"Not a cell: {cell!r}\")\n                    self._indexes[\"_rmap\"][idx] = cell\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    # Return a copy without the now obsolete repetition\n                    if cell is None:\n                        cell = Cell()\n                    else:\n                        cell = cell.clone\n                        if repeated &gt; 1:\n                            cell.repeated = None\n                    cell.y = self.y\n                    cell.x = x\n                    x += 1\n                    yield cell\n        else:\n            if start is None:\n                start = 0\n            start = max(0, start)\n            if end is None:\n                try:\n                    end = self._rmap[-1]\n                except Exception:\n                    end = -1\n            start_map = find_odf_idx(self._rmap, start)\n            if start_map is None:\n                return\n            if start_map &gt; 0:\n                before = self._rmap[start_map - 1]\n            idx = start_map - 1\n            before = start - 1\n            x = start\n            for juska in self._rmap[start_map:]:\n                idx += 1\n                if idx in self._indexes[\"_rmap\"]:\n                    cell = self._indexes[\"_rmap\"][idx]\n                else:\n                    cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                    if not isinstance(cell, Cell):\n                        raise TypeError(f\"Not a cell: {cell!r}\")\n                    self._indexes[\"_rmap\"][idx] = cell\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    if x &lt;= end:\n                        if cell is None:\n                            cell = Cell()\n                        else:\n                            cell = cell.clone\n                            if repeated &gt; 1 or (x == start and start &gt; 0):\n                                cell.repeated = None\n                        cell.y = self.y\n                        cell.x = x\n                        x += 1\n                        yield cell\n\n    def get_cells(\n        self,\n        coord: str | tuple | None = None,\n        style: str | None = None,\n        content: str | None = None,\n        cell_type: str | None = None,\n    ) -&gt; list[Cell]:\n        \"\"\"Get the list of cells matching the criteria.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n\n        Filter by coordinates will retrieve the amount of cells defined by\n        'coord', minus the other filters.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            content -- str regex\n\n            style -- str\n\n        Return: list of Cell\n        \"\"\"\n        # fixme : not clones ?\n        if coord:\n            x, z = self._translate_row_coordinates(coord)\n        else:\n            x = None\n            z = None\n        if cell_type:\n            cell_type = cell_type.lower().strip()\n        cells: list[Cell] = []\n        for cell in self.traverse(start=x, end=z):\n            # Filter the cells by cell_type\n            if cell_type:\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    continue\n            # Filter the cells with the regex\n            if content and not cell.match(content):\n                continue\n            # Filter the cells with the style\n            if style and style != cell.style:\n                continue\n            cells.append(cell)\n        return cells\n\n    @property\n    def cells(self) -&gt; list[Cell]:\n        \"\"\"Get the list of all cells.\n\n        Return: list of Cell\n        \"\"\"\n        # fixme : not clones ?\n        return list(self.traverse())\n\n    def _get_cell2(self, x: int, clone: bool = True) -&gt; Cell | None:\n        if x &gt;= self.width:\n            return Cell()\n        if clone:\n            return self._get_cell2_base(x).clone  # type: ignore\n        else:\n            return self._get_cell2_base(x)\n\n    def _get_cell2_base(self, x: int) -&gt; Cell | None:\n        idx = find_odf_idx(self._rmap, x)\n        cell: Cell\n        if idx is not None:\n            if idx in self._indexes[\"_rmap\"]:\n                cell = self._indexes[\"_rmap\"][idx]\n            else:\n                cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                self._indexes[\"_rmap\"][idx] = cell\n            return cell\n        return None\n\n    def get_cell(self, x: int, clone: bool = True) -&gt; Cell | None:\n        \"\"\"Get the cell at position \"x\" starting from 0. Alphabetical\n        positions like \"D\" are accepted.\n\n        A  copy is returned, use set_cell() to push it back.\n\n        Arguments:\n\n            x -- int or str\n\n        Return: Cell | None\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        cell = self._get_cell2(x, clone=clone)\n        if not cell:\n            return None\n        cell.y = self.y\n        cell.x = x\n        return cell\n\n    def get_value(\n        self,\n        x: int | str,\n        get_type: bool = False,\n    ) -&gt; Any | tuple[Any, str]:\n        \"\"\"Shortcut to get the value of the cell at position \"x\".\n        If get_type is True, returns the tuples (value, ODF type).\n\n        If the cell is empty, returns None or (None, None)\n\n        See get_cell() and Cell.get_value().\n        \"\"\"\n        if get_type:\n            x = self._translate_x_from_any(x)\n            cell = self._get_cell2_base(x)\n            if cell is None:\n                return (None, None)\n            return cell.get_value(get_type=get_type)\n        x = self._translate_x_from_any(x)\n        cell = self._get_cell2_base(x)\n        if cell is None:\n            return None\n        return cell.get_value()\n\n    def set_cell(\n        self,\n        x: int | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Push the cell back in the row at position \"x\" starting from 0.\n        Alphabetical positions like \"D\" are accepted.\n\n        Arguments:\n\n            x -- int or str\n\n        returns the cell with x and y updated\n        \"\"\"\n        cell_back: Cell\n        if cell is None:\n            cell = Cell()\n            repeated = 1\n            clone = False\n        else:\n            repeated = cell.repeated or 1\n        x = self._translate_x_from_any(x)\n        # Outside the defined row\n        diff = x - self.width\n        if diff == 0:\n            cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n        elif diff &gt; 0:\n            self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n            cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n        else:\n            # Inside the defined row\n            set_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\", clone=clone)\n            cell.x = x\n            cell.y = self.y\n            cell_back = cell\n        return cell_back\n\n    def set_value(\n        self,\n        x: int | str,\n        value: Any,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the value of the cell at position \"x\".\n\n        Arguments:\n\n            x -- int or str\n\n            value -- Python type\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n\n        See get_cell() and Cell.get_value().\n        \"\"\"\n        self.set_cell(\n            x,\n            Cell(value, style=style, cell_type=cell_type, currency=currency),\n            clone=False,\n        )\n\n    def insert_cell(\n        self,\n        x: int | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Insert the given cell at position \"x\" starting from 0. If no cell\n        is given, an empty one is created.\n\n        Alphabetical positions like \"D\" are accepted.\n\n        Do not use when working on a table, use Table.insert_cell().\n\n        Arguments:\n\n            x -- int or str\n\n            cell -- Cell\n\n        returns the cell with x and y updated\n        \"\"\"\n        cell_back: Cell\n        if cell is None:\n            cell = Cell()\n        x = self._translate_x_from_any(x)\n        # Outside the defined row\n        diff = x - self.width\n        if diff &lt; 0:\n            insert_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\")\n            cell.x = x\n            cell.y = self.y\n            cell_back = cell\n        elif diff == 0:\n            cell_back = self.append_cell(cell, clone=clone)\n        else:\n            self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n            cell_back = self.append_cell(cell, clone=clone)\n        return cell_back\n\n    def extend_cells(self, cells: Iterable[Cell] | None = None) -&gt; None:\n        if cells is None:\n            cells = []\n        self.extend(cells)\n        self._compute_row_cache()\n\n    def append_cell(\n        self,\n        cell: Cell | None = None,\n        clone: bool = True,\n        _repeated: int | None = None,\n    ) -&gt; Cell:\n        \"\"\"Append the given cell at the end of the row. Repeated cells are\n        accepted. If no cell is given, an empty one is created.\n\n        Do not use when working on a table, use Table.append_cell().\n\n        Arguments:\n\n            cell -- Cell\n\n            _repeated -- (optional), repeated value of the row\n\n        returns the cell with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        if clone:\n            cell = cell.clone\n        self._append(cell)\n        if _repeated is None:\n            _repeated = cell.repeated or 1\n        self._rmap = insert_map_once(self._rmap, len(self._rmap), _repeated)\n        cell.x = self.width - 1\n        cell.y = self.y\n        return cell\n\n    # fix for unit test and typos\n    append = append_cell  # type: ignore\n\n    def delete_cell(self, x: int | str) -&gt; None:\n        \"\"\"Delete the cell at the given position \"x\" starting from 0.\n        Alphabetical positions like \"D\" are accepted.\n\n        Cells on the right will be shifted to the left. In a table, other\n        rows remain unaffected.\n\n        Arguments:\n\n            x -- int or str\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        if x &gt;= self.width:\n            return\n        delete_item_in_vault(x, self, _xpath_cell_idx, \"_rmap\")\n\n    def get_values(\n        self,\n        coord: str | tuple | None = None,\n        cell_type: str | None = None,\n        complete: bool = False,\n        get_type: bool = False,\n    ) -&gt; list[Any | tuple[Any, Any]]:\n        \"\"\"Shortcut to get the cell values in this row.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n        If cell_type is used and complete is True, missing values are\n        replaced by None.\n        If cell_type is None, complete is always True : with no cell type\n        queried, get_values() returns None for each empty cell, the length\n        of the list is equal to the length of the row (depending on\n        coordinates use).\n\n        If get_type is True, returns a tuple (value, ODF type of value), or\n        (None, None) for empty cells if complete is True.\n\n        Filter by coordinates will retrieve the amount of cells defined by\n        coordinates with None for empty cells, except when using cell_type.\n\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates in row\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of Python types, or list of tuples.\n        \"\"\"\n        if coord:\n            x, z = self._translate_row_coordinates(coord)\n        else:\n            x = None\n            z = None\n        if cell_type:\n            cell_type = cell_type.lower().strip()\n            values: list[Any | tuple[Any, Any]] = []\n            for cell in self.traverse(start=x, end=z):\n                # Filter the cells by cell_type\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    if complete:\n                        if get_type:\n                            values.append((None, None))\n                        else:\n                            values.append(None)\n                    continue\n                values.append(cell.get_value(get_type=get_type))\n            return values\n        else:\n            return [\n                cell.get_value(get_type=get_type)\n                for cell in self.traverse(start=x, end=z)\n            ]\n\n    def set_cells(\n        self,\n        cells: list[Cell] | tuple[Cell] | None = None,\n        start: int | str = 0,\n        clone: bool = True,\n    ) -&gt; None:\n        \"\"\"Set the cells in the row, from the 'start' column.\n        This method does not clear the row, use row.clear() before to start\n        with an empty row.\n\n        Arguments:\n\n            cells -- list of cells\n\n            start -- int or str\n        \"\"\"\n        if cells is None:\n            cells = []\n        if start is None:\n            start = 0\n        else:\n            start = self._translate_x_from_any(start)\n        if start == 0 and clone is False and (len(cells) &gt;= self.width):\n            self.clear()\n            self.extend_cells(cells)\n        else:\n            x = start\n            for cell in cells:\n                self.set_cell(x, cell, clone=clone)\n                if cell:\n                    x += cell.repeated or 1\n                else:\n                    x += 1\n\n    def set_values(\n        self,\n        values: list[Any],\n        start: int | str = 0,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the value of cells in the row, from the 'start'\n        column vith values.\n        This method does not clear the row, use row.clear() before to start\n        with an empty row.\n\n        Arguments:\n\n            values -- list of Python types\n\n            start -- int or str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency' or 'percentage'\n\n            currency -- three-letter str\n\n            style -- cell style\n        \"\"\"\n        # fixme : if values n, n+ are same, use repeat\n        if start is None:\n            start = 0\n        else:\n            start = self._translate_x_from_any(start)\n        if start == 0 and (len(values) &gt;= self.width):\n            self.clear()\n            cells = [\n                Cell(value, style=style, cell_type=cell_type, currency=currency)\n                for value in values\n            ]\n            self.extend_cells(cells)\n        else:\n            x = start\n            for value in values:\n                self.set_cell(\n                    x,\n                    Cell(value, style=style, cell_type=cell_type, currency=currency),\n                    clone=False,\n                )\n                x += 1\n\n    def rstrip(self, aggressive: bool = False) -&gt; None:\n        \"\"\"Remove *in-place* empty cells at the right of the row. An empty\n        cell has no value but can have style. If \"aggressive\" is True, style\n        is ignored.\n\n        Arguments:\n\n            aggressive -- bool\n        \"\"\"\n        for cell in reversed(self._get_cells()):\n            if not cell.is_empty(aggressive=aggressive):  # type: ignore\n                break\n            self.delete(cell)\n        self._compute_row_cache()\n        self._indexes[\"_rmap\"] = {}\n\n    def _current_length(self) -&gt; int:\n        \"\"\"Return the current estimated length of the row.\n\n        Return: int\n        \"\"\"\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_cell, \"table:number-columns-repeated\"\n        )\n        repeated = [item[1] for item in idx_repeated_seq]\n        if repeated:\n            return sum(repeated)\n        return 1\n\n    def minimized_width(self) -&gt; int:\n        \"\"\"Return the length of the row if the last repeated sequence is\n        reduced to one.\n\n        Return: int\n        \"\"\"\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_cell, \"table:number-columns-repeated\"\n        )\n        repeated = [item[1] for item in idx_repeated_seq]\n        if repeated:\n            cell = self.last_cell()\n            if cell is not None and cell.is_empty(aggressive=True):\n                repeated[-1] = 1\n            min_width = sum(repeated)\n        else:\n            min_width = 1\n        self._compute_row_cache()\n        self._indexes[\"_rmap\"] = {}\n        return min_width\n\n    def last_cell(self) -&gt; Cell | None:\n        \"\"\"Return the las cell of the row.\n\n        Return Cell | None\n        \"\"\"\n        try:\n            return self._get_cells()[-1]  # type: ignore\n        except IndexError:\n            return None\n\n    def force_width(self, width: int) -&gt; None:\n        \"\"\"Change the repeated property of the last cell of the row\n        to comply with the required max width.\n\n        Arguments:\n\n            width -- int\n        \"\"\"\n        cell = self.last_cell()\n        if cell is None or not cell.is_empty(aggressive=True):\n            return\n        repeated = cell.repeated\n        if repeated is None:\n            return\n        # empty repeated cell\n        delta = self._current_length() - width\n        if delta &gt; 0:\n            cell._set_repeated(repeated - delta)\n            self._compute_row_cache()\n\n    def is_empty(self, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return whether every cell in the row has no value or the value\n        evaluates to False (empty string), and no style.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            aggressive -- bool\n\n        Return: bool\n        \"\"\"\n        return all(cell.is_empty(aggressive=aggressive) for cell in self._get_cells())  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Row.cells","title":"<code>cells: list[Cell]</code>  <code>property</code>","text":"<p>Get the list of all cells.</p> <p>Return: list of Cell</p>"},{"location":"reference.html#odfdo.Row.repeated","title":"<code>repeated: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the number of times the row is repeated.</p> <p>Always None when using the table API.</p> <p>Return: int or None</p>"},{"location":"reference.html#odfdo.Row.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get /set the style of the row itself.</p> <p>Return: str</p>"},{"location":"reference.html#odfdo.Row.width","title":"<code>width: int</code>  <code>property</code>","text":"<p>Get the number of expected cells in the row, i.e. addition repetitions.</p> <p>Return: int</p>"},{"location":"reference.html#odfdo.Row.__init__","title":"<code>__init__(width=None, repeated=None, style=None, **kwargs)</code>","text":"<p>create a Row, optionally filled with \u201cwidth\u201d number of cells.</p> <p>Rows contain cells, their number determine the number of columns.</p> <p>You don\u2019t generally have to create rows by hand, use the Table API.</p> <p>Arguments:</p> <pre><code>width -- int\n\nrepeated -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def __init__(\n    self,\n    width: int | None = None,\n    repeated: int | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"create a Row, optionally filled with \"width\" number of cells.\n\n    Rows contain cells, their number determine the number of columns.\n\n    You don't generally have to create rows by hand, use the Table API.\n\n    Arguments:\n\n        width -- int\n\n        repeated -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self.y = None\n    if not hasattr(self, \"_indexes\"):\n        self._indexes = {}\n        self._indexes[\"_rmap\"] = {}\n    if not hasattr(self, \"_rmap\"):\n        self._compute_row_cache()\n        if not hasattr(self, \"_tmap\"):\n            self._tmap = []\n            self._cmap = []\n    if self._do_init:\n        if width is not None:\n            for _i in range(width):\n                self.append(Cell())  # type:ignore\n        if repeated:\n            self.repeated = repeated\n        if style is not None:\n            self.style = style\n        self._compute_row_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Row.append_cell","title":"<code>append_cell(cell=None, clone=True, _repeated=None)</code>","text":"<p>Append the given cell at the end of the row. Repeated cells are accepted. If no cell is given, an empty one is created.</p> <p>Do not use when working on a table, use Table.append_cell().</p> <p>Arguments:</p> <pre><code>cell -- Cell\n\n_repeated -- (optional), repeated value of the row\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/row.py</code> <pre><code>def append_cell(\n    self,\n    cell: Cell | None = None,\n    clone: bool = True,\n    _repeated: int | None = None,\n) -&gt; Cell:\n    \"\"\"Append the given cell at the end of the row. Repeated cells are\n    accepted. If no cell is given, an empty one is created.\n\n    Do not use when working on a table, use Table.append_cell().\n\n    Arguments:\n\n        cell -- Cell\n\n        _repeated -- (optional), repeated value of the row\n\n    returns the cell with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    if clone:\n        cell = cell.clone\n    self._append(cell)\n    if _repeated is None:\n        _repeated = cell.repeated or 1\n    self._rmap = insert_map_once(self._rmap, len(self._rmap), _repeated)\n    cell.x = self.width - 1\n    cell.y = self.y\n    return cell\n</code></pre>"},{"location":"reference.html#odfdo.Row.delete_cell","title":"<code>delete_cell(x)</code>","text":"<p>Delete the cell at the given position \u201cx\u201d starting from 0. Alphabetical positions like \u201cD\u201d are accepted.</p> <p>Cells on the right will be shifted to the left. In a table, other rows remain unaffected.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def delete_cell(self, x: int | str) -&gt; None:\n    \"\"\"Delete the cell at the given position \"x\" starting from 0.\n    Alphabetical positions like \"D\" are accepted.\n\n    Cells on the right will be shifted to the left. In a table, other\n    rows remain unaffected.\n\n    Arguments:\n\n        x -- int or str\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    if x &gt;= self.width:\n        return\n    delete_item_in_vault(x, self, _xpath_cell_idx, \"_rmap\")\n</code></pre>"},{"location":"reference.html#odfdo.Row.force_width","title":"<code>force_width(width)</code>","text":"<p>Change the repeated property of the last cell of the row to comply with the required max width.</p> <p>Arguments:</p> <pre><code>width -- int\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def force_width(self, width: int) -&gt; None:\n    \"\"\"Change the repeated property of the last cell of the row\n    to comply with the required max width.\n\n    Arguments:\n\n        width -- int\n    \"\"\"\n    cell = self.last_cell()\n    if cell is None or not cell.is_empty(aggressive=True):\n        return\n    repeated = cell.repeated\n    if repeated is None:\n        return\n    # empty repeated cell\n    delta = self._current_length() - width\n    if delta &gt; 0:\n        cell._set_repeated(repeated - delta)\n        self._compute_row_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_cell","title":"<code>get_cell(x, clone=True)</code>","text":"<p>Get the cell at position \u201cx\u201d starting from 0. Alphabetical positions like \u201cD\u201d are accepted.</p> <p>A  copy is returned, use set_cell() to push it back.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> <p>Return: Cell | None</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_cell(self, x: int, clone: bool = True) -&gt; Cell | None:\n    \"\"\"Get the cell at position \"x\" starting from 0. Alphabetical\n    positions like \"D\" are accepted.\n\n    A  copy is returned, use set_cell() to push it back.\n\n    Arguments:\n\n        x -- int or str\n\n    Return: Cell | None\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    cell = self._get_cell2(x, clone=clone)\n    if not cell:\n        return None\n    cell.y = self.y\n    cell.x = x\n    return cell\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_cells","title":"<code>get_cells(coord=None, style=None, content=None, cell_type=None)</code>","text":"<p>Get the list of cells matching the criteria.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells.</p> <p>Filter by coordinates will retrieve the amount of cells defined by \u2018coord\u2019, minus the other filters.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncontent -- str regex\n\nstyle -- str\n</code></pre> <p>Return: list of Cell</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_cells(\n    self,\n    coord: str | tuple | None = None,\n    style: str | None = None,\n    content: str | None = None,\n    cell_type: str | None = None,\n) -&gt; list[Cell]:\n    \"\"\"Get the list of cells matching the criteria.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n\n    Filter by coordinates will retrieve the amount of cells defined by\n    'coord', minus the other filters.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        content -- str regex\n\n        style -- str\n\n    Return: list of Cell\n    \"\"\"\n    # fixme : not clones ?\n    if coord:\n        x, z = self._translate_row_coordinates(coord)\n    else:\n        x = None\n        z = None\n    if cell_type:\n        cell_type = cell_type.lower().strip()\n    cells: list[Cell] = []\n    for cell in self.traverse(start=x, end=z):\n        # Filter the cells by cell_type\n        if cell_type:\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                continue\n        # Filter the cells with the regex\n        if content and not cell.match(content):\n            continue\n        # Filter the cells with the style\n        if style and style != cell.style:\n            continue\n        cells.append(cell)\n    return cells\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_value","title":"<code>get_value(x, get_type=False)</code>","text":"<p>Shortcut to get the value of the cell at position \u201cx\u201d. If get_type is True, returns the tuples (value, ODF type).</p> <p>If the cell is empty, returns None or (None, None)</p> <p>See get_cell() and Cell.get_value().</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_value(\n    self,\n    x: int | str,\n    get_type: bool = False,\n) -&gt; Any | tuple[Any, str]:\n    \"\"\"Shortcut to get the value of the cell at position \"x\".\n    If get_type is True, returns the tuples (value, ODF type).\n\n    If the cell is empty, returns None or (None, None)\n\n    See get_cell() and Cell.get_value().\n    \"\"\"\n    if get_type:\n        x = self._translate_x_from_any(x)\n        cell = self._get_cell2_base(x)\n        if cell is None:\n            return (None, None)\n        return cell.get_value(get_type=get_type)\n    x = self._translate_x_from_any(x)\n    cell = self._get_cell2_base(x)\n    if cell is None:\n        return None\n    return cell.get_value()\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_values","title":"<code>get_values(coord=None, cell_type=None, complete=False, get_type=False)</code>","text":"<p>Shortcut to get the cell values in this row.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells. If cell_type is used and complete is True, missing values are replaced by None. If cell_type is None, complete is always True : with no cell type queried, get_values() returns None for each empty cell, the length of the list is equal to the length of the row (depending on coordinates use).</p> <p>If get_type is True, returns a tuple (value, ODF type of value), or (None, None) for empty cells if complete is True.</p> <p>Filter by coordinates will retrieve the amount of cells defined by coordinates with None for empty cells, except when using cell_type.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates in row\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of Python types, or list of tuples.</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_values(\n    self,\n    coord: str | tuple | None = None,\n    cell_type: str | None = None,\n    complete: bool = False,\n    get_type: bool = False,\n) -&gt; list[Any | tuple[Any, Any]]:\n    \"\"\"Shortcut to get the cell values in this row.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n    If cell_type is used and complete is True, missing values are\n    replaced by None.\n    If cell_type is None, complete is always True : with no cell type\n    queried, get_values() returns None for each empty cell, the length\n    of the list is equal to the length of the row (depending on\n    coordinates use).\n\n    If get_type is True, returns a tuple (value, ODF type of value), or\n    (None, None) for empty cells if complete is True.\n\n    Filter by coordinates will retrieve the amount of cells defined by\n    coordinates with None for empty cells, except when using cell_type.\n\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates in row\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of Python types, or list of tuples.\n    \"\"\"\n    if coord:\n        x, z = self._translate_row_coordinates(coord)\n    else:\n        x = None\n        z = None\n    if cell_type:\n        cell_type = cell_type.lower().strip()\n        values: list[Any | tuple[Any, Any]] = []\n        for cell in self.traverse(start=x, end=z):\n            # Filter the cells by cell_type\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                if complete:\n                    if get_type:\n                        values.append((None, None))\n                    else:\n                        values.append(None)\n                continue\n            values.append(cell.get_value(get_type=get_type))\n        return values\n    else:\n        return [\n            cell.get_value(get_type=get_type)\n            for cell in self.traverse(start=x, end=z)\n        ]\n</code></pre>"},{"location":"reference.html#odfdo.Row.insert_cell","title":"<code>insert_cell(x, cell=None, clone=True)</code>","text":"<p>Insert the given cell at position \u201cx\u201d starting from 0. If no cell is given, an empty one is created.</p> <p>Alphabetical positions like \u201cD\u201d are accepted.</p> <p>Do not use when working on a table, use Table.insert_cell().</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncell -- Cell\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/row.py</code> <pre><code>def insert_cell(\n    self,\n    x: int | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Insert the given cell at position \"x\" starting from 0. If no cell\n    is given, an empty one is created.\n\n    Alphabetical positions like \"D\" are accepted.\n\n    Do not use when working on a table, use Table.insert_cell().\n\n    Arguments:\n\n        x -- int or str\n\n        cell -- Cell\n\n    returns the cell with x and y updated\n    \"\"\"\n    cell_back: Cell\n    if cell is None:\n        cell = Cell()\n    x = self._translate_x_from_any(x)\n    # Outside the defined row\n    diff = x - self.width\n    if diff &lt; 0:\n        insert_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\")\n        cell.x = x\n        cell.y = self.y\n        cell_back = cell\n    elif diff == 0:\n        cell_back = self.append_cell(cell, clone=clone)\n    else:\n        self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n        cell_back = self.append_cell(cell, clone=clone)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Row.is_empty","title":"<code>is_empty(aggressive=False)</code>","text":"<p>Return whether every cell in the row has no value or the value evaluates to False (empty string), and no style.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> <p>Return: bool</p> Source code in <code>odfdo/row.py</code> <pre><code>def is_empty(self, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return whether every cell in the row has no value or the value\n    evaluates to False (empty string), and no style.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        aggressive -- bool\n\n    Return: bool\n    \"\"\"\n    return all(cell.is_empty(aggressive=aggressive) for cell in self._get_cells())  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Row.last_cell","title":"<code>last_cell()</code>","text":"<p>Return the las cell of the row.</p> <p>Return Cell | None</p> Source code in <code>odfdo/row.py</code> <pre><code>def last_cell(self) -&gt; Cell | None:\n    \"\"\"Return the las cell of the row.\n\n    Return Cell | None\n    \"\"\"\n    try:\n        return self._get_cells()[-1]  # type: ignore\n    except IndexError:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Row.minimized_width","title":"<code>minimized_width()</code>","text":"<p>Return the length of the row if the last repeated sequence is reduced to one.</p> <p>Return: int</p> Source code in <code>odfdo/row.py</code> <pre><code>def minimized_width(self) -&gt; int:\n    \"\"\"Return the length of the row if the last repeated sequence is\n    reduced to one.\n\n    Return: int\n    \"\"\"\n    idx_repeated_seq = self.elements_repeated_sequence(\n        _xpath_cell, \"table:number-columns-repeated\"\n    )\n    repeated = [item[1] for item in idx_repeated_seq]\n    if repeated:\n        cell = self.last_cell()\n        if cell is not None and cell.is_empty(aggressive=True):\n            repeated[-1] = 1\n        min_width = sum(repeated)\n    else:\n        min_width = 1\n    self._compute_row_cache()\n    self._indexes[\"_rmap\"] = {}\n    return min_width\n</code></pre>"},{"location":"reference.html#odfdo.Row.rstrip","title":"<code>rstrip(aggressive=False)</code>","text":"<p>Remove in-place empty cells at the right of the row. An empty cell has no value but can have style. If \u201caggressive\u201d is True, style is ignored.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def rstrip(self, aggressive: bool = False) -&gt; None:\n    \"\"\"Remove *in-place* empty cells at the right of the row. An empty\n    cell has no value but can have style. If \"aggressive\" is True, style\n    is ignored.\n\n    Arguments:\n\n        aggressive -- bool\n    \"\"\"\n    for cell in reversed(self._get_cells()):\n        if not cell.is_empty(aggressive=aggressive):  # type: ignore\n            break\n        self.delete(cell)\n    self._compute_row_cache()\n    self._indexes[\"_rmap\"] = {}\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_cell","title":"<code>set_cell(x, cell=None, clone=True)</code>","text":"<p>Push the cell back in the row at position \u201cx\u201d starting from 0. Alphabetical positions like \u201cD\u201d are accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/row.py</code> <pre><code>def set_cell(\n    self,\n    x: int | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Push the cell back in the row at position \"x\" starting from 0.\n    Alphabetical positions like \"D\" are accepted.\n\n    Arguments:\n\n        x -- int or str\n\n    returns the cell with x and y updated\n    \"\"\"\n    cell_back: Cell\n    if cell is None:\n        cell = Cell()\n        repeated = 1\n        clone = False\n    else:\n        repeated = cell.repeated or 1\n    x = self._translate_x_from_any(x)\n    # Outside the defined row\n    diff = x - self.width\n    if diff == 0:\n        cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n    elif diff &gt; 0:\n        self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n        cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n    else:\n        # Inside the defined row\n        set_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\", clone=clone)\n        cell.x = x\n        cell.y = self.y\n        cell_back = cell\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_cells","title":"<code>set_cells(cells=None, start=0, clone=True)</code>","text":"<p>Set the cells in the row, from the \u2018start\u2019 column. This method does not clear the row, use row.clear() before to start with an empty row.</p> <p>Arguments:</p> <pre><code>cells -- list of cells\n\nstart -- int or str\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def set_cells(\n    self,\n    cells: list[Cell] | tuple[Cell] | None = None,\n    start: int | str = 0,\n    clone: bool = True,\n) -&gt; None:\n    \"\"\"Set the cells in the row, from the 'start' column.\n    This method does not clear the row, use row.clear() before to start\n    with an empty row.\n\n    Arguments:\n\n        cells -- list of cells\n\n        start -- int or str\n    \"\"\"\n    if cells is None:\n        cells = []\n    if start is None:\n        start = 0\n    else:\n        start = self._translate_x_from_any(start)\n    if start == 0 and clone is False and (len(cells) &gt;= self.width):\n        self.clear()\n        self.extend_cells(cells)\n    else:\n        x = start\n        for cell in cells:\n            self.set_cell(x, cell, clone=clone)\n            if cell:\n                x += cell.repeated or 1\n            else:\n                x += 1\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_value","title":"<code>set_value(x, value, style=None, cell_type=None, currency=None)</code>","text":"<p>Shortcut to set the value of the cell at position \u201cx\u201d.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\nvalue -- Python type\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n         'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> <p>See get_cell() and Cell.get_value().</p> Source code in <code>odfdo/row.py</code> <pre><code>def set_value(\n    self,\n    x: int | str,\n    value: Any,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the value of the cell at position \"x\".\n\n    Arguments:\n\n        x -- int or str\n\n        value -- Python type\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                 'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n\n    See get_cell() and Cell.get_value().\n    \"\"\"\n    self.set_cell(\n        x,\n        Cell(value, style=style, cell_type=cell_type, currency=currency),\n        clone=False,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_values","title":"<code>set_values(values, start=0, style=None, cell_type=None, currency=None)</code>","text":"<p>Shortcut to set the value of cells in the row, from the \u2018start\u2019 column vith values. This method does not clear the row, use row.clear() before to start with an empty row.</p> <p>Arguments:</p> <pre><code>values -- list of Python types\n\nstart -- int or str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency' or 'percentage'\n\ncurrency -- three-letter str\n\nstyle -- cell style\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def set_values(\n    self,\n    values: list[Any],\n    start: int | str = 0,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the value of cells in the row, from the 'start'\n    column vith values.\n    This method does not clear the row, use row.clear() before to start\n    with an empty row.\n\n    Arguments:\n\n        values -- list of Python types\n\n        start -- int or str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency' or 'percentage'\n\n        currency -- three-letter str\n\n        style -- cell style\n    \"\"\"\n    # fixme : if values n, n+ are same, use repeat\n    if start is None:\n        start = 0\n    else:\n        start = self._translate_x_from_any(start)\n    if start == 0 and (len(values) &gt;= self.width):\n        self.clear()\n        cells = [\n            Cell(value, style=style, cell_type=cell_type, currency=currency)\n            for value in values\n        ]\n        self.extend_cells(cells)\n    else:\n        x = start\n        for value in values:\n            self.set_cell(\n                x,\n                Cell(value, style=style, cell_type=cell_type, currency=currency),\n                clone=False,\n            )\n            x += 1\n</code></pre>"},{"location":"reference.html#odfdo.Row.traverse","title":"<code>traverse(start=None, end=None)</code>","text":"<p>Yield as many cell elements as expected cells in the row, i.e. expand repetitions by returning the same cell as many times as necessary.</p> <pre><code>Arguments:\n\n    start -- int\n\n    end -- int\n</code></pre> <p>Copies are returned, use set_cell() to push them back.</p> Source code in <code>odfdo/row.py</code> <pre><code>def traverse(  # noqa: C901\n    self,\n    start: int | None = None,\n    end: int | None = None,\n) -&gt; Iterator[Cell]:\n    \"\"\"Yield as many cell elements as expected cells in the row, i.e.\n    expand repetitions by returning the same cell as many times as\n    necessary.\n\n        Arguments:\n\n            start -- int\n\n            end -- int\n\n    Copies are returned, use set_cell() to push them back.\n    \"\"\"\n    idx = -1\n    before = -1\n    x = 0\n    cell: Cell\n    if start is None and end is None:\n        for juska in self._rmap:\n            idx += 1\n            if idx in self._indexes[\"_rmap\"]:\n                cell = self._indexes[\"_rmap\"][idx]\n            else:\n                cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                if not isinstance(cell, Cell):\n                    raise TypeError(f\"Not a cell: {cell!r}\")\n                self._indexes[\"_rmap\"][idx] = cell\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                # Return a copy without the now obsolete repetition\n                if cell is None:\n                    cell = Cell()\n                else:\n                    cell = cell.clone\n                    if repeated &gt; 1:\n                        cell.repeated = None\n                cell.y = self.y\n                cell.x = x\n                x += 1\n                yield cell\n    else:\n        if start is None:\n            start = 0\n        start = max(0, start)\n        if end is None:\n            try:\n                end = self._rmap[-1]\n            except Exception:\n                end = -1\n        start_map = find_odf_idx(self._rmap, start)\n        if start_map is None:\n            return\n        if start_map &gt; 0:\n            before = self._rmap[start_map - 1]\n        idx = start_map - 1\n        before = start - 1\n        x = start\n        for juska in self._rmap[start_map:]:\n            idx += 1\n            if idx in self._indexes[\"_rmap\"]:\n                cell = self._indexes[\"_rmap\"][idx]\n            else:\n                cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                if not isinstance(cell, Cell):\n                    raise TypeError(f\"Not a cell: {cell!r}\")\n                self._indexes[\"_rmap\"][idx] = cell\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                if x &lt;= end:\n                    if cell is None:\n                        cell = Cell()\n                    else:\n                        cell = cell.clone\n                        if repeated &gt; 1 or (x == start and start &gt; 0):\n                            cell.repeated = None\n                    cell.y = self.y\n                    cell.x = x\n                    x += 1\n                    yield cell\n</code></pre>"},{"location":"reference.html#odfdo.RowGroup","title":"<code>RowGroup</code>","text":"<p>             Bases: <code>Element</code></p> <p>\u201ctable:table-row-group\u201d group rows with common properties.</p> Source code in <code>odfdo/table.py</code> <pre><code>class RowGroup(Element):\n    \"\"\" \"table:table-row-group\" group rows with common properties.\"\"\"\n\n    # TODO\n    _tag = \"table:table-row-group\"\n    _caching = True\n\n    def __init__(\n        self,\n        height: int | None = None,\n        width: int | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a group of rows, optionnaly filled with \"height\" number of\n        rows, of \"width\" cells each.\n\n        Row group bear style information applied to a series of rows.\n\n        Arguments:\n\n            height -- int\n\n            width -- int\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init and height is not None:\n            for _i in range(height):\n                row = Row(width=width)\n                self.append(row)\n</code></pre>"},{"location":"reference.html#odfdo.RowGroup.__init__","title":"<code>__init__(height=None, width=None, **kwargs)</code>","text":"<p>Create a group of rows, optionnaly filled with \u201cheight\u201d number of rows, of \u201cwidth\u201d cells each.</p> <p>Row group bear style information applied to a series of rows.</p> <p>Arguments:</p> <pre><code>height -- int\n\nwidth -- int\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    height: int | None = None,\n    width: int | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a group of rows, optionnaly filled with \"height\" number of\n    rows, of \"width\" cells each.\n\n    Row group bear style information applied to a series of rows.\n\n    Arguments:\n\n        height -- int\n\n        width -- int\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init and height is not None:\n        for _i in range(height):\n            row = Row(width=width)\n            self.append(row)\n</code></pre>"},{"location":"reference.html#odfdo.Section","title":"<code>Section</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF section \u201ctext:section\u201d</p> <p>Arguments:</p> <pre><code>style -- str\n\nname -- str\n</code></pre> Source code in <code>odfdo/section.py</code> <pre><code>class Section(Element):\n    \"\"\"ODF section \"text:section\"\n\n    Arguments:\n\n        style -- str\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:section\"\n    _properties = (\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"name\", \"text:name\"),\n    )\n\n    def __init__(\n        self,\n        style: str | None = None,\n        name: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style:\n                self.style = style\n            if name:\n                self.name = name\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        result = [element.get_formatted_text(context) for element in self.children]\n        result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.Spacer","title":"<code>Spacer</code>","text":"<p>             Bases: <code>Element</code></p> <p>This element shall be used to represent the second and all following \u201c \u201c (U+0020, SPACE) characters in a sequence of \u201c \u201c (U+0020, SPACE) characters. Note: It is not an error if the character preceding the element is not a white space character, but it is good practice to use this element only for the second and all following SPACE characters in a sequence.</p> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>class Spacer(Element):\n    \"\"\"This element shall be used to represent the second and all following \u201c \u201c\n    (U+0020, SPACE) characters in a sequence of \u201c \u201c (U+0020, SPACE) characters.\n    Note: It is not an error if the character preceding the element is not a\n    white space character, but it is good practice to use this element only for\n    the second and all following SPACE characters in a sequence.\n    \"\"\"\n\n    _tag = \"text:s\"\n    _properties: tuple[PropDef, ...] = (PropDef(\"number\", \"text:c\"),)\n\n    def __init__(self, number: int = 1, **kwargs: Any):\n        \"\"\"\n        Arguments:\n\n            number -- int\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.number = str(number)\n</code></pre>"},{"location":"reference.html#odfdo.Spacer.__init__","title":"<code>__init__(number=1, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>number -- int\n</code></pre> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>def __init__(self, number: int = 1, **kwargs: Any):\n    \"\"\"\n    Arguments:\n\n        number -- int\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.number = str(number)\n</code></pre>"},{"location":"reference.html#odfdo.Span","title":"<code>Span</code>","text":"<p>             Bases: <code>Paragraph</code></p> <p>Create a span element \u201ctext:span\u201d of the given style containing the optional given text.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>class Span(Paragraph):\n    \"\"\"Create a span element \"text:span\" of the given style containing the optional\n    given text.\n    \"\"\"\n\n    _tag = \"text:span\"\n    _properties = (\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"class_names\", \"text:class-names\"),\n    )\n\n    def __init__(\n        self,\n        text: str | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            text -- str\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if text:\n                self.text = text\n            if style:\n                self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Span.__init__","title":"<code>__init__(text=None, style=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>text -- str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def __init__(\n    self,\n    text: str | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        text -- str\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if text:\n            self.text = text\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Spreadsheet","title":"<code>Spreadsheet</code>","text":"<p>             Bases: <code>Body</code></p> <p>Spreadsheet, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Spreadsheet(Body):\n    \"\"\"Spreadsheet, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:spreadsheet\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.Style","title":"<code>Style</code>","text":"<p>             Bases: <code>Element</code></p> <p>Style class for all these tags:</p> <p>\u2018style:style\u2019 \u2018number:date-style\u2019, \u2018number:number-style\u2019, \u2018number:percentage-style\u2019, \u2018number:time-style\u2019 \u2018style:font-face\u2019, \u2018style:master-page\u2019, \u2018style:page-layout\u2019, \u2018style:presentation-page-layout\u2019, \u2018text:list-style\u2019, \u2018text:outline-style\u2019, \u2018style:tab-stops\u2019, \u2026</p> Source code in <code>odfdo/style.py</code> <pre><code>class Style(Element):\n    \"\"\"Style class for all these tags:\n\n    'style:style'\n    'number:date-style',\n    'number:number-style',\n    'number:percentage-style',\n    'number:time-style'\n    'style:font-face',\n    'style:master-page',\n    'style:page-layout',\n    'style:presentation-page-layout',\n    'text:list-style',\n    'text:outline-style',\n    'style:tab-stops',\n    ...\n    \"\"\"\n\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"page_layout\", \"style:page-layout-name\", \"master-page\"),\n        PropDef(\"next_style\", \"style:next-style-name\", \"master-page\"),\n        PropDef(\"name\", \"style:name\"),\n        PropDef(\"parent_style\", \"style:parent-style-name\"),\n        PropDef(\"display_name\", \"style:display-name\"),\n        PropDef(\"svg_font_family\", \"svg:font-family\"),\n        PropDef(\"font_family_generic\", \"style:font-family-generic\"),\n        PropDef(\"font_pitch\", \"style:font-pitch\"),\n        PropDef(\"text_style\", \"text:style-name\"),\n        PropDef(\"master_page\", \"style:master-page-name\", \"paragraph\"),\n        PropDef(\"master_page\", \"style:master-page-name\", \"paragraph\"),\n        PropDef(\"master_page\", \"style:master-page-name\", \"paragraph\"),\n        # style:tab-stop\n        PropDef(\"style_type\", \"style:type\"),\n        PropDef(\"leader_style\", \"style:leader-style\"),\n        PropDef(\"leader_text\", \"style:leader-text\"),\n        PropDef(\"style_position\", \"style:position\"),\n        PropDef(\"leader_text\", \"style:position\"),\n    )\n\n    def __init__(  # noqa: C901\n        self,\n        family: str | None = None,\n        name: str | None = None,\n        display_name: str | None = None,\n        parent_style: str | None = None,\n        # Where properties apply\n        area: str | None = None,\n        # For family 'text':\n        color: str | tuple | None = None,\n        background_color: str | tuple | None = None,\n        italic: bool = False,\n        bold: bool = False,\n        # For family 'paragraph'\n        master_page: str | None = None,\n        # For family 'master-page'\n        page_layout: str | None = None,\n        next_style: str | None = None,\n        # For family 'table-cell'\n        data_style: str | None = None,  # unused\n        border: str | None = None,\n        border_top: str | None = None,\n        border_right: str | None = None,\n        border_bottom: str | None = None,\n        border_left: str | None = None,\n        padding: str | None = None,\n        padding_top: str | None = None,\n        padding_bottom: str | None = None,\n        padding_left: str | None = None,\n        padding_right: str | None = None,\n        shadow: str | None = None,\n        # For family 'table-row'\n        height: str | None = None,\n        use_optimal_height: bool = False,\n        # For family 'table-column'\n        width: str | None = None,\n        break_before: str | None = None,\n        break_after: str | None = None,\n        # For family 'graphic'\n        min_height: str | None = None,\n        # For family 'font-face'\n        font_name: str | None = None,\n        font_family: str | None = None,\n        font_family_generic: str | None = None,\n        font_pitch: str = \"variable\",\n        # Every other property\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a style of the given family. The name is not mandatory at this\n        point but will become required when inserting in a document as a common\n        style.\n\n        The display name is the name the user sees in an office application.\n\n        The parent_style is the name of the style this style will inherit from.\n\n        To set properties, pass them as keyword arguments. The area properties\n        apply to is optional and defaults to the family.\n\n        Arguments:\n\n            family -- 'paragraph', 'text', 'section', 'table', 'table-column',\n                      'table-row', 'table-cell', 'table-page', 'chart',\n                      'drawing-page', 'graphic', 'presentation',\n                      'control', 'ruby', 'list', 'number', 'page-layout'\n                      'font-face', or 'master-page'\n\n            name -- str\n\n            display_name -- str\n\n            parent_style -- str\n\n            area -- str\n\n        'text' Properties:\n\n            italic -- bool\n\n            bold -- bool\n\n        'paragraph' Properties:\n\n            master_page -- str\n\n        'master-page' Properties:\n\n            page_layout -- str\n\n            next_style -- str\n\n        'table-cell' Properties:\n\n            border, border_top, border_right, border_bottom, border_left -- str,\n            e.g. \"0.002cm solid #000000\" or 'none'\n\n            padding, padding_top, padding_right, padding_bottom, padding_left -- str,\n            e.g. \"0.002cm\" or 'none'\n\n            shadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\n        'table-row' Properties:\n\n            height -- str, e.g. '5cm'\n\n            use_optimal_height -- bool\n\n        'table-column' Properties:\n\n            width -- str, e.g. '5cm'\n\n            break_before -- 'page', 'column' or 'auto'\n\n            break_after -- 'page', 'column' or 'auto'\n        \"\"\"\n        self._family: str | None = None\n        tag_or_elem = kwargs.get(\"tag_or_elem\", None)\n        if tag_or_elem is None:\n            family = to_str(family)\n            if family not in FAMILY_MAPPING:\n                raise ValueError(f\"Unknown family value: '{family}'\")\n            kwargs[\"tag\"] = FAMILY_MAPPING[family]\n        super().__init__(**kwargs)\n        if self._do_init and family not in SUBCLASSED_STYLES:\n            kwargs.pop(\"tag\", None)\n            kwargs.pop(\"tag_or_elem\", None)\n            self.family = family  # relevant test made by property\n            # Common attributes\n            if name:\n                self.name = name\n            if display_name:\n                self.display_name = display_name\n            if parent_style:\n                self.parent_style = parent_style\n            # Paragraph\n            if family == \"paragraph\":\n                if master_page:\n                    self.master_page = master_page\n            # Master Page\n            elif family == \"master-page\":\n                if page_layout:\n                    self.page_layout = page_layout\n                if next_style:\n                    self.next_style = next_style\n            # Font face\n            elif family == \"font-face\":\n                if not font_name:\n                    raise ValueError(\"A font_name is required for 'font-face' style\")\n                self.set_font(\n                    font_name,\n                    family=font_family,\n                    family_generic=font_family_generic,\n                    pitch=font_pitch,\n                )\n            # Properties\n            if area is None:\n                area = family\n            area = to_str(area)\n            # Text\n            if area == \"text\":\n                if color:\n                    kwargs[\"fo:color\"] = color\n                if background_color:\n                    kwargs[\"fo:background-color\"] = background_color\n                if italic:\n                    kwargs[\"fo:font-style\"] = \"italic\"\n                    kwargs[\"style:font-style-asian\"] = \"italic\"\n                    kwargs[\"style:font-style-complex\"] = \"italic\"\n                if bold:\n                    kwargs[\"fo:font-weight\"] = \"bold\"\n                    kwargs[\"style:font-weight-asian\"] = \"bold\"\n                    kwargs[\"style:font-weight-complex\"] = \"bold\"\n            # Table cell\n            elif area == \"table-cell\":\n                if border:\n                    kwargs[\"fo:border\"] = border\n                elif border_top or border_right or border_bottom or border_left:\n                    kwargs[\"fo:border-top\"] = border_top or \"none\"\n                    kwargs[\"fo:border-right\"] = border_right or \"none\"\n                    kwargs[\"fo:border-bottom\"] = border_bottom or \"none\"\n                    kwargs[\"fo:border-left\"] = border_left or \"none\"\n                else:  # no border_top, ... neither border are defined\n                    pass  # left untouched\n                if padding:\n                    kwargs[\"fo:padding\"] = padding\n                elif padding_top or padding_right or padding_bottom or padding_left:\n                    kwargs[\"fo:padding-top\"] = padding_top or \"none\"\n                    kwargs[\"fo:padding-right\"] = padding_right or \"none\"\n                    kwargs[\"fo:padding-bottom\"] = padding_bottom or \"none\"\n                    kwargs[\"fo:padding-left\"] = padding_left or \"none\"\n                else:  # no border_top, ... neither border are defined\n                    pass  # left untouched\n                if shadow:\n                    kwargs[\"style:shadow\"] = shadow\n                if background_color:\n                    kwargs[\"fo:background-color\"] = background_color\n            # Table row\n            elif area == \"table-row\":\n                if height:\n                    kwargs[\"style:row-height\"] = height\n                if use_optimal_height:\n                    kwargs[\"style:use-optimal-row-height\"] = Boolean.encode(\n                        use_optimal_height\n                    )\n                if background_color:\n                    kwargs[\"fo:background-color\"] = background_color\n            # Table column\n            elif area == \"table-column\":\n                if width:\n                    kwargs[\"style:column-width\"] = width\n                if break_before:\n                    kwargs[\"fo:break-before\"] = break_before\n                if break_after:\n                    kwargs[\"fo:break-after\"] = break_after\n            # Graphic\n            elif area == \"graphic\":\n                if min_height:\n                    kwargs[\"fo:min-height\"] = min_height\n            # Every other properties\n            if kwargs:\n                self.set_properties(kwargs, area=area)\n\n    @property\n    def family(self) -&gt; str | None:\n        if self._family is None:\n            self._family = FALSE_FAMILY_MAP_REVERSE.get(\n                self.tag, self.get_attribute_string(\"style:family\")\n            )\n        return self._family\n\n    @family.setter\n    def family(self, family: str | None) -&gt; None:\n        self._family = family\n        if family in FAMILY_ODF_STD and self.tag == \"style:style\":\n            self.set_attribute(\"style:family\", family)\n\n    def get_properties(self, area: str | None = None) -&gt; dict[str, str | dict] | None:\n        \"\"\"Get the mapping of all properties of this style. By default the\n        properties of the same family, e.g. a paragraph style and its\n        paragraph properties. Specify the area to get the text properties of\n        a paragraph style for example.\n\n        Arguments:\n\n            area -- str\n\n        Return: dict\n        \"\"\"\n        if area is None:\n            area = self.family\n        element = self.get_element(f\"style:{area}-properties\")\n        if element is None:\n            return None\n        properties: dict[str, str | dict] = element.attributes  # type: ignore\n        # Nested properties are nested dictionaries\n        for child in element.children:\n            properties[child.tag] = child.attributes\n        return properties\n\n    def set_properties(  # noqa: C901\n        self,\n        properties: dict[str, str | dict] | None = None,\n        style: Style | None = None,\n        area: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Set the properties of the \"area\" type of this style. Properties\n        are given either as a dict or as named arguments (or both). The area\n        is identical to the style family by default. If the properties\n        element is missing, it is created.\n\n        Instead of properties, you can pass a style with properties of the\n        same area. These will be copied.\n\n        Arguments:\n\n            properties -- dict\n\n            style -- Style\n\n            area -- 'paragraph', 'text'...\n        \"\"\"\n        if properties is None:\n            properties = {}\n        if area is None:\n            if isinstance(self.family, bool):\n                area = None\n            else:\n                area = self.family\n        element = self.get_element(f\"style:{area}-properties\")\n        if element is None:\n            element = Element.from_tag(f\"style:{area}-properties\")\n            self.append(element)\n        if properties or kwargs:\n            properties = _expand_properties_dict(_merge_dicts(properties, kwargs))\n        elif style is not None:\n            properties = style.get_properties(area=area)\n            if properties is None:\n                return\n        if properties is None:\n            return\n        for key, value in properties.items():\n            if value is None:\n                element.del_attribute(key)\n            elif isinstance(value, (str, bool, tuple)):\n                element.set_attribute(key, value)\n            else:\n                pass\n\n    def del_properties(\n        self,\n        properties: list[str] | None = None,\n        area: str | None = None,\n    ) -&gt; None:\n        \"\"\"Delete the given properties, either by list argument or\n        positional argument (or both). Remove only from the given area,\n        identical to the style family by default.\n\n        Arguments:\n\n            properties -- list\n\n            area -- str\n        \"\"\"\n        if properties is None:\n            properties = []\n        if area is None:\n            area = self.family\n        element = self.get_element(f\"style:{area}-properties\")\n        if element is None:\n            raise ValueError(\n                f\"properties element is inexistent for: style:{area}-properties\"\n            )\n        for key in _expand_properties_list(properties):\n            element.del_attribute(key)\n\n    def set_background(  # noqa: C901\n        self,\n        color: str | None = None,\n        url: str | None = None,\n        position: str | None = \"center\",\n        repeat: str | None = None,\n        opacity: str | None = None,\n        filter: str | None = None,  # noqa: A002\n    ) -&gt; None:\n        \"\"\"Set the background color of a text style, or the background color\n        or image of a paragraph style or page layout.\n\n        With no argument, remove any existing background.\n\n        The position is one or two of 'center', 'left', 'right', 'top' or\n        'bottom'.\n\n        The repeat is 'no-repeat', 'repeat' or 'stretch'.\n\n        The opacity is a percentage integer (not a string with the '%s' sign)\n\n        The filter is an application-specific filter name defined elsewhere.\n\n        Though this method is defined on the base style class, it will raise\n        an error if the style type is not compatible.\n\n        Arguments:\n\n            color -- '#rrggbb'\n\n            url -- str\n\n            position -- str\n\n            repeat -- str\n\n            opacity -- int\n\n            filter -- str\n        \"\"\"\n        family = self.family\n        if family not in {\n            \"text\",\n            \"paragraph\",\n            \"page-layout\",\n            \"section\",\n            \"table\",\n            \"table-row\",\n            \"table-cell\",\n            \"graphic\",\n        }:\n            raise TypeError(\"No background support for this family\")\n        if url is not None and family == \"text\":\n            raise TypeError(\"No background image for text styles\")\n        properties = self.get_element(f\"style:{family}-properties\")\n        bg_image: BackgroundImage | None = None\n        if properties is not None:\n            bg_image = properties.get_element(\"style:background-image\")  # type:ignore\n        # Erasing\n        if color is None and url is None:\n            if properties is None:\n                return\n            properties.del_attribute(\"fo:background-color\")\n            if bg_image is not None:\n                properties.delete(bg_image)\n            return\n        # Add the properties if necessary\n        if properties is None:\n            properties = Element.from_tag(f\"style:{family}-properties\")\n            self.append(properties)\n        # Add the color...\n        if color:\n            properties.set_attribute(\"fo:background-color\", color)\n            if bg_image is not None:\n                properties.delete(bg_image)\n        # ... or the background\n        elif url:\n            properties.set_attribute(\"fo:background-color\", \"transparent\")\n            if bg_image is None:\n                bg_image = Element.from_tag(\"style:background-image\")  # type:ignore\n                properties.append(bg_image)  # type:ignore\n            bg_image.url = url  # type:ignore\n            if position:\n                bg_image.position = position  # type:ignore\n            if repeat:\n                bg_image.repeat = repeat  # type:ignore\n            if opacity:\n                bg_image.opacity = opacity  # type:ignore\n            if filter:\n                bg_image.filter = filter  # type:ignore\n\n    # list-style only:\n\n    def get_level_style(self, level: int) -&gt; Style | None:\n        if self.family != \"list\":\n            return None\n        level_styles = (\n            \"(text:list-level-style-number\"\n            \"|text:list-level-style-bullet\"\n            \"|text:list-level-style-image)\"\n        )\n        return self._filtered_element(level_styles, 0, level=level)  # type: ignore\n\n    def set_level_style(  # noqa: C901\n        self,\n        level: int,\n        num_format: str | None = None,\n        bullet_char: str | None = None,\n        url: str | None = None,\n        display_levels: int | None = None,\n        prefix: str | None = None,\n        suffix: str | None = None,\n        start_value: int | None = None,\n        style: str | None = None,\n        clone: Style | None = None,\n    ) -&gt; Style | None:\n        \"\"\"\n        Arguments:\n\n            level -- int\n\n            num_format (for number) -- int\n\n            bullet_char (for bullet) -- str\n\n            url (for image) -- str\n\n            display_levels -- int\n\n            prefix -- str\n\n            suffix -- str\n\n            start_value -- int\n\n            style -- str\n\n            clone -- List Style\n\n        Return:\n            level_style created\n        \"\"\"\n        if self.family != \"list\":\n            return None\n        # Expected name\n        if num_format is not None:\n            level_style_name = \"text:list-level-style-number\"\n        elif bullet_char is not None:\n            level_style_name = \"text:list-level-style-bullet\"\n        elif url is not None:\n            level_style_name = \"text:list-level-style-image\"\n        elif clone is not None:\n            level_style_name = clone.tag\n        else:\n            raise ValueError(\"unknown level style type\")\n        was_created = False\n        # Cloning or reusing an existing element\n        level_style: Style | None = None\n        if clone is not None:\n            level_style = clone.clone  # type: ignore\n            was_created = True\n        else:\n            level_style = self.get_level_style(level)\n            if level_style is None:\n                level_style = Element.from_tag(level_style_name)  # type: ignore\n                was_created = True\n        if level_style is None:\n            return None\n        # Transmute if the type changed\n        if level_style.tag != level_style_name:\n            print(\"Warn: different style\", level_style_name, level_style.tag)\n            level_style.tag = level_style_name\n        # Set the level\n        level_style.set_attribute(\"text:level\", str(level))\n        # Set the main attribute\n        if num_format is not None:\n            level_style.set_attribute(\"fo:num-format\", num_format)\n        elif bullet_char is not None:\n            level_style.set_attribute(\"text:bullet-char\", bullet_char)\n        elif url is not None:\n            level_style.set_attribute(\"xlink:href\", url)\n        # Set attributes\n        if prefix:\n            level_style.set_attribute(\"style:num-prefix\", prefix)\n        if suffix:\n            level_style.set_attribute(\"style:num-suffix\", suffix)\n        if display_levels:\n            level_style.set_attribute(\"text:display-levels\", str(display_levels))\n        if start_value:\n            level_style.set_attribute(\"text:start-value\", str(start_value))\n        if style:\n            level_style.text_style = style  # type: ignore\n        # Commit the creation\n        if was_created:\n            self.append(level_style)\n        return level_style\n\n    # page-layout only:\n\n    def get_header_style(self) -&gt; Element | None:\n        if self.family != \"page-layout\":\n            return None\n        return self.get_element(\"style:header-style\")\n\n    def set_header_style(self, new_style: Style) -&gt; None:\n        if self.family != \"page-layout\":\n            return\n        header_style = self.get_header_style()\n        if header_style is not None:\n            self.delete(header_style)\n        self.append(new_style)\n\n    def get_footer_style(self) -&gt; Style | None:\n        if self.family != \"page-layout\":\n            return None\n        return self.get_element(\"style:footer-style\")  # type: ignore\n\n    def set_footer_style(self, new_style: Style) -&gt; None:\n        if self.family != \"page-layout\":\n            return\n        footer_style = self.get_footer_style()\n        if footer_style is not None:\n            self.delete(footer_style)\n        self.append(new_style)\n\n    # master-page only:\n\n    def _set_header_or_footer(\n        self,\n        text_or_element: str | Element | list[Element | str],\n        name: str = \"header\",\n        style: str = \"Header\",\n    ) -&gt; None:\n        if name == \"header\":\n            header_or_footer = self.get_page_header()\n        else:\n            header_or_footer = self.get_page_footer()\n        if header_or_footer is None:\n            header_or_footer = Element.from_tag(\"style:\" + name)\n            self.append(header_or_footer)\n        else:\n            header_or_footer.clear()\n        if (\n            isinstance(text_or_element, Element)\n            and text_or_element.tag == f\"style:{name}\"\n        ):\n            # Already a header or footer?\n            self.delete(header_or_footer)\n            self.append(text_or_element)\n            return\n        if isinstance(text_or_element, (Element, str)):\n            elem_list: list[Element | str] = [text_or_element]\n        else:\n            elem_list = text_or_element\n        for item in elem_list:\n            if isinstance(item, str):\n                paragraph = Element.from_tag(\"text:p\")\n                paragraph.style = style  # type: ignore\n                header_or_footer.append(paragraph)\n            elif isinstance(item, Element):\n                header_or_footer.append(item)\n\n    def get_page_header(self) -&gt; Element | None:\n        \"\"\"Get the element that contains the header contents.\n\n        If None, no header was set.\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        return self.get_element(\"style:header\")\n\n    def set_page_header(\n        self,\n        text_or_element: str | Element | list[Element | str],\n    ) -&gt; None:\n        \"\"\"Create or replace the header by the given content. It can already\n        be a complete header.\n\n        If you only want to update the existing header, get it and use the\n        API.\n\n        Arguments:\n\n            text_or_element -- str or Element or a list of them\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        self._set_header_or_footer(text_or_element)\n\n    def get_page_footer(self) -&gt; Element | None:\n        \"\"\"Get the element that contains the footer contents.\n\n        If None, no footer was set.\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        return self.get_element(\"style:footer\")\n\n    def set_page_footer(\n        self,\n        text_or_element: str | Element | list[Element | str],\n    ) -&gt; None:\n        \"\"\"Create or replace the footer by the given content. It can already\n        be a complete footer.\n\n        If you only want to update the existing footer, get it and use the\n        API.\n\n        Arguments:\n\n            text_or_element -- str or Element or a list of them\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        self._set_header_or_footer(text_or_element, name=\"footer\", style=\"Footer\")\n\n    # font-face only:\n\n    def set_font(\n        self,\n        name: str,\n        family: str | None = None,\n        family_generic: str | None = None,\n        pitch: str = \"variable\",\n    ) -&gt; None:\n        if self.family != \"font-face\":\n            return\n        self.name = name\n        if family is None:\n            family = name\n        self.svg_font_family = f'\"{family}\"'\n        if family_generic is not None:\n            self.font_family_generic = family_generic\n        self.font_pitch = pitch\n</code></pre>"},{"location":"reference.html#odfdo.Style.__init__","title":"<code>__init__(family=None, name=None, display_name=None, parent_style=None, area=None, color=None, background_color=None, italic=False, bold=False, master_page=None, page_layout=None, next_style=None, data_style=None, border=None, border_top=None, border_right=None, border_bottom=None, border_left=None, padding=None, padding_top=None, padding_bottom=None, padding_left=None, padding_right=None, shadow=None, height=None, use_optimal_height=False, width=None, break_before=None, break_after=None, min_height=None, font_name=None, font_family=None, font_family_generic=None, font_pitch='variable', **kwargs)</code>","text":"<p>Create a style of the given family. The name is not mandatory at this point but will become required when inserting in a document as a common style.</p> <p>The display name is the name the user sees in an office application.</p> <p>The parent_style is the name of the style this style will inherit from.</p> <p>To set properties, pass them as keyword arguments. The area properties apply to is optional and defaults to the family.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text', 'section', 'table', 'table-column',\n          'table-row', 'table-cell', 'table-page', 'chart',\n          'drawing-page', 'graphic', 'presentation',\n          'control', 'ruby', 'list', 'number', 'page-layout'\n          'font-face', or 'master-page'\n\nname -- str\n\ndisplay_name -- str\n\nparent_style -- str\n\narea -- str\n</code></pre> <p>\u2018text\u2019 Properties:</p> <pre><code>italic -- bool\n\nbold -- bool\n</code></pre> <p>\u2018paragraph\u2019 Properties:</p> <pre><code>master_page -- str\n</code></pre> <p>\u2018master-page\u2019 Properties:</p> <pre><code>page_layout -- str\n\nnext_style -- str\n</code></pre> <p>\u2018table-cell\u2019 Properties:</p> <pre><code>border, border_top, border_right, border_bottom, border_left -- str,\ne.g. \"0.002cm solid #000000\" or 'none'\n\npadding, padding_top, padding_right, padding_bottom, padding_left -- str,\ne.g. \"0.002cm\" or 'none'\n\nshadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n</code></pre> <p>\u2018table-row\u2019 Properties:</p> <pre><code>height -- str, e.g. '5cm'\n\nuse_optimal_height -- bool\n</code></pre> <p>\u2018table-column\u2019 Properties:</p> <pre><code>width -- str, e.g. '5cm'\n\nbreak_before -- 'page', 'column' or 'auto'\n\nbreak_after -- 'page', 'column' or 'auto'\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def __init__(  # noqa: C901\n    self,\n    family: str | None = None,\n    name: str | None = None,\n    display_name: str | None = None,\n    parent_style: str | None = None,\n    # Where properties apply\n    area: str | None = None,\n    # For family 'text':\n    color: str | tuple | None = None,\n    background_color: str | tuple | None = None,\n    italic: bool = False,\n    bold: bool = False,\n    # For family 'paragraph'\n    master_page: str | None = None,\n    # For family 'master-page'\n    page_layout: str | None = None,\n    next_style: str | None = None,\n    # For family 'table-cell'\n    data_style: str | None = None,  # unused\n    border: str | None = None,\n    border_top: str | None = None,\n    border_right: str | None = None,\n    border_bottom: str | None = None,\n    border_left: str | None = None,\n    padding: str | None = None,\n    padding_top: str | None = None,\n    padding_bottom: str | None = None,\n    padding_left: str | None = None,\n    padding_right: str | None = None,\n    shadow: str | None = None,\n    # For family 'table-row'\n    height: str | None = None,\n    use_optimal_height: bool = False,\n    # For family 'table-column'\n    width: str | None = None,\n    break_before: str | None = None,\n    break_after: str | None = None,\n    # For family 'graphic'\n    min_height: str | None = None,\n    # For family 'font-face'\n    font_name: str | None = None,\n    font_family: str | None = None,\n    font_family_generic: str | None = None,\n    font_pitch: str = \"variable\",\n    # Every other property\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a style of the given family. The name is not mandatory at this\n    point but will become required when inserting in a document as a common\n    style.\n\n    The display name is the name the user sees in an office application.\n\n    The parent_style is the name of the style this style will inherit from.\n\n    To set properties, pass them as keyword arguments. The area properties\n    apply to is optional and defaults to the family.\n\n    Arguments:\n\n        family -- 'paragraph', 'text', 'section', 'table', 'table-column',\n                  'table-row', 'table-cell', 'table-page', 'chart',\n                  'drawing-page', 'graphic', 'presentation',\n                  'control', 'ruby', 'list', 'number', 'page-layout'\n                  'font-face', or 'master-page'\n\n        name -- str\n\n        display_name -- str\n\n        parent_style -- str\n\n        area -- str\n\n    'text' Properties:\n\n        italic -- bool\n\n        bold -- bool\n\n    'paragraph' Properties:\n\n        master_page -- str\n\n    'master-page' Properties:\n\n        page_layout -- str\n\n        next_style -- str\n\n    'table-cell' Properties:\n\n        border, border_top, border_right, border_bottom, border_left -- str,\n        e.g. \"0.002cm solid #000000\" or 'none'\n\n        padding, padding_top, padding_right, padding_bottom, padding_left -- str,\n        e.g. \"0.002cm\" or 'none'\n\n        shadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\n    'table-row' Properties:\n\n        height -- str, e.g. '5cm'\n\n        use_optimal_height -- bool\n\n    'table-column' Properties:\n\n        width -- str, e.g. '5cm'\n\n        break_before -- 'page', 'column' or 'auto'\n\n        break_after -- 'page', 'column' or 'auto'\n    \"\"\"\n    self._family: str | None = None\n    tag_or_elem = kwargs.get(\"tag_or_elem\", None)\n    if tag_or_elem is None:\n        family = to_str(family)\n        if family not in FAMILY_MAPPING:\n            raise ValueError(f\"Unknown family value: '{family}'\")\n        kwargs[\"tag\"] = FAMILY_MAPPING[family]\n    super().__init__(**kwargs)\n    if self._do_init and family not in SUBCLASSED_STYLES:\n        kwargs.pop(\"tag\", None)\n        kwargs.pop(\"tag_or_elem\", None)\n        self.family = family  # relevant test made by property\n        # Common attributes\n        if name:\n            self.name = name\n        if display_name:\n            self.display_name = display_name\n        if parent_style:\n            self.parent_style = parent_style\n        # Paragraph\n        if family == \"paragraph\":\n            if master_page:\n                self.master_page = master_page\n        # Master Page\n        elif family == \"master-page\":\n            if page_layout:\n                self.page_layout = page_layout\n            if next_style:\n                self.next_style = next_style\n        # Font face\n        elif family == \"font-face\":\n            if not font_name:\n                raise ValueError(\"A font_name is required for 'font-face' style\")\n            self.set_font(\n                font_name,\n                family=font_family,\n                family_generic=font_family_generic,\n                pitch=font_pitch,\n            )\n        # Properties\n        if area is None:\n            area = family\n        area = to_str(area)\n        # Text\n        if area == \"text\":\n            if color:\n                kwargs[\"fo:color\"] = color\n            if background_color:\n                kwargs[\"fo:background-color\"] = background_color\n            if italic:\n                kwargs[\"fo:font-style\"] = \"italic\"\n                kwargs[\"style:font-style-asian\"] = \"italic\"\n                kwargs[\"style:font-style-complex\"] = \"italic\"\n            if bold:\n                kwargs[\"fo:font-weight\"] = \"bold\"\n                kwargs[\"style:font-weight-asian\"] = \"bold\"\n                kwargs[\"style:font-weight-complex\"] = \"bold\"\n        # Table cell\n        elif area == \"table-cell\":\n            if border:\n                kwargs[\"fo:border\"] = border\n            elif border_top or border_right or border_bottom or border_left:\n                kwargs[\"fo:border-top\"] = border_top or \"none\"\n                kwargs[\"fo:border-right\"] = border_right or \"none\"\n                kwargs[\"fo:border-bottom\"] = border_bottom or \"none\"\n                kwargs[\"fo:border-left\"] = border_left or \"none\"\n            else:  # no border_top, ... neither border are defined\n                pass  # left untouched\n            if padding:\n                kwargs[\"fo:padding\"] = padding\n            elif padding_top or padding_right or padding_bottom or padding_left:\n                kwargs[\"fo:padding-top\"] = padding_top or \"none\"\n                kwargs[\"fo:padding-right\"] = padding_right or \"none\"\n                kwargs[\"fo:padding-bottom\"] = padding_bottom or \"none\"\n                kwargs[\"fo:padding-left\"] = padding_left or \"none\"\n            else:  # no border_top, ... neither border are defined\n                pass  # left untouched\n            if shadow:\n                kwargs[\"style:shadow\"] = shadow\n            if background_color:\n                kwargs[\"fo:background-color\"] = background_color\n        # Table row\n        elif area == \"table-row\":\n            if height:\n                kwargs[\"style:row-height\"] = height\n            if use_optimal_height:\n                kwargs[\"style:use-optimal-row-height\"] = Boolean.encode(\n                    use_optimal_height\n                )\n            if background_color:\n                kwargs[\"fo:background-color\"] = background_color\n        # Table column\n        elif area == \"table-column\":\n            if width:\n                kwargs[\"style:column-width\"] = width\n            if break_before:\n                kwargs[\"fo:break-before\"] = break_before\n            if break_after:\n                kwargs[\"fo:break-after\"] = break_after\n        # Graphic\n        elif area == \"graphic\":\n            if min_height:\n                kwargs[\"fo:min-height\"] = min_height\n        # Every other properties\n        if kwargs:\n            self.set_properties(kwargs, area=area)\n</code></pre>"},{"location":"reference.html#odfdo.Style.del_properties","title":"<code>del_properties(properties=None, area=None)</code>","text":"<p>Delete the given properties, either by list argument or positional argument (or both). Remove only from the given area, identical to the style family by default.</p> <p>Arguments:</p> <pre><code>properties -- list\n\narea -- str\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def del_properties(\n    self,\n    properties: list[str] | None = None,\n    area: str | None = None,\n) -&gt; None:\n    \"\"\"Delete the given properties, either by list argument or\n    positional argument (or both). Remove only from the given area,\n    identical to the style family by default.\n\n    Arguments:\n\n        properties -- list\n\n        area -- str\n    \"\"\"\n    if properties is None:\n        properties = []\n    if area is None:\n        area = self.family\n    element = self.get_element(f\"style:{area}-properties\")\n    if element is None:\n        raise ValueError(\n            f\"properties element is inexistent for: style:{area}-properties\"\n        )\n    for key in _expand_properties_list(properties):\n        element.del_attribute(key)\n</code></pre>"},{"location":"reference.html#odfdo.Style.get_page_footer","title":"<code>get_page_footer()</code>","text":"<p>Get the element that contains the footer contents.</p> <p>If None, no footer was set.</p> Source code in <code>odfdo/style.py</code> <pre><code>def get_page_footer(self) -&gt; Element | None:\n    \"\"\"Get the element that contains the footer contents.\n\n    If None, no footer was set.\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    return self.get_element(\"style:footer\")\n</code></pre>"},{"location":"reference.html#odfdo.Style.get_page_header","title":"<code>get_page_header()</code>","text":"<p>Get the element that contains the header contents.</p> <p>If None, no header was set.</p> Source code in <code>odfdo/style.py</code> <pre><code>def get_page_header(self) -&gt; Element | None:\n    \"\"\"Get the element that contains the header contents.\n\n    If None, no header was set.\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    return self.get_element(\"style:header\")\n</code></pre>"},{"location":"reference.html#odfdo.Style.get_properties","title":"<code>get_properties(area=None)</code>","text":"<p>Get the mapping of all properties of this style. By default the properties of the same family, e.g. a paragraph style and its paragraph properties. Specify the area to get the text properties of a paragraph style for example.</p> <p>Arguments:</p> <pre><code>area -- str\n</code></pre> <p>Return: dict</p> Source code in <code>odfdo/style.py</code> <pre><code>def get_properties(self, area: str | None = None) -&gt; dict[str, str | dict] | None:\n    \"\"\"Get the mapping of all properties of this style. By default the\n    properties of the same family, e.g. a paragraph style and its\n    paragraph properties. Specify the area to get the text properties of\n    a paragraph style for example.\n\n    Arguments:\n\n        area -- str\n\n    Return: dict\n    \"\"\"\n    if area is None:\n        area = self.family\n    element = self.get_element(f\"style:{area}-properties\")\n    if element is None:\n        return None\n    properties: dict[str, str | dict] = element.attributes  # type: ignore\n    # Nested properties are nested dictionaries\n    for child in element.children:\n        properties[child.tag] = child.attributes\n    return properties\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_background","title":"<code>set_background(color=None, url=None, position='center', repeat=None, opacity=None, filter=None)</code>","text":"<p>Set the background color of a text style, or the background color or image of a paragraph style or page layout.</p> <p>With no argument, remove any existing background.</p> <p>The position is one or two of \u2018center\u2019, \u2018left\u2019, \u2018right\u2019, \u2018top\u2019 or \u2018bottom\u2019.</p> <p>The repeat is \u2018no-repeat\u2019, \u2018repeat\u2019 or \u2018stretch\u2019.</p> <p>The opacity is a percentage integer (not a string with the \u2018%s\u2019 sign)</p> <p>The filter is an application-specific filter name defined elsewhere.</p> <p>Though this method is defined on the base style class, it will raise an error if the style type is not compatible.</p> <p>Arguments:</p> <pre><code>color -- '#rrggbb'\n\nurl -- str\n\nposition -- str\n\nrepeat -- str\n\nopacity -- int\n\nfilter -- str\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_background(  # noqa: C901\n    self,\n    color: str | None = None,\n    url: str | None = None,\n    position: str | None = \"center\",\n    repeat: str | None = None,\n    opacity: str | None = None,\n    filter: str | None = None,  # noqa: A002\n) -&gt; None:\n    \"\"\"Set the background color of a text style, or the background color\n    or image of a paragraph style or page layout.\n\n    With no argument, remove any existing background.\n\n    The position is one or two of 'center', 'left', 'right', 'top' or\n    'bottom'.\n\n    The repeat is 'no-repeat', 'repeat' or 'stretch'.\n\n    The opacity is a percentage integer (not a string with the '%s' sign)\n\n    The filter is an application-specific filter name defined elsewhere.\n\n    Though this method is defined on the base style class, it will raise\n    an error if the style type is not compatible.\n\n    Arguments:\n\n        color -- '#rrggbb'\n\n        url -- str\n\n        position -- str\n\n        repeat -- str\n\n        opacity -- int\n\n        filter -- str\n    \"\"\"\n    family = self.family\n    if family not in {\n        \"text\",\n        \"paragraph\",\n        \"page-layout\",\n        \"section\",\n        \"table\",\n        \"table-row\",\n        \"table-cell\",\n        \"graphic\",\n    }:\n        raise TypeError(\"No background support for this family\")\n    if url is not None and family == \"text\":\n        raise TypeError(\"No background image for text styles\")\n    properties = self.get_element(f\"style:{family}-properties\")\n    bg_image: BackgroundImage | None = None\n    if properties is not None:\n        bg_image = properties.get_element(\"style:background-image\")  # type:ignore\n    # Erasing\n    if color is None and url is None:\n        if properties is None:\n            return\n        properties.del_attribute(\"fo:background-color\")\n        if bg_image is not None:\n            properties.delete(bg_image)\n        return\n    # Add the properties if necessary\n    if properties is None:\n        properties = Element.from_tag(f\"style:{family}-properties\")\n        self.append(properties)\n    # Add the color...\n    if color:\n        properties.set_attribute(\"fo:background-color\", color)\n        if bg_image is not None:\n            properties.delete(bg_image)\n    # ... or the background\n    elif url:\n        properties.set_attribute(\"fo:background-color\", \"transparent\")\n        if bg_image is None:\n            bg_image = Element.from_tag(\"style:background-image\")  # type:ignore\n            properties.append(bg_image)  # type:ignore\n        bg_image.url = url  # type:ignore\n        if position:\n            bg_image.position = position  # type:ignore\n        if repeat:\n            bg_image.repeat = repeat  # type:ignore\n        if opacity:\n            bg_image.opacity = opacity  # type:ignore\n        if filter:\n            bg_image.filter = filter  # type:ignore\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_level_style","title":"<code>set_level_style(level, num_format=None, bullet_char=None, url=None, display_levels=None, prefix=None, suffix=None, start_value=None, style=None, clone=None)</code>","text":"<p>Arguments:</p> <pre><code>level -- int\n\nnum_format (for number) -- int\n\nbullet_char (for bullet) -- str\n\nurl (for image) -- str\n\ndisplay_levels -- int\n\nprefix -- str\n\nsuffix -- str\n\nstart_value -- int\n\nstyle -- str\n\nclone -- List Style\n</code></pre> Return <p>level_style created</p> Source code in <code>odfdo/style.py</code> <pre><code>def set_level_style(  # noqa: C901\n    self,\n    level: int,\n    num_format: str | None = None,\n    bullet_char: str | None = None,\n    url: str | None = None,\n    display_levels: int | None = None,\n    prefix: str | None = None,\n    suffix: str | None = None,\n    start_value: int | None = None,\n    style: str | None = None,\n    clone: Style | None = None,\n) -&gt; Style | None:\n    \"\"\"\n    Arguments:\n\n        level -- int\n\n        num_format (for number) -- int\n\n        bullet_char (for bullet) -- str\n\n        url (for image) -- str\n\n        display_levels -- int\n\n        prefix -- str\n\n        suffix -- str\n\n        start_value -- int\n\n        style -- str\n\n        clone -- List Style\n\n    Return:\n        level_style created\n    \"\"\"\n    if self.family != \"list\":\n        return None\n    # Expected name\n    if num_format is not None:\n        level_style_name = \"text:list-level-style-number\"\n    elif bullet_char is not None:\n        level_style_name = \"text:list-level-style-bullet\"\n    elif url is not None:\n        level_style_name = \"text:list-level-style-image\"\n    elif clone is not None:\n        level_style_name = clone.tag\n    else:\n        raise ValueError(\"unknown level style type\")\n    was_created = False\n    # Cloning or reusing an existing element\n    level_style: Style | None = None\n    if clone is not None:\n        level_style = clone.clone  # type: ignore\n        was_created = True\n    else:\n        level_style = self.get_level_style(level)\n        if level_style is None:\n            level_style = Element.from_tag(level_style_name)  # type: ignore\n            was_created = True\n    if level_style is None:\n        return None\n    # Transmute if the type changed\n    if level_style.tag != level_style_name:\n        print(\"Warn: different style\", level_style_name, level_style.tag)\n        level_style.tag = level_style_name\n    # Set the level\n    level_style.set_attribute(\"text:level\", str(level))\n    # Set the main attribute\n    if num_format is not None:\n        level_style.set_attribute(\"fo:num-format\", num_format)\n    elif bullet_char is not None:\n        level_style.set_attribute(\"text:bullet-char\", bullet_char)\n    elif url is not None:\n        level_style.set_attribute(\"xlink:href\", url)\n    # Set attributes\n    if prefix:\n        level_style.set_attribute(\"style:num-prefix\", prefix)\n    if suffix:\n        level_style.set_attribute(\"style:num-suffix\", suffix)\n    if display_levels:\n        level_style.set_attribute(\"text:display-levels\", str(display_levels))\n    if start_value:\n        level_style.set_attribute(\"text:start-value\", str(start_value))\n    if style:\n        level_style.text_style = style  # type: ignore\n    # Commit the creation\n    if was_created:\n        self.append(level_style)\n    return level_style\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_page_footer","title":"<code>set_page_footer(text_or_element)</code>","text":"<p>Create or replace the footer by the given content. It can already be a complete footer.</p> <p>If you only want to update the existing footer, get it and use the API.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or Element or a list of them\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_page_footer(\n    self,\n    text_or_element: str | Element | list[Element | str],\n) -&gt; None:\n    \"\"\"Create or replace the footer by the given content. It can already\n    be a complete footer.\n\n    If you only want to update the existing footer, get it and use the\n    API.\n\n    Arguments:\n\n        text_or_element -- str or Element or a list of them\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    self._set_header_or_footer(text_or_element, name=\"footer\", style=\"Footer\")\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_page_header","title":"<code>set_page_header(text_or_element)</code>","text":"<p>Create or replace the header by the given content. It can already be a complete header.</p> <p>If you only want to update the existing header, get it and use the API.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or Element or a list of them\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_page_header(\n    self,\n    text_or_element: str | Element | list[Element | str],\n) -&gt; None:\n    \"\"\"Create or replace the header by the given content. It can already\n    be a complete header.\n\n    If you only want to update the existing header, get it and use the\n    API.\n\n    Arguments:\n\n        text_or_element -- str or Element or a list of them\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    self._set_header_or_footer(text_or_element)\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_properties","title":"<code>set_properties(properties=None, style=None, area=None, **kwargs)</code>","text":"<p>Set the properties of the \u201carea\u201d type of this style. Properties are given either as a dict or as named arguments (or both). The area is identical to the style family by default. If the properties element is missing, it is created.</p> <p>Instead of properties, you can pass a style with properties of the same area. These will be copied.</p> <p>Arguments:</p> <pre><code>properties -- dict\n\nstyle -- Style\n\narea -- 'paragraph', 'text'...\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_properties(  # noqa: C901\n    self,\n    properties: dict[str, str | dict] | None = None,\n    style: Style | None = None,\n    area: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Set the properties of the \"area\" type of this style. Properties\n    are given either as a dict or as named arguments (or both). The area\n    is identical to the style family by default. If the properties\n    element is missing, it is created.\n\n    Instead of properties, you can pass a style with properties of the\n    same area. These will be copied.\n\n    Arguments:\n\n        properties -- dict\n\n        style -- Style\n\n        area -- 'paragraph', 'text'...\n    \"\"\"\n    if properties is None:\n        properties = {}\n    if area is None:\n        if isinstance(self.family, bool):\n            area = None\n        else:\n            area = self.family\n    element = self.get_element(f\"style:{area}-properties\")\n    if element is None:\n        element = Element.from_tag(f\"style:{area}-properties\")\n        self.append(element)\n    if properties or kwargs:\n        properties = _expand_properties_dict(_merge_dicts(properties, kwargs))\n    elif style is not None:\n        properties = style.get_properties(area=area)\n        if properties is None:\n            return\n    if properties is None:\n        return\n    for key, value in properties.items():\n        if value is None:\n            element.del_attribute(key)\n        elif isinstance(value, (str, bool, tuple)):\n            element.set_attribute(key, value)\n        else:\n            pass\n</code></pre>"},{"location":"reference.html#odfdo.Styles","title":"<code>Styles</code>","text":"<p>             Bases: <code>XmlPart</code></p> Source code in <code>odfdo/styles.py</code> <pre><code>class Styles(XmlPart):\n    def _get_style_contexts(\n        self, family: str, automatic: bool = False\n    ) -&gt; list[Element]:\n        if automatic:\n            return [self.get_element(\"//office:automatic-styles\")]\n        if not family:\n            # All possibilities\n            return [\n                self.get_element(\"//office:automatic-styles\"),\n                self.get_element(\"//office:styles\"),\n                self.get_element(\"//office:master-styles\"),\n                self.get_element(\"//office:font-face-decls\"),\n            ]\n        queries = CONTEXT_MAPPING.get(family)\n        if queries is None:\n            raise ValueError(f\"unknown family: {family}\")\n        # print('q:', queries)\n        return [self.get_element(query) for query in queries]\n\n    def get_styles(self, family: str = \"\", automatic: bool = False) -&gt; list[Element]:\n        \"\"\"Return the list of styles in the Content part, optionally limited\n        to the given family, optionaly limited to automatic styles.\n\n        Arguments:\n\n            family -- str\n\n            automatic -- bool\n\n        Return: list of Style\n        \"\"\"\n        result = []\n        for context in self._get_style_contexts(family, automatic=automatic):\n            if context is None:\n                continue\n            # print('-ctx----', automatic)\n            # print(context.tag)\n            # print(context.__class__)\n            # print(context.serialize())\n            result.extend(context.get_styles(family=family))\n        return result\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Style | None = None,\n        display_name: str | None = None,\n    ) -&gt; Style | None:\n        \"\"\"Return the style uniquely identified by the name/family pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is None, the default style is fetched.\n\n        If the name is not the internal name but the name you gave in the\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                      'number', 'page-layout', 'master-page'\n\n            name_or_element -- str, odf_style or None\n\n            display_name -- str or None\n\n        Return: odf_style or None if not found\n        \"\"\"\n        for context in self._get_style_contexts(family):\n            if context is None:\n                continue\n            style = context.get_style(\n                family,\n                name_or_element=name_or_element,\n                display_name=display_name,\n            )\n            if style is not None:\n                return style  # type: ignore\n        return None\n\n    def get_master_pages(self) -&gt; list[Element]:\n        query = make_xpath_query(\"descendant::style:master-page\")\n        return self.get_elements(query)  # type:ignore\n\n    def get_master_page(self, position: int = 0) -&gt; Element | None:\n        results = self.get_master_pages()\n        try:\n            return results[position]\n        except IndexError:\n            return None\n</code></pre>"},{"location":"reference.html#odfdo.Styles.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the name/family pair. If the argument is already a style object, it will return it.</p> <p>If the name is None, the default style is fetched.</p> <p>If the name is not the internal name but the name you gave in the desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n          'number', 'page-layout', 'master-page'\n\nname_or_element -- str, odf_style or None\n\ndisplay_name -- str or None\n</code></pre> <p>Return: odf_style or None if not found</p> Source code in <code>odfdo/styles.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Style | None = None,\n    display_name: str | None = None,\n) -&gt; Style | None:\n    \"\"\"Return the style uniquely identified by the name/family pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is None, the default style is fetched.\n\n    If the name is not the internal name but the name you gave in the\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                  'number', 'page-layout', 'master-page'\n\n        name_or_element -- str, odf_style or None\n\n        display_name -- str or None\n\n    Return: odf_style or None if not found\n    \"\"\"\n    for context in self._get_style_contexts(family):\n        if context is None:\n            continue\n        style = context.get_style(\n            family,\n            name_or_element=name_or_element,\n            display_name=display_name,\n        )\n        if style is not None:\n            return style  # type: ignore\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Styles.get_styles","title":"<code>get_styles(family='', automatic=False)</code>","text":"<p>Return the list of styles in the Content part, optionally limited to the given family, optionaly limited to automatic styles.</p> <p>Arguments:</p> <pre><code>family -- str\n\nautomatic -- bool\n</code></pre> <p>Return: list of Style</p> Source code in <code>odfdo/styles.py</code> <pre><code>def get_styles(self, family: str = \"\", automatic: bool = False) -&gt; list[Element]:\n    \"\"\"Return the list of styles in the Content part, optionally limited\n    to the given family, optionaly limited to automatic styles.\n\n    Arguments:\n\n        family -- str\n\n        automatic -- bool\n\n    Return: list of Style\n    \"\"\"\n    result = []\n    for context in self._get_style_contexts(family, automatic=automatic):\n        if context is None:\n            continue\n        # print('-ctx----', automatic)\n        # print(context.tag)\n        # print(context.__class__)\n        # print(context.serialize())\n        result.extend(context.get_styles(family=family))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.TOC","title":"<code>TOC</code>","text":"<p>             Bases: <code>Element</code></p> <p>Table of content. The \u201ctext:table-of-content\u201d element represents a table of contents for a document. The items that can be listed in a table of contents are:   - Headings (as defined by the outline structure of the document), up to     a selected level.   - Table of contents index marks.   - Paragraphs formatted with specified paragraph styles.</p> <p>Implementation: Default parameters are what most people use: protected from manual modifications and not limited in title levels.</p> <p>The name is mandatory and derived automatically from the title if not given. Provide one in case of a conflict with other TOCs in the same document.</p> <p>The \u201ctext:table-of-content\u201d element has the following attributes: text:name, text:protected, text:protection-key, text:protection-key-digest-algorithm, text:style-name and xml:id.</p> <p>Arguments:</p> <pre><code>title -- str\n\nname -- str\n\nprotected -- bool\n\noutline_level -- int\n\nstyle -- str\n\ntitle_style -- str\n\nentry_style -- str\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>class TOC(Element):\n    \"\"\"Table of content.\n    The \"text:table-of-content\" element represents a table of contents for a\n    document. The items that can be listed in a table of contents are:\n      - Headings (as defined by the outline structure of the document), up to\n        a selected level.\n      - Table of contents index marks.\n      - Paragraphs formatted with specified paragraph styles.\n\n\n    Implementation:\n    Default parameters are what most people use: protected from manual\n    modifications and not limited in title levels.\n\n    The name is mandatory and derived automatically from the title if not\n    given. Provide one in case of a conflict with other TOCs in the same\n    document.\n\n    The \"text:table-of-content\" element has the following attributes:\n    text:name, text:protected, text:protection-key,\n    text:protection-key-digest-algorithm, text:style-name and xml:id.\n\n    Arguments:\n\n        title -- str\n\n        name -- str\n\n        protected -- bool\n\n        outline_level -- int\n\n        style -- str\n\n        title_style -- str\n\n        entry_style -- str\n    \"\"\"\n\n    _tag = \"text:table-of-content\"\n    _properties = (\n        PropDef(\"name\", \"text:name\"),\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"xml_id\", \"xml:id\"),\n        PropDef(\"protected\", \"text:protected\"),\n        PropDef(\"protection_key\", \"text:protection-key\"),\n        PropDef(\n            \"protection_key_digest_algorithm\", \"text:protection-key-digest-algorithm\"\n        ),\n    )\n\n    def __init__(\n        self,\n        title: str = \"Table of Contents\",\n        name: str | None = None,\n        protected: bool = True,\n        outline_level: int = 0,\n        style: str | None = None,\n        title_style: str = \"Contents_20_Heading\",\n        entry_style: str = \"Contents_20_%d\",\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style:\n                self.style = style\n            if protected:\n                self.protected = protected\n            if name is None:\n                self.name = f\"{title}1\"\n            # Create the source template\n            toc_source = self.create_toc_source(\n                title, outline_level, title_style, entry_style\n            )\n            self.append(toc_source)\n            # Create the index body automatically with the index title\n            if title:\n                # This style is in the template document\n                self.set_toc_title(title, text_style=title_style)\n\n    @staticmethod\n    def create_toc_source(\n        title: str,\n        outline_level: int,\n        title_style: str,\n        entry_style: str,\n    ) -&gt; Element:\n        toc_source = Element.from_tag(\"text:table-of-content-source\")\n        toc_source.set_attribute(\"text:outline-level\", str(outline_level))\n        if title:\n            title_template = IndexTitleTemplate()\n            if title_style:\n                # This style is in the template document\n                title_template.style = title_style\n            title_template.text = title\n            toc_source.append(title_template)\n        for level in range(1, 11):\n            template = TocEntryTemplate(outline_level=level)\n            if entry_style:\n                template.style = entry_style % level\n            toc_source.append(template)\n        return toc_source\n\n    def __str__(self) -&gt; str:\n        return self.get_formatted_text()\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        index_body = self.get_element(\"text:index-body\")\n\n        if index_body is None:\n            return \"\"\n        if context is None:\n            context = {}\n        if context.get(\"rst_mode\"):\n            return \"\\n.. contents::\\n\\n\"\n\n        result = []\n        for element in index_body.children:\n            if element.tag == \"text:index-title\":\n                for child_element in element.children:\n                    result.append(child_element.get_formatted_text(context).strip())\n            else:\n                result.append(element.get_formatted_text(context).strip())\n        return \"\\n\".join(result)\n\n    @property\n    def outline_level(self) -&gt; int | None:\n        source = self.get_element(\"text:table-of-content-source\")\n        if source is None:\n            return None\n        return source.get_attribute_integer(\"text:outline-level\")\n\n    @outline_level.setter\n    def outline_level(self, level: int) -&gt; None:\n        source = self.get_element(\"text:table-of-content-source\")\n        if source is None:\n            source = Element.from_tag(\"text:table-of-content-source\")\n            self.insert(source, FIRST_CHILD)\n        source.set_attribute(\"text:outline-level\", str(level))\n\n    @property\n    def body(self) -&gt; Element | None:\n        return self.get_element(\"text:index-body\")\n\n    @body.setter\n    def body(self, body: Element | None = None) -&gt; Element | None:\n        old_body = self.body\n        if old_body is not None:\n            self.delete(old_body)\n        if body is None:\n            body = Element.from_tag(\"text:index-body\")\n        self.append(body)\n        return body\n\n    def get_title(self) -&gt; str:\n        index_body = self.body\n        if index_body is None:\n            return \"\"\n        index_title = index_body.get_element(IndexTitle._tag)\n        if index_title is None:\n            return \"\"\n        return index_title.text_content\n\n    def set_toc_title(\n        self,\n        title: str,\n        style: str | None = None,\n        text_style: str | None = None,\n    ) -&gt; None:\n        index_body = self.body\n        if index_body is None:\n            self.body = None\n            index_body = self.body\n        index_title = index_body.get_element(IndexTitle._tag)  # type: ignore\n        if index_title is None:\n            name = f\"{self.name}_Head\"\n            index_title = IndexTitle(\n                name=name, style=style, title_text=title, text_style=text_style\n            )\n            index_body.append(index_title)  # type: ignore\n        else:\n            if style:\n                index_title.style = style  # type: ignore\n            paragraph = index_title.get_paragraph()\n            if paragraph is None:\n                paragraph = Paragraph()\n                index_title.append(paragraph)\n            if text_style:\n                paragraph.style = text_style  # type: ignore\n            paragraph.text = title\n\n    @staticmethod\n    def _header_numbering(level_indexes: dict[int, int], level: int) -&gt; str:\n        \"\"\"Return the header hierarchical number (like \"1.2.3.\").\"\"\"\n        numbers: list[int] = []\n        # before header level\n        for idx in range(1, level):\n            numbers.append(level_indexes.setdefault(idx, 1))\n        # header level\n        index = level_indexes.get(level, 0) + 1\n        level_indexes[level] = index\n        numbers.append(index)\n        # after header level\n        idx = level + 1\n        while idx in level_indexes:\n            del level_indexes[idx]\n            idx += 1\n        return \".\".join(str(x) for x in numbers) + \".\"\n\n    def fill(  # noqa: C901\n        self,\n        document: Document | None = None,\n        use_default_styles: bool = True,\n    ) -&gt; None:\n        \"\"\"Fill the TOC with the titles found in the document. A TOC is not\n        contextual so it will catch all titles before and after its insertion.\n        If the TOC is not attached to a document, attach it beforehand or\n        provide one as argument.\n\n        For having a pretty TOC, let use_default_styles by default.\n\n        Arguments:\n\n            document -- Document\n\n            use_default_styles -- bool\n        \"\"\"\n        # Find the body\n        if document is not None:\n            body: Element | None = document.body\n        else:\n            body = self.document_body\n        if body is None:\n            raise ValueError(\"The TOC must be related to a document somehow\")\n\n        # Save the title\n        index_body = self.body\n        title = index_body.get_element(\"text:index-title\")  # type: ignore\n\n        # Clean the old index-body\n        self.body = None\n        index_body = self.body\n\n        # Restore the title\n        if title and str(title):\n            index_body.insert(title, position=0)  # type: ignore\n\n        # Insert default TOC style\n        if use_default_styles:\n            automatic_styles = body.get_element(\"//office:automatic-styles\")\n            if isinstance(automatic_styles, Element):\n                for level in range(1, 11):\n                    if (\n                        automatic_styles.get_style(\n                            \"paragraph\", _toc_entry_style_name(level)\n                        )\n                        is None\n                    ):\n                        level_style = default_toc_level_style(level)\n                        automatic_styles.append(level_style)\n\n        # Auto-fill the index\n        outline_level = self.outline_level or 10\n        level_indexes: dict[int, int] = {}\n        for header in body.headers:\n            level = header.get_attribute_integer(\"text:outline-level\") or 0\n            if level is None or level &gt; outline_level:\n                continue\n            number_str = self._header_numbering(level_indexes, level)\n            # Make the title with \"1.2.3. Title\" format\n            paragraph = Paragraph(f\"{number_str} {header}\")\n            if use_default_styles:\n                paragraph.style = _toc_entry_style_name(level)\n            index_body.append(paragraph)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.TOC.fill","title":"<code>fill(document=None, use_default_styles=True)</code>","text":"<p>Fill the TOC with the titles found in the document. A TOC is not contextual so it will catch all titles before and after its insertion. If the TOC is not attached to a document, attach it beforehand or provide one as argument.</p> <p>For having a pretty TOC, let use_default_styles by default.</p> <p>Arguments:</p> <pre><code>document -- Document\n\nuse_default_styles -- bool\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>def fill(  # noqa: C901\n    self,\n    document: Document | None = None,\n    use_default_styles: bool = True,\n) -&gt; None:\n    \"\"\"Fill the TOC with the titles found in the document. A TOC is not\n    contextual so it will catch all titles before and after its insertion.\n    If the TOC is not attached to a document, attach it beforehand or\n    provide one as argument.\n\n    For having a pretty TOC, let use_default_styles by default.\n\n    Arguments:\n\n        document -- Document\n\n        use_default_styles -- bool\n    \"\"\"\n    # Find the body\n    if document is not None:\n        body: Element | None = document.body\n    else:\n        body = self.document_body\n    if body is None:\n        raise ValueError(\"The TOC must be related to a document somehow\")\n\n    # Save the title\n    index_body = self.body\n    title = index_body.get_element(\"text:index-title\")  # type: ignore\n\n    # Clean the old index-body\n    self.body = None\n    index_body = self.body\n\n    # Restore the title\n    if title and str(title):\n        index_body.insert(title, position=0)  # type: ignore\n\n    # Insert default TOC style\n    if use_default_styles:\n        automatic_styles = body.get_element(\"//office:automatic-styles\")\n        if isinstance(automatic_styles, Element):\n            for level in range(1, 11):\n                if (\n                    automatic_styles.get_style(\n                        \"paragraph\", _toc_entry_style_name(level)\n                    )\n                    is None\n                ):\n                    level_style = default_toc_level_style(level)\n                    automatic_styles.append(level_style)\n\n    # Auto-fill the index\n    outline_level = self.outline_level or 10\n    level_indexes: dict[int, int] = {}\n    for header in body.headers:\n        level = header.get_attribute_integer(\"text:outline-level\") or 0\n        if level is None or level &gt; outline_level:\n            continue\n        number_str = self._header_numbering(level_indexes, level)\n        # Make the title with \"1.2.3. Title\" format\n        paragraph = Paragraph(f\"{number_str} {header}\")\n        if use_default_styles:\n            paragraph.style = _toc_entry_style_name(level)\n        index_body.append(paragraph)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Tab","title":"<code>Tab</code>","text":"<p>             Bases: <code>Element</code></p> <p>This element represents the [UNICODE] tab character (HORIZONTAL TABULATION, U+0009).</p> <p>The position attribute contains the number of the tab-stop to which a tab character refers. The position 0 marks the start margin of a paragraph. Note: The position attribute is only a hint to help non-layout oriented consumers to determine the tab/tab-stop association. Layout oriented consumers should determine the tab positions based on the style information</p> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>class Tab(Element):\n    \"\"\"This element represents the [UNICODE] tab character (HORIZONTAL\n    TABULATION, U+0009).\n\n    The position attribute contains the number of the tab-stop to which\n    a tab character refers. The position 0 marks the start margin of a\n    paragraph. Note: The position attribute is only a hint to help non-layout\n    oriented consumers to determine the tab/tab-stop association. Layout\n    oriented consumers should determine the tab positions based on the style\n    information\n    \"\"\"\n\n    _tag = \"text:tab\"\n    _properties: tuple[PropDef, ...] = (PropDef(\"position\", \"text:tab-ref\"),)\n\n    def __init__(self, position: int | None = None, **kwargs: Any) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            position -- int\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init and position is not None and position &gt;= 0:\n            self.position = str(position)\n</code></pre>"},{"location":"reference.html#odfdo.Tab.__init__","title":"<code>__init__(position=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>position -- int\n</code></pre> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>def __init__(self, position: int | None = None, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        position -- int\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init and position is not None and position &gt;= 0:\n        self.position = str(position)\n</code></pre>"},{"location":"reference.html#odfdo.TabStopStyle","title":"<code>TabStopStyle</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF \u201cstyle:tab-stop\u201d Base style for a TOC entryBase style for a TOC entry</p> Source code in <code>odfdo/toc.py</code> <pre><code>class TabStopStyle(Element):\n    \"\"\"ODF \"style:tab-stop\"\n    Base style for a TOC entryBase style for a TOC entry\n    \"\"\"\n\n    _tag = \"style:tab-stop\"\n    _properties = (\n        PropDef(\"style_char\", \"style:char\"),\n        PropDef(\"leader_color\", \"style:leader-color\"),\n        PropDef(\"leader_style\", \"style:leader-style\"),\n        PropDef(\"leader_text\", \"style:leader-text\"),\n        PropDef(\"leader_text_style\", \"style:leader-text-style\"),\n        PropDef(\"leader_type\", \"style:leader-type\"),\n        PropDef(\"leader_width\", \"style:leader-width\"),\n        PropDef(\"style_position\", \"style:position\"),\n        PropDef(\"style_type\", \"style:type\"),\n    )\n\n    def __init__(  # noqa: C901\n        self,\n        style_char: str | None = None,\n        leader_color: str | None = None,\n        leader_style: str | None = None,\n        leader_text: str | None = None,\n        leader_text_style: str | None = None,\n        leader_type: str | None = None,\n        leader_width: str | None = None,\n        style_position: str | None = None,\n        style_type: str | None = None,\n        **kwargs: Any,\n    ):\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style_char:\n                self.style_char = style_char\n            if leader_color:\n                self.leader_color = leader_color\n            if leader_style:\n                self.leader_style = leader_style\n            if leader_text:\n                self.leader_text = leader_text\n            if leader_text_style:\n                self.leader_text_style = leader_text_style\n            if leader_type:\n                self.leader_type = leader_type\n            if leader_width:\n                self.leader_width = leader_width\n            if style_position:\n                self.style_position = style_position\n            if style_type:\n                self.style_type = style_type\n</code></pre>"},{"location":"reference.html#odfdo.Table","title":"<code>Table</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF table \u201ctable:table\u201d</p> Source code in <code>odfdo/table.py</code> <pre><code>class Table(Element):\n    \"\"\"ODF table \"table:table\" \"\"\"\n\n    _tag = \"table:table\"\n    _caching = True\n    _append = Element.append\n\n    def __init__(\n        self,\n        name: str | None = None,\n        width: int | None = None,\n        height: int | None = None,\n        protected: bool = False,\n        protection_key: str | None = None,\n        display: bool = True,\n        printable: bool = True,\n        print_ranges: list[str] | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a table element, optionally prefilled with \"height\" rows of\n        \"width\" cells each.\n\n        If the table is to be protected, a protection key must be provided,\n        i.e. a hash value of the password.\n\n        If the table must not be displayed, set \"display\" to False.\n\n        If the table must not be printed, set \"printable\" to False. The table\n        will not be printed when it is not displayed, whatever the value of\n        this argument.\n\n        Ranges of cells to print can be provided as a list of cell ranges,\n        e.g. ['E6:K12', 'P6:R12'] or directly as a raw string, e.g.\n        \"E6:K12 P6:R12\".\n\n        You can access and modify the XML tree manually, but you probably want\n        to use the API to access and alter cells. It will save you from\n        handling repetitions and the same number of cells for each row.\n\n        If you use both the table API and the XML API, you are on your own for\n        ensuiring model integrity.\n\n        Arguments:\n\n            name -- str\n\n            width -- int\n\n            height -- int\n\n            protected -- bool\n\n            protection_key -- str\n\n            display -- bool\n\n            printable -- bool\n\n            print_ranges -- list\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self._indexes = {}\n        self._indexes[\"_cmap\"] = {}\n        self._indexes[\"_tmap\"] = {}\n        if self._do_init:\n            self.name = name\n            if protected:\n                self.protected = protected\n                self.set_protection_key = protection_key\n            if not display:\n                self.displayed = display\n            if not printable:\n                self.printable = printable\n            if print_ranges:\n                self.print_ranges = print_ranges\n            if style:\n                self.style = style\n            # Prefill the table\n            if width is not None or height is not None:\n                width = width or 1\n                height = height or 1\n                # Column groups for style information\n                columns = Column(repeated=width)\n                self._append(columns)\n                for _i in range(height):\n                    row = Row(width)\n                    self._append(row)\n        self._compute_table_cache()\n\n    def __str__(self) -&gt; str:\n        def write_content(csv_writer: object) -&gt; None:\n            for values in self.iter_values():\n                line = []\n                for value in values:\n                    if value is None:\n                        value = \"\"\n                    if isinstance(value, str):\n                        value = value.strip()\n                    line.append(value)\n                csv_writer.writerow(line)  # type: ignore\n\n        out = StringIO(newline=os.linesep)\n        csv_writer = csv.writer(\n            out,\n            delimiter=\" \",\n            doublequote=False,\n            escapechar=\"\\\\\",\n            lineterminator=os.linesep,\n            quotechar='\"',\n            quoting=csv.QUOTE_NONNUMERIC,\n        )\n        write_content(csv_writer)\n        return out.getvalue()\n\n    def _translate_y_from_any(self, y: str | int) -&gt; int:\n        # \"3\" (couting from 1) -&gt; 2 (couting from 0)\n        return translate_from_any(y, self.height, 1)\n\n    def _translate_table_coordinates_list(\n        self,\n        coord: tuple | list,\n    ) -&gt; tuple[int | None, ...]:\n        height = self.height\n        width = self.width\n        # assuming we got int values\n        if len(coord) == 1:\n            # It is a row\n            y = coord[0]\n            if y and y &lt; 0:\n                y = increment(y, height)\n            return (None, y, None, y)\n        if len(coord) == 2:\n            # It is a row range, not a cell, because context is table\n            y = coord[0]\n            if y and y &lt; 0:\n                y = increment(y, height)\n            t = coord[1]\n            if t and t &lt; 0:\n                t = increment(t, height)\n            return (None, y, None, t)\n        # should be 4 int\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_table_coordinates_str(\n        self,\n        coord_str: str,\n    ) -&gt; tuple[int | None, ...]:\n        height = self.height\n        width = self.width\n        coord = convert_coordinates(coord_str)\n        if len(coord) == 2:\n            x, y = coord\n            if x and x &lt; 0:\n                x = increment(x, width)\n            if y and y &lt; 0:\n                y = increment(y, height)\n            # extent to an area :\n            return (x, y, x, y)\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_table_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, ...]:\n        if isinstance(coord, str):\n            return self._translate_table_coordinates_str(coord)\n        return self._translate_table_coordinates_list(coord)\n\n    def _translate_column_coordinates_str(\n        self,\n        coord_str: str,\n    ) -&gt; tuple[int | None, ...]:\n        width = self.width\n        height = self.height\n        coord = convert_coordinates(coord_str)\n        if len(coord) == 2:\n            x, y = coord\n            if x and x &lt; 0:\n                x = increment(x, width)\n            if y and y &lt; 0:\n                y = increment(y, height)\n            # extent to an area :\n            return (x, y, x, y)\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_column_coordinates_list(\n        self,\n        coord: tuple | list,\n    ) -&gt; tuple[int | None, ...]:\n        width = self.width\n        height = self.height\n        # assuming we got int values\n        if len(coord) == 1:\n            # It is a column\n            x = coord[0]\n            if x and x &lt; 0:\n                x = increment(x, width)\n            return (x, None, x, None)\n        if len(coord) == 2:\n            # It is a column range, not a cell, because context is table\n            x = coord[0]\n            if x and x &lt; 0:\n                x = increment(x, width)\n            z = coord[1]\n            if z and z &lt; 0:\n                z = increment(z, width)\n            return (x, None, z, None)\n        # should be 4 int\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_column_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, ...]:\n        if isinstance(coord, str):\n            return self._translate_column_coordinates_str(coord)\n        return self._translate_column_coordinates_list(coord)\n\n    def _translate_cell_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, int | None]:\n        # we want an x,y result\n        coord = convert_coordinates(coord)\n        if len(coord) == 2:\n            x, y = coord\n        # If we got an area, take the first cell\n        elif len(coord) == 4:\n            x, y, z, t = coord\n        else:\n            raise ValueError(str(coord))\n        if x and x &lt; 0:\n            x = increment(x, self.width)\n        if y and y &lt; 0:\n            y = increment(y, self.height)\n        return (x, y)\n\n    def _compute_table_cache(self) -&gt; None:\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_row, \"table:number-rows-repeated\"\n        )\n        self._tmap = make_cache_map(idx_repeated_seq)\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_column, \"table:number-columns-repeated\"\n        )\n        self._cmap = make_cache_map(idx_repeated_seq)\n\n    def _update_width(self, row: Row) -&gt; None:\n        \"\"\"Synchronize the number of columns if the row is bigger.\n\n        Append, don't insert, not to disturb the current layout.\n        \"\"\"\n        diff = row.width - self.width\n        if diff &gt; 0:\n            self.append_column(Column(repeated=diff))\n\n    def _get_formatted_text_normal(self, context: dict | None) -&gt; str:\n        result = []\n        for row in self.traverse():\n            for cell in row.traverse():\n                value = cell.get_value(try_get_text=False)\n                # None ?\n                if value is None:\n                    # Try with get_formatted_text on the elements\n                    value = []\n                    for element in cell.children:\n                        value.append(element.get_formatted_text(context))\n                    value = \"\".join(value)\n                else:\n                    value = str(value)\n                result.append(value)\n                result.append(\"\\n\")\n            result.append(\"\\n\")\n        return \"\".join(result)\n\n    def _get_formatted_text_rst(self, context: dict) -&gt; str:  # noqa: C901\n        context[\"no_img_level\"] += 1\n        # Strip the table =&gt; We must clone\n        table = self.clone\n        table.rstrip(aggressive=True)  # type: ignore\n\n        # Fill the rows\n        rows = []\n        cols_nb = 0\n        cols_size: dict[int, int] = {}\n        for odf_row in table.traverse():  # type: ignore\n            row = []\n            for i, cell in enumerate(odf_row.traverse()):\n                value = cell.get_value(try_get_text=False)\n                # None ?\n                if value is None:\n                    # Try with get_formatted_text on the elements\n                    value = []\n                    for element in cell.children:\n                        value.append(element.get_formatted_text(context))\n                    value = \"\".join(value)\n                else:\n                    value = str(value)\n                value = value.strip()\n                # Strip the empty columns\n                if value:\n                    cols_nb = max(cols_nb, i + 1)\n                # Compute the size of each columns (at least 2)\n                cols_size[i] = max(cols_size.get(i, 2), len(value))\n                # Append\n                row.append(value)\n            rows.append(row)\n\n        # Nothing ?\n        if cols_nb == 0:\n            return \"\"\n\n        # Prevent a crash with empty columns (by example with images)\n        for col, size in cols_size.items():\n            if size == 0:\n                cols_size[col] = 1\n\n        # Update cols_size\n        LINE_MAX = 100\n        COL_MIN = 16\n\n        free_size = LINE_MAX - (cols_nb - 1) * 3 - 4\n        real_size = sum([cols_size[i] for i in range(cols_nb)])\n        if real_size &gt; free_size:\n            factor = float(free_size) / real_size\n\n            for i in range(cols_nb):\n                old_size = cols_size[i]\n\n                # The cell is already small\n                if old_size &lt;= COL_MIN:\n                    continue\n\n                new_size = int(factor * old_size)\n\n                if new_size &lt; COL_MIN:\n                    new_size = COL_MIN\n                cols_size[i] = new_size\n\n        # Convert !\n        result: list[str] = [\"\"]\n        # Construct the first/last line\n        line: list[str] = []\n        for i in range(cols_nb):\n            line.append(\"=\" * cols_size[i])\n            line.append(\" \")\n        line_str = \"\".join(line)\n\n        # Add the lines\n        result.append(line_str)\n        for row in rows:\n            # Wrap the row\n            wrapped_row = []\n            for i, value in enumerate(row[:cols_nb]):\n                wrapped_value = []\n                for part in value.split(\"\\n\"):\n                    # Hack to handle correctly the lists or the directives\n                    subsequent_indent = \"\"\n                    part_lstripped = part.lstrip()\n                    if part_lstripped.startswith(\"-\") or part_lstripped.startswith(\n                        \"..\"\n                    ):\n                        subsequent_indent = \" \" * (len(part) - len(part.lstrip()) + 2)\n                    wrapped_part = wrap(\n                        part, width=cols_size[i], subsequent_indent=subsequent_indent\n                    )\n                    if wrapped_part:\n                        wrapped_value.extend(wrapped_part)\n                    else:\n                        wrapped_value.append(\"\")\n                wrapped_row.append(wrapped_value)\n\n            # Append!\n            for j in range(max([1] + [len(values) for values in wrapped_row])):\n                txt_row: list[str] = []\n                for i in range(cols_nb):\n                    values = wrapped_row[i] if i &lt; len(wrapped_row) else []\n\n                    # An empty cell ?\n                    if len(values) - 1 &lt; j or not values[j]:\n                        if i == 0 and j == 0:\n                            txt_row.append(\"..\")\n                            txt_row.append(\" \" * (cols_size[i] - 1))\n                        else:\n                            txt_row.append(\" \" * (cols_size[i] + 1))\n                        continue\n\n                    # Not empty\n                    value = values[j]\n                    txt_row.append(value)\n                    txt_row.append(\" \" * (cols_size[i] - len(value) + 1))\n                result.append(\"\".join(txt_row))\n\n        result.append(line_str)\n        result.append(\"\")\n        result.append(\"\")\n        result_str = \"\\n\".join(result)\n\n        context[\"no_img_level\"] -= 1\n        return result_str\n\n    def _translate_x_from_any(self, x: str | int) -&gt; int:\n        return translate_from_any(x, self.width, 0)\n\n    #\n    # Public API\n    #\n\n    def append(self, something: Element | str) -&gt; None:\n        \"\"\"Dispatch .append() call to append_row() or append_column().\"\"\"\n        if isinstance(something, Row):\n            self.append_row(something)\n        elif isinstance(something, Column):\n            self.append_column(something)\n        else:\n            # probably still an error\n            self._append(something)\n\n    @property\n    def height(self) -&gt; int:\n        \"\"\"Get the current height of the table.\n\n        Return: int\n        \"\"\"\n        try:\n            height = self._tmap[-1] + 1\n        except Exception:\n            height = 0\n        return height\n\n    @property\n    def width(self) -&gt; int:\n        \"\"\"Get the current width of the table, measured on columns.\n\n        Rows may have different widths, use the Table API to ensure width\n        consistency.\n\n        Return: int\n        \"\"\"\n        # Columns are our reference for user expected width\n\n        try:\n            width = self._cmap[-1] + 1\n        except Exception:\n            width = 0\n\n        # columns = self._get_columns()\n        # repeated = self.xpath(\n        #        'table:table-column/@table:number-columns-repeated')\n        # unrepeated = len(columns) - len(repeated)\n        # ws = sum(int(r) for r in repeated) + unrepeated\n        # if w != ws:\n        #    print \"WARNING   ws\", ws, \"w\", w\n\n        return width\n\n    @property\n    def size(self) -&gt; tuple[int, int]:\n        \"\"\"Shortcut to get the current width and height of the table.\n\n        Return: (int, int)\n        \"\"\"\n        return self.width, self.height\n\n    @property\n    def name(self) -&gt; str | None:\n        \"\"\"Get / set the name of the table.\"\"\"\n        return self.get_attribute_string(\"table:name\")\n\n    @name.setter\n    def name(self, name: str) -&gt; None:\n        name = _table_name_check(name)\n        # first, update named ranges\n        # fixme : delete name ranges when deleting table, too.\n        for named_range in self.get_named_ranges(table_name=self.name):\n            named_range.set_table_name(name)\n        self.set_attribute(\"table:name\", name)\n\n    @property\n    def protected(self) -&gt; bool:\n        return bool(self.get_attribute(\"table:protected\"))\n\n    @protected.setter\n    def protected(self, protect: bool) -&gt; None:\n        self.set_attribute(\"table:protected\", protect)\n\n    @property\n    def protection_key(self) -&gt; str | None:\n        return self.get_attribute_string(\"table:protection-key\")\n\n    @protection_key.setter\n    def protection_key(self, key: str) -&gt; None:\n        self.set_attribute(\"table:protection-key\", key)\n\n    @property\n    def displayed(self) -&gt; bool:\n        return bool(self.get_attribute(\"table:display\"))\n\n    @displayed.setter\n    def displayed(self, display: bool) -&gt; None:\n        self.set_attribute(\"table:display\", display)\n\n    @property\n    def printable(self) -&gt; bool:\n        printable = self.get_attribute(\"table:print\")\n        # Default value\n        if printable is None:\n            return True\n        return bool(printable)\n\n    @printable.setter\n    def printable(self, printable: bool) -&gt; None:\n        self.set_attribute(\"table:print\", printable)\n\n    @property\n    def print_ranges(self) -&gt; list[str]:\n        ranges = self.get_attribute_string(\"table:print-ranges\")\n        if isinstance(ranges, str):\n            return ranges.split()\n        return []\n\n    @print_ranges.setter\n    def print_ranges(self, ranges: list[str] | None) -&gt; None:\n        if isinstance(ranges, (list, tuple)):\n            self.set_attribute(\"table:print-ranges\", \" \".join(ranges))\n        else:\n            self.set_attribute(\"table:print-ranges\", ranges)\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get / set the style of the table\n\n        Return: str\n        \"\"\"\n        return self.get_attribute_string(\"table:style-name\")\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        if context and context[\"rst_mode\"]:\n            return self._get_formatted_text_rst(context)\n        return self._get_formatted_text_normal(context)\n\n    def get_values(\n        self,\n        coord: tuple | list | str | None = None,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n        flat: bool = False,\n    ) -&gt; list:\n        \"\"\"Get a matrix of values of the table.\n\n        Filter by coordinates will parse the area defined by the coordinates.\n\n        If 'cell_type' is used and 'complete' is True (default), missing values\n        are replaced by None.\n        Filter by ' cell_type = \"all\" ' will retrieve cells of any\n        type, aka non empty cells.\n\n        If 'cell_type' is None, complete is always True : with no cell type\n        queried, get_values() returns None for each empty cell, the length\n        each lists is equal to the width of the table.\n\n        If get_type is True, returns tuples (value, ODF type of value), or\n        (None, None) for empty cells with complete True.\n\n        If flat is True, the methods return a single list of all the values.\n        By default, flat is False.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of area\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of lists of Python types\n        \"\"\"\n        if coord:\n            x, y, z, t = self._translate_table_coordinates(coord)\n        else:\n            x = y = z = t = None\n        data = []\n        for row in self.traverse(start=y, end=t):\n            if z is None:\n                width = self.width\n            else:\n                width = min(z + 1, self.width)\n            if x is not None:\n                width -= x\n            values = row.get_values(\n                (x, z),\n                cell_type=cell_type,\n                complete=complete,\n                get_type=get_type,\n            )\n            # complete row to match request width\n            if complete:\n                if get_type:\n                    values.extend([(None, None)] * (width - len(values)))\n                else:\n                    values.extend([None] * (width - len(values)))\n            if flat:\n                data.extend(values)\n            else:\n                data.append(values)\n        return data\n\n    def iter_values(\n        self,\n        coord: tuple | list | str | None = None,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n    ) -&gt; Iterator[list]:\n        \"\"\"Iterate through lines of Python values of the table.\n\n        Filter by coordinates will parse the area defined by the coordinates.\n\n        cell_type, complete, grt_type : see get_values()\n\n\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of area\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: iterator of lists\n        \"\"\"\n        if coord:\n            x, y, z, t = self._translate_table_coordinates(coord)\n        else:\n            x = y = z = t = None\n        for row in self.traverse(start=y, end=t):\n            if z is None:\n                width = self.width\n            else:\n                width = min(z + 1, self.width)\n            if x is not None:\n                width -= x\n            values = row.get_values(\n                (x, z),\n                cell_type=cell_type,\n                complete=complete,\n                get_type=get_type,\n            )\n            # complete row to match column width\n            if complete:\n                if get_type:\n                    values.extend([(None, None)] * (width - len(values)))\n                else:\n                    values.extend([None] * (width - len(values)))\n            yield values\n\n    def set_values(\n        self,\n        values: list,\n        coord: tuple | list | str | None = None,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Set the value of cells in the table, from the 'coord' position\n        with values.\n\n        'coord' is the coordinate of the upper left cell to be modified by\n        values. If 'coord' is None, default to the position (0,0) (\"A1\").\n        If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n        area is used as coordinate.\n\n        The table is *not* cleared before the operation, to reset the table\n        before setting values, use table.clear().\n\n        A list of lists is expected, with as many lists as rows, and as many\n        items in each sublist as cells to be setted. None values in the list\n        will create empty cells with no cell type (but eventually a style).\n\n        Arguments:\n\n            coord -- tuple or str\n\n            values -- list of lists of python types\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n        \"\"\"\n        if coord:\n            x, y = self._translate_cell_coordinates(coord)\n        else:\n            x = y = 0\n        if y is None:\n            y = 0\n        if x is None:\n            x = 0\n        y -= 1\n        for row_values in values:\n            y += 1\n            if not row_values:\n                continue\n            row = self.get_row(y, clone=True)\n            repeated = row.repeated or 1\n            if repeated &gt;= 2:\n                row.repeated = None\n            row.set_values(\n                row_values,\n                start=x,\n                cell_type=cell_type,\n                currency=currency,\n                style=style,\n            )\n            self.set_row(y, row, clone=False)\n            self._update_width(row)\n\n    def rstrip(self, aggressive: bool = False) -&gt; None:\n        \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n        the table. Cells are empty if they contain no value or it evaluates\n        to False, and no style.\n\n        If aggressive is True, empty cells with style are removed too.\n\n        Argument:\n\n            aggressive -- bool\n        \"\"\"\n        # Step 1: remove empty rows below the table\n        for row in reversed(self._get_rows()):\n            if row.is_empty(aggressive=aggressive):\n                row.parent.delete(row)  # type: ignore\n            else:\n                break\n        # Step 2: rstrip remaining rows\n        max_width = 0\n        for row in self._get_rows():\n            row.rstrip(aggressive=aggressive)\n            # keep count of the biggest row\n            max_width = max(max_width, row.width)\n        # raz cache of rows\n        self._indexes[\"_tmap\"] = {}\n        # Step 3: trim columns to match max_width\n        columns = self._get_columns()\n        repeated_cols = self.xpath(\"table:table-column/@table:number-columns-repeated\")\n        if not isinstance(repeated_cols, list):\n            raise TypeError\n        unrepeated = len(columns) - len(repeated_cols)\n        column_width = sum(int(r) for r in repeated_cols) + unrepeated  # type: ignore\n        diff = column_width - max_width\n        if diff &gt; 0:\n            for column in reversed(columns):\n                repeated = column.repeated or 1\n                repeated = repeated - diff\n                if repeated &gt; 0:\n                    column.repeated = repeated\n                    break\n                else:\n                    column.parent.delete(column)\n                    diff = -repeated\n                    if diff == 0:\n                        break\n        # raz cache of columns\n        self._indexes[\"_cmap\"] = {}\n        self._compute_table_cache()\n\n    def optimize_width(self) -&gt; None:\n        \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n        the table. Keep repeated styles of empty cells but minimize row width.\n        \"\"\"\n        self._optimize_width_trim_rows()\n        width = self._optimize_width_length()\n        self._optimize_width_rstrip_rows(width)\n        self._optimize_width_adapt_columns(width)\n\n    def _optimize_width_trim_rows(self) -&gt; None:\n        count = -1  # to keep one empty row\n        for row in reversed(self._get_rows()):\n            if row.is_empty(aggressive=False):\n                count += 1\n            else:\n                break\n        if count &gt; 0:\n            for row in reversed(self._get_rows()):\n                row.parent.delete(row)  # type: ignore\n                count -= 1\n                if count &lt;= 0:\n                    break\n        try:\n            last_row = self._get_rows()[-1]\n            last_row._set_repeated(None)\n        except IndexError:\n            pass\n        # raz cache of rows\n        self._indexes[\"_tmap\"] = {}\n\n    def _optimize_width_length(self) -&gt; int:\n        return max(row.minimized_width() for row in self._get_rows())\n\n    def _optimize_width_rstrip_rows(self, width: int) -&gt; None:\n        for row in self._get_rows():\n            row.force_width(width)\n\n    def _optimize_width_adapt_columns(self, width: int) -&gt; None:\n        # trim columns to match minimal_width\n        columns = self._get_columns()\n        repeated_cols = self.xpath(\"table:table-column/@table:number-columns-repeated\")\n        if not isinstance(repeated_cols, list):\n            raise TypeError\n        unrepeated = len(columns) - len(repeated_cols)\n        column_width = sum(int(r) for r in repeated_cols) + unrepeated  # type: ignore\n        diff = column_width - width\n        if diff &gt; 0:\n            for column in reversed(columns):\n                repeated = column.repeated or 1\n                repeated = repeated - diff\n                if repeated &gt; 0:\n                    column.repeated = repeated\n                    break\n                else:\n                    column.parent.delete(column)\n                    diff = -repeated\n                    if diff == 0:\n                        break\n        # raz cache of columns\n        self._indexes[\"_cmap\"] = {}\n        self._compute_table_cache()\n\n    def transpose(self, coord: tuple | list | str | None = None) -&gt; None:  # noqa: C901\n        \"\"\"Swap *in-place* rows and columns of the table.\n\n        If 'coord' is not None, apply transpose only to the area defined by the\n        coordinates. Beware, if area is not square, some cells mays be over\n        written during the process.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of area\n\n            start -- int or str\n        \"\"\"\n        data = []\n        if coord is None:\n            for row in self.traverse():\n                data.append(list(row.traverse()))\n            transposed_data = zip_longest(*data)\n            self.clear()\n            # new_rows = []\n            for row_cells in transposed_data:\n                if not isiterable(row_cells):\n                    row_cells = (row_cells,)\n                row = Row()\n                row.extend_cells(row_cells)\n                self.append_row(row, clone=False)\n            self._compute_table_cache()\n        else:\n            x, y, z, t = self._translate_table_coordinates(coord)\n            if x is None:\n                x = 0\n            else:\n                x = min(x, self.width - 1)\n            if z is None:\n                z = self.width - 1\n            else:\n                z = min(z, self.width - 1)\n            if y is None:\n                y = 0\n            else:\n                y = min(y, self.height - 1)\n            if t is None:\n                t = self.height - 1\n            else:\n                t = min(t, self.height - 1)\n            for row in self.traverse(start=y, end=t):\n                data.append(list(row.traverse(start=x, end=z)))\n            transposed_data = zip_longest(*data)\n            # clear locally\n            w = z - x + 1\n            h = t - y + 1\n            if w != h:\n                nones = [[None] * w for i in range(h)]\n                self.set_values(nones, coord=(x, y, z, t))\n            # put transposed\n            filtered_data: list[tuple[Cell]] = []\n            for row_cells in transposed_data:\n                if isinstance(row_cells, (list, tuple)):\n                    filtered_data.append(row_cells)\n                else:\n                    filtered_data.append((row_cells,))\n            self.set_cells(filtered_data, (x, y, x + h - 1, y + w - 1))\n            self._compute_table_cache()\n\n    def is_empty(self, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return whether every cell in the table has no value or the value\n        evaluates to False (empty string), and no style.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            aggressive -- bool\n        \"\"\"\n        return all(row.is_empty(aggressive=aggressive) for row in self._get_rows())\n\n    #\n    # Rows\n    #\n\n    def _get_rows(self) -&gt; list[Row]:\n        return self.get_elements(_xpath_row)  # type: ignore\n\n    def traverse(  # noqa: C901\n        self,\n        start: int | None = None,\n        end: int | None = None,\n    ) -&gt; Iterator[Row]:\n        \"\"\"Yield as many row elements as expected rows in the table, i.e.\n        expand repetitions by returning the same row as many times as\n        necessary.\n\n            Arguments:\n\n                start -- int\n\n                end -- int\n\n        Copies are returned, use set_row() to push them back.\n        \"\"\"\n        idx = -1\n        before = -1\n        y = 0\n        if start is None and end is None:\n            for juska in self._tmap:\n                idx += 1\n                if idx in self._indexes[\"_tmap\"]:\n                    row = self._indexes[\"_tmap\"][idx]\n                else:\n                    row = self._get_element_idx2(_xpath_row_idx, idx)\n                    self._indexes[\"_tmap\"][idx] = row\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    # Return a copy without the now obsolete repetition\n                    row = row.clone\n                    row.y = y\n                    y += 1\n                    if repeated &gt; 1:\n                        row.repeated = None\n                    yield row\n        else:\n            if start is None:\n                start = 0\n            start = max(0, start)\n            if end is None:\n                try:\n                    end = self._tmap[-1]\n                except Exception:\n                    end = -1\n            start_map = find_odf_idx(self._tmap, start)\n            if start_map is None:\n                return\n            if start_map &gt; 0:\n                before = self._tmap[start_map - 1]\n            idx = start_map - 1\n            before = start - 1\n            y = start\n            for juska in self._tmap[start_map:]:\n                idx += 1\n                if idx in self._indexes[\"_tmap\"]:\n                    row = self._indexes[\"_tmap\"][idx]\n                else:\n                    row = self._get_element_idx2(_xpath_row_idx, idx)\n                    self._indexes[\"_tmap\"][idx] = row\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    if y &lt;= end:\n                        row = row.clone\n                        row.y = y\n                        y += 1\n                        if repeated &gt; 1 or (y == start and start &gt; 0):\n                            row.repeated = None\n                        yield row\n\n    def get_rows(\n        self,\n        coord: tuple | list | str | None = None,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Row]:\n        \"\"\"Get the list of rows matching the criteria.\n\n        Filter by coordinates will parse the area defined by the coordinates.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of rows\n\n            content -- str regex\n\n            style -- str\n\n        Return: list of rows\n        \"\"\"\n        if coord:\n            _x, y, _z, t = self._translate_table_coordinates(coord)\n        else:\n            y = t = None\n        # fixme : not clones ?\n        if not content and not style:\n            return list(self.traverse(start=y, end=t))\n        rows = []\n        for row in self.traverse(start=y, end=t):\n            if content and not row.match(content):\n                continue\n            if style and style != row.style:\n                continue\n            rows.append(row)\n        return rows\n\n    @property\n    def rows(self) -&gt; list[Row]:\n        \"\"\"Get the list of all rows.\n\n        Return: list of rows\n        \"\"\"\n        # fixme : not clones ?\n        return list(self.traverse())\n\n    def _get_row2(self, y: int, clone: bool = True, create: bool = True) -&gt; Row:\n        if y &gt;= self.height:\n            if create:\n                return Row()\n            raise ValueError(\"Row not found\")\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError(\"Row not found\")\n        if clone:\n            return row.clone\n        return row\n\n    def _get_row2_base(self, y: int) -&gt; Row | None:\n        idx = find_odf_idx(self._tmap, y)\n        if idx is not None:\n            if idx in self._indexes[\"_tmap\"]:\n                row = self._indexes[\"_tmap\"][idx]\n            else:\n                row = self._get_element_idx2(_xpath_row_idx, idx)\n                self._indexes[\"_tmap\"][idx] = row\n            return row\n        return None\n\n    def get_row(self, y: int | str, clone: bool = True, create: bool = True) -&gt; Row:\n        \"\"\"Get the row at the given \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        A copy is returned, use set_cell() to push it back.\n\n        Arguments:\n\n            y -- int or str\n\n        Return: Row\n        \"\"\"\n        # fixme : keep repeat ? maybe an option to functions : \"raw=False\"\n        y = self._translate_y_from_any(y)\n        row = self._get_row2(y, clone=clone, create=create)\n        if row is None:\n            raise ValueError(\"Row not found\")\n        row.y = y\n        return row\n\n    def set_row(self, y: int | str, row: Row | None = None, clone: bool = True) -&gt; Row:\n        \"\"\"Replace the row at the given position with the new one. Repetions of\n        the old row will be adjusted.\n\n        If row is None, a new empty row is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n\n            row -- Row\n\n        returns the row, with updated row.y\n        \"\"\"\n        if row is None:\n            row = Row()\n            repeated = 1\n            clone = False\n        else:\n            repeated = row.repeated or 1\n        y = self._translate_y_from_any(y)\n        row.y = y\n        # Outside the defined table ?\n        diff = y - self.height\n        if diff == 0:\n            row_back = self.append_row(row, _repeated=repeated, clone=clone)\n        elif diff &gt; 0:\n            self.append_row(Row(repeated=diff), _repeated=diff, clone=clone)\n            row_back = self.append_row(row, _repeated=repeated, clone=clone)\n        else:\n            # Inside the defined table\n            row_back = set_item_in_vault(  # type: ignore\n                y, row, self, _xpath_row_idx, \"_tmap\", clone=clone\n            )\n        # print self.serialize(True)\n        # Update width if necessary\n        self._update_width(row_back)\n        return row_back\n\n    def insert_row(\n        self, y: str | int, row: Row | None = None, clone: bool = True\n    ) -&gt; Row:\n        \"\"\"Insert the row before the given \"y\" position. If no row is given,\n        an empty one is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        If row is None, a new empty row is created.\n\n        Arguments:\n\n            y -- int or str\n\n            row -- Row\n\n        returns the row, with updated row.y\n        \"\"\"\n        if row is None:\n            row = Row()\n            clone = False\n        y = self._translate_y_from_any(y)\n        diff = y - self.height\n        if diff &lt; 0:\n            row_back = insert_item_in_vault(y, row, self, _xpath_row_idx, \"_tmap\")\n        elif diff == 0:\n            row_back = self.append_row(row, clone=clone)\n        else:\n            self.append_row(Row(repeated=diff), _repeated=diff, clone=False)\n            row_back = self.append_row(row, clone=clone)\n        row_back.y = y  # type: ignore\n        # Update width if necessary\n        self._update_width(row_back)  # type: ignore\n        return row_back  # type: ignore\n\n    def extend_rows(self, rows: list[Row] | None = None) -&gt; None:\n        \"\"\"Append a list of rows at the end of the table.\n\n        Arguments:\n\n            rows -- list of Row\n        \"\"\"\n        if rows is None:\n            rows = []\n        self.extend(rows)\n        self._compute_table_cache()\n        # Update width if necessary\n        width = self.width\n        for row in self.traverse():\n            if row.width &gt; width:\n                width = row.width\n        diff = width - self.width\n        if diff &gt; 0:\n            self.append_column(Column(repeated=diff))\n\n    def append_row(\n        self,\n        row: Row | None = None,\n        clone: bool = True,\n        _repeated: int | None = None,\n    ) -&gt; Row:\n        \"\"\"Append the row at the end of the table. If no row is given, an\n        empty one is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Note the columns are automatically created when the first row is\n        inserted in an empty table. So better insert a filled row.\n\n        Arguments:\n\n            row -- Row\n\n            _repeated -- (optional), repeated value of the row\n\n        returns the row, with updated row.y\n        \"\"\"\n        if row is None:\n            row = Row()\n            _repeated = 1\n        elif clone:\n            row = row.clone\n        # Appending a repeated row accepted\n        # Do not insert next to the last row because it could be in a group\n        self._append(row)\n        if _repeated is None:\n            _repeated = row.repeated or 1\n        self._tmap = insert_map_once(self._tmap, len(self._tmap), _repeated)\n        row.y = self.height - 1\n        # Initialize columns\n        if not self._get_columns():\n            repeated = row.width\n            self.insert(Column(repeated=repeated), position=0)\n            self._compute_table_cache()\n        # Update width if necessary\n        self._update_width(row)\n        return row\n\n    def delete_row(self, y: int | str) -&gt; None:\n        \"\"\"Delete the row at the given \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n        \"\"\"\n        y = self._translate_y_from_any(y)\n        # Outside the defined table\n        if y &gt;= self.height:\n            return\n        # Inside the defined table\n        delete_item_in_vault(y, self, _xpath_row_idx, \"_tmap\")\n\n    def get_row_values(\n        self,\n        y: int | str,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n    ) -&gt; list:\n        \"\"\"Shortcut to get the list of Python values for the cells of the row\n        at the given \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n        If cell_type and complete is True, replace missing values by None.\n\n        If get_type is True, returns a tuple (value, ODF type of value)\n\n        Arguments:\n\n            y -- int, str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of lists of Python types\n        \"\"\"\n        values = self.get_row(y, clone=False).get_values(\n            cell_type=cell_type, complete=complete, get_type=get_type\n        )\n        # complete row to match column width\n        if complete:\n            if get_type:\n                values.extend([(None, None)] * (self.width - len(values)))\n            else:\n                values.extend([None] * (self.width - len(values)))\n        return values\n\n    def set_row_values(\n        self,\n        y: int | str,\n        values: list,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; Row:\n        \"\"\"Shortcut to set the values of *all* cells of the row at the given\n        \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n\n            values -- list of Python types\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n\n        returns the row, with updated row.y\n        \"\"\"\n        row = Row()  # needed if clones rows\n        row.set_values(values, style=style, cell_type=cell_type, currency=currency)\n        return self.set_row(y, row)  # needed if clones rows\n\n    def set_row_cells(self, y: int | str, cells: list | None = None) -&gt; Row:\n        \"\"\"Shortcut to set *all* the cells of the row at the given\n        \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n\n            cells -- list of Python types\n\n            style -- str\n\n        returns the row, with updated row.y\n        \"\"\"\n        if cells is None:\n            cells = []\n        row = Row()  # needed if clones rows\n        row.extend_cells(cells)\n        return self.set_row(y, row)  # needed if clones rows\n\n    def is_row_empty(self, y: int | str, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return wether every cell in the row at the given \"y\" position has\n        no value or the value evaluates to False (empty string), and no style.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            y -- int or str\n\n            aggressive -- bool\n        \"\"\"\n        return self.get_row(y, clone=False).is_empty(aggressive=aggressive)\n\n    #\n    # Cells\n    #\n\n    def get_cells(\n        self,\n        coord: tuple | list | str | None = None,\n        cell_type: str | None = None,\n        style: str | None = None,\n        content: str | None = None,\n        flat: bool = False,\n    ) -&gt; list:\n        \"\"\"Get the cells matching the criteria. If 'coord' is None,\n        parse the whole table, else parse the area defined by 'coord'.\n\n        Filter by  cell_type = \"all\"  will retrieve cells of any\n        type, aka non empty cells.\n\n        If flat is True (default is False), the method return a single list\n        of all the values, else a list of lists of cells.\n\n        if cell_type, style and content are None, get_cells() will return\n        the exact number of cells of the area, including empty cells.\n\n        Arguments:\n\n            coordinates -- str or tuple of int : coordinates of area\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            content -- str regex\n\n            style -- str\n\n            flat -- boolean\n\n        Return: list of list of Cell\n        \"\"\"\n        if coord:\n            x, y, z, t = self._translate_table_coordinates(coord)\n        else:\n            x = y = z = t = None\n        if flat:\n            cells: list[Cell] = []\n            for row in self.traverse(start=y, end=t):\n                row_cells = row.get_cells(\n                    coord=(x, z),\n                    cell_type=cell_type,\n                    style=style,\n                    content=content,\n                )\n                cells.extend(row_cells)\n            return cells\n        else:\n            lcells: list[list[Cell]] = []\n            for row in self.traverse(start=y, end=t):\n                row_cells = row.get_cells(\n                    coord=(x, z),\n                    cell_type=cell_type,\n                    style=style,\n                    content=content,\n                )\n                lcells.append(row_cells)\n            return lcells\n\n    @property\n    def cells(self) -&gt; list:\n        \"\"\"Get all cells of the table.\n\n        Return: list of list of Cell\n        \"\"\"\n        lcells: list[list[Cell]] = []\n        for row in self.traverse():\n            lcells.append(row.cells)\n        return lcells\n\n    def get_cell(\n        self,\n        coord: tuple | list | str,\n        clone: bool = True,\n        keep_repeated: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Get the cell at the given coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        A copy is returned, use ``set_cell`` to push it back.\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n        Return: Cell\n        \"\"\"\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        # Outside the defined table\n        if y &gt;= self.height:\n            cell = Cell()\n        else:\n            # Inside the defined table\n            row = self._get_row2_base(y)\n            if row is None:\n                raise ValueError\n            read_cell = row.get_cell(x, clone=clone)\n            if read_cell is None:\n                raise ValueError\n            cell = read_cell\n            if not keep_repeated:\n                repeated = cell.repeated or 1\n                if repeated &gt;= 2:\n                    cell.repeated = None\n        cell.x = x\n        cell.y = y\n        return cell\n\n    def get_value(\n        self,\n        coord: tuple | list | str,\n        get_type: bool = False,\n    ) -&gt; Any:\n        \"\"\"Shortcut to get the Python value of the cell at the given\n        coordinates.\n\n        If get_type is True, returns the tuples (value, ODF type)\n\n        coord is either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\". If an Area is given, the upper\n        left position is used as coord.\n\n        Arguments:\n\n            coord -- (int, int) or str : coordinate\n\n        Return: Python type\n        \"\"\"\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        # Outside the defined table\n        if y &gt;= self.height:\n            if get_type:\n                return (None, None)\n            return None\n        else:\n            # Inside the defined table\n            row = self._get_row2_base(y)\n            if row is None:\n                raise ValueError\n            cell = row._get_cell2_base(x)\n            if cell is None:\n                if get_type:\n                    return (None, None)\n                return None\n            return cell.get_value(get_type=get_type)\n\n    def set_cell(\n        self,\n        coord: tuple | list | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Replace a cell of the table at the given coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Arguments:\n\n            coord -- (int, int) or str : coordinate\n\n            cell -- Cell\n\n        return the cell, with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        cell.x = x\n        cell.y = y\n        if y &gt;= self.height:\n            row = Row()\n            cell_back = row.set_cell(x, cell, clone=clone)\n            self.set_row(y, row, clone=False)\n        else:\n            row_read = self._get_row2_base(y)\n            if row_read is None:\n                raise ValueError\n            row = row_read\n            row.y = y\n            repeated = row.repeated or 1\n            if repeated &gt; 1:\n                row = row.clone\n                row.repeated = None\n                cell_back = row.set_cell(x, cell, clone=clone)\n                self.set_row(y, row, clone=False)\n            else:\n                cell_back = row.set_cell(x, cell, clone=clone)\n                # Update width if necessary, since we don't use set_row\n                self._update_width(row)\n        return cell_back\n\n    def set_cells(\n        self,\n        cells: list[list[Cell]] | list[tuple[Cell]],\n        coord: tuple | list | str | None = None,\n        clone: bool = True,\n    ) -&gt; None:\n        \"\"\"Set the cells in the table, from the 'coord' position.\n\n        'coord' is the coordinate of the upper left cell to be modified by\n        values. If 'coord' is None, default to the position (0,0) (\"A1\").\n        If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n        area is used as coordinate.\n\n        The table is *not* cleared before the operation, to reset the table\n        before setting cells, use table.clear().\n\n        A list of lists is expected, with as many lists as rows to be set, and\n        as many cell in each sublist as cells to be setted in the row.\n\n        Arguments:\n\n            cells -- list of list of cells\n\n            coord -- tuple or str\n\n            values -- list of lists of python types\n        \"\"\"\n        if coord:\n            x, y = self._translate_cell_coordinates(coord)\n        else:\n            x = y = 0\n        if y is None:\n            y = 0\n        if x is None:\n            x = 0\n        y -= 1\n        for row_cells in cells:\n            y += 1\n            if not row_cells:\n                continue\n            row = self.get_row(y, clone=True)\n            repeated = row.repeated or 1\n            if repeated &gt;= 2:\n                row.repeated = None\n            row.set_cells(row_cells, start=x, clone=clone)\n            self.set_row(y, row, clone=False)\n            self._update_width(row)\n\n    def set_value(\n        self,\n        coord: tuple | list | str,\n        value: Any,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; None:\n        \"\"\"Set the Python value of the cell at the given coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n            value -- Python type\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n\n        \"\"\"\n        self.set_cell(\n            coord,\n            Cell(value, cell_type=cell_type, currency=currency, style=style),\n            clone=False,\n        )\n\n    def set_cell_image(\n        self,\n        coord: tuple | list | str,\n        image_frame: Frame,\n        doc_type: str | None = None,\n    ) -&gt; None:\n        \"\"\"Do all the magic to display an image in the cell at the given\n        coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        The frame element must contain the expected image position and\n        dimensions.\n\n        DrawImage insertion depends on the document type, so the type must be\n        provided or the table element must be already attached to a document.\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n            image_frame -- Frame including an image\n\n            doc_type -- 'spreadsheet' or 'text'\n        \"\"\"\n        # Test document type\n        if doc_type is None:\n            body = self.document_body\n            if body is None:\n                raise ValueError(\"document type not found\")\n            doc_type = {\"office:spreadsheet\": \"spreadsheet\", \"office:text\": \"text\"}.get(\n                body.tag\n            )\n            if doc_type is None:\n                raise ValueError(\"document type not supported for images\")\n        # We need the end address of the image\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        cell = self.get_cell((x, y))\n        image_frame = image_frame.clone  # type: ignore\n        # Remove any previous paragraph, frame, etc.\n        for child in cell.children:\n            cell.delete(child)\n        # Now it all depends on the document type\n        if doc_type == \"spreadsheet\":\n            image_frame.anchor_type = \"char\"\n            # The frame needs end coordinates\n            width, height = image_frame.size\n            image_frame.set_attribute(\"table:end-x\", width)\n            image_frame.set_attribute(\"table:end-y\", height)\n            # FIXME what happens when the address changes?\n            address = f\"{self.name}.{digit_to_alpha(x)}{y + 1}\"\n            image_frame.set_attribute(\"table:end-cell-address\", address)\n            # The frame is directly in the cell\n            cell.append(image_frame)\n        elif doc_type == \"text\":\n            # The frame must be in a paragraph\n            cell.set_value(\"\")\n            paragraph = cell.get_element(\"text:p\")\n            if paragraph is None:\n                raise ValueError\n            paragraph.append(image_frame)\n        self.set_cell(coord, cell)\n\n    def insert_cell(\n        self,\n        coord: tuple | list | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Insert the given cell at the given coordinates. If no cell is\n        given, an empty one is created.\n\n        Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Cells on the right are shifted. Other rows remain untouched.\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n            cell -- Cell\n\n        returns the cell with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        if clone:\n            cell = cell.clone\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        row = self._get_row2(y, clone=True)\n        row.y = y\n        row.repeated = None\n        cell_back = row.insert_cell(x, cell, clone=False)\n        self.set_row(y, row, clone=False)\n        # Update width if necessary\n        self._update_width(row)\n        return cell_back\n\n    def append_cell(\n        self,\n        y: int | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Append the given cell at the \"y\" coordinate. Repeated cells are\n        accepted. If no cell is given, an empty one is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Other rows remain untouched.\n\n        Arguments:\n\n            y -- int or str\n\n            cell -- Cell\n\n        returns the cell with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        if clone:\n            cell = cell.clone\n        y = self._translate_y_from_any(y)\n        row = self._get_row2(y)\n        row.y = y\n        cell_back = row.append_cell(cell, clone=False)\n        self.set_row(y, row)\n        # Update width if necessary\n        self._update_width(row)\n        return cell_back\n\n    def delete_cell(self, coord: tuple | list | str) -&gt; None:\n        \"\"\"Delete the cell at the given coordinates, so that next cells are\n        shifted to the left.\n\n        Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Use set_value() for erasing value.\n\n        Arguments:\n\n            coord -- (int, int) or str\n        \"\"\"\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        # Outside the defined table\n        if y &gt;= self.height:\n            return\n        # Inside the defined table\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError\n        row.delete_cell(x)\n        # self.set_row(y, row)\n\n    # Columns\n\n    def _get_columns(self) -&gt; list:\n        return self.get_elements(_xpath_column)\n\n    def traverse_columns(  # noqa: C901\n        self,\n        start: int | None = None,\n        end: int | None = None,\n    ) -&gt; Iterator[Column]:\n        \"\"\"Yield as many column elements as expected columns in the table,\n        i.e. expand repetitions by returning the same column as many times as\n        necessary.\n\n            Arguments:\n\n                start -- int\n\n                end -- int\n\n        Copies are returned, use set_column() to push them back.\n        \"\"\"\n        idx = -1\n        before = -1\n        x = 0\n        if start is None and end is None:\n            for juska in self._cmap:\n                idx += 1\n                if idx in self._indexes[\"_cmap\"]:\n                    column = self._indexes[\"_cmap\"][idx]\n                else:\n                    column = self._get_element_idx2(_xpath_column_idx, idx)\n                    self._indexes[\"_cmap\"][idx] = column\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    # Return a copy without the now obsolete repetition\n                    column = column.clone\n                    column.x = x\n                    x += 1\n                    if repeated &gt; 1:\n                        column.repeated = None\n                    yield column\n        else:\n            if start is None:\n                start = 0\n            start = max(0, start)\n            if end is None:\n                try:\n                    end = self._cmap[-1]\n                except Exception:\n                    end = -1\n            start_map = find_odf_idx(self._cmap, start)\n            if start_map is None:\n                return\n            if start_map &gt; 0:\n                before = self._cmap[start_map - 1]\n            idx = start_map - 1\n            before = start - 1\n            x = start\n            for juska in self._cmap[start_map:]:\n                idx += 1\n                if idx in self._indexes[\"_cmap\"]:\n                    column = self._indexes[\"_cmap\"][idx]\n                else:\n                    column = self._get_element_idx2(_xpath_column_idx, idx)\n                    self._indexes[\"_cmap\"][idx] = column\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    if x &lt;= end:\n                        column = column.clone\n                        column.x = x\n                        x += 1\n                        if repeated &gt; 1 or (x == start and start &gt; 0):\n                            column.repeated = None\n                        yield column\n\n    def get_columns(\n        self,\n        coord: tuple | list | str | None = None,\n        style: str | None = None,\n    ) -&gt; list[Column]:\n        \"\"\"Get the list of columns matching the criteria.\n\n        Copies are returned, use set_column() to push them back.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of columns\n\n            style -- str\n\n        Return: list of columns\n        \"\"\"\n        if coord:\n            x, _y, _z, t = self._translate_column_coordinates(coord)\n        else:\n            x = t = None\n        if not style:\n            return list(self.traverse_columns(start=x, end=t))\n        columns = []\n        for column in self.traverse_columns(start=x, end=t):\n            if style != column.style:\n                continue\n            columns.append(column)\n        return columns\n\n    def _get_column2(self, x: int) -&gt; Column | None:\n        # Outside the defined table\n        if x &gt;= self.width:\n            return Column()\n        # Inside the defined table\n        odf_idx = find_odf_idx(self._cmap, x)\n        if odf_idx is not None:\n            column = self._get_element_idx2(_xpath_column_idx, odf_idx)\n            if column is None:\n                return None\n            # fixme : no clone here =&gt; change doc and unit tests\n            return column.clone  # type: ignore\n            # return row\n        return None\n\n    @property\n    def columns(self) -&gt; list[Column]:\n        \"\"\"Get the list of all columns matching the criteria.\n\n        Copies are returned, use set_column() to push them back.\n\n        Return: list of columns\n        \"\"\"\n        return list(self.traverse_columns())\n\n    def get_column(self, x: int | str) -&gt; Column:\n        \"\"\"Get the column at the given \"x\" position.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        A copy is returned, use set_column() to push it back.\n\n        Arguments:\n\n            x -- int or str\n\n        Return: Column\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        column = self._get_column2(x)\n        if column is None:\n            raise ValueError\n        column.x = x\n        return column\n\n    def set_column(\n        self,\n        x: int | str,\n        column: Column | None = None,\n    ) -&gt; Column:\n        \"\"\"Replace the column at the given \"x\" position.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            x -- int or str\n\n            column -- Column\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        if column is None:\n            column = Column()\n            repeated = 1\n        else:\n            repeated = column.repeated or 1\n        column.x = x\n        # Outside the defined table ?\n        diff = x - self.width\n        if diff == 0:\n            column_back = self.append_column(column, _repeated=repeated)\n        elif diff &gt; 0:\n            self.append_column(Column(repeated=diff), _repeated=diff)\n            column_back = self.append_column(column, _repeated=repeated)\n        else:\n            # Inside the defined table\n            column_back = set_item_in_vault(  # type: ignore\n                x, column, self, _xpath_column_idx, \"_cmap\"\n            )\n        return column_back\n\n    def insert_column(\n        self,\n        x: int | str,\n        column: Column | None = None,\n    ) -&gt; Column:\n        \"\"\"Insert the column before the given \"x\" position. If no column is\n        given, an empty one is created.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            x -- int or str\n\n            column -- Column\n        \"\"\"\n        if column is None:\n            column = Column()\n        x = self._translate_x_from_any(x)\n        diff = x - self.width\n        if diff &lt; 0:\n            column_back = insert_item_in_vault(\n                x, column, self, _xpath_column_idx, \"_cmap\"\n            )\n        elif diff == 0:\n            column_back = self.append_column(column.clone)\n        else:\n            self.append_column(Column(repeated=diff), _repeated=diff)\n            column_back = self.append_column(column.clone)\n        column_back.x = x  # type: ignore\n        # Repetitions are accepted\n        repeated = column.repeated or 1\n        # Update width on every row\n        for row in self._get_rows():\n            if row.width &gt; x:\n                row.insert_cell(x, Cell(repeated=repeated))\n            # Shorter rows don't need insert\n            # Longer rows shouldn't exist!\n        return column_back  # type: ignore\n\n    def append_column(\n        self,\n        column: Column | None = None,\n        _repeated: int | None = None,\n    ) -&gt; Column:\n        \"\"\"Append the column at the end of the table. If no column is given,\n        an empty one is created.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            column -- Column\n        \"\"\"\n        if column is None:\n            column = Column()\n        else:\n            column = column.clone\n        if not self._cmap:\n            position = 0\n        else:\n            odf_idx = len(self._cmap) - 1\n            last_column = self._get_element_idx2(_xpath_column_idx, odf_idx)\n            if last_column is None:\n                raise ValueError\n            position = self.index(last_column) + 1\n        column.x = self.width\n        self.insert(column, position=position)\n        # Repetitions are accepted\n        if _repeated is None:\n            _repeated = column.repeated or 1\n        self._cmap = insert_map_once(self._cmap, len(self._cmap), _repeated)\n        # No need to update row widths\n        return column\n\n    def delete_column(self, x: int | str) -&gt; None:\n        \"\"\"Delete the column at the given position. ODF columns don't contain\n        cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            x -- int or str\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        # Outside the defined table\n        if x &gt;= self.width:\n            return\n        # Inside the defined table\n        delete_item_in_vault(x, self, _xpath_column_idx, \"_cmap\")\n        # Update width\n        width = self.width\n        for row in self._get_rows():\n            if row.width &gt;= width:\n                row.delete_cell(x)\n\n    def get_column_cells(  # noqa: C901\n        self,\n        x: int | str,\n        style: str | None = None,\n        content: str | None = None,\n        cell_type: str | None = None,\n        complete: bool = False,\n    ) -&gt; list[Cell | None]:\n        \"\"\"Get the list of cells at the given position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n\n        If complete is True, replace missing values by None.\n\n        Arguments:\n\n            x -- int or str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            content -- str regex\n\n            style -- str\n\n            complete -- boolean\n\n        Return: list of Cell\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        if cell_type:\n            cell_type = cell_type.lower().strip()\n        cells: list[Cell | None] = []\n        if not style and not content and not cell_type:\n            for row in self.traverse():\n                cells.append(row.get_cell(x, clone=True))\n            return cells\n        for row in self.traverse():\n            cell = row.get_cell(x, clone=True)\n            if cell is None:\n                raise ValueError\n            # Filter the cells by cell_type\n            if cell_type:\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    if complete:\n                        cells.append(None)\n                    continue\n            # Filter the cells with the regex\n            if content and not cell.match(content):\n                if complete:\n                    cells.append(None)\n                continue\n            # Filter the cells with the style\n            if style and style != cell.style:\n                if complete:\n                    cells.append(None)\n                continue\n            cells.append(cell)\n        return cells\n\n    def get_column_values(\n        self,\n        x: int | str,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n    ) -&gt; list[Any]:\n        \"\"\"Shortcut to get the list of Python values for the cells at the\n        given position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n        If cell_type and complete is True, replace missing values by None.\n\n        If get_type is True, returns a tuple (value, ODF type of value)\n\n        Arguments:\n\n            x -- int or str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of Python types\n        \"\"\"\n        cells = self.get_column_cells(\n            x, style=None, content=None, cell_type=cell_type, complete=complete\n        )\n        values: list[Any] = []\n        for cell in cells:\n            if cell is None:\n                if complete:\n                    if get_type:\n                        values.append((None, None))\n                    else:\n                        values.append(None)\n                continue\n            if cell_type:\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    if complete:\n                        if get_type:\n                            values.append((None, None))\n                        else:\n                            values.append(None)\n                    continue\n            values.append(cell.get_value(get_type=get_type))\n        return values\n\n    def set_column_cells(self, x: int | str, cells: list[Cell]) -&gt; None:\n        \"\"\"Shortcut to set the list of cells at the given position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        The list must have the same length than the table height.\n\n        Arguments:\n\n            x -- int or str\n\n            cells -- list of Cell\n        \"\"\"\n        height = self.height\n        if len(cells) != height:\n            raise ValueError(f\"col mismatch: {height} cells expected\")\n        cells_iterator = iter(cells)\n        for y, row in enumerate(self.traverse()):\n            row.set_cell(x, next(cells_iterator))\n            self.set_row(y, row)\n\n    def set_column_values(\n        self,\n        x: int | str,\n        values: list,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the list of Python values of cells at the given\n        position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        The list must have the same length than the table height.\n\n        Arguments:\n\n            x -- int or str\n\n            values -- list of Python types\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n        \"\"\"\n        cells = [\n            Cell(value, cell_type=cell_type, currency=currency, style=style)\n            for value in values\n        ]\n        self.set_column_cells(x, cells)\n\n    def is_column_empty(self, x: int | str, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return wether every cell in the column at \"x\" position has no value\n        or the value evaluates to False (empty string), and no style.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Return: bool\n        \"\"\"\n        for cell in self.get_column_cells(x):\n            if cell is None:\n                continue\n            if not cell.is_empty(aggressive=aggressive):\n                return False\n        return True\n\n    # Named Range\n\n    def get_named_ranges(  # type: ignore\n        self,\n        table_name: str | list[str] | None = None,\n    ) -&gt; list[NamedRange]:\n        \"\"\"Returns the list of available Name Ranges of the spreadsheet. If\n        table_name is provided, limits the search to these tables.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            table_names -- str or list of str, names of tables\n\n        Return : list of table_range\n        \"\"\"\n        body = self.document_body\n        if not body:\n            return []\n        all_named_ranges = body.get_named_ranges()\n        if not table_name:\n            return all_named_ranges  # type:ignore\n        filter_ = []\n        if isinstance(table_name, str):\n            filter_.append(table_name)\n        elif isiterable(table_name):\n            filter_.extend(table_name)\n        else:\n            raise ValueError(\n                f\"table_name must be string or Iterable, not {type(table_name)}\"\n            )\n        return [\n            nr for nr in all_named_ranges if nr.table_name in filter_  # type:ignore\n        ]\n\n    def get_named_range(self, name: str) -&gt; NamedRange:\n        \"\"\"Returns the Name Ranges of the specified name. If\n        table_name is provided, limits the search to these tables.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            name -- str, name of the named range object\n\n        Return : NamedRange\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document\")\n        return body.get_named_range(name)  # type: ignore\n\n    def set_named_range(\n        self,\n        name: str,\n        crange: str | tuple | list,\n        table_name: str | None = None,\n        usage: str | None = None,\n    ) -&gt; None:\n        \"\"\"Create a Named Range element and insert it in the document.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            name -- str, name of the named range\n\n            crange -- str or tuple of int, cell or area coordinate\n\n            table_name -- str, name of the table\n\n            uage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document\")\n        if not name:\n            raise ValueError(\"Name required.\")\n        if table_name is None:\n            table_name = self.name\n        named_range = NamedRange(name, crange, table_name, usage)\n        body.append_named_range(named_range)\n\n    def delete_named_range(self, name: str) -&gt; None:\n        \"\"\"Delete the Named Range of specified name from the spreadsheet.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        name = name.strip()\n        if not name:\n            raise ValueError(\"Name required.\")\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        body.delete_named_range(name)\n\n    #\n    # Cell span\n    #\n\n    def set_span(  # noqa: C901\n        self,\n        area: str | tuple | list,\n        merge: bool = False,\n    ) -&gt; bool:\n        \"\"\"Create a Cell Span : span the first cell of the area on several\n        columns and/or rows.\n        If merge is True, replace text of the cell by the concatenation of\n        existing text in covered cells.\n        Beware : if merge is True, old text is changed, if merge is False\n        (the default), old text in coverd cells is still present but not\n        displayed by most GUI.\n\n        If the area defines only one cell, the set span will do nothing.\n        It is not allowed to apply set span to an area whose one cell already\n        belongs to previous cell span.\n\n        Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n        be provided as an alpha numeric value like \"A1:B2' or a tuple like\n        (0, 0, 1, 1) or (0, 0).\n\n        Arguments:\n\n            area -- str or tuple of int, cell or area coordinate\n\n            merge -- boolean\n        \"\"\"\n        # get area\n        digits = convert_coordinates(area)\n        if len(digits) == 4:\n            x, y, z, t = digits\n        else:\n            x, y = digits\n            z, t = digits\n        start = x, y\n        end = z, t\n        if start == end:\n            # one cell : do nothing\n            return False\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        if z is None:\n            raise ValueError\n        if t is None:\n            raise ValueError\n        # check for previous span\n        good = True\n        # Check boundaries and empty cells : need to crate non existent cells\n        # so don't use get_cells directly, but get_cell\n        cells = []\n        for yy in range(y, t + 1):\n            row_cells = []\n            for xx in range(x, z + 1):\n                row_cells.append(\n                    self.get_cell((xx, yy), clone=True, keep_repeated=False)\n                )\n            cells.append(row_cells)\n        for row in cells:\n            for cell in row:\n                if cell.is_spanned():\n                    good = False\n                    break\n            if not good:\n                break\n        if not good:\n            return False\n        # Check boundaries\n        # if z &gt;= self.width or t &gt;= self.height:\n        #    self.set_cell(coord = end)\n        #    print area, z, t\n        #    cells = self.get_cells((x, y, z, t))\n        #    print cells\n        # do it:\n        if merge:\n            val_list = []\n            for row in cells:\n                for cell in row:\n                    if cell.is_empty(aggressive=True):\n                        continue\n                    val = cell.get_value()\n                    if val is not None:\n                        if isinstance(val, str):\n                            val.strip()\n                        if val != \"\":\n                            val_list.append(val)\n                        cell.clear()\n            if val_list:\n                if len(val_list) == 1:\n                    cells[0][0].set_value(val_list[0])\n                else:\n                    value = \" \".join([str(v) for v in val_list if v])\n                    cells[0][0].set_value(value)\n        cols = z - x + 1\n        cells[0][0].set_attribute(\"table:number-columns-spanned\", str(cols))\n        rows = t - y + 1\n        cells[0][0].set_attribute(\"table:number-rows-spanned\", str(rows))\n        for cell in cells[0][1:]:\n            cell.tag = \"table:covered-table-cell\"\n        for row in cells[1:]:\n            for cell in row:\n                cell.tag = \"table:covered-table-cell\"\n        # replace cells in table\n        self.set_cells(cells, coord=start, clone=False)\n        return True\n\n    def del_span(self, area: str | tuple | list) -&gt; bool:\n        \"\"\"Delete a Cell Span. 'area' is the cell coordiante of the upper left\n        cell of the spanned area.\n\n        Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n        be provided as an alpha numeric value like \"A1:B2' or a tuple like\n        (0, 0, 1, 1) or (0, 0). If an area is provided, the upper left cell\n        is used.\n\n        Arguments:\n\n            area -- str or tuple of int, cell or area coordinate\n        \"\"\"\n        # get area\n        digits = convert_coordinates(area)\n        if len(digits) == 4:\n            x, y, _z, _t = digits\n        else:\n            x, y = digits\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        start = x, y\n        # check for previous span\n        cell0 = self.get_cell(start)\n        nb_cols = cell0.get_attribute_integer(\"table:number-columns-spanned\")\n        if nb_cols is None:\n            return False\n        nb_rows = cell0.get_attribute_integer(\"table:number-rows-spanned\")\n        if nb_rows is None:\n            return False\n        z = x + nb_cols - 1\n        t = y + nb_rows - 1\n        cells = self.get_cells((x, y, z, t))\n        cells[0][0].del_attribute(\"table:number-columns-spanned\")\n        cells[0][0].del_attribute(\"table:number-rows-spanned\")\n        for cell in cells[0][1:]:\n            cell.tag = \"table:table-cell\"\n        for row in cells[1:]:\n            for cell in row:\n                cell.tag = \"table:table-cell\"\n        # replace cells in table\n        self.set_cells(cells, coord=start, clone=False)\n        return True\n\n    # Utilities\n\n    def to_csv(\n        self,\n        path_or_file: str | Path | None = None,\n        dialect: str = \"excel\",\n    ) -&gt; Any:\n        \"\"\"Write the table as CSV in the file.\n\n        If the file is a string, it is opened as a local path. Else an\n        opened file-like is expected.\n\n        Arguments:\n\n            path_or_file -- str or file-like\n\n            dialect -- str, python csv.dialect, can be 'excel', 'unix'...\n        \"\"\"\n\n        def write_content(csv_writer: object) -&gt; None:\n            for values in self.iter_values():\n                line = []\n                for value in values:\n                    if value is None:\n                        value = \"\"\n                    if isinstance(value, str):\n                        value = value.strip()\n                    line.append(value)\n                csv_writer.writerow(line)  # type: ignore\n\n        out = StringIO(newline=\"\")\n        csv_writer = csv.writer(out, dialect=dialect)\n        write_content(csv_writer)\n        if path_or_file is None:\n            return out.getvalue()\n        path = Path(path_or_file)\n        path.write_text(out.getvalue())\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Table.cells","title":"<code>cells: list</code>  <code>property</code>","text":"<p>Get all cells of the table.</p> <p>Return: list of list of Cell</p>"},{"location":"reference.html#odfdo.Table.columns","title":"<code>columns: list[Column]</code>  <code>property</code>","text":"<p>Get the list of all columns matching the criteria.</p> <p>Copies are returned, use set_column() to push them back.</p> <p>Return: list of columns</p>"},{"location":"reference.html#odfdo.Table.height","title":"<code>height: int</code>  <code>property</code>","text":"<p>Get the current height of the table.</p> <p>Return: int</p>"},{"location":"reference.html#odfdo.Table.name","title":"<code>name: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the name of the table.</p>"},{"location":"reference.html#odfdo.Table.rows","title":"<code>rows: list[Row]</code>  <code>property</code>","text":"<p>Get the list of all rows.</p> <p>Return: list of rows</p>"},{"location":"reference.html#odfdo.Table.size","title":"<code>size: tuple[int, int]</code>  <code>property</code>","text":"<p>Shortcut to get the current width and height of the table.</p> <p>Return: (int, int)</p>"},{"location":"reference.html#odfdo.Table.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the style of the table</p> <p>Return: str</p>"},{"location":"reference.html#odfdo.Table.width","title":"<code>width: int</code>  <code>property</code>","text":"<p>Get the current width of the table, measured on columns.</p> <p>Rows may have different widths, use the Table API to ensure width consistency.</p> <p>Return: int</p>"},{"location":"reference.html#odfdo.Table.__init__","title":"<code>__init__(name=None, width=None, height=None, protected=False, protection_key=None, display=True, printable=True, print_ranges=None, style=None, **kwargs)</code>","text":"<p>Create a table element, optionally prefilled with \u201cheight\u201d rows of \u201cwidth\u201d cells each.</p> <p>If the table is to be protected, a protection key must be provided, i.e. a hash value of the password.</p> <p>If the table must not be displayed, set \u201cdisplay\u201d to False.</p> <p>If the table must not be printed, set \u201cprintable\u201d to False. The table will not be printed when it is not displayed, whatever the value of this argument.</p> <p>Ranges of cells to print can be provided as a list of cell ranges, e.g. [\u2018E6:K12\u2019, \u2018P6:R12\u2019] or directly as a raw string, e.g. \u201cE6:K12 P6:R12\u201d.</p> <p>You can access and modify the XML tree manually, but you probably want to use the API to access and alter cells. It will save you from handling repetitions and the same number of cells for each row.</p> <p>If you use both the table API and the XML API, you are on your own for ensuiring model integrity.</p> <p>Arguments:</p> <pre><code>name -- str\n\nwidth -- int\n\nheight -- int\n\nprotected -- bool\n\nprotection_key -- str\n\ndisplay -- bool\n\nprintable -- bool\n\nprint_ranges -- list\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    name: str | None = None,\n    width: int | None = None,\n    height: int | None = None,\n    protected: bool = False,\n    protection_key: str | None = None,\n    display: bool = True,\n    printable: bool = True,\n    print_ranges: list[str] | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a table element, optionally prefilled with \"height\" rows of\n    \"width\" cells each.\n\n    If the table is to be protected, a protection key must be provided,\n    i.e. a hash value of the password.\n\n    If the table must not be displayed, set \"display\" to False.\n\n    If the table must not be printed, set \"printable\" to False. The table\n    will not be printed when it is not displayed, whatever the value of\n    this argument.\n\n    Ranges of cells to print can be provided as a list of cell ranges,\n    e.g. ['E6:K12', 'P6:R12'] or directly as a raw string, e.g.\n    \"E6:K12 P6:R12\".\n\n    You can access and modify the XML tree manually, but you probably want\n    to use the API to access and alter cells. It will save you from\n    handling repetitions and the same number of cells for each row.\n\n    If you use both the table API and the XML API, you are on your own for\n    ensuiring model integrity.\n\n    Arguments:\n\n        name -- str\n\n        width -- int\n\n        height -- int\n\n        protected -- bool\n\n        protection_key -- str\n\n        display -- bool\n\n        printable -- bool\n\n        print_ranges -- list\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self._indexes = {}\n    self._indexes[\"_cmap\"] = {}\n    self._indexes[\"_tmap\"] = {}\n    if self._do_init:\n        self.name = name\n        if protected:\n            self.protected = protected\n            self.set_protection_key = protection_key\n        if not display:\n            self.displayed = display\n        if not printable:\n            self.printable = printable\n        if print_ranges:\n            self.print_ranges = print_ranges\n        if style:\n            self.style = style\n        # Prefill the table\n        if width is not None or height is not None:\n            width = width or 1\n            height = height or 1\n            # Column groups for style information\n            columns = Column(repeated=width)\n            self._append(columns)\n            for _i in range(height):\n                row = Row(width)\n                self._append(row)\n    self._compute_table_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Table.append","title":"<code>append(something)</code>","text":"<p>Dispatch .append() call to append_row() or append_column().</p> Source code in <code>odfdo/table.py</code> <pre><code>def append(self, something: Element | str) -&gt; None:\n    \"\"\"Dispatch .append() call to append_row() or append_column().\"\"\"\n    if isinstance(something, Row):\n        self.append_row(something)\n    elif isinstance(something, Column):\n        self.append_column(something)\n    else:\n        # probably still an error\n        self._append(something)\n</code></pre>"},{"location":"reference.html#odfdo.Table.append_cell","title":"<code>append_cell(y, cell=None, clone=True)</code>","text":"<p>Append the given cell at the \u201cy\u201d coordinate. Repeated cells are accepted. If no cell is given, an empty one is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Other rows remain untouched.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\ncell -- Cell\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/table.py</code> <pre><code>def append_cell(\n    self,\n    y: int | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Append the given cell at the \"y\" coordinate. Repeated cells are\n    accepted. If no cell is given, an empty one is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Other rows remain untouched.\n\n    Arguments:\n\n        y -- int or str\n\n        cell -- Cell\n\n    returns the cell with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    if clone:\n        cell = cell.clone\n    y = self._translate_y_from_any(y)\n    row = self._get_row2(y)\n    row.y = y\n    cell_back = row.append_cell(cell, clone=False)\n    self.set_row(y, row)\n    # Update width if necessary\n    self._update_width(row)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.append_column","title":"<code>append_column(column=None, _repeated=None)</code>","text":"<p>Append the column at the end of the table. If no column is given, an empty one is created.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>column -- Column\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def append_column(\n    self,\n    column: Column | None = None,\n    _repeated: int | None = None,\n) -&gt; Column:\n    \"\"\"Append the column at the end of the table. If no column is given,\n    an empty one is created.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        column -- Column\n    \"\"\"\n    if column is None:\n        column = Column()\n    else:\n        column = column.clone\n    if not self._cmap:\n        position = 0\n    else:\n        odf_idx = len(self._cmap) - 1\n        last_column = self._get_element_idx2(_xpath_column_idx, odf_idx)\n        if last_column is None:\n            raise ValueError\n        position = self.index(last_column) + 1\n    column.x = self.width\n    self.insert(column, position=position)\n    # Repetitions are accepted\n    if _repeated is None:\n        _repeated = column.repeated or 1\n    self._cmap = insert_map_once(self._cmap, len(self._cmap), _repeated)\n    # No need to update row widths\n    return column\n</code></pre>"},{"location":"reference.html#odfdo.Table.append_row","title":"<code>append_row(row=None, clone=True, _repeated=None)</code>","text":"<p>Append the row at the end of the table. If no row is given, an empty one is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Note the columns are automatically created when the first row is inserted in an empty table. So better insert a filled row.</p> <p>Arguments:</p> <pre><code>row -- Row\n\n_repeated -- (optional), repeated value of the row\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def append_row(\n    self,\n    row: Row | None = None,\n    clone: bool = True,\n    _repeated: int | None = None,\n) -&gt; Row:\n    \"\"\"Append the row at the end of the table. If no row is given, an\n    empty one is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Note the columns are automatically created when the first row is\n    inserted in an empty table. So better insert a filled row.\n\n    Arguments:\n\n        row -- Row\n\n        _repeated -- (optional), repeated value of the row\n\n    returns the row, with updated row.y\n    \"\"\"\n    if row is None:\n        row = Row()\n        _repeated = 1\n    elif clone:\n        row = row.clone\n    # Appending a repeated row accepted\n    # Do not insert next to the last row because it could be in a group\n    self._append(row)\n    if _repeated is None:\n        _repeated = row.repeated or 1\n    self._tmap = insert_map_once(self._tmap, len(self._tmap), _repeated)\n    row.y = self.height - 1\n    # Initialize columns\n    if not self._get_columns():\n        repeated = row.width\n        self.insert(Column(repeated=repeated), position=0)\n        self._compute_table_cache()\n    # Update width if necessary\n    self._update_width(row)\n    return row\n</code></pre>"},{"location":"reference.html#odfdo.Table.del_span","title":"<code>del_span(area)</code>","text":"<p>Delete a Cell Span. \u2018area\u2019 is the cell coordiante of the upper left cell of the spanned area.</p> <p>Area can be either one cell (like \u2018A1\u2019) or an area (\u2018A1:B2\u2019). It can be provided as an alpha numeric value like \u201cA1:B2\u2019 or a tuple like (0, 0, 1, 1) or (0, 0). If an area is provided, the upper left cell is used.</p> <p>Arguments:</p> <pre><code>area -- str or tuple of int, cell or area coordinate\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def del_span(self, area: str | tuple | list) -&gt; bool:\n    \"\"\"Delete a Cell Span. 'area' is the cell coordiante of the upper left\n    cell of the spanned area.\n\n    Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n    be provided as an alpha numeric value like \"A1:B2' or a tuple like\n    (0, 0, 1, 1) or (0, 0). If an area is provided, the upper left cell\n    is used.\n\n    Arguments:\n\n        area -- str or tuple of int, cell or area coordinate\n    \"\"\"\n    # get area\n    digits = convert_coordinates(area)\n    if len(digits) == 4:\n        x, y, _z, _t = digits\n    else:\n        x, y = digits\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    start = x, y\n    # check for previous span\n    cell0 = self.get_cell(start)\n    nb_cols = cell0.get_attribute_integer(\"table:number-columns-spanned\")\n    if nb_cols is None:\n        return False\n    nb_rows = cell0.get_attribute_integer(\"table:number-rows-spanned\")\n    if nb_rows is None:\n        return False\n    z = x + nb_cols - 1\n    t = y + nb_rows - 1\n    cells = self.get_cells((x, y, z, t))\n    cells[0][0].del_attribute(\"table:number-columns-spanned\")\n    cells[0][0].del_attribute(\"table:number-rows-spanned\")\n    for cell in cells[0][1:]:\n        cell.tag = \"table:table-cell\"\n    for row in cells[1:]:\n        for cell in row:\n            cell.tag = \"table:table-cell\"\n    # replace cells in table\n    self.set_cells(cells, coord=start, clone=False)\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_cell","title":"<code>delete_cell(coord)</code>","text":"<p>Delete the cell at the given coordinates, so that next cells are shifted to the left.</p> <p>Coordinates are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Use set_value() for erasing value.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_cell(self, coord: tuple | list | str) -&gt; None:\n    \"\"\"Delete the cell at the given coordinates, so that next cells are\n    shifted to the left.\n\n    Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Use set_value() for erasing value.\n\n    Arguments:\n\n        coord -- (int, int) or str\n    \"\"\"\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    # Outside the defined table\n    if y &gt;= self.height:\n        return\n    # Inside the defined table\n    row = self._get_row2_base(y)\n    if row is None:\n        raise ValueError\n    row.delete_cell(x)\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_column","title":"<code>delete_column(x)</code>","text":"<p>Delete the column at the given position. ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_column(self, x: int | str) -&gt; None:\n    \"\"\"Delete the column at the given position. ODF columns don't contain\n    cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        x -- int or str\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    # Outside the defined table\n    if x &gt;= self.width:\n        return\n    # Inside the defined table\n    delete_item_in_vault(x, self, _xpath_column_idx, \"_cmap\")\n    # Update width\n    width = self.width\n    for row in self._get_rows():\n        if row.width &gt;= width:\n            row.delete_cell(x)\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_named_range","title":"<code>delete_named_range(name)</code>","text":"<p>Delete the Named Range of specified name from the spreadsheet. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_named_range(self, name: str) -&gt; None:\n    \"\"\"Delete the Named Range of specified name from the spreadsheet.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    name = name.strip()\n    if not name:\n        raise ValueError(\"Name required.\")\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    body.delete_named_range(name)\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_row","title":"<code>delete_row(y)</code>","text":"<p>Delete the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_row(self, y: int | str) -&gt; None:\n    \"\"\"Delete the row at the given \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n    \"\"\"\n    y = self._translate_y_from_any(y)\n    # Outside the defined table\n    if y &gt;= self.height:\n        return\n    # Inside the defined table\n    delete_item_in_vault(y, self, _xpath_row_idx, \"_tmap\")\n</code></pre>"},{"location":"reference.html#odfdo.Table.extend_rows","title":"<code>extend_rows(rows=None)</code>","text":"<p>Append a list of rows at the end of the table.</p> <p>Arguments:</p> <pre><code>rows -- list of Row\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def extend_rows(self, rows: list[Row] | None = None) -&gt; None:\n    \"\"\"Append a list of rows at the end of the table.\n\n    Arguments:\n\n        rows -- list of Row\n    \"\"\"\n    if rows is None:\n        rows = []\n    self.extend(rows)\n    self._compute_table_cache()\n    # Update width if necessary\n    width = self.width\n    for row in self.traverse():\n        if row.width &gt; width:\n            width = row.width\n    diff = width - self.width\n    if diff &gt; 0:\n        self.append_column(Column(repeated=diff))\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_cell","title":"<code>get_cell(coord, clone=True, keep_repeated=True)</code>","text":"<p>Get the cell at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>A copy is returned, use <code>set_cell</code> to push it back.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n</code></pre> <p>Return: Cell</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_cell(\n    self,\n    coord: tuple | list | str,\n    clone: bool = True,\n    keep_repeated: bool = True,\n) -&gt; Cell:\n    \"\"\"Get the cell at the given coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    A copy is returned, use ``set_cell`` to push it back.\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n    Return: Cell\n    \"\"\"\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    # Outside the defined table\n    if y &gt;= self.height:\n        cell = Cell()\n    else:\n        # Inside the defined table\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError\n        read_cell = row.get_cell(x, clone=clone)\n        if read_cell is None:\n            raise ValueError\n        cell = read_cell\n        if not keep_repeated:\n            repeated = cell.repeated or 1\n            if repeated &gt;= 2:\n                cell.repeated = None\n    cell.x = x\n    cell.y = y\n    return cell\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_cells","title":"<code>get_cells(coord=None, cell_type=None, style=None, content=None, flat=False)</code>","text":"<p>Get the cells matching the criteria. If \u2018coord\u2019 is None, parse the whole table, else parse the area defined by \u2018coord\u2019.</p> <p>Filter by  cell_type = \u201call\u201d  will retrieve cells of any type, aka non empty cells.</p> <p>If flat is True (default is False), the method return a single list of all the values, else a list of lists of cells.</p> <p>if cell_type, style and content are None, get_cells() will return the exact number of cells of the area, including empty cells.</p> <p>Arguments:</p> <pre><code>coordinates -- str or tuple of int : coordinates of area\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncontent -- str regex\n\nstyle -- str\n\nflat -- boolean\n</code></pre> <p>Return: list of list of Cell</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_cells(\n    self,\n    coord: tuple | list | str | None = None,\n    cell_type: str | None = None,\n    style: str | None = None,\n    content: str | None = None,\n    flat: bool = False,\n) -&gt; list:\n    \"\"\"Get the cells matching the criteria. If 'coord' is None,\n    parse the whole table, else parse the area defined by 'coord'.\n\n    Filter by  cell_type = \"all\"  will retrieve cells of any\n    type, aka non empty cells.\n\n    If flat is True (default is False), the method return a single list\n    of all the values, else a list of lists of cells.\n\n    if cell_type, style and content are None, get_cells() will return\n    the exact number of cells of the area, including empty cells.\n\n    Arguments:\n\n        coordinates -- str or tuple of int : coordinates of area\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        content -- str regex\n\n        style -- str\n\n        flat -- boolean\n\n    Return: list of list of Cell\n    \"\"\"\n    if coord:\n        x, y, z, t = self._translate_table_coordinates(coord)\n    else:\n        x = y = z = t = None\n    if flat:\n        cells: list[Cell] = []\n        for row in self.traverse(start=y, end=t):\n            row_cells = row.get_cells(\n                coord=(x, z),\n                cell_type=cell_type,\n                style=style,\n                content=content,\n            )\n            cells.extend(row_cells)\n        return cells\n    else:\n        lcells: list[list[Cell]] = []\n        for row in self.traverse(start=y, end=t):\n            row_cells = row.get_cells(\n                coord=(x, z),\n                cell_type=cell_type,\n                style=style,\n                content=content,\n            )\n            lcells.append(row_cells)\n        return lcells\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_column","title":"<code>get_column(x)</code>","text":"<p>Get the column at the given \u201cx\u201d position.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>A copy is returned, use set_column() to push it back.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> <p>Return: Column</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_column(self, x: int | str) -&gt; Column:\n    \"\"\"Get the column at the given \"x\" position.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    A copy is returned, use set_column() to push it back.\n\n    Arguments:\n\n        x -- int or str\n\n    Return: Column\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    column = self._get_column2(x)\n    if column is None:\n        raise ValueError\n    column.x = x\n    return column\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_column_cells","title":"<code>get_column_cells(x, style=None, content=None, cell_type=None, complete=False)</code>","text":"<p>Get the list of cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells.</p> <p>If complete is True, replace missing values by None.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncontent -- str regex\n\nstyle -- str\n\ncomplete -- boolean\n</code></pre> <p>Return: list of Cell</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_column_cells(  # noqa: C901\n    self,\n    x: int | str,\n    style: str | None = None,\n    content: str | None = None,\n    cell_type: str | None = None,\n    complete: bool = False,\n) -&gt; list[Cell | None]:\n    \"\"\"Get the list of cells at the given position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n\n    If complete is True, replace missing values by None.\n\n    Arguments:\n\n        x -- int or str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        content -- str regex\n\n        style -- str\n\n        complete -- boolean\n\n    Return: list of Cell\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    if cell_type:\n        cell_type = cell_type.lower().strip()\n    cells: list[Cell | None] = []\n    if not style and not content and not cell_type:\n        for row in self.traverse():\n            cells.append(row.get_cell(x, clone=True))\n        return cells\n    for row in self.traverse():\n        cell = row.get_cell(x, clone=True)\n        if cell is None:\n            raise ValueError\n        # Filter the cells by cell_type\n        if cell_type:\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                if complete:\n                    cells.append(None)\n                continue\n        # Filter the cells with the regex\n        if content and not cell.match(content):\n            if complete:\n                cells.append(None)\n            continue\n        # Filter the cells with the style\n        if style and style != cell.style:\n            if complete:\n                cells.append(None)\n            continue\n        cells.append(cell)\n    return cells\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_column_values","title":"<code>get_column_values(x, cell_type=None, complete=True, get_type=False)</code>","text":"<p>Shortcut to get the list of Python values for the cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells. If cell_type and complete is True, replace missing values by None.</p> <p>If get_type is True, returns a tuple (value, ODF type of value)</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of Python types</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_column_values(\n    self,\n    x: int | str,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n) -&gt; list[Any]:\n    \"\"\"Shortcut to get the list of Python values for the cells at the\n    given position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n    If cell_type and complete is True, replace missing values by None.\n\n    If get_type is True, returns a tuple (value, ODF type of value)\n\n    Arguments:\n\n        x -- int or str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of Python types\n    \"\"\"\n    cells = self.get_column_cells(\n        x, style=None, content=None, cell_type=cell_type, complete=complete\n    )\n    values: list[Any] = []\n    for cell in cells:\n        if cell is None:\n            if complete:\n                if get_type:\n                    values.append((None, None))\n                else:\n                    values.append(None)\n            continue\n        if cell_type:\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                if complete:\n                    if get_type:\n                        values.append((None, None))\n                    else:\n                        values.append(None)\n                continue\n        values.append(cell.get_value(get_type=get_type))\n    return values\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_columns","title":"<code>get_columns(coord=None, style=None)</code>","text":"<p>Get the list of columns matching the criteria.</p> <p>Copies are returned, use set_column() to push them back.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of columns\n\nstyle -- str\n</code></pre> <p>Return: list of columns</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_columns(\n    self,\n    coord: tuple | list | str | None = None,\n    style: str | None = None,\n) -&gt; list[Column]:\n    \"\"\"Get the list of columns matching the criteria.\n\n    Copies are returned, use set_column() to push them back.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of columns\n\n        style -- str\n\n    Return: list of columns\n    \"\"\"\n    if coord:\n        x, _y, _z, t = self._translate_column_coordinates(coord)\n    else:\n        x = t = None\n    if not style:\n        return list(self.traverse_columns(start=x, end=t))\n    columns = []\n    for column in self.traverse_columns(start=x, end=t):\n        if style != column.style:\n            continue\n        columns.append(column)\n    return columns\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_named_range","title":"<code>get_named_range(name)</code>","text":"<p>Returns the Name Ranges of the specified name. If table_name is provided, limits the search to these tables. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>name -- str, name of the named range object\n</code></pre> <p>Return : NamedRange</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_named_range(self, name: str) -&gt; NamedRange:\n    \"\"\"Returns the Name Ranges of the specified name. If\n    table_name is provided, limits the search to these tables.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        name -- str, name of the named range object\n\n    Return : NamedRange\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document\")\n    return body.get_named_range(name)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_named_ranges","title":"<code>get_named_ranges(table_name=None)</code>","text":"<p>Returns the list of available Name Ranges of the spreadsheet. If table_name is provided, limits the search to these tables. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>table_names -- str or list of str, names of tables\n</code></pre> <p>Return : list of table_range</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_named_ranges(  # type: ignore\n    self,\n    table_name: str | list[str] | None = None,\n) -&gt; list[NamedRange]:\n    \"\"\"Returns the list of available Name Ranges of the spreadsheet. If\n    table_name is provided, limits the search to these tables.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        table_names -- str or list of str, names of tables\n\n    Return : list of table_range\n    \"\"\"\n    body = self.document_body\n    if not body:\n        return []\n    all_named_ranges = body.get_named_ranges()\n    if not table_name:\n        return all_named_ranges  # type:ignore\n    filter_ = []\n    if isinstance(table_name, str):\n        filter_.append(table_name)\n    elif isiterable(table_name):\n        filter_.extend(table_name)\n    else:\n        raise ValueError(\n            f\"table_name must be string or Iterable, not {type(table_name)}\"\n        )\n    return [\n        nr for nr in all_named_ranges if nr.table_name in filter_  # type:ignore\n    ]\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_row","title":"<code>get_row(y, clone=True, create=True)</code>","text":"<p>Get the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>A copy is returned, use set_cell() to push it back.</p> <p>Arguments:</p> <pre><code>y -- int or str\n</code></pre> <p>Return: Row</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_row(self, y: int | str, clone: bool = True, create: bool = True) -&gt; Row:\n    \"\"\"Get the row at the given \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    A copy is returned, use set_cell() to push it back.\n\n    Arguments:\n\n        y -- int or str\n\n    Return: Row\n    \"\"\"\n    # fixme : keep repeat ? maybe an option to functions : \"raw=False\"\n    y = self._translate_y_from_any(y)\n    row = self._get_row2(y, clone=clone, create=create)\n    if row is None:\n        raise ValueError(\"Row not found\")\n    row.y = y\n    return row\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_row_values","title":"<code>get_row_values(y, cell_type=None, complete=True, get_type=False)</code>","text":"<p>Shortcut to get the list of Python values for the cells of the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells. If cell_type and complete is True, replace missing values by None.</p> <p>If get_type is True, returns a tuple (value, ODF type of value)</p> <p>Arguments:</p> <pre><code>y -- int, str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of lists of Python types</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_row_values(\n    self,\n    y: int | str,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n) -&gt; list:\n    \"\"\"Shortcut to get the list of Python values for the cells of the row\n    at the given \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n    If cell_type and complete is True, replace missing values by None.\n\n    If get_type is True, returns a tuple (value, ODF type of value)\n\n    Arguments:\n\n        y -- int, str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of lists of Python types\n    \"\"\"\n    values = self.get_row(y, clone=False).get_values(\n        cell_type=cell_type, complete=complete, get_type=get_type\n    )\n    # complete row to match column width\n    if complete:\n        if get_type:\n            values.extend([(None, None)] * (self.width - len(values)))\n        else:\n            values.extend([None] * (self.width - len(values)))\n    return values\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_rows","title":"<code>get_rows(coord=None, style=None, content=None)</code>","text":"<p>Get the list of rows matching the criteria.</p> <p>Filter by coordinates will parse the area defined by the coordinates.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of rows\n\ncontent -- str regex\n\nstyle -- str\n</code></pre> <p>Return: list of rows</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_rows(\n    self,\n    coord: tuple | list | str | None = None,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Row]:\n    \"\"\"Get the list of rows matching the criteria.\n\n    Filter by coordinates will parse the area defined by the coordinates.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of rows\n\n        content -- str regex\n\n        style -- str\n\n    Return: list of rows\n    \"\"\"\n    if coord:\n        _x, y, _z, t = self._translate_table_coordinates(coord)\n    else:\n        y = t = None\n    # fixme : not clones ?\n    if not content and not style:\n        return list(self.traverse(start=y, end=t))\n    rows = []\n    for row in self.traverse(start=y, end=t):\n        if content and not row.match(content):\n            continue\n        if style and style != row.style:\n            continue\n        rows.append(row)\n    return rows\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_value","title":"<code>get_value(coord, get_type=False)</code>","text":"<p>Shortcut to get the Python value of the cell at the given coordinates.</p> <p>If get_type is True, returns the tuples (value, ODF type)</p> <p>coord is either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d. If an Area is given, the upper left position is used as coord.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str : coordinate\n</code></pre> <p>Return: Python type</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_value(\n    self,\n    coord: tuple | list | str,\n    get_type: bool = False,\n) -&gt; Any:\n    \"\"\"Shortcut to get the Python value of the cell at the given\n    coordinates.\n\n    If get_type is True, returns the tuples (value, ODF type)\n\n    coord is either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\". If an Area is given, the upper\n    left position is used as coord.\n\n    Arguments:\n\n        coord -- (int, int) or str : coordinate\n\n    Return: Python type\n    \"\"\"\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    # Outside the defined table\n    if y &gt;= self.height:\n        if get_type:\n            return (None, None)\n        return None\n    else:\n        # Inside the defined table\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError\n        cell = row._get_cell2_base(x)\n        if cell is None:\n            if get_type:\n                return (None, None)\n            return None\n        return cell.get_value(get_type=get_type)\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_values","title":"<code>get_values(coord=None, cell_type=None, complete=True, get_type=False, flat=False)</code>","text":"<p>Get a matrix of values of the table.</p> <p>Filter by coordinates will parse the area defined by the coordinates.</p> <p>If \u2018cell_type\u2019 is used and \u2018complete\u2019 is True (default), missing values are replaced by None. Filter by \u2018 cell_type = \u201call\u201d \u2018 will retrieve cells of any type, aka non empty cells.</p> <p>If \u2018cell_type\u2019 is None, complete is always True : with no cell type queried, get_values() returns None for each empty cell, the length each lists is equal to the width of the table.</p> <p>If get_type is True, returns tuples (value, ODF type of value), or (None, None) for empty cells with complete True.</p> <p>If flat is True, the methods return a single list of all the values. By default, flat is False.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of area\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of lists of Python types</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_values(\n    self,\n    coord: tuple | list | str | None = None,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n    flat: bool = False,\n) -&gt; list:\n    \"\"\"Get a matrix of values of the table.\n\n    Filter by coordinates will parse the area defined by the coordinates.\n\n    If 'cell_type' is used and 'complete' is True (default), missing values\n    are replaced by None.\n    Filter by ' cell_type = \"all\" ' will retrieve cells of any\n    type, aka non empty cells.\n\n    If 'cell_type' is None, complete is always True : with no cell type\n    queried, get_values() returns None for each empty cell, the length\n    each lists is equal to the width of the table.\n\n    If get_type is True, returns tuples (value, ODF type of value), or\n    (None, None) for empty cells with complete True.\n\n    If flat is True, the methods return a single list of all the values.\n    By default, flat is False.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of area\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of lists of Python types\n    \"\"\"\n    if coord:\n        x, y, z, t = self._translate_table_coordinates(coord)\n    else:\n        x = y = z = t = None\n    data = []\n    for row in self.traverse(start=y, end=t):\n        if z is None:\n            width = self.width\n        else:\n            width = min(z + 1, self.width)\n        if x is not None:\n            width -= x\n        values = row.get_values(\n            (x, z),\n            cell_type=cell_type,\n            complete=complete,\n            get_type=get_type,\n        )\n        # complete row to match request width\n        if complete:\n            if get_type:\n                values.extend([(None, None)] * (width - len(values)))\n            else:\n                values.extend([None] * (width - len(values)))\n        if flat:\n            data.extend(values)\n        else:\n            data.append(values)\n    return data\n</code></pre>"},{"location":"reference.html#odfdo.Table.insert_cell","title":"<code>insert_cell(coord, cell=None, clone=True)</code>","text":"<p>Insert the given cell at the given coordinates. If no cell is given, an empty one is created.</p> <p>Coordinates are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Cells on the right are shifted. Other rows remain untouched.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n\ncell -- Cell\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/table.py</code> <pre><code>def insert_cell(\n    self,\n    coord: tuple | list | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Insert the given cell at the given coordinates. If no cell is\n    given, an empty one is created.\n\n    Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Cells on the right are shifted. Other rows remain untouched.\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n        cell -- Cell\n\n    returns the cell with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    if clone:\n        cell = cell.clone\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    row = self._get_row2(y, clone=True)\n    row.y = y\n    row.repeated = None\n    cell_back = row.insert_cell(x, cell, clone=False)\n    self.set_row(y, row, clone=False)\n    # Update width if necessary\n    self._update_width(row)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.insert_column","title":"<code>insert_column(x, column=None)</code>","text":"<p>Insert the column before the given \u201cx\u201d position. If no column is given, an empty one is created.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncolumn -- Column\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def insert_column(\n    self,\n    x: int | str,\n    column: Column | None = None,\n) -&gt; Column:\n    \"\"\"Insert the column before the given \"x\" position. If no column is\n    given, an empty one is created.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        x -- int or str\n\n        column -- Column\n    \"\"\"\n    if column is None:\n        column = Column()\n    x = self._translate_x_from_any(x)\n    diff = x - self.width\n    if diff &lt; 0:\n        column_back = insert_item_in_vault(\n            x, column, self, _xpath_column_idx, \"_cmap\"\n        )\n    elif diff == 0:\n        column_back = self.append_column(column.clone)\n    else:\n        self.append_column(Column(repeated=diff), _repeated=diff)\n        column_back = self.append_column(column.clone)\n    column_back.x = x  # type: ignore\n    # Repetitions are accepted\n    repeated = column.repeated or 1\n    # Update width on every row\n    for row in self._get_rows():\n        if row.width &gt; x:\n            row.insert_cell(x, Cell(repeated=repeated))\n        # Shorter rows don't need insert\n        # Longer rows shouldn't exist!\n    return column_back  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Table.insert_row","title":"<code>insert_row(y, row=None, clone=True)</code>","text":"<p>Insert the row before the given \u201cy\u201d position. If no row is given, an empty one is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>If row is None, a new empty row is created.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\nrow -- Row\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def insert_row(\n    self, y: str | int, row: Row | None = None, clone: bool = True\n) -&gt; Row:\n    \"\"\"Insert the row before the given \"y\" position. If no row is given,\n    an empty one is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    If row is None, a new empty row is created.\n\n    Arguments:\n\n        y -- int or str\n\n        row -- Row\n\n    returns the row, with updated row.y\n    \"\"\"\n    if row is None:\n        row = Row()\n        clone = False\n    y = self._translate_y_from_any(y)\n    diff = y - self.height\n    if diff &lt; 0:\n        row_back = insert_item_in_vault(y, row, self, _xpath_row_idx, \"_tmap\")\n    elif diff == 0:\n        row_back = self.append_row(row, clone=clone)\n    else:\n        self.append_row(Row(repeated=diff), _repeated=diff, clone=False)\n        row_back = self.append_row(row, clone=clone)\n    row_back.y = y  # type: ignore\n    # Update width if necessary\n    self._update_width(row_back)  # type: ignore\n    return row_back  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Table.is_column_empty","title":"<code>is_column_empty(x, aggressive=False)</code>","text":"<p>Return wether every cell in the column at \u201cx\u201d position has no value or the value evaluates to False (empty string), and no style.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Return: bool</p> Source code in <code>odfdo/table.py</code> <pre><code>def is_column_empty(self, x: int | str, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return wether every cell in the column at \"x\" position has no value\n    or the value evaluates to False (empty string), and no style.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Return: bool\n    \"\"\"\n    for cell in self.get_column_cells(x):\n        if cell is None:\n            continue\n        if not cell.is_empty(aggressive=aggressive):\n            return False\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Table.is_empty","title":"<code>is_empty(aggressive=False)</code>","text":"<p>Return whether every cell in the table has no value or the value evaluates to False (empty string), and no style.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def is_empty(self, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return whether every cell in the table has no value or the value\n    evaluates to False (empty string), and no style.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        aggressive -- bool\n    \"\"\"\n    return all(row.is_empty(aggressive=aggressive) for row in self._get_rows())\n</code></pre>"},{"location":"reference.html#odfdo.Table.is_row_empty","title":"<code>is_row_empty(y, aggressive=False)</code>","text":"<p>Return wether every cell in the row at the given \u201cy\u201d position has no value or the value evaluates to False (empty string), and no style.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\naggressive -- bool\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def is_row_empty(self, y: int | str, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return wether every cell in the row at the given \"y\" position has\n    no value or the value evaluates to False (empty string), and no style.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        y -- int or str\n\n        aggressive -- bool\n    \"\"\"\n    return self.get_row(y, clone=False).is_empty(aggressive=aggressive)\n</code></pre>"},{"location":"reference.html#odfdo.Table.iter_values","title":"<code>iter_values(coord=None, cell_type=None, complete=True, get_type=False)</code>","text":"<p>Iterate through lines of Python values of the table.</p> <p>Filter by coordinates will parse the area defined by the coordinates.</p> <p>cell_type, complete, grt_type : see get_values()</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of area\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: iterator of lists</p> Source code in <code>odfdo/table.py</code> <pre><code>def iter_values(\n    self,\n    coord: tuple | list | str | None = None,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n) -&gt; Iterator[list]:\n    \"\"\"Iterate through lines of Python values of the table.\n\n    Filter by coordinates will parse the area defined by the coordinates.\n\n    cell_type, complete, grt_type : see get_values()\n\n\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of area\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: iterator of lists\n    \"\"\"\n    if coord:\n        x, y, z, t = self._translate_table_coordinates(coord)\n    else:\n        x = y = z = t = None\n    for row in self.traverse(start=y, end=t):\n        if z is None:\n            width = self.width\n        else:\n            width = min(z + 1, self.width)\n        if x is not None:\n            width -= x\n        values = row.get_values(\n            (x, z),\n            cell_type=cell_type,\n            complete=complete,\n            get_type=get_type,\n        )\n        # complete row to match column width\n        if complete:\n            if get_type:\n                values.extend([(None, None)] * (width - len(values)))\n            else:\n                values.extend([None] * (width - len(values)))\n        yield values\n</code></pre>"},{"location":"reference.html#odfdo.Table.optimize_width","title":"<code>optimize_width()</code>","text":"<p>Remove in-place empty rows below and empty cells at the right of the table. Keep repeated styles of empty cells but minimize row width.</p> Source code in <code>odfdo/table.py</code> <pre><code>def optimize_width(self) -&gt; None:\n    \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n    the table. Keep repeated styles of empty cells but minimize row width.\n    \"\"\"\n    self._optimize_width_trim_rows()\n    width = self._optimize_width_length()\n    self._optimize_width_rstrip_rows(width)\n    self._optimize_width_adapt_columns(width)\n</code></pre>"},{"location":"reference.html#odfdo.Table.rstrip","title":"<code>rstrip(aggressive=False)</code>","text":"<p>Remove in-place empty rows below and empty cells at the right of the table. Cells are empty if they contain no value or it evaluates to False, and no style.</p> <p>If aggressive is True, empty cells with style are removed too.</p> <p>Argument:</p> <pre><code>aggressive -- bool\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def rstrip(self, aggressive: bool = False) -&gt; None:\n    \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n    the table. Cells are empty if they contain no value or it evaluates\n    to False, and no style.\n\n    If aggressive is True, empty cells with style are removed too.\n\n    Argument:\n\n        aggressive -- bool\n    \"\"\"\n    # Step 1: remove empty rows below the table\n    for row in reversed(self._get_rows()):\n        if row.is_empty(aggressive=aggressive):\n            row.parent.delete(row)  # type: ignore\n        else:\n            break\n    # Step 2: rstrip remaining rows\n    max_width = 0\n    for row in self._get_rows():\n        row.rstrip(aggressive=aggressive)\n        # keep count of the biggest row\n        max_width = max(max_width, row.width)\n    # raz cache of rows\n    self._indexes[\"_tmap\"] = {}\n    # Step 3: trim columns to match max_width\n    columns = self._get_columns()\n    repeated_cols = self.xpath(\"table:table-column/@table:number-columns-repeated\")\n    if not isinstance(repeated_cols, list):\n        raise TypeError\n    unrepeated = len(columns) - len(repeated_cols)\n    column_width = sum(int(r) for r in repeated_cols) + unrepeated  # type: ignore\n    diff = column_width - max_width\n    if diff &gt; 0:\n        for column in reversed(columns):\n            repeated = column.repeated or 1\n            repeated = repeated - diff\n            if repeated &gt; 0:\n                column.repeated = repeated\n                break\n            else:\n                column.parent.delete(column)\n                diff = -repeated\n                if diff == 0:\n                    break\n    # raz cache of columns\n    self._indexes[\"_cmap\"] = {}\n    self._compute_table_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_cell","title":"<code>set_cell(coord, cell=None, clone=True)</code>","text":"<p>Replace a cell of the table at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str : coordinate\n\ncell -- Cell\n</code></pre> <p>return the cell, with x and y updated</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_cell(\n    self,\n    coord: tuple | list | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Replace a cell of the table at the given coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Arguments:\n\n        coord -- (int, int) or str : coordinate\n\n        cell -- Cell\n\n    return the cell, with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    cell.x = x\n    cell.y = y\n    if y &gt;= self.height:\n        row = Row()\n        cell_back = row.set_cell(x, cell, clone=clone)\n        self.set_row(y, row, clone=False)\n    else:\n        row_read = self._get_row2_base(y)\n        if row_read is None:\n            raise ValueError\n        row = row_read\n        row.y = y\n        repeated = row.repeated or 1\n        if repeated &gt; 1:\n            row = row.clone\n            row.repeated = None\n            cell_back = row.set_cell(x, cell, clone=clone)\n            self.set_row(y, row, clone=False)\n        else:\n            cell_back = row.set_cell(x, cell, clone=clone)\n            # Update width if necessary, since we don't use set_row\n            self._update_width(row)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_cell_image","title":"<code>set_cell_image(coord, image_frame, doc_type=None)</code>","text":"<p>Do all the magic to display an image in the cell at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>The frame element must contain the expected image position and dimensions.</p> <p>DrawImage insertion depends on the document type, so the type must be provided or the table element must be already attached to a document.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n\nimage_frame -- Frame including an image\n\ndoc_type -- 'spreadsheet' or 'text'\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_cell_image(\n    self,\n    coord: tuple | list | str,\n    image_frame: Frame,\n    doc_type: str | None = None,\n) -&gt; None:\n    \"\"\"Do all the magic to display an image in the cell at the given\n    coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    The frame element must contain the expected image position and\n    dimensions.\n\n    DrawImage insertion depends on the document type, so the type must be\n    provided or the table element must be already attached to a document.\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n        image_frame -- Frame including an image\n\n        doc_type -- 'spreadsheet' or 'text'\n    \"\"\"\n    # Test document type\n    if doc_type is None:\n        body = self.document_body\n        if body is None:\n            raise ValueError(\"document type not found\")\n        doc_type = {\"office:spreadsheet\": \"spreadsheet\", \"office:text\": \"text\"}.get(\n            body.tag\n        )\n        if doc_type is None:\n            raise ValueError(\"document type not supported for images\")\n    # We need the end address of the image\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    cell = self.get_cell((x, y))\n    image_frame = image_frame.clone  # type: ignore\n    # Remove any previous paragraph, frame, etc.\n    for child in cell.children:\n        cell.delete(child)\n    # Now it all depends on the document type\n    if doc_type == \"spreadsheet\":\n        image_frame.anchor_type = \"char\"\n        # The frame needs end coordinates\n        width, height = image_frame.size\n        image_frame.set_attribute(\"table:end-x\", width)\n        image_frame.set_attribute(\"table:end-y\", height)\n        # FIXME what happens when the address changes?\n        address = f\"{self.name}.{digit_to_alpha(x)}{y + 1}\"\n        image_frame.set_attribute(\"table:end-cell-address\", address)\n        # The frame is directly in the cell\n        cell.append(image_frame)\n    elif doc_type == \"text\":\n        # The frame must be in a paragraph\n        cell.set_value(\"\")\n        paragraph = cell.get_element(\"text:p\")\n        if paragraph is None:\n            raise ValueError\n        paragraph.append(image_frame)\n    self.set_cell(coord, cell)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_cells","title":"<code>set_cells(cells, coord=None, clone=True)</code>","text":"<p>Set the cells in the table, from the \u2018coord\u2019 position.</p> <p>\u2018coord\u2019 is the coordinate of the upper left cell to be modified by values. If \u2018coord\u2019 is None, default to the position (0,0) (\u201cA1\u201d). If \u2018coord\u2019 is an area (e.g. \u201cA2:B5\u201d), the upper left position of this area is used as coordinate.</p> <p>The table is not cleared before the operation, to reset the table before setting cells, use table.clear().</p> <p>A list of lists is expected, with as many lists as rows to be set, and as many cell in each sublist as cells to be setted in the row.</p> <p>Arguments:</p> <pre><code>cells -- list of list of cells\n\ncoord -- tuple or str\n\nvalues -- list of lists of python types\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_cells(\n    self,\n    cells: list[list[Cell]] | list[tuple[Cell]],\n    coord: tuple | list | str | None = None,\n    clone: bool = True,\n) -&gt; None:\n    \"\"\"Set the cells in the table, from the 'coord' position.\n\n    'coord' is the coordinate of the upper left cell to be modified by\n    values. If 'coord' is None, default to the position (0,0) (\"A1\").\n    If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n    area is used as coordinate.\n\n    The table is *not* cleared before the operation, to reset the table\n    before setting cells, use table.clear().\n\n    A list of lists is expected, with as many lists as rows to be set, and\n    as many cell in each sublist as cells to be setted in the row.\n\n    Arguments:\n\n        cells -- list of list of cells\n\n        coord -- tuple or str\n\n        values -- list of lists of python types\n    \"\"\"\n    if coord:\n        x, y = self._translate_cell_coordinates(coord)\n    else:\n        x = y = 0\n    if y is None:\n        y = 0\n    if x is None:\n        x = 0\n    y -= 1\n    for row_cells in cells:\n        y += 1\n        if not row_cells:\n            continue\n        row = self.get_row(y, clone=True)\n        repeated = row.repeated or 1\n        if repeated &gt;= 2:\n            row.repeated = None\n        row.set_cells(row_cells, start=x, clone=clone)\n        self.set_row(y, row, clone=False)\n        self._update_width(row)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_column","title":"<code>set_column(x, column=None)</code>","text":"<p>Replace the column at the given \u201cx\u201d position.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncolumn -- Column\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_column(\n    self,\n    x: int | str,\n    column: Column | None = None,\n) -&gt; Column:\n    \"\"\"Replace the column at the given \"x\" position.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        x -- int or str\n\n        column -- Column\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    if column is None:\n        column = Column()\n        repeated = 1\n    else:\n        repeated = column.repeated or 1\n    column.x = x\n    # Outside the defined table ?\n    diff = x - self.width\n    if diff == 0:\n        column_back = self.append_column(column, _repeated=repeated)\n    elif diff &gt; 0:\n        self.append_column(Column(repeated=diff), _repeated=diff)\n        column_back = self.append_column(column, _repeated=repeated)\n    else:\n        # Inside the defined table\n        column_back = set_item_in_vault(  # type: ignore\n            x, column, self, _xpath_column_idx, \"_cmap\"\n        )\n    return column_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_column_cells","title":"<code>set_column_cells(x, cells)</code>","text":"<p>Shortcut to set the list of cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>The list must have the same length than the table height.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncells -- list of Cell\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_column_cells(self, x: int | str, cells: list[Cell]) -&gt; None:\n    \"\"\"Shortcut to set the list of cells at the given position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    The list must have the same length than the table height.\n\n    Arguments:\n\n        x -- int or str\n\n        cells -- list of Cell\n    \"\"\"\n    height = self.height\n    if len(cells) != height:\n        raise ValueError(f\"col mismatch: {height} cells expected\")\n    cells_iterator = iter(cells)\n    for y, row in enumerate(self.traverse()):\n        row.set_cell(x, next(cells_iterator))\n        self.set_row(y, row)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_column_values","title":"<code>set_column_values(x, values, cell_type=None, currency=None, style=None)</code>","text":"<p>Shortcut to set the list of Python values of cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>The list must have the same length than the table height.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\nvalues -- list of Python types\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_column_values(\n    self,\n    x: int | str,\n    values: list,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the list of Python values of cells at the given\n    position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    The list must have the same length than the table height.\n\n    Arguments:\n\n        x -- int or str\n\n        values -- list of Python types\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n    \"\"\"\n    cells = [\n        Cell(value, cell_type=cell_type, currency=currency, style=style)\n        for value in values\n    ]\n    self.set_column_cells(x, cells)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_named_range","title":"<code>set_named_range(name, crange, table_name=None, usage=None)</code>","text":"<p>Create a Named Range element and insert it in the document. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>name -- str, name of the named range\n\ncrange -- str or tuple of int, cell or area coordinate\n\ntable_name -- str, name of the table\n\nuage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_named_range(\n    self,\n    name: str,\n    crange: str | tuple | list,\n    table_name: str | None = None,\n    usage: str | None = None,\n) -&gt; None:\n    \"\"\"Create a Named Range element and insert it in the document.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        name -- str, name of the named range\n\n        crange -- str or tuple of int, cell or area coordinate\n\n        table_name -- str, name of the table\n\n        uage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document\")\n    if not name:\n        raise ValueError(\"Name required.\")\n    if table_name is None:\n        table_name = self.name\n    named_range = NamedRange(name, crange, table_name, usage)\n    body.append_named_range(named_range)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_row","title":"<code>set_row(y, row=None, clone=True)</code>","text":"<p>Replace the row at the given position with the new one. Repetions of the old row will be adjusted.</p> <p>If row is None, a new empty row is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\nrow -- Row\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_row(self, y: int | str, row: Row | None = None, clone: bool = True) -&gt; Row:\n    \"\"\"Replace the row at the given position with the new one. Repetions of\n    the old row will be adjusted.\n\n    If row is None, a new empty row is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n\n        row -- Row\n\n    returns the row, with updated row.y\n    \"\"\"\n    if row is None:\n        row = Row()\n        repeated = 1\n        clone = False\n    else:\n        repeated = row.repeated or 1\n    y = self._translate_y_from_any(y)\n    row.y = y\n    # Outside the defined table ?\n    diff = y - self.height\n    if diff == 0:\n        row_back = self.append_row(row, _repeated=repeated, clone=clone)\n    elif diff &gt; 0:\n        self.append_row(Row(repeated=diff), _repeated=diff, clone=clone)\n        row_back = self.append_row(row, _repeated=repeated, clone=clone)\n    else:\n        # Inside the defined table\n        row_back = set_item_in_vault(  # type: ignore\n            y, row, self, _xpath_row_idx, \"_tmap\", clone=clone\n        )\n    # print self.serialize(True)\n    # Update width if necessary\n    self._update_width(row_back)\n    return row_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_row_cells","title":"<code>set_row_cells(y, cells=None)</code>","text":"<p>Shortcut to set all the cells of the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\ncells -- list of Python types\n\nstyle -- str\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_row_cells(self, y: int | str, cells: list | None = None) -&gt; Row:\n    \"\"\"Shortcut to set *all* the cells of the row at the given\n    \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n\n        cells -- list of Python types\n\n        style -- str\n\n    returns the row, with updated row.y\n    \"\"\"\n    if cells is None:\n        cells = []\n    row = Row()  # needed if clones rows\n    row.extend_cells(cells)\n    return self.set_row(y, row)  # needed if clones rows\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_row_values","title":"<code>set_row_values(y, values, cell_type=None, currency=None, style=None)</code>","text":"<p>Shortcut to set the values of all cells of the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\nvalues -- list of Python types\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_row_values(\n    self,\n    y: int | str,\n    values: list,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; Row:\n    \"\"\"Shortcut to set the values of *all* cells of the row at the given\n    \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n\n        values -- list of Python types\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n\n    returns the row, with updated row.y\n    \"\"\"\n    row = Row()  # needed if clones rows\n    row.set_values(values, style=style, cell_type=cell_type, currency=currency)\n    return self.set_row(y, row)  # needed if clones rows\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_span","title":"<code>set_span(area, merge=False)</code>","text":"<p>Create a Cell Span : span the first cell of the area on several columns and/or rows. If merge is True, replace text of the cell by the concatenation of existing text in covered cells. Beware : if merge is True, old text is changed, if merge is False (the default), old text in coverd cells is still present but not displayed by most GUI.</p> <p>If the area defines only one cell, the set span will do nothing. It is not allowed to apply set span to an area whose one cell already belongs to previous cell span.</p> <p>Area can be either one cell (like \u2018A1\u2019) or an area (\u2018A1:B2\u2019). It can be provided as an alpha numeric value like \u201cA1:B2\u2019 or a tuple like (0, 0, 1, 1) or (0, 0).</p> <p>Arguments:</p> <pre><code>area -- str or tuple of int, cell or area coordinate\n\nmerge -- boolean\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_span(  # noqa: C901\n    self,\n    area: str | tuple | list,\n    merge: bool = False,\n) -&gt; bool:\n    \"\"\"Create a Cell Span : span the first cell of the area on several\n    columns and/or rows.\n    If merge is True, replace text of the cell by the concatenation of\n    existing text in covered cells.\n    Beware : if merge is True, old text is changed, if merge is False\n    (the default), old text in coverd cells is still present but not\n    displayed by most GUI.\n\n    If the area defines only one cell, the set span will do nothing.\n    It is not allowed to apply set span to an area whose one cell already\n    belongs to previous cell span.\n\n    Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n    be provided as an alpha numeric value like \"A1:B2' or a tuple like\n    (0, 0, 1, 1) or (0, 0).\n\n    Arguments:\n\n        area -- str or tuple of int, cell or area coordinate\n\n        merge -- boolean\n    \"\"\"\n    # get area\n    digits = convert_coordinates(area)\n    if len(digits) == 4:\n        x, y, z, t = digits\n    else:\n        x, y = digits\n        z, t = digits\n    start = x, y\n    end = z, t\n    if start == end:\n        # one cell : do nothing\n        return False\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    if z is None:\n        raise ValueError\n    if t is None:\n        raise ValueError\n    # check for previous span\n    good = True\n    # Check boundaries and empty cells : need to crate non existent cells\n    # so don't use get_cells directly, but get_cell\n    cells = []\n    for yy in range(y, t + 1):\n        row_cells = []\n        for xx in range(x, z + 1):\n            row_cells.append(\n                self.get_cell((xx, yy), clone=True, keep_repeated=False)\n            )\n        cells.append(row_cells)\n    for row in cells:\n        for cell in row:\n            if cell.is_spanned():\n                good = False\n                break\n        if not good:\n            break\n    if not good:\n        return False\n    # Check boundaries\n    # if z &gt;= self.width or t &gt;= self.height:\n    #    self.set_cell(coord = end)\n    #    print area, z, t\n    #    cells = self.get_cells((x, y, z, t))\n    #    print cells\n    # do it:\n    if merge:\n        val_list = []\n        for row in cells:\n            for cell in row:\n                if cell.is_empty(aggressive=True):\n                    continue\n                val = cell.get_value()\n                if val is not None:\n                    if isinstance(val, str):\n                        val.strip()\n                    if val != \"\":\n                        val_list.append(val)\n                    cell.clear()\n        if val_list:\n            if len(val_list) == 1:\n                cells[0][0].set_value(val_list[0])\n            else:\n                value = \" \".join([str(v) for v in val_list if v])\n                cells[0][0].set_value(value)\n    cols = z - x + 1\n    cells[0][0].set_attribute(\"table:number-columns-spanned\", str(cols))\n    rows = t - y + 1\n    cells[0][0].set_attribute(\"table:number-rows-spanned\", str(rows))\n    for cell in cells[0][1:]:\n        cell.tag = \"table:covered-table-cell\"\n    for row in cells[1:]:\n        for cell in row:\n            cell.tag = \"table:covered-table-cell\"\n    # replace cells in table\n    self.set_cells(cells, coord=start, clone=False)\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_value","title":"<code>set_value(coord, value, cell_type=None, currency=None, style=None)</code>","text":"<p>Set the Python value of the cell at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n\nvalue -- Python type\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n         'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_value(\n    self,\n    coord: tuple | list | str,\n    value: Any,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; None:\n    \"\"\"Set the Python value of the cell at the given coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n        value -- Python type\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                 'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n\n    \"\"\"\n    self.set_cell(\n        coord,\n        Cell(value, cell_type=cell_type, currency=currency, style=style),\n        clone=False,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_values","title":"<code>set_values(values, coord=None, style=None, cell_type=None, currency=None)</code>","text":"<p>Set the value of cells in the table, from the \u2018coord\u2019 position with values.</p> <p>\u2018coord\u2019 is the coordinate of the upper left cell to be modified by values. If \u2018coord\u2019 is None, default to the position (0,0) (\u201cA1\u201d). If \u2018coord\u2019 is an area (e.g. \u201cA2:B5\u201d), the upper left position of this area is used as coordinate.</p> <p>The table is not cleared before the operation, to reset the table before setting values, use table.clear().</p> <p>A list of lists is expected, with as many lists as rows, and as many items in each sublist as cells to be setted. None values in the list will create empty cells with no cell type (but eventually a style).</p> <p>Arguments:</p> <pre><code>coord -- tuple or str\n\nvalues -- list of lists of python types\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_values(\n    self,\n    values: list,\n    coord: tuple | list | str | None = None,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Set the value of cells in the table, from the 'coord' position\n    with values.\n\n    'coord' is the coordinate of the upper left cell to be modified by\n    values. If 'coord' is None, default to the position (0,0) (\"A1\").\n    If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n    area is used as coordinate.\n\n    The table is *not* cleared before the operation, to reset the table\n    before setting values, use table.clear().\n\n    A list of lists is expected, with as many lists as rows, and as many\n    items in each sublist as cells to be setted. None values in the list\n    will create empty cells with no cell type (but eventually a style).\n\n    Arguments:\n\n        coord -- tuple or str\n\n        values -- list of lists of python types\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n    \"\"\"\n    if coord:\n        x, y = self._translate_cell_coordinates(coord)\n    else:\n        x = y = 0\n    if y is None:\n        y = 0\n    if x is None:\n        x = 0\n    y -= 1\n    for row_values in values:\n        y += 1\n        if not row_values:\n            continue\n        row = self.get_row(y, clone=True)\n        repeated = row.repeated or 1\n        if repeated &gt;= 2:\n            row.repeated = None\n        row.set_values(\n            row_values,\n            start=x,\n            cell_type=cell_type,\n            currency=currency,\n            style=style,\n        )\n        self.set_row(y, row, clone=False)\n        self._update_width(row)\n</code></pre>"},{"location":"reference.html#odfdo.Table.to_csv","title":"<code>to_csv(path_or_file=None, dialect='excel')</code>","text":"<p>Write the table as CSV in the file.</p> <p>If the file is a string, it is opened as a local path. Else an opened file-like is expected.</p> <p>Arguments:</p> <pre><code>path_or_file -- str or file-like\n\ndialect -- str, python csv.dialect, can be 'excel', 'unix'...\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def to_csv(\n    self,\n    path_or_file: str | Path | None = None,\n    dialect: str = \"excel\",\n) -&gt; Any:\n    \"\"\"Write the table as CSV in the file.\n\n    If the file is a string, it is opened as a local path. Else an\n    opened file-like is expected.\n\n    Arguments:\n\n        path_or_file -- str or file-like\n\n        dialect -- str, python csv.dialect, can be 'excel', 'unix'...\n    \"\"\"\n\n    def write_content(csv_writer: object) -&gt; None:\n        for values in self.iter_values():\n            line = []\n            for value in values:\n                if value is None:\n                    value = \"\"\n                if isinstance(value, str):\n                    value = value.strip()\n                line.append(value)\n            csv_writer.writerow(line)  # type: ignore\n\n    out = StringIO(newline=\"\")\n    csv_writer = csv.writer(out, dialect=dialect)\n    write_content(csv_writer)\n    if path_or_file is None:\n        return out.getvalue()\n    path = Path(path_or_file)\n    path.write_text(out.getvalue())\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Table.transpose","title":"<code>transpose(coord=None)</code>","text":"<p>Swap in-place rows and columns of the table.</p> <p>If \u2018coord\u2019 is not None, apply transpose only to the area defined by the coordinates. Beware, if area is not square, some cells mays be over written during the process.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of area\n\nstart -- int or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def transpose(self, coord: tuple | list | str | None = None) -&gt; None:  # noqa: C901\n    \"\"\"Swap *in-place* rows and columns of the table.\n\n    If 'coord' is not None, apply transpose only to the area defined by the\n    coordinates. Beware, if area is not square, some cells mays be over\n    written during the process.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of area\n\n        start -- int or str\n    \"\"\"\n    data = []\n    if coord is None:\n        for row in self.traverse():\n            data.append(list(row.traverse()))\n        transposed_data = zip_longest(*data)\n        self.clear()\n        # new_rows = []\n        for row_cells in transposed_data:\n            if not isiterable(row_cells):\n                row_cells = (row_cells,)\n            row = Row()\n            row.extend_cells(row_cells)\n            self.append_row(row, clone=False)\n        self._compute_table_cache()\n    else:\n        x, y, z, t = self._translate_table_coordinates(coord)\n        if x is None:\n            x = 0\n        else:\n            x = min(x, self.width - 1)\n        if z is None:\n            z = self.width - 1\n        else:\n            z = min(z, self.width - 1)\n        if y is None:\n            y = 0\n        else:\n            y = min(y, self.height - 1)\n        if t is None:\n            t = self.height - 1\n        else:\n            t = min(t, self.height - 1)\n        for row in self.traverse(start=y, end=t):\n            data.append(list(row.traverse(start=x, end=z)))\n        transposed_data = zip_longest(*data)\n        # clear locally\n        w = z - x + 1\n        h = t - y + 1\n        if w != h:\n            nones = [[None] * w for i in range(h)]\n            self.set_values(nones, coord=(x, y, z, t))\n        # put transposed\n        filtered_data: list[tuple[Cell]] = []\n        for row_cells in transposed_data:\n            if isinstance(row_cells, (list, tuple)):\n                filtered_data.append(row_cells)\n            else:\n                filtered_data.append((row_cells,))\n        self.set_cells(filtered_data, (x, y, x + h - 1, y + w - 1))\n        self._compute_table_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Table.traverse","title":"<code>traverse(start=None, end=None)</code>","text":"<p>Yield as many row elements as expected rows in the table, i.e. expand repetitions by returning the same row as many times as necessary.</p> <pre><code>Arguments:\n\n    start -- int\n\n    end -- int\n</code></pre> <p>Copies are returned, use set_row() to push them back.</p> Source code in <code>odfdo/table.py</code> <pre><code>def traverse(  # noqa: C901\n    self,\n    start: int | None = None,\n    end: int | None = None,\n) -&gt; Iterator[Row]:\n    \"\"\"Yield as many row elements as expected rows in the table, i.e.\n    expand repetitions by returning the same row as many times as\n    necessary.\n\n        Arguments:\n\n            start -- int\n\n            end -- int\n\n    Copies are returned, use set_row() to push them back.\n    \"\"\"\n    idx = -1\n    before = -1\n    y = 0\n    if start is None and end is None:\n        for juska in self._tmap:\n            idx += 1\n            if idx in self._indexes[\"_tmap\"]:\n                row = self._indexes[\"_tmap\"][idx]\n            else:\n                row = self._get_element_idx2(_xpath_row_idx, idx)\n                self._indexes[\"_tmap\"][idx] = row\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                # Return a copy without the now obsolete repetition\n                row = row.clone\n                row.y = y\n                y += 1\n                if repeated &gt; 1:\n                    row.repeated = None\n                yield row\n    else:\n        if start is None:\n            start = 0\n        start = max(0, start)\n        if end is None:\n            try:\n                end = self._tmap[-1]\n            except Exception:\n                end = -1\n        start_map = find_odf_idx(self._tmap, start)\n        if start_map is None:\n            return\n        if start_map &gt; 0:\n            before = self._tmap[start_map - 1]\n        idx = start_map - 1\n        before = start - 1\n        y = start\n        for juska in self._tmap[start_map:]:\n            idx += 1\n            if idx in self._indexes[\"_tmap\"]:\n                row = self._indexes[\"_tmap\"][idx]\n            else:\n                row = self._get_element_idx2(_xpath_row_idx, idx)\n                self._indexes[\"_tmap\"][idx] = row\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                if y &lt;= end:\n                    row = row.clone\n                    row.y = y\n                    y += 1\n                    if repeated &gt; 1 or (y == start and start &gt; 0):\n                        row.repeated = None\n                    yield row\n</code></pre>"},{"location":"reference.html#odfdo.Table.traverse_columns","title":"<code>traverse_columns(start=None, end=None)</code>","text":"<p>Yield as many column elements as expected columns in the table, i.e. expand repetitions by returning the same column as many times as necessary.</p> <pre><code>Arguments:\n\n    start -- int\n\n    end -- int\n</code></pre> <p>Copies are returned, use set_column() to push them back.</p> Source code in <code>odfdo/table.py</code> <pre><code>def traverse_columns(  # noqa: C901\n    self,\n    start: int | None = None,\n    end: int | None = None,\n) -&gt; Iterator[Column]:\n    \"\"\"Yield as many column elements as expected columns in the table,\n    i.e. expand repetitions by returning the same column as many times as\n    necessary.\n\n        Arguments:\n\n            start -- int\n\n            end -- int\n\n    Copies are returned, use set_column() to push them back.\n    \"\"\"\n    idx = -1\n    before = -1\n    x = 0\n    if start is None and end is None:\n        for juska in self._cmap:\n            idx += 1\n            if idx in self._indexes[\"_cmap\"]:\n                column = self._indexes[\"_cmap\"][idx]\n            else:\n                column = self._get_element_idx2(_xpath_column_idx, idx)\n                self._indexes[\"_cmap\"][idx] = column\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                # Return a copy without the now obsolete repetition\n                column = column.clone\n                column.x = x\n                x += 1\n                if repeated &gt; 1:\n                    column.repeated = None\n                yield column\n    else:\n        if start is None:\n            start = 0\n        start = max(0, start)\n        if end is None:\n            try:\n                end = self._cmap[-1]\n            except Exception:\n                end = -1\n        start_map = find_odf_idx(self._cmap, start)\n        if start_map is None:\n            return\n        if start_map &gt; 0:\n            before = self._cmap[start_map - 1]\n        idx = start_map - 1\n        before = start - 1\n        x = start\n        for juska in self._cmap[start_map:]:\n            idx += 1\n            if idx in self._indexes[\"_cmap\"]:\n                column = self._indexes[\"_cmap\"][idx]\n            else:\n                column = self._get_element_idx2(_xpath_column_idx, idx)\n                self._indexes[\"_cmap\"][idx] = column\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                if x &lt;= end:\n                    column = column.clone\n                    column.x = x\n                    x += 1\n                    if repeated &gt; 1 or (x == start and start &gt; 0):\n                        column.repeated = None\n                    yield column\n</code></pre>"},{"location":"reference.html#odfdo.Text","title":"<code>Text</code>","text":"<p>             Bases: <code>Body</code></p> <p>Text, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Text(Body):\n    \"\"\"Text, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:text\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.TextChange","title":"<code>TextChange</code>","text":"<p>             Bases: <code>Element</code></p> <p>The TextChange \u201ctext:change\u201d element marks a position in an empty region where text has been deleted.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChange(Element):\n    \"\"\"The TextChange \"text:change\" element marks a position in an empty\n    region where text has been deleted.\n    \"\"\"\n\n    _tag = \"text:change\"\n\n    def get_id(self) -&gt; str | None:\n        return self.get_attribute_string(\"text:change-id\")\n\n    def set_id(self, idx: str) -&gt; None:\n        self.set_attribute(\"text:change-id\", idx)\n\n    def _get_tracked_changes(self) -&gt; Element | None:\n        body = self.document_body\n        if not body:\n            raise ValueError\n        return body.get_tracked_changes()\n\n    def get_changed_region(\n        self,\n        tracked_changes: Element | None = None,\n    ) -&gt; Element | None:\n        if not tracked_changes:\n            tracked_changes = self._get_tracked_changes()\n        idx = self.get_id()\n        return tracked_changes.get_changed_region(text_id=idx)  # type: ignore\n\n    def get_change_info(\n        self,\n        tracked_changes: Element | None = None,\n    ) -&gt; Element | None:\n        changed_region = self.get_changed_region(tracked_changes=tracked_changes)\n        if not changed_region:\n            return None\n        return changed_region.get_change_info()  # type: ignore\n\n    def get_change_element(\n        self,\n        tracked_changes: Element | None = None,\n    ) -&gt; Element | None:\n        changed_region = self.get_changed_region(tracked_changes=tracked_changes)\n        if not changed_region:\n            return None\n        return changed_region.get_change_element()  # type: ignore\n\n    def get_deleted(\n        self,\n        tracked_changes: Element | None = None,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; Element | None:\n        \"\"\"Shortcut to get the deleted informations stored in the\n        TextDeletion stored in the tracked changes.\n\n        Return: Paragraph (or None).\"\n        \"\"\"\n        changed = self.get_change_element(tracked_changes=tracked_changes)\n        if not changed:\n            return None\n        return changed.get_deleted(  # type: ignore\n            as_text=as_text,\n            no_header=no_header,\n            clean=clean,\n        )\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Return None.\"\"\"\n        return None\n\n    def get_start(self) -&gt; TextChangeStart | None:\n        \"\"\"Return None.\"\"\"\n        return None\n\n    def get_end(self) -&gt; TextChangeEnd | None:\n        \"\"\"Return None.\"\"\"\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_deleted","title":"<code>get_deleted(tracked_changes=None, as_text=False, no_header=False, clean=True)</code>","text":"<p>Shortcut to get the deleted informations stored in the TextDeletion stored in the tracked changes.</p> <p>Return: Paragraph (or None).\u201d</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(\n    self,\n    tracked_changes: Element | None = None,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; Element | None:\n    \"\"\"Shortcut to get the deleted informations stored in the\n    TextDeletion stored in the tracked changes.\n\n    Return: Paragraph (or None).\"\n    \"\"\"\n    changed = self.get_change_element(tracked_changes=tracked_changes)\n    if not changed:\n        return None\n    return changed.get_deleted(  # type: ignore\n        as_text=as_text,\n        no_header=no_header,\n        clean=clean,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_end","title":"<code>get_end()</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_end(self) -&gt; TextChangeEnd | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_start","title":"<code>get_start()</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_start(self) -&gt; TextChangeStart | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd","title":"<code>TextChangeEnd</code>","text":"<p>             Bases: <code>TextChange</code></p> <p>The TextChangeEnd \u201ctext:change-end\u201d element marks the end of a region with content where text has been inserted or the format has been changed.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChangeEnd(TextChange):\n    \"\"\"The TextChangeEnd \"text:change-end\" element marks the end of a region\n    with content where text has been inserted or the format has been\n    changed.\n    \"\"\"\n\n    _tag = \"text:change-end\"\n\n    def get_start(self) -&gt; TextChangeStart | None:\n        \"\"\"Return the corresponding annotation starting tag or None.\"\"\"\n        idx = self.get_id()\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can not find end tag: no parent available.\")\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_text_change_start(idx=idx)  # type: ignore\n\n    def get_end(self) -&gt; TextChangeEnd | None:\n        \"\"\"Return self.\"\"\"\n        return self\n\n    def get_deleted(self, *args: Any, **kwargs: Any) -&gt; Element | None:\n        \"\"\"Return None.\"\"\"\n        return None\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Return the content between text:change-start and text:change-end.\n\n        If no content exists (deletion tag), returns None (or '' if text flag\n        is True).\n        If as_text is True: returns the text content.\n        If clean is True: suppress unwanted tags (deletions marks, ...)\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of Element, cleaned and with headers\n\n        Arguments:\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list or Element or text\n        \"\"\"\n\n        # idx = self.get_id()\n        start = self.get_start()\n        end = self.get_end()\n        if end is None or start is None:\n            if as_text:\n                return \"\"\n            return None\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_between(\n            start, end, as_text=as_text, no_header=no_header, clean=clean\n        )\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_deleted","title":"<code>get_deleted(*args, **kwargs)</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(self, *args: Any, **kwargs: Any) -&gt; Element | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_end","title":"<code>get_end()</code>","text":"<p>Return self.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_end(self) -&gt; TextChangeEnd | None:\n    \"\"\"Return self.\"\"\"\n    return self\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Return the content between text:change-start and text:change-end.</p> <p>If no content exists (deletion tag), returns None (or \u2018\u2019 if text flag is True). If as_text is True: returns the text content. If clean is True: suppress unwanted tags (deletions marks, \u2026) If no_header is True: existing text:h are changed in text:p By default: returns a list of Element, cleaned and with headers</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list or Element or text</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Return the content between text:change-start and text:change-end.\n\n    If no content exists (deletion tag), returns None (or '' if text flag\n    is True).\n    If as_text is True: returns the text content.\n    If clean is True: suppress unwanted tags (deletions marks, ...)\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of Element, cleaned and with headers\n\n    Arguments:\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list or Element or text\n    \"\"\"\n\n    # idx = self.get_id()\n    start = self.get_start()\n    end = self.get_end()\n    if end is None or start is None:\n        if as_text:\n            return \"\"\n        return None\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_between(\n        start, end, as_text=as_text, no_header=no_header, clean=clean\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_start","title":"<code>get_start()</code>","text":"<p>Return the corresponding annotation starting tag or None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_start(self) -&gt; TextChangeStart | None:\n    \"\"\"Return the corresponding annotation starting tag or None.\"\"\"\n    idx = self.get_id()\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Can not find end tag: no parent available.\")\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_text_change_start(idx=idx)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart","title":"<code>TextChangeStart</code>","text":"<p>             Bases: <code>TextChangeEnd</code></p> <p>The TextChangeStart \u201ctext:change-start\u201d element marks the start of a region with content where text has been inserted or the format has been changed.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChangeStart(TextChangeEnd):\n    \"\"\"The TextChangeStart \"text:change-start\" element marks the start of a\n    region with content where text has been inserted or the format has\n    been changed.\n    \"\"\"\n\n    _tag = \"text:change-start\"\n\n    def get_start(self) -&gt; TextChangeStart:\n        \"\"\"Return self.\"\"\"\n        return self\n\n    def get_end(self) -&gt; TextChangeEnd:\n        \"\"\"Return the corresponding change-end tag or None.\"\"\"\n        idx = self.get_id()\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can not find end tag: no parent available.\")\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_text_change_end(idx=idx)  # type: ignore\n\n    def delete(\n        self,\n        child: Element | None = None,\n        keep_tail: bool = True,\n    ) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        For TextChangeStart : delete also the end tag if exists.\n\n        Arguments:\n\n            child -- Element\n\n            keep_tail -- boolean (default to True), True for most usages.\n        \"\"\"\n        if child is not None:  # act like normal delete\n            return super().delete(child, keep_tail)\n        idx = self.get_id()\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"cannot delete the root element\")\n        body = self.document_body\n        if not body:\n            body = parent\n        end = body.get_text_change_end(idx=idx)\n        if end:\n            end.delete()\n        # act like normal delete\n        super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>For TextChangeStart : delete also the end tag if exists.</p> <p>Arguments:</p> <pre><code>child -- Element\n\nkeep_tail -- boolean (default to True), True for most usages.\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def delete(\n    self,\n    child: Element | None = None,\n    keep_tail: bool = True,\n) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    For TextChangeStart : delete also the end tag if exists.\n\n    Arguments:\n\n        child -- Element\n\n        keep_tail -- boolean (default to True), True for most usages.\n    \"\"\"\n    if child is not None:  # act like normal delete\n        return super().delete(child, keep_tail)\n    idx = self.get_id()\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"cannot delete the root element\")\n    body = self.document_body\n    if not body:\n        body = parent\n    end = body.get_text_change_end(idx=idx)\n    if end:\n        end.delete()\n    # act like normal delete\n    super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart.get_end","title":"<code>get_end()</code>","text":"<p>Return the corresponding change-end tag or None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_end(self) -&gt; TextChangeEnd:\n    \"\"\"Return the corresponding change-end tag or None.\"\"\"\n    idx = self.get_id()\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Can not find end tag: no parent available.\")\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_text_change_end(idx=idx)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart.get_start","title":"<code>get_start()</code>","text":"<p>Return self.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_start(self) -&gt; TextChangeStart:\n    \"\"\"Return self.\"\"\"\n    return self\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion","title":"<code>TextChangedRegion</code>","text":"<p>             Bases: <code>Element</code></p> <p>Each TextChangedRegion \u201ctext:changed-region\u201d element contains a single element, one of TextInsertion, TextDeletion or TextFormatChange that corresponds to a change being tracked within the scope of the \u201ctext:tracked-changes\u201d element that contains the \u201ctext:changed-region\u201d instance. The xml:id attribute of the TextChangedRegion is referenced from the \u201ctext:change\u201d, \u201ctext:change-start\u201d and \u201ctext:change-end\u201d elements that identify where the change applies to markup in the scope of the \u201ctext:tracked-changes\u201d element.</p> for this implementation, text:change should be referenced only <p>once in the scope, which is different from ODF 1.2 requirement:</p> <pre><code>     \" A \"text:changed-region\" can be referenced by more than one\n     change, but the corresponding referencing change mark elements\n     shall be of the same change type - insertion, format change or\n     deletion. \"\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChangedRegion(Element):\n    \"\"\"Each TextChangedRegion \"text:changed-region\" element contains a single\n    element, one of TextInsertion, TextDeletion or TextFormatChange that\n    corresponds to a change being tracked within the scope of the\n    \"text:tracked-changes\" element that contains the \"text:changed-region\"\n    instance.\n    The xml:id attribute of the TextChangedRegion is referenced\n    from the \"text:change\", \"text:change-start\" and \"text:change-end\"\n    elements that identify where the change applies to markup in the scope of\n    the \"text:tracked-changes\" element.\n\n    Warning : for this implementation, text:change should be referenced only\n              once in the scope, which is different from ODF 1.2 requirement:\n             \" A \"text:changed-region\" can be referenced by more than one\n             change, but the corresponding referencing change mark elements\n             shall be of the same change type - insertion, format change or\n             deletion. \"\n    \"\"\"\n\n    _tag = \"text:changed-region\"\n\n    def get_change_info(self) -&gt; Element | None:\n        \"\"\"Shortcut to get the ChangeInfo element of the change\n        element child.\n\n        Return: ChangeInfo element.\n        \"\"\"\n        return self.get_element(\"descendant::office:change-info\")\n\n    def set_change_info(\n        self,\n        change_info: Element | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        comments: Element | list[Element] | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the ChangeInfo element of the sub change element.\n        See TextInsertion.set_change_info() for details.\n\n        Arguments:\n\n             change_info -- ChangeInfo element (or None)\n\n             cretor -- str (or None)\n\n             date -- datetime (or None)\n\n             comments -- Paragraph or list of Paragraph elements (or None)\n        \"\"\"\n        child = self.get_change_element()\n        if not child:\n            raise ValueError\n        child.set_change_info(  # type: ignore\n            change_info=change_info, creator=creator, date=date, comments=comments\n        )\n\n    def get_change_element(self) -&gt; Element | None:\n        \"\"\"Get the change element child. It can be either: TextInsertion,\n        TextDeletion, or TextFormatChange as an Element object.\n\n        Return: Element.\n        \"\"\"\n        request = (\n            \"descendant::text:insertion \"\n            \"| descendant::text:deletion\"\n            \"| descendant::text:format-change\"\n        )\n        return self._filtered_element(request, 0)\n\n    def _get_text_id(self) -&gt; str | None:\n        return self.get_attribute_string(\"text:id\")\n\n    def _set_text_id(self, text_id: str) -&gt; None:\n        self.set_attribute(\"text:id\", text_id)\n\n    def _get_xml_id(self) -&gt; str | None:\n        return self.get_attribute_string(\"xml:id\")\n\n    def _set_xml_id(self, xml_id: str) -&gt; None:\n        self.set_attribute(\"xml:id\", xml_id)\n\n    def get_id(self) -&gt; str | None:\n        \"\"\"Get the \"text:id\" attribute.\n\n        Return: str\n        \"\"\"\n        return self._get_text_id()\n\n    def set_id(self, idx: str) -&gt; None:\n        \"\"\"Set both the \"text:id\" and \"xml:id\" attributes with same value.\"\"\"\n        self._set_text_id(idx)\n        self._set_xml_id(idx)\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.get_change_element","title":"<code>get_change_element()</code>","text":"<p>Get the change element child. It can be either: TextInsertion, TextDeletion, or TextFormatChange as an Element object.</p> <p>Return: Element.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_change_element(self) -&gt; Element | None:\n    \"\"\"Get the change element child. It can be either: TextInsertion,\n    TextDeletion, or TextFormatChange as an Element object.\n\n    Return: Element.\n    \"\"\"\n    request = (\n        \"descendant::text:insertion \"\n        \"| descendant::text:deletion\"\n        \"| descendant::text:format-change\"\n    )\n    return self._filtered_element(request, 0)\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.get_change_info","title":"<code>get_change_info()</code>","text":"<p>Shortcut to get the ChangeInfo element of the change element child.</p> <p>Return: ChangeInfo element.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_change_info(self) -&gt; Element | None:\n    \"\"\"Shortcut to get the ChangeInfo element of the change\n    element child.\n\n    Return: ChangeInfo element.\n    \"\"\"\n    return self.get_element(\"descendant::office:change-info\")\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.get_id","title":"<code>get_id()</code>","text":"<p>Get the \u201ctext:id\u201d attribute.</p> <p>Return: str</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_id(self) -&gt; str | None:\n    \"\"\"Get the \"text:id\" attribute.\n\n    Return: str\n    \"\"\"\n    return self._get_text_id()\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.set_change_info","title":"<code>set_change_info(change_info=None, creator=None, date=None, comments=None)</code>","text":"<p>Shortcut to set the ChangeInfo element of the sub change element. See TextInsertion.set_change_info() for details.</p> <p>Arguments:</p> <pre><code> change_info -- ChangeInfo element (or None)\n\n cretor -- str (or None)\n\n date -- datetime (or None)\n\n comments -- Paragraph or list of Paragraph elements (or None)\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_change_info(\n    self,\n    change_info: Element | None = None,\n    creator: str | None = None,\n    date: datetime | None = None,\n    comments: Element | list[Element] | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the ChangeInfo element of the sub change element.\n    See TextInsertion.set_change_info() for details.\n\n    Arguments:\n\n         change_info -- ChangeInfo element (or None)\n\n         cretor -- str (or None)\n\n         date -- datetime (or None)\n\n         comments -- Paragraph or list of Paragraph elements (or None)\n    \"\"\"\n    child = self.get_change_element()\n    if not child:\n        raise ValueError\n    child.set_change_info(  # type: ignore\n        change_info=change_info, creator=creator, date=date, comments=comments\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.set_id","title":"<code>set_id(idx)</code>","text":"<p>Set both the \u201ctext:id\u201d and \u201cxml:id\u201d attributes with same value.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_id(self, idx: str) -&gt; None:\n    \"\"\"Set both the \"text:id\" and \"xml:id\" attributes with same value.\"\"\"\n    self._set_text_id(idx)\n    self._set_xml_id(idx)\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion","title":"<code>TextDeletion</code>","text":"<p>             Bases: <code>TextInsertion</code></p> <p>The TextDeletion \u201ctext:deletion\u201d contains information that identifies the person responsible for a deletion and the date of that deletion. This information may also contain one or more Paragraph which contains a comment on the deletion. The TextDeletion element may also contain content that was deleted while change tracking was enabled. The position where the text was deleted is marked by a \u201ctext:change\u201d element. Deleted text is contained in a paragraph element. To reconstruct the original text, the paragraph containing the deleted text is merged with its surrounding paragraph or heading element. To reconstruct the text before a deletion took place:   - If the change mark is inside a paragraph, insert the content that was   deleted, but remove all leading start tags up to and including the   first \u201ctext:p\u201d element and all trailing end tags up to and including   the last \u201c/text:p\u201d or \u201c/text:h\u201d element. If the last trailing element   is a \u201c/text:h\u201d, change the end tag \u201c/text:p\u201d following this insertion   to a \u201c/text:h\u201d element.   - If the change mark is inside a heading, insert the content that was   deleted, but remove all leading start tags up to and including the   first \u201ctext:h\u201d element and all trailing end tags up to and including   the last \u201c/text:h\u201d or \u201c/text:p\u201d element. If the last trailing element   is a \u201c/text:p\u201d, change the end tag \u201c/text:h\u201d following this insertion   to a \u201c/text:p\u201d element.   - Otherwise, copy the text content of the \u201ctext:deletion\u201d element in   place of the change mark.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextDeletion(TextInsertion):\n    \"\"\"The TextDeletion \"text:deletion\" contains information that identifies\n    the person responsible for a deletion and the date of that deletion.\n    This information may also contain one or more Paragraph which contains\n    a comment on the deletion. The TextDeletion element may also contain\n    content that was deleted while change tracking was enabled. The position\n    where the text was deleted is marked by a \"text:change\" element. Deleted\n    text is contained in a paragraph element. To reconstruct the original\n    text, the paragraph containing the deleted text is merged with its\n    surrounding paragraph or heading element. To reconstruct the text before\n    a deletion took place:\n      - If the change mark is inside a paragraph, insert the content that was\n      deleted, but remove all leading start tags up to and including the\n      first \"text:p\" element and all trailing end tags up to and including\n      the last \"/text:p\" or \"/text:h\" element. If the last trailing element\n      is a \"/text:h\", change the end tag \"/text:p\" following this insertion\n      to a \"/text:h\" element.\n      - If the change mark is inside a heading, insert the content that was\n      deleted, but remove all leading start tags up to and including the\n      first \"text:h\" element and all trailing end tags up to and including\n      the last \"/text:h\" or \"/text:p\" element. If the last trailing element\n      is a \"/text:p\", change the end tag \"/text:h\" following this insertion\n      to a \"/text:p\" element.\n      - Otherwise, copy the text content of the \"text:deletion\" element in\n      place of the change mark.\n    \"\"\"\n\n    _tag = \"text:deletion\"\n\n    def get_deleted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n    ) -&gt; str | list[Element] | None:\n        \"\"\"Get the deleted informations stored in the TextDeletion.\n        If as_text is True: returns the text content.\n        If no_header is True: existing Heading are changed in Paragraph\n\n        Arguments:\n\n            as_text -- boolean\n\n            no_header -- boolean\n\n        Return: Paragraph and Header list\n        \"\"\"\n        children = self.children\n        inner = [elem for elem in children if elem.tag != \"office:change-info\"]\n        if no_header:  # crude replace t:h by t:p\n            new_inner = []\n            for element in inner:\n                if element.tag == \"text:h\":\n                    children = element.children\n                    text = element.text\n                    para = Element.from_tag(\"text:p\")\n                    para.text = text\n                    for child in children:\n                        para.append(child)\n                    new_inner.append(para)\n                else:\n                    new_inner.append(element)\n            inner = new_inner\n        if as_text:\n            return \"\\n\".join([elem.get_formatted_text(context=None) for elem in inner])\n        return inner\n\n    def set_deleted(self, paragraph_or_list: Element | list[Element]) -&gt; None:\n        \"\"\"Set the deleted informations stored in the TextDeletion. An\n        actual content that was deleted is expected, embeded in a Paragraph\n        element or Header.\n\n        Arguments:\n\n            paragraph_or_list -- Paragraph or Header element (or list)\n        \"\"\"\n        for element in self.get_deleted():  # type: ignore\n            self.delete(element)  # type: ignore\n        if isinstance(paragraph_or_list, Element):\n            paragraph_or_list = [paragraph_or_list]\n        for element in paragraph_or_list:\n            self.append(element)\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Return None.\"\"\"\n        if as_text:\n            return \"\"\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion.get_deleted","title":"<code>get_deleted(as_text=False, no_header=False)</code>","text":"<p>Get the deleted informations stored in the TextDeletion. If as_text is True: returns the text content. If no_header is True: existing Heading are changed in Paragraph</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: Paragraph and Header list</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n) -&gt; str | list[Element] | None:\n    \"\"\"Get the deleted informations stored in the TextDeletion.\n    If as_text is True: returns the text content.\n    If no_header is True: existing Heading are changed in Paragraph\n\n    Arguments:\n\n        as_text -- boolean\n\n        no_header -- boolean\n\n    Return: Paragraph and Header list\n    \"\"\"\n    children = self.children\n    inner = [elem for elem in children if elem.tag != \"office:change-info\"]\n    if no_header:  # crude replace t:h by t:p\n        new_inner = []\n        for element in inner:\n            if element.tag == \"text:h\":\n                children = element.children\n                text = element.text\n                para = Element.from_tag(\"text:p\")\n                para.text = text\n                for child in children:\n                    para.append(child)\n                new_inner.append(para)\n            else:\n                new_inner.append(element)\n        inner = new_inner\n    if as_text:\n        return \"\\n\".join([elem.get_formatted_text(context=None) for elem in inner])\n    return inner\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Return None.\"\"\"\n    if as_text:\n        return \"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion.set_deleted","title":"<code>set_deleted(paragraph_or_list)</code>","text":"<p>Set the deleted informations stored in the TextDeletion. An actual content that was deleted is expected, embeded in a Paragraph element or Header.</p> <p>Arguments:</p> <pre><code>paragraph_or_list -- Paragraph or Header element (or list)\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_deleted(self, paragraph_or_list: Element | list[Element]) -&gt; None:\n    \"\"\"Set the deleted informations stored in the TextDeletion. An\n    actual content that was deleted is expected, embeded in a Paragraph\n    element or Header.\n\n    Arguments:\n\n        paragraph_or_list -- Paragraph or Header element (or list)\n    \"\"\"\n    for element in self.get_deleted():  # type: ignore\n        self.delete(element)  # type: ignore\n    if isinstance(paragraph_or_list, Element):\n        paragraph_or_list = [paragraph_or_list]\n    for element in paragraph_or_list:\n        self.append(element)\n</code></pre>"},{"location":"reference.html#odfdo.TextFormatChange","title":"<code>TextFormatChange</code>","text":"<p>             Bases: <code>TextInsertion</code></p> <p>The TextFormatChange \u201ctext:format-change\u201d element represents any change in formatting attributes. The region where the change took place is marked by \u201ctext:change-start\u201d, \u201ctext:change-end\u201d or \u201ctext:change\u201d elements.</p> <p>Note: This element does not contain formatting changes that have taken place.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextFormatChange(TextInsertion):\n    \"\"\"The TextFormatChange \"text:format-change\" element represents any change\n    in formatting attributes. The region where the change took place is\n    marked by \"text:change-start\", \"text:change-end\" or \"text:change\"\n    elements.\n\n    Note: This element does not contain formatting changes that have taken\n    place.\n    \"\"\"\n\n    _tag = \"text:format-change\"\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion","title":"<code>TextInsertion</code>","text":"<p>             Bases: <code>Element</code></p> <p>The TextInsertion \u201ctext:insertion\u201d element contains the information that identifies the person responsible for a change and the date of that change. This information may also contain one or more \u201ctext:p\u201d Paragraph which contain a comment on the insertion. The TextInsertion element\u2019s parent \u201ctext:changed-region\u201d element has an xml:id or text:id attribute, the value of which binds that parent element to the text:change-id attribute on the \u201ctext:change-start\u201d and \u201ctext:change-end\u201d elements.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextInsertion(Element):\n    \"\"\"The TextInsertion \"text:insertion\" element contains the information\n    that identifies the person responsible for a change and the date of\n    that change. This information may also contain one or more \"text:p\"\n    Paragraph which contain a comment on the insertion. The\n    TextInsertion element's parent \"text:changed-region\" element has an\n    xml:id or text:id attribute, the value of which binds that parent\n    element to the text:change-id attribute on the \"text:change-start\"\n    and \"text:change-end\" elements.\n    \"\"\"\n\n    _tag = \"text:insertion\"\n\n    def get_deleted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n    ) -&gt; str | list[Element] | None:\n        \"\"\"Return: None.\"\"\"\n        if as_text:\n            return \"\"\n        return None\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Shortcut to text:change-start.get_inserted(). Return the content\n        between text:change-start and text:change-end.\n\n        If as_text is True: returns the text content.\n        If no_header is True: existing Heading are changed in Paragraph\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of Element, cleaned and with headers\n\n        Arguments:\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list or Element or text\n        \"\"\"\n        current = self.parent  # text:changed-region\n        if not current:\n            raise ValueError\n        idx = current.get_id()  # type: ignore\n        body = self.document_body\n        if not body:\n            body = self.root\n        text_change = body.get_text_change_start(idx=idx)\n        if not text_change:\n            raise ValueError\n        return text_change.get_inserted(  # type: ignore\n            as_text=as_text, no_header=no_header, clean=clean\n        )\n\n    def get_change_info(self) -&gt; Element | None:\n        \"\"\"Get the ChangeInfo child of the element.\n\n        Return: ChangeInfo element.\n        \"\"\"\n        return self.get_element(\"descendant::office:change-info\")\n\n    def set_change_info(\n        self,\n        change_info: Element | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        comments: Element | list[Element] | None = None,\n    ) -&gt; None:\n        \"\"\"Set the ChangeInfo element for the change element. If change_info\n        is not provided, creator, date and comments will be used to build a\n        suitable change info element. Default for creator is 'Unknown',\n        default for date is current time and default for comments is no\n        comment at all.\n        The new change info element will replace any existant ChangeInfo.\n\n        Arguments:\n\n             change_info -- ChangeInfo element (or None)\n\n             cretor -- str (or None)\n\n             date -- datetime (or None)\n\n             comments -- Paragraph or list of Paragraph elements (or None)\n        \"\"\"\n        if change_info is None:\n            new_change_info = ChangeInfo(creator, date)\n            if comments is not None:\n                if isinstance(comments, Element):\n                    # single pararagraph comment\n                    comments_list = [comments]\n                else:\n                    comments_list = comments\n                # assume iterable of Paragraph\n                for paragraph in comments_list:\n                    if not isinstance(paragraph, Paragraph):\n                        raise TypeError(f\"Not a Paragraph: '{paragraph!r}'\")\n                    new_change_info.insert(paragraph, xmlposition=LAST_CHILD)\n        else:\n            if not isinstance(change_info, ChangeInfo):\n                raise TypeError(f\"Not a ChangeInfo: '{change_info!r}'\")\n            new_change_info = change_info\n\n        old = self.get_change_info()\n        if old is not None:\n            self.replace_element(old, new_change_info)\n        else:\n            self.insert(new_change_info, xmlposition=FIRST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.get_change_info","title":"<code>get_change_info()</code>","text":"<p>Get the ChangeInfo child of the element.</p> <p>Return: ChangeInfo element.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_change_info(self) -&gt; Element | None:\n    \"\"\"Get the ChangeInfo child of the element.\n\n    Return: ChangeInfo element.\n    \"\"\"\n    return self.get_element(\"descendant::office:change-info\")\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.get_deleted","title":"<code>get_deleted(as_text=False, no_header=False)</code>","text":"<p>Return: None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n) -&gt; str | list[Element] | None:\n    \"\"\"Return: None.\"\"\"\n    if as_text:\n        return \"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Shortcut to text:change-start.get_inserted(). Return the content between text:change-start and text:change-end.</p> <p>If as_text is True: returns the text content. If no_header is True: existing Heading are changed in Paragraph If no_header is True: existing text:h are changed in text:p By default: returns a list of Element, cleaned and with headers</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list or Element or text</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Shortcut to text:change-start.get_inserted(). Return the content\n    between text:change-start and text:change-end.\n\n    If as_text is True: returns the text content.\n    If no_header is True: existing Heading are changed in Paragraph\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of Element, cleaned and with headers\n\n    Arguments:\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list or Element or text\n    \"\"\"\n    current = self.parent  # text:changed-region\n    if not current:\n        raise ValueError\n    idx = current.get_id()  # type: ignore\n    body = self.document_body\n    if not body:\n        body = self.root\n    text_change = body.get_text_change_start(idx=idx)\n    if not text_change:\n        raise ValueError\n    return text_change.get_inserted(  # type: ignore\n        as_text=as_text, no_header=no_header, clean=clean\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.set_change_info","title":"<code>set_change_info(change_info=None, creator=None, date=None, comments=None)</code>","text":"<p>Set the ChangeInfo element for the change element. If change_info is not provided, creator, date and comments will be used to build a suitable change info element. Default for creator is \u2018Unknown\u2019, default for date is current time and default for comments is no comment at all. The new change info element will replace any existant ChangeInfo.</p> <p>Arguments:</p> <pre><code> change_info -- ChangeInfo element (or None)\n\n cretor -- str (or None)\n\n date -- datetime (or None)\n\n comments -- Paragraph or list of Paragraph elements (or None)\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_change_info(\n    self,\n    change_info: Element | None = None,\n    creator: str | None = None,\n    date: datetime | None = None,\n    comments: Element | list[Element] | None = None,\n) -&gt; None:\n    \"\"\"Set the ChangeInfo element for the change element. If change_info\n    is not provided, creator, date and comments will be used to build a\n    suitable change info element. Default for creator is 'Unknown',\n    default for date is current time and default for comments is no\n    comment at all.\n    The new change info element will replace any existant ChangeInfo.\n\n    Arguments:\n\n         change_info -- ChangeInfo element (or None)\n\n         cretor -- str (or None)\n\n         date -- datetime (or None)\n\n         comments -- Paragraph or list of Paragraph elements (or None)\n    \"\"\"\n    if change_info is None:\n        new_change_info = ChangeInfo(creator, date)\n        if comments is not None:\n            if isinstance(comments, Element):\n                # single pararagraph comment\n                comments_list = [comments]\n            else:\n                comments_list = comments\n            # assume iterable of Paragraph\n            for paragraph in comments_list:\n                if not isinstance(paragraph, Paragraph):\n                    raise TypeError(f\"Not a Paragraph: '{paragraph!r}'\")\n                new_change_info.insert(paragraph, xmlposition=LAST_CHILD)\n    else:\n        if not isinstance(change_info, ChangeInfo):\n            raise TypeError(f\"Not a ChangeInfo: '{change_info!r}'\")\n        new_change_info = change_info\n\n    old = self.get_change_info()\n    if old is not None:\n        self.replace_element(old, new_change_info)\n    else:\n        self.insert(new_change_info, xmlposition=FIRST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.TocEntryTemplate","title":"<code>TocEntryTemplate</code>","text":"<p>             Bases: <code>Element</code></p> <p>ODF \u201ctext:table-of-content-entry-template\u201d</p> <p>Arguments:</p> <pre><code>style -- str\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>class TocEntryTemplate(Element):\n    \"\"\"ODF \"text:table-of-content-entry-template\"\n\n    Arguments:\n\n        style -- str\n    \"\"\"\n\n    _tag = \"text:table-of-content-entry-template\"\n    _properties = (PropDef(\"style\", \"text:style-name\"),)\n\n    def __init__(\n        self,\n        style: str | None = None,\n        outline_level: int | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style:\n                self.style = style\n            if outline_level:\n                self.outline_level = outline_level\n\n    @property\n    def outline_level(self) -&gt; int | None:\n        return self.get_attribute_integer(\"text:outline-level\")\n\n    @outline_level.setter\n    def outline_level(self, level: int) -&gt; None:\n        self.set_attribute(\"text:outline-level\", str(level))\n\n    def complete_defaults(self) -&gt; None:\n        self.append(Element.from_tag(\"text:index-entry-chapter\"))\n        self.append(Element.from_tag(\"text:index-entry-text\"))\n        self.append(Element.from_tag(\"text:index-entry-text\"))\n        ts = Element.from_tag(\"text:index-entry-text\")\n        ts.set_style_attribute(\"style:type\", \"right\")\n        ts.set_style_attribute(\"style:leader-char\", \".\")\n        self.append(ts)\n        self.append(Element.from_tag(\"text:index-entry-page-number\"))\n</code></pre>"},{"location":"reference.html#odfdo.TrackedChanges","title":"<code>TrackedChanges</code>","text":"<p>             Bases: <code>Element</code></p> <p>The TrackedChanges \u201ctext:tracked-changes\u201d element acts as a container for TextChangedRegion elements that represent changes in a certain scope of an OpenDocument document. This scope is the element in which the TrackedChanges element occurs. Changes in this scope shall be tracked by TextChangedRegion elements contained in the TrackedChanges element in this scope. If a TrackedChanges element is absent, there are no tracked changes in the corresponding scope. In this case, all change mark elements in this scope shall be ignored.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TrackedChanges(Element):\n    \"\"\"The TrackedChanges \"text:tracked-changes\" element acts as a container\n    for TextChangedRegion elements that represent changes in a certain\n    scope of an OpenDocument document. This scope is the element in which\n    the TrackedChanges element occurs. Changes in this scope shall be\n    tracked by TextChangedRegion elements contained in the\n    TrackedChanges element in this scope. If a TrackedChanges\n    element is absent, there are no tracked changes in the corresponding\n    scope. In this case, all change mark elements in this scope shall be\n    ignored.\n    \"\"\"\n\n    _tag = \"text:tracked-changes\"\n\n    def get_changed_regions(\n        self,\n        creator: str | None = None,\n        date: datetime | None = None,\n        content: str | None = None,\n        role: str | None = None,\n    ) -&gt; list[Element]:\n        changed_regions = self._filtered_elements(\n            \"text:changed-region\",\n            dc_creator=creator,\n            dc_date=date,\n            content=content,\n        )\n        if role is None:\n            return changed_regions\n        result: list[Element] = []\n        for regien in changed_regions:\n            changed = regien.get_change_element()  # type: ignore\n            if not changed:\n                continue\n            if changed.tag.endswith(role):\n                result.append(regien)\n        return result\n\n    def get_changed_region(\n        self,\n        position: int = 0,\n        text_id: str | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        return self._filtered_element(\n            \"text:changed-region\",\n            position,\n            text_id=text_id,\n            dc_creator=creator,\n            dc_date=date,\n            content=content,\n        )\n</code></pre>"},{"location":"reference.html#odfdo.UserDefined","title":"<code>UserDefined</code>","text":"<p>             Bases: <code>ElementTyped</code></p> <p>Return a user defined field \u201ctext:user-defined\u201d. If the current document is provided, try to extract the content of the meta user defined field of same name.</p> <p>Arguments:</p> <pre><code>name -- str, name of the user defined field\n\nvalue -- python typed value, value of the field\n\nvalue_type -- str, office:value-type known type\n\ntext -- str\n\nstyle -- str\n\nfrom_document -- ODF document\n</code></pre> Source code in <code>odfdo/variable.py</code> <pre><code>class UserDefined(ElementTyped):\n    \"\"\"Return a user defined field \"text:user-defined\". If the current\n    document is provided, try to extract the content of the meta user defined\n    field of same name.\n\n    Arguments:\n\n        name -- str, name of the user defined field\n\n        value -- python typed value, value of the field\n\n        value_type -- str, office:value-type known type\n\n        text -- str\n\n        style -- str\n\n        from_document -- ODF document\n    \"\"\"\n\n    _tag = \"text:user-defined\"\n    _properties = (\n        PropDef(\"name\", \"text:name\"),\n        PropDef(\"style\", \"style:data-style-name\"),\n    )\n\n    def __init__(\n        self,\n        name: str = \"\",\n        value: Any = None,\n        value_type: str | None = None,\n        text: str | None = None,\n        style: str | None = None,\n        from_document: Document | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if name:\n                self.name = name\n            if style:\n                self.style = style\n            if from_document is not None:\n                meta_infos = from_document.meta\n                content = meta_infos.get_user_defined_metadata_of_name(name)\n                if content is not None:\n                    value = content.get(\"value\", None)\n                    value_type = content.get(\"value_type\", None)\n                    text = content.get(\"text\", None)\n            text = self.set_value_and_type(\n                value=value, value_type=value_type, text=text\n            )\n            self.text = text  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.VarChapter","title":"<code>VarChapter</code>","text":"<p>             Bases: <code>Element</code></p> Source code in <code>odfdo/variable.py</code> <pre><code>class VarChapter(Element):\n    _tag = \"text:chapter\"\n    _properties = (\n        PropDef(\"display\", \"text:display\"),\n        PropDef(\"outline_level\", \"text:outline-level\"),\n    )\n    DISPLAY_VALUE_CHOICE = {  # noqa: RUF012\n        \"number\",\n        \"name\",\n        \"number-and-name\",\n        \"plain-number\",\n        \"plain-number-and-name\",\n    }\n\n    def __init__(\n        self,\n        display: str | None = \"name\",\n        outline_level: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"display can be: 'number', 'name', 'number-and-name', 'plain-number' or\n        'plain-number-and-name'\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if display not in VarChapter.DISPLAY_VALUE_CHOICE:\n                raise ValueError(f\"Unknown display value: '{display}'\")\n            self.display = display\n            if outline_level is not None:\n                self.outline_level = outline_level\n</code></pre>"},{"location":"reference.html#odfdo.VarChapter.__init__","title":"<code>__init__(display='name', outline_level=None, **kwargs)</code>","text":"<p>display can be: \u2018number\u2019, \u2018name\u2019, \u2018number-and-name\u2019, \u2018plain-number\u2019 or \u2018plain-number-and-name\u2019</p> Source code in <code>odfdo/variable.py</code> <pre><code>def __init__(\n    self,\n    display: str | None = \"name\",\n    outline_level: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"display can be: 'number', 'name', 'number-and-name', 'plain-number' or\n    'plain-number-and-name'\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if display not in VarChapter.DISPLAY_VALUE_CHOICE:\n            raise ValueError(f\"Unknown display value: '{display}'\")\n        self.display = display\n        if outline_level is not None:\n            self.outline_level = outline_level\n</code></pre>"},{"location":"reference.html#odfdo.VarFileName","title":"<code>VarFileName</code>","text":"<p>             Bases: <code>Element</code></p> Source code in <code>odfdo/variable.py</code> <pre><code>class VarFileName(Element):\n    _tag = \"text:file-name\"\n    _properties = (\n        PropDef(\"display\", \"text:display\"),\n        PropDef(\"fixed\", \"text:fixed\"),\n    )\n    DISPLAY_VALUE_CHOICE = {  # noqa: RUF012\n        \"full\",\n        \"path\",\n        \"name\",\n        \"name-and-extension\",\n    }\n\n    def __init__(\n        self,\n        display: str | None = \"full\",\n        fixed: bool = False,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"display can be: 'full', 'path', 'name' or 'name-and-extension'\"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if display not in VarFileName.DISPLAY_VALUE_CHOICE:\n                raise ValueError(f\"Unknown display value: '{display}'\")\n            self.display = display\n            if fixed:\n                self.fixed = True\n</code></pre>"},{"location":"reference.html#odfdo.VarFileName.__init__","title":"<code>__init__(display='full', fixed=False, **kwargs)</code>","text":"<p>display can be: \u2018full\u2019, \u2018path\u2019, \u2018name\u2019 or \u2018name-and-extension\u2019</p> Source code in <code>odfdo/variable.py</code> <pre><code>def __init__(\n    self,\n    display: str | None = \"full\",\n    fixed: bool = False,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"display can be: 'full', 'path', 'name' or 'name-and-extension'\"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if display not in VarFileName.DISPLAY_VALUE_CHOICE:\n            raise ValueError(f\"Unknown display value: '{display}'\")\n        self.display = display\n        if fixed:\n            self.fixed = True\n</code></pre>"},{"location":"reference.html#odfdo.VarPageNumber","title":"<code>VarPageNumber</code>","text":"<p>             Bases: <code>Element</code></p> <p>select_page \u2013 string in (\u2018previous\u2019, \u2018current\u2019, \u2018next\u2019)</p> <p>page_adjust \u2013 int (to add or subtract to the page number)</p> Source code in <code>odfdo/variable.py</code> <pre><code>class VarPageNumber(Element):\n    \"\"\"\n    select_page -- string in ('previous', 'current', 'next')\n\n    page_adjust -- int (to add or subtract to the page number)\n    \"\"\"\n\n    _tag = \"text:page-number\"\n    _properties = (\n        PropDef(\"select_page\", \"text:select-page\"),\n        PropDef(\"page_adjust\", \"text:page-adjust\"),\n    )\n\n    def __init__(\n        self,\n        select_page: str | None = None,\n        page_adjust: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if select_page is None:\n                select_page = \"current\"\n            self.select_page = select_page\n            if page_adjust is not None:\n                self.page_adjust = page_adjust\n</code></pre>"},{"location":"reference.html#odfdo.XmlPart","title":"<code>XmlPart</code>","text":"<p>Representation of an XML part.</p> <p>Abstraction of the XML library behind.</p> Source code in <code>odfdo/xmlpart.py</code> <pre><code>class XmlPart:\n    \"\"\"Representation of an XML part.\n\n    Abstraction of the XML library behind.\n    \"\"\"\n\n    def __init__(self, part_name: str, container: Container) -&gt; None:\n        self.part_name = part_name\n        self.container = container\n\n        # Internal state\n        self.__tree: _ElementTree | None = None\n        self.__root: Element | None = None\n\n    def _get_tree(self) -&gt; _ElementTree:\n        if self.__tree is None:\n            part = self.container.get_part(self.part_name)\n            self.__tree = parse(BytesIO(part))  # type: ignore\n        return self.__tree\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} part_name={self.part_name}&gt;\"\n\n    # Public API\n\n    @property\n    def root(self) -&gt; Element:\n        if self.__root is None:\n            tree = self._get_tree()\n            self.__root = Element.from_tag(tree.getroot())\n        return self.__root\n\n    @property\n    def body(self) -&gt; Element:\n        \"\"\"Get or set the document body : 'office:body'\"\"\"\n        body = self.root.document_body\n        if not isinstance(body, Element):\n            raise TypeError(f\"No body found in {self.part_name!r}\")\n        return body\n\n    @body.setter\n    def body(self, new_body: Element) -&gt; None:\n        body = self.root.document_body\n        if not isinstance(body, Element):\n            raise TypeError(\"//office:body not found in document\")\n        tail = body.tail\n        body.clear()\n        for item in new_body.children:\n            body.append(item)\n        if tail:\n            body.tail = tail\n\n    def get_elements(self, xpath_query: str) -&gt; list[Element | EText]:\n        root = self.root\n        return root.xpath(xpath_query)\n\n    def get_element(self, xpath_query: str) -&gt; Any:\n        result = self.get_elements(xpath_query)\n        if not result:\n            return None\n        return result[0]\n\n    def delete_element(self, child: Element) -&gt; None:\n        child.delete()\n\n    def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n        \"\"\"Apply XPath query to the XML part. Return list of Element or\n        EText instances translated from the nodes found.\n        \"\"\"\n        root = self.root\n        return root.xpath(xpath_query)\n\n    @property\n    def clone(self) -&gt; XmlPart:\n        clone = object.__new__(self.__class__)\n        for name in self.__dict__:\n            if name == \"container\":\n                setattr(clone, name, self.container.clone)\n            elif name in (\"_XmlPart__tree\",):\n                setattr(clone, name, None)\n            else:\n                value = getattr(self, name)\n                value = deepcopy(value)\n                setattr(clone, name, value)\n        return clone\n\n    def serialize(self, pretty: bool = False) -&gt; bytes:\n        tree = self._get_tree()\n        xml_header = b'&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\\n'\n        bytes_tree = tostring(\n            tree,\n            pretty_print=pretty,\n            encoding=\"utf8\",\n        )\n        # Lxml with pretty_print is adding a empty line\n        if pretty:\n            bytes_tree = bytes_tree.strip()\n        return xml_header + bytes_tree\n</code></pre>"},{"location":"reference.html#odfdo.XmlPart.body","title":"<code>body: Element</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the document body : \u2018office:body\u2019</p>"},{"location":"reference.html#odfdo.XmlPart.xpath","title":"<code>xpath(xpath_query)</code>","text":"<p>Apply XPath query to the XML part. Return list of Element or EText instances translated from the nodes found.</p> Source code in <code>odfdo/xmlpart.py</code> <pre><code>def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n    \"\"\"Apply XPath query to the XML part. Return list of Element or\n    EText instances translated from the nodes found.\n    \"\"\"\n    root = self.root\n    return root.xpath(xpath_query)\n</code></pre>"},{"location":"reference.html#odfdo.PageBreak","title":"<code>PageBreak()</code>","text":"<p>Return an empty paragraph with a manual page break.</p> Using this function requires to register the page break style with <p>document.add_page_break_style()</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def PageBreak() -&gt; Paragraph:\n    \"\"\"Return an empty paragraph with a manual page break.\n\n    Using this function requires to register the page break style with:\n        document.add_page_break_style()\n    \"\"\"\n    return Paragraph(\"\", style=\"odfdopagebreak\")\n</code></pre>"},{"location":"reference.html#odfdo.create_table_cell_style","title":"<code>create_table_cell_style(border=None, border_top=None, border_bottom=None, border_left=None, border_right=None, padding=None, padding_top=None, padding_bottom=None, padding_left=None, padding_right=None, background_color=None, shadow=None, color=None)</code>","text":"<p>Return a cell style.</p> <p>The borders arguments must be some style attribute strings or None, see the method \u2018make_table_cell_border_string\u2019 to generate them. If the \u2018border\u2019 argument as the value \u2018default\u2019, the default style \u201c0.06pt solid #000000\u201d is used for the 4 borders. If any value is used for border, it is used for the 4 borders, else any of the 4 borders can be specified by it\u2019s own string. If all the border, border_top, border_bottom, \u2026 arguments are None, an empty border is used (ODF value is fo:border=\u201dnone\u201d).</p> <p>Padding arguments are string specifying a length (e.g. \u201c0.5mm\u201d)\u201d. If \u2018padding\u2019 is provided, it is used for the 4 sides, else any of the 4 sides padding can be specified by it\u2019s own string. Default padding is no padding.</p> <p>Arguments:</p> <pre><code>border -- str, style string for borders on four sides\n\nborder_top -- str, style string for top if no 'border' argument\n\nborder_bottom -- str, style string for bottom if no 'border' argument\n\nborder_left -- str, style string for left if no 'border' argument\n\nborder_right -- str, style string for right if no 'border' argument\n\npadding -- str, style string for padding on four sides\n\npadding_top -- str, style string for top if no 'padding' argument\n\npadding_bottom -- str, style string for bottom if no 'padding' argument\n\npadding_left -- str, style string for left if no 'padding' argument\n\npadding_right -- str, style string for right if no 'padding' argument\n\nbackground_color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\nshadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\ncolor -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n</code></pre> <p>Return : Style</p> Source code in <code>odfdo/style.py</code> <pre><code>def create_table_cell_style(\n    border: str | None = None,\n    border_top: str | None = None,\n    border_bottom: str | None = None,\n    border_left: str | None = None,\n    border_right: str | None = None,\n    padding: str | None = None,\n    padding_top: str | None = None,\n    padding_bottom: str | None = None,\n    padding_left: str | None = None,\n    padding_right: str | None = None,\n    background_color: str | tuple | None = None,\n    shadow: str | None = None,\n    color: str | tuple | None = None,\n) -&gt; Style:\n    \"\"\"Return a cell style.\n\n    The borders arguments must be some style attribute strings or None, see the\n    method 'make_table_cell_border_string' to generate them.\n    If the 'border' argument as the value 'default', the default style\n    \"0.06pt solid #000000\" is used for the 4 borders.\n    If any value is used for border, it is used for the 4 borders, else any of\n    the 4 borders can be specified by it's own string. If all the border,\n    border_top, border_bottom, ... arguments are None, an empty border is used\n    (ODF value is fo:border=\"none\").\n\n    Padding arguments are string specifying a length (e.g. \"0.5mm\")\". If\n    'padding' is provided, it is used for the 4 sides, else any of\n    the 4 sides padding can be specified by it's own string. Default padding is\n    no padding.\n\n    Arguments:\n\n        border -- str, style string for borders on four sides\n\n        border_top -- str, style string for top if no 'border' argument\n\n        border_bottom -- str, style string for bottom if no 'border' argument\n\n        border_left -- str, style string for left if no 'border' argument\n\n        border_right -- str, style string for right if no 'border' argument\n\n        padding -- str, style string for padding on four sides\n\n        padding_top -- str, style string for top if no 'padding' argument\n\n        padding_bottom -- str, style string for bottom if no 'padding' argument\n\n        padding_left -- str, style string for left if no 'padding' argument\n\n        padding_right -- str, style string for right if no 'padding' argument\n\n        background_color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\n        shadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\n        color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\n    Return : Style\n    \"\"\"\n    if border == \"default\":\n        border = make_table_cell_border_string()  # default border\n    if border is not None:\n        # use the border value for 4 sides.\n        border_bottom = border_top = border_left = border_right = None\n    if (\n        border is None\n        and border_bottom is None\n        and border_top is None\n        and border_left is None\n        and border_right is None\n    ):\n        border = \"none\"\n    if padding is not None:\n        # use the padding value for 4 sides.\n        padding_bottom = padding_top = padding_left = padding_right = None\n    cell_style = Style(\n        \"table-cell\",\n        area=\"table-cell\",\n        border=border,\n        border_top=border_top,\n        border_bottom=border_bottom,\n        border_left=border_left,\n        border_right=border_right,\n        padding=padding,\n        padding_top=padding_top,\n        padding_bottom=padding_bottom,\n        padding_left=padding_left,\n        padding_right=padding_right,\n        background_color=background_color,\n        shadow=shadow,\n    )\n    if color:\n        cell_style.set_properties(area=\"text\", color=color)\n    return cell_style\n</code></pre>"},{"location":"reference.html#odfdo.default_frame_position_style","title":"<code>default_frame_position_style(name='FramePosition', horizontal_pos='from-left', vertical_pos='from-top', horizontal_rel='paragraph', vertical_rel='paragraph')</code>","text":"<p>Helper style for positioning frames in desktop applications that need it.</p> <p>Default arguments should be enough.</p> <p>Use the returned Style as the frame style or build a new graphic style with this style as the parent.</p> Source code in <code>odfdo/frame.py</code> <pre><code>def default_frame_position_style(\n    name: str = \"FramePosition\",\n    horizontal_pos: str = \"from-left\",\n    vertical_pos: str = \"from-top\",\n    horizontal_rel: str = \"paragraph\",\n    vertical_rel: str = \"paragraph\",\n) -&gt; Style:\n    \"\"\"Helper style for positioning frames in desktop applications that need\n    it.\n\n    Default arguments should be enough.\n\n    Use the returned Style as the frame style or build a new graphic style\n    with this style as the parent.\n    \"\"\"\n    return Style(\n        family=\"graphic\",\n        name=name,\n        horizontal_pos=horizontal_pos,\n        horizontal_rel=horizontal_rel,\n        vertical_pos=vertical_pos,\n        vertical_rel=vertical_rel,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.default_toc_level_style","title":"<code>default_toc_level_style(level)</code>","text":"<p>Generate an automatic default style for the given TOC level.</p> Source code in <code>odfdo/toc.py</code> <pre><code>def default_toc_level_style(level: int) -&gt; Style:\n    \"\"\"Generate an automatic default style for the given TOC level.\"\"\"\n    tab_stop = TabStopStyle(style_type=\"right\", leader_style=\"dotted\", leader_text=\".\")\n    position = 17.5 - (0.5 * level)\n    tab_stop.style_position = f\"{position}cm\"\n    tab_stops = Element.from_tag(\"style:tab-stops\")\n    tab_stops.append(tab_stop)\n    properties = Element.from_tag(\"style:paragraph-properties\")\n    properties.append(tab_stops)\n    toc_style_level = Style(\n        family=\"paragraph\",\n        name=_toc_entry_style_name(level),\n        parent=f\"Contents_20_{level}\",\n    )\n    toc_style_level.append(properties)\n    return toc_style_level\n</code></pre>"},{"location":"reference.html#odfdo.hex2rgb","title":"<code>hex2rgb(color)</code>","text":"<p>Turns a \u201c#RRGGBB\u201d hexadecimal color representation into a (R, G, B) tuple.</p> <p>Arguments:</p> <pre><code>color -- str\n</code></pre> <p>Return: tuple</p> Source code in <code>odfdo/utils/color.py</code> <pre><code>def hex2rgb(color: str) -&gt; tuple[int, int, int]:\n    \"\"\"Turns a \"#RRGGBB\" hexadecimal color representation into a (R, G, B)\n    tuple.\n\n    Arguments:\n\n        color -- str\n\n    Return: tuple\n    \"\"\"\n    code = color[1:]\n    if not (len(color) == 7 and color[0] == \"#\" and code.isalnum()):\n        raise ValueError(f'\"{color}\" is not a valid color')\n    red = int(code[:2], 16)\n    green = int(code[2:4], 16)\n    blue = int(code[4:6], 16)\n    return (red, green, blue)\n</code></pre>"},{"location":"reference.html#odfdo.hexa_color","title":"<code>hexa_color(color=None)</code>","text":"<p>Convert a color definition of type tuple or string to hexadecimal representation.</p> <p>Empty string is converted to black. None is converted to None.</p> <p>Arguments:</p> <pre><code>color -- str or tuple or None\n</code></pre> <p>Return: str or None</p> Source code in <code>odfdo/utils/color.py</code> <pre><code>def hexa_color(color: str | tuple[int, int, int] | None = None) -&gt; str | None:\n    \"\"\"Convert a color definition of type tuple or string to hexadecimal\n    representation.\n\n    Empty string is converted to black.\n    None is converted to None.\n\n    Arguments:\n\n        color -- str or tuple or None\n\n    Return: str or None\n    \"\"\"\n    if color is None:\n        return None\n    if isinstance(color, tuple):\n        return rgb2hex(color)\n    if not isinstance(color, str):\n        raise TypeError(f'Invalid color argument \"{color!r}\"')\n    color = color.strip()\n    if not color:\n        return \"#000000\"\n    if color.startswith(\"#\"):\n        return color\n    return rgb2hex(color)\n</code></pre>"},{"location":"reference.html#odfdo.make_table_cell_border_string","title":"<code>make_table_cell_border_string(thick=None, line=None, color=None)</code>","text":"<p>Returns a string for style:table-cell-properties fo:border, with default : \u201c0.06pt solid #000000\u201d</p> <pre><code>thick -- str or float or int\nline -- str\ncolor -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n</code></pre> <p>Returns : str</p> Source code in <code>odfdo/style.py</code> <pre><code>def make_table_cell_border_string(\n    thick: str | float | int | None = None,\n    line: str | None = None,\n    color: str | tuple | None = None,\n) -&gt; str:\n    \"\"\"Returns a string for style:table-cell-properties fo:border,\n    with default : \"0.06pt solid #000000\"\n\n        thick -- str or float or int\n        line -- str\n        color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\n    Returns : str\n    \"\"\"\n    thick_string = _make_thick_string(thick)\n    line_string = _make_line_string(line)\n    color_string = hexa_color(color) or \"#000000\"\n    return \" \".join((thick_string, line_string, color_string))\n</code></pre>"},{"location":"reference.html#odfdo.rgb2hex","title":"<code>rgb2hex(color)</code>","text":"<p>Turns a color name or a (R, G, B) color tuple into a \u201c#RRGGBB\u201d hexadecimal representation.</p> <p>Arguments:</p> <pre><code>color -- str or tuple\n</code></pre> <p>Return: str</p> <p>Examples::</p> <pre><code>&gt;&gt;&gt; rgb2hex('yellow')\n'#FFFF00'\n&gt;&gt;&gt; rgb2hex((238, 130, 238))\n'#EE82EE'\n</code></pre> Source code in <code>odfdo/utils/color.py</code> <pre><code>def rgb2hex(color: str | tuple[int, int, int]) -&gt; str:\n    \"\"\"Turns a color name or a (R, G, B) color tuple into a \"#RRGGBB\"\n    hexadecimal representation.\n\n    Arguments:\n\n        color -- str or tuple\n\n    Return: str\n\n    Examples::\n\n        &gt;&gt;&gt; rgb2hex('yellow')\n        '#FFFF00'\n        &gt;&gt;&gt; rgb2hex((238, 130, 238))\n        '#EE82EE'\n    \"\"\"\n    if isinstance(color, str):\n        try:\n            code = CSS3_COLORMAP[color.lower()]\n        except KeyError as e:\n            raise KeyError(f'Color \"{color}\" is unknown in CSS color list') from e\n    elif isinstance(color, tuple):\n        if len(color) != 3:\n            raise ValueError(\"Color must be a 3-tuple\")\n        code = color\n    else:\n        raise TypeError(f'Invalid color \"{color}\"')\n    for channel in code:\n        if not 0 &lt;= channel &lt;= 255:\n            raise ValueError(\n                f'Invalid color \"{color}\", channel must be between 0 and 255'\n            )\n    return f\"#{code[0]:02X}{code[1]:02X}{code[2]:02X}\"\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"odfdo","text":"<p>Python library for OpenDocument format (ODF)</p> <p></p> <p><code>odfdo</code> is a Python3 library implementing the ISO/IEC 26300 OpenDocument Format standard.</p> <p>Project: https://github.com/jdum/odfdo</p> <p>Author: jerome.dumonteil@gmail.com</p> <p>License: Apache License, Version 2.0</p> <p><code>odfdo</code> is a derivative work of the former <code>lpod-python</code> project.</p>"},{"location":"index.html#installation","title":"Installation","text":"<p>Installation from Pypi (recommended):</p> <pre><code>pip install odfdo\n</code></pre> <p>Installation from sources (requiring setuptools):</p> <pre><code>pip install .\n</code></pre> <p>After installation from sources, you can check everything is working (some requirements: <code>pytest</code>, Pillow, \u2026):</p> <pre><code>pytest\n</code></pre> <p>The tests should run for a few seconds or minutes and issue no error.</p>"},{"location":"index.html#usage","title":"Usage","text":"<pre><code>from odfdo import Document, Paragraph\n\ndoc = Document('text')\ndoc.body.append(Paragraph(\"Hello world!\"))\ndoc.save(\"hello.odt\")\n</code></pre>"},{"location":"index.html#tldr","title":"tl;dr","text":"<p>\u2018Intended Audience :: Developers\u2019</p>"},{"location":"index.html#documentation","title":"Documentation","text":"<p>There is no detailed documentation or tutorial, but:</p> <ul> <li>the <code>recipes</code> folder contains more than 50 working sample scripts,</li> <li>the <code>doc</code> folder contains an auto generated documentation.</li> </ul> <p>When installing odfdo, a few scripts are installed:</p> <ul> <li><code>odfdo-diff</code>: show a diff between two .odt document.</li> <li><code>odfdo-folder</code>: convert standard ODF file to folder and files, and reverse.</li> <li><code>odfdo-show</code>: dump text from an ODF file to the standard output, and optionally styles and meta informations.</li> <li><code>odfdo-styles</code>: command line interface tool to manipulate styles of ODF files.</li> <li><code>odfdo-replace</code>: find a pattern (regex) in an ODF file and replace by some string.</li> <li><code>odfdo-userfield</code>: Show or set the user-field content in an ODF file.</li> <li><code>odfdo-highlight</code>: highlight the text matching a pattern (regex) in an ODF file.</li> <li><code>odfdo-headers</code>: print the headers of an ODF file.</li> <li><code>odfdo-table-shrink</code>: shrink tables to optimize width and height.</li> </ul> <p>About styles: the best way to apply style is by merging styles from a template document into your generated document (See <code>odfdo-styles</code> script). Styles are a complex matter in ODF, so trying to generate styles programmatically is not recommended.</p>"},{"location":"index.html#limitations","title":"Limitations","text":"<p><code>odfdo</code> is intended to facilitate the generation of ODF documents, nevertheless a basic knowledge of the ODF format is necessary.</p> <p>ODF document rendering can vary greatly from software to software. Especially the \u201cstyles\u201d of the document allow an adaptation of the rendering for a particular software.</p> <p>The best (only ?) way to apply style is by merging styles from a template document into your generated document. However a few recipes show how to make programmatically some basic styles: <code>create_basic_text_styles</code>, <code>add_text_span_styles</code>).</p>"},{"location":"index.html#related-project","title":"Related project","text":"<p>I you work on <code>.ods</code> files (spreadsheet), you may be interested by these scripts using this library to parse/generate <code>.ods</code> files: <code>https://github.com/jdum/odsgenerator</code> and <code>https://github.com/jdum/odsparsator</code></p>"},{"location":"index.html#changes-from-former-lpod-library","title":"Changes from former lpod library","text":"<p><code>lpod-python</code> was written in 2009-2010 as a Python 2.x library, see: <code>https://github.com/lpod/lpod-python</code></p> <p><code>odfdo</code> is an adaptation of this former project. <code>odfdo</code> main changes from <code>lpod</code>:</p> <ul> <li><code>odfdo</code> requires Python version 3.9 to 3.12. For Python 3.6 to 3.8 see previous releases.</li> <li>API change: more pythonic.</li> <li>include recipes.</li> <li>use Apache 2.0 license.</li> </ul>"},{"location":"CHANGES.html","title":"Odfdo Release Notes","text":""},{"location":"CHANGES.html#3711-2024-05-25","title":"[3.7.11] - 2024-05-25","text":"<ul> <li>New script <code>odfdo-userfield</code> to show or set the user-field content in an ODF file.</li> </ul>"},{"location":"CHANGES.html#added","title":"Added","text":"<ul> <li>Add script <code>odfdo-userfield</code>.</li> </ul>"},{"location":"CHANGES.html#changed","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#3710-2024-05-4","title":"[3.7.10] - 2024-05-4","text":"<ul> <li> <p>Refactor to add property getter for some common methods. Original get_*     method is still available and permits detailed requests with parameters.</p> <pre><code>-   Body.tables -&gt; Body.get_tables()\n-   Element.tocs -&gt; Element.get_tocs()\n-   Element.toc -&gt; Element.get_toc()\n-   Element.text_changes -&gt; Element.get_text_changes()\n-   Element.tracked_changes -&gt; Element.get_tracked_changes()\n-   Element.user_defined_list -&gt; Element.get_user_defined_list()\n-   Element.images -&gt; Element.get_images()\n-   Element.frames -&gt; Element.get_frames()\n-   Element.lists -&gt; Element.get_lists()\n-   Element.headers -&gt; Element.get_headers()\n-   Element.spans -&gt; Element.get_spans()\n-   Element.paragraphs -&gt; Element.get_paragraphs()\n-   Element.sections -&gt; Element.get_sections()\n-   Table.rows -&gt; Table.get_rows()\n-   Table.cells -&gt; Table.get_cells()\n-   Table.columns -&gt; Table.get_columns()\n-   Row.cells -&gt; Row.get_cells()\n-   Document.parts -&gt; Document.get_parts()\n-   Container.parts -&gt; Container.get_parts()\n</code></pre> </li> <li> <p>Refactor to add property getter/setter for some common methods. Original get_*     and set_* methods are still available and permit detailed requests with parameters.</p> <pre><code>-   Column.default_cell_style -&gt; Column.get/set_default_cell_style()\n</code></pre> </li> </ul>"},{"location":"CHANGES.html#added_1","title":"Added","text":"<ul> <li>Added <code>Body.tables</code></li> <li>Added <code>Element.tocs</code></li> <li>Added <code>Element.toc</code></li> <li>Added <code>Element.text_changes</code></li> <li>Added <code>Element.tracked_changes</code></li> <li>Added <code>Element.images</code></li> <li>Added <code>Element.frames</code></li> <li>Added <code>Element.lists</code></li> <li>Added <code>Element.headers</code></li> <li>Added <code>Element.spans</code></li> <li>Added <code>Element.paragraphs</code></li> <li>Added <code>Element.sections</code></li> <li>Added <code>Column.default_cell_style</code></li> <li>Added <code>Table.rows</code></li> <li>Added <code>Table.cells</code></li> <li>Added <code>Table.columns</code></li> <li>Added <code>Row.cells</code></li> <li>Added <code>Document.parts</code></li> <li>Added <code>Container.parts</code></li> </ul>"},{"location":"CHANGES.html#379-2024-05-3","title":"[3.7.9] - 2024-05-3","text":"<ul> <li> <p>Refactor the Body access methods, creating relevant a Body class and related sub-classes. Moved some access method from the Element class to relevant Body sub-classes.</p> </li> <li> <p>Refactor metadata methods to permit access throuh @property (the legacy get_* and set_* methods are still available).</p> </li> <li> <p>Added a few metadata elements from the ODF standard (hyperlink-behaviour, auto-reload, template, print-dateprinted-by)</p> </li> </ul>"},{"location":"CHANGES.html#added_2","title":"Added","text":"<ul> <li>Added <code>MetaAutoReload</code> class</li> <li>Added <code>MetaHyperlinkBehaviour</code> class</li> <li>Added <code>MetaTemplate</code> class</li> <li>Added <code>DcCreatorMixin</code> class</li> <li>Added <code>DcDateMixin</code> class</li> <li>Added <code>Body</code> class</li> <li>Added <code>Chart</code> class</li> <li>Added <code>Database</code> class</li> <li>Added <code>Drawing</code> class</li> <li>Added <code>Image</code> class</li> <li>Added <code>Presentation</code> class</li> <li>Added <code>Spreadsheet</code> class</li> <li>Added <code>Text</code> class (renaming the previous internal <code>Text</code> class to <code>EText</code>)</li> </ul>"},{"location":"CHANGES.html#378-2024-05-2","title":"[3.7.8] - 2024-05-2","text":"<p>Fix embedded chart analysis in documents, see recipe <code>change_values_of_a_chart_inside_a_document.py</code>.</p>"},{"location":"CHANGES.html#added_3","title":"Added","text":"<ul> <li>Added <code>change_values_of_a_chart_inside_a_document.py</code> recipe</li> </ul>"},{"location":"CHANGES.html#changed_1","title":"Changed","text":"<ul> <li> <p>The \u201cpretty\u201d setting when saving the file always defaults to False. This setting should only be used for debugging purposes</p> </li> <li> <p><code>meta.generator</code> can be used via a @property accessor</p> </li> <li> <p>(Internal change) move body() definition to xmlpart</p> </li> <li> <p>(Internal change) refactoring for future XML feature</p> </li> </ul>"},{"location":"CHANGES.html#fixed","title":"Fixed","text":"<ul> <li> <p>Fix parsing of Table when parent uses \u201ctable:table-rows\u201d kind of wrapper</p> </li> <li> <p>Fix a bug when a Cell contains the valid \u2018NaN\u2019 Decimal number</p> </li> </ul>"},{"location":"CHANGES.html#377-2024-04-1","title":"[3.7.7] - 2024-04-1","text":"<p>Improvement of the <code>lxml</code> dependency support.</p>"},{"location":"CHANGES.html#added_4","title":"Added","text":"<ul> <li> <p>Added a <code>CHANGES.md</code> file</p> </li> <li> <p>Automatic tests for ubuntu-latest, macos-latest, windows-latest</p> </li> </ul>"},{"location":"CHANGES.html#changed_2","title":"Changed","text":"<ul> <li> <p>Now supports a wider range of <code>lxml</code> versions:</p> <ul> <li> <p>python 3.9: lxml version 4.8.0 to 4.9.4</p> </li> <li> <p>python 3.10: lxml version 4.8.0 to 5.1.1</p> </li> <li> <p>python 3.11: lxml version 4.9.4 to 5.2.0 and beyond</p> </li> <li> <p>python 3.12: lxml version 4.9.4 to 5.2.0 and beyond</p> </li> </ul> </li> <li> <p>autogenerated documentation now uses <code>mkdocs</code></p> </li> </ul>"},{"location":"CHANGES.html#fixed_1","title":"Fixed","text":"<ul> <li> <p>Use <code>sys.executable</code> to ensure all tests can pass in a github virtualenv on Windows.</p> </li> <li> <p>Remove import of <code>lxml</code> internal <code>\\_ElementUnicodeResult</code> and <code>\\_ElementUnicodeResult</code> classes.</p> </li> </ul>"},{"location":"CHANGES.html#376-2024-03-30","title":"[3.7.6] - 2024-03-30","text":"<p>Quick fix for the crash with new <code>lxml</code> version 5.1.1</p>"},{"location":"CHANGES.html#fixed_2","title":"Fixed","text":"<pre><code>- Fix crash with `lxml` 5.1.1 by restricting version do 5.1.0\n</code></pre>"},{"location":"CHANGES.html#375-2024-03-23","title":"[3.7.5] - 2024-03-23","text":"<p>Add the method <code>get_cell_background_color</code> to retrieve the background color of a cell in a table.</p>"},{"location":"CHANGES.html#added_5","title":"Added","text":"<ul> <li> <p>Tables: some users need to easily access the background color of cells, including cells without \u201cvalue\u201d content. That was requiring a complex parsing of styles. So a new method: <code>Document.get_cell_background_color(sheet_id, cell_coords)</code>.</p> </li> <li> <p>See the corresponding recipe <code>recipes/get_cell_background_color.py</code> for an exemple of usage.</p> </li> <li> <p>Tables: (related to previous). It is often useful to reduce the table size before working on it, especially if styles apply to whole rows. A method called <code>Table.rstrip()</code> already permitted to remove empty bottom rows and empty right columns. However, a <code>Cell</code> mays have no value but a style (color background for example), and <code>rstrip()</code> was removing such cells. So an new clever method is provided: <code>Table.optimize_width()</code> that shrink the table size, still keeping styled empty cells.</p> </li> <li> <p>To test the actual result of this method, you can use the new script <code>odfdo-table-shrink</code> which is basically a wrapper upon this method. (Note: all this stuff aims to facilitate some feature for the related github project <code>odsparsator</code>).</p> </li> <li> <p><code>repr()</code> method for <code>Cell</code>, <code>Row</code> and <code>Column</code>.</p> </li> <li> <p>Ancillary methods related to above features.</p> </li> </ul>"},{"location":"CHANGES.html#fixed_3","title":"Fixed","text":"<ul> <li><code>Document(path)</code> now accepts a <code>str</code> path starting with <code>~</code> as the path relative to the user home.</li> </ul>"},{"location":"CHANGES.html#changed_3","title":"Changed","text":"<ul> <li> <p>Tables: (related to previous), change the <code>Cell.is_empty()</code> test. A cell is now considered as not empty if part of a <code>span</code> (a cell spanned on several rows or columns). This may induce some changes for parsing scripts. Before that, only the first cell of the span (which actually contains the value) was considered as non empty. Now other cells of the span are not empty (but contain a null value).</p> </li> <li> <p>Minor refactor of code, version updates of dependencies.</p> </li> </ul>"},{"location":"CHANGES.html#374-2024-03-17","title":"[3.7.4] - 2024-03-17","text":"<p>Add a recipe as example of programmatically setting text styles for headers and paragraphs, with basic font and color properties.</p>"},{"location":"CHANGES.html#added_6","title":"Added","text":"<ul> <li> <p>Add recipe <code>create_basic_text_styles</code>.</p> </li> <li> <p>All style fields related to color accept a color name from the CSS list of color.</p> </li> </ul>"},{"location":"CHANGES.html#changed_4","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#373-2024-03-10","title":"[3.7.3] - 2024-03-10","text":"<p>Internal maintenance release.</p>"},{"location":"CHANGES.html#fixed_4","title":"Fixed","text":"<ul> <li>Fix logo link on <code>Pypi</code> page.</li> </ul>"},{"location":"CHANGES.html#changed_5","title":"Changed","text":"<ul> <li> <p>Technical updates from <code>optparse</code> to <code>argparse</code>.</p> </li> <li> <p>Updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#372-2024-03-9","title":"[3.7.2] - 2024-03-9","text":"<p>Internal maintenance release.</p>"},{"location":"CHANGES.html#changed_6","title":"Changed","text":"<ul> <li> <p>Use <code>pdoc</code> for autogenerated documentation.</p> </li> <li> <p>Refactor some recipes to use them in a test suit.</p> </li> <li> <p>Code refactor, Updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#371-2024-03-3","title":"[3.7.1] - 2024-03-3","text":"<p>Minor performance improvement of script <code>odfdo-headers</code>.</p>"},{"location":"CHANGES.html#changed_7","title":"Changed","text":"<ul> <li>Use better algorithm for script <code>odfdo-headers</code>.</li> </ul>"},{"location":"CHANGES.html#370-2024-03-2","title":"[3.7.0] - 2024-03-2","text":"<p>New script <code>odfdo-headers</code> to print the headers of a <code>ODF</code> file.</p>"},{"location":"CHANGES.html#added_7","title":"Added","text":"<ul> <li>Add script <code>odfdo-headers</code>.</li> </ul>"},{"location":"CHANGES.html#changed_8","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#360-2024-02-25","title":"[3.6.0] - 2024-02-25","text":"<p>New script <code>odfdo-highlight</code> to highlight the text matching a pattern (regex) in a <code>ODF</code> file.</p>"},{"location":"CHANGES.html#added_8","title":"Added","text":"<ul> <li>Add script <code>odfdo-highlight</code>.</li> </ul>"},{"location":"CHANGES.html#changed_9","title":"Changed","text":"<ul> <li>Updating dependency versions.</li> </ul>"},{"location":"CHANGES.html#351-2024-02-20","title":"[3.5.1] - 2024-02-20","text":"<p>Fix the update method of <code>Table of Content</code> and add a recipe to show how to update a <code>TOC</code>.</p>"},{"location":"CHANGES.html#added_9","title":"Added","text":"<ul> <li>Add recipe <code>update_a_text_document_with_a_table_of_content</code>.</li> </ul>"},{"location":"CHANGES.html#changed_10","title":"Changed","text":"<ul> <li> <p>Refactor of TOC related code.</p> </li> <li> <p>Updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#350-2024-01-27","title":"[3.5.0] - 2024-01-27","text":"<p>2024 release, updated ODF templates and better test suit.</p>"},{"location":"CHANGES.html#changed_11","title":"Changed","text":"<ul> <li> <p>Update <code>ODF</code> templates.</p> </li> <li> <p>Refactor many Python files for use of type hints.</p> </li> <li> <p>Updates for year 2024, updating dependency versions.</p> </li> </ul>"},{"location":"CHANGES.html#347-2024-01-15","title":"[3.4.7] - 2024-01-15","text":"<p>Updade to <code>lxml</code> version 5.</p>"},{"location":"CHANGES.html#changed_12","title":"Changed","text":"<pre><code>- Update `lxml` from version 4 to 5.\n</code></pre>"},{"location":"CHANGES.html#346-2023-12-25","title":"[3.4.6] - 2023-12-25","text":"<p>Add script <code>odfdo-replace</code> to find a pattern (regex) in an <code>ODF</code> file and replace by some string.</p>"},{"location":"CHANGES.html#fixed_5","title":"Fixed","text":"<ul> <li>Fix reading content from a <code>BytesIO</code>.</li> </ul>"},{"location":"CHANGES.html#changed_13","title":"Changed","text":"<ul> <li>Add script <code>odfdo-replace</code>.</li> </ul>"},{"location":"CHANGES.html#345-2023-12-24","title":"[3.4.5] - 2023-12-24","text":"<p>Add recipes showing how to save/read document from <code>io.BytesIO</code>.</p>"},{"location":"CHANGES.html#added_10","title":"Added","text":"<ul> <li>Add recipes <code>read_document_from_bytesio.py</code> and <code>save_document_as_bytesio.py</code>.</li> </ul>"},{"location":"CHANGES.html#changed_14","title":"Changed","text":"<ul> <li>Refactoring of code.</li> </ul>"},{"location":"reference.html","title":"Reference","text":""},{"location":"reference.html#odfdo.AnimPar","title":"<code>AnimPar</code>","text":"<p>               Bases: <code>Element</code></p> <p>A container for SMIL Presentation Animations.</p> <p>Arguments:</p> <pre><code>presentation_node_type -- default, on-click, with-previous,\n                          after-previous, timing-root, main-sequence\n                          and interactive-sequence\n\nsmil_begin -- indefinite, 10s, [id].click, [id].begin\n</code></pre> Source code in <code>odfdo/smil.py</code> <pre><code>class AnimPar(Element):\n    \"\"\"A container for SMIL Presentation Animations.\n\n    Arguments:\n\n        presentation_node_type -- default, on-click, with-previous,\n                                  after-previous, timing-root, main-sequence\n                                  and interactive-sequence\n\n        smil_begin -- indefinite, 10s, [id].click, [id].begin\n    \"\"\"\n\n    _tag = \"anim:par\"\n    _properties = (\n        PropDef(\"presentation_node_type\", \"presentation:node-type\"),\n        PropDef(\"smil_begin\", \"smil:begin\"),\n    )\n\n    def __init__(\n        self,\n        presentation_node_type: str | None = None,\n        smil_begin: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if presentation_node_type:\n                self.presentation_node_type = presentation_node_type\n            if smil_begin:\n                self.smil_begin = smil_begin\n</code></pre>"},{"location":"reference.html#odfdo.AnimSeq","title":"<code>AnimSeq</code>","text":"<p>               Bases: <code>Element</code></p> <p>TA container for SMIL Presentation Animations. Animations inside this block are executed after the slide has executed its initial transition.</p> <p>Arguments:</p> <pre><code>presentation_node_type -- default, on-click, with-previous,\n                          after-previous, timing-root, main-sequence\n                          and interactive-sequence\n</code></pre> Source code in <code>odfdo/smil.py</code> <pre><code>class AnimSeq(Element):\n    \"\"\"TA container for SMIL Presentation Animations. Animations\n    inside this block are executed after the slide has executed its initial\n    transition.\n\n    Arguments:\n\n        presentation_node_type -- default, on-click, with-previous,\n                                  after-previous, timing-root, main-sequence\n                                  and interactive-sequence\n    \"\"\"\n\n    _tag = \"anim:seq\"\n    _properties = (PropDef(\"presentation_node_type\", \"presentation:node-type\"),)\n\n    def __init__(\n        self,\n        presentation_node_type: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init and presentation_node_type:\n            self.presentation_node_type = presentation_node_type\n</code></pre>"},{"location":"reference.html#odfdo.AnimTransFilter","title":"<code>AnimTransFilter</code>","text":"<p>               Bases: <code>Element</code></p> <p>Class to make a beautiful transition between two frames.</p> <p>Parameters:</p> Name Type Description Default <code>smil_type</code> <code>and smil_subtype -- see http</code> <p>//www.w3.org/TR/SMIL20/             smil-transitions.html#TransitionEffects-Appendix                             to get a list of all types/subtypes</p> <code>None</code> Source code in <code>odfdo/smil.py</code> <pre><code>class AnimTransFilter(Element):\n    \"\"\"\n    Class to make a beautiful transition between two frames.\n\n    Arguments:\n      smil_dur -- XXX complete me\n\n      smil_type and smil_subtype -- see http://www.w3.org/TR/SMIL20/\n                    smil-transitions.html#TransitionEffects-Appendix\n                                    to get a list of all types/subtypes\n\n      smil_direction -- forward, reverse\n\n      smil_fadeColor -- forward, reverse\n\n      smil_mode -- in, out\n    \"\"\"\n\n    _tag = \"anim:transitionFilter\"\n    _properties = (\n        PropDef(\"smil_dur\", \"smil:dur\"),\n        PropDef(\"smil_type\", \"smil:type\"),\n        PropDef(\"smil_subtype\", \"smil:subtype\"),\n        PropDef(\"smil_direction\", \"smil:direction\"),\n        PropDef(\"smil_fadeColor\", \"smil:fadeColor\"),\n        PropDef(\"smil_mode\", \"smil:mode\"),\n    )\n\n    def __init__(\n        self,\n        smil_dur: str | None = None,\n        smil_type: str | None = None,\n        smil_subtype: str | None = None,\n        smil_direction: str | None = None,\n        smil_fadeColor: str | None = None,\n        smil_mode: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if smil_dur:\n                self.smil_dur = smil_dur\n            if smil_type:\n                self.smil_type = smil_type\n            if smil_subtype:\n                self.smil_subtype = smil_subtype\n            if smil_direction:\n                self.smil_direction = smil_direction\n            if smil_fadeColor:\n                self.smil_fadeColor = smil_fadeColor\n            if smil_mode:\n                self.smil_mode = smil_mode\n</code></pre>"},{"location":"reference.html#odfdo.Annotation","title":"<code>Annotation</code>","text":"<p>               Bases: <code>Element</code>, <code>DcCreatorMixin</code>, <code>DcDateMixin</code></p> <p>Annotation element credited to the given creator with the given text, optionally dated (current date by default). If name not provided and some parent is provided, the name is autogenerated.</p> <p>Arguments:</p> <pre><code>text -- str or odf_element\n\ncreator -- str\n\ndate -- datetime\n\nname -- str\n\nparent -- Element\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>class Annotation(Element, DcCreatorMixin, DcDateMixin):\n    \"\"\"Annotation element credited to the given creator with the\n    given text, optionally dated (current date by default).\n    If name not provided and some parent is provided, the name is\n    autogenerated.\n\n    Arguments:\n\n        text -- str or odf_element\n\n        creator -- str\n\n        date -- datetime\n\n        name -- str\n\n        parent -- Element\n    \"\"\"\n\n    _tag = \"office:annotation\"\n    _properties = (\n        PropDef(\"name\", \"office:name\"),\n        PropDef(\"note_id\", \"text:id\"),\n    )\n\n    def __init__(\n        self,\n        text_or_element: Element | str | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        name: str | None = None,\n        parent: Element | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        # fixme : use offset\n        # TODO allow paragraph and text styles\n        super().__init__(**kwargs)\n\n        if self._do_init:\n            self.note_body = text_or_element  # type:ignore\n            if creator:\n                self.creator = creator\n            if date is None:\n                date = datetime.now()\n            self.date = date\n            if not name:\n                name = get_unique_office_name(parent)\n                self.name = name\n\n    @property\n    def dc_creator(self) -&gt; str | None:\n        \"\"\"Alias for self.creator property.\"\"\"\n        return self.creator\n\n    @dc_creator.setter\n    def dc_creator(self, creator: str) -&gt; None:\n        self.creator = creator\n\n    @property\n    def dc_date(self) -&gt; datetime | None:\n        \"\"\"Alias for self.date property.\"\"\"\n        return self.date\n\n    @dc_date.setter\n    def dc_date(self, dtdate: datetime) -&gt; None:\n        self.date = dtdate\n\n    @property\n    def note_body(self) -&gt; str:\n        return self.text_content\n\n    @note_body.setter\n    def note_body(self, text_or_element: Element | str | None) -&gt; None:\n        if text_or_element is None:\n            self.text_content = \"\"\n        elif isinstance(text_or_element, str):\n            self.text_content = text_or_element\n        elif isinstance(text_or_element, Element):\n            self.clear()\n            self.append(text_or_element)\n        else:\n            raise TypeError(f'Unexpected type for body: \"{type(text_or_element)}\"')\n\n    @property\n    def start(self) -&gt; Element:\n        \"\"\"Return self.\"\"\"\n        return self\n\n    @property\n    def end(self) -&gt; Element | None:\n        \"\"\"Return the corresponding annotation-end tag or None.\"\"\"\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can't find end tag: no parent available\")\n        body = self.document_body\n        if not body:\n            body = parent\n        return body.get_annotation_end(name=name)\n\n    def get_annotated(\n        self,\n        as_text: bool = False,\n        no_header: bool = True,\n        clean: bool = True,\n    ) -&gt; Element | list | str | None:\n        \"\"\"Returns the annotated content from an annotation.\n\n        If no content exists (single position annotation or annotation-end not\n        found), returns [] (or \"\" if text flag is True).\n        If as_text is True: returns the text content.\n        If clean is True: suppress unwanted tags (deletions marks, ...)\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of odf_element, cleaned and without headers.\n\n        Arguments:\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list or Element or text or None\n        \"\"\"\n        end = self.end\n        if end is None:\n            if as_text:\n                return \"\"\n            return None\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_between(\n            self, end, as_text=as_text, no_header=no_header, clean=clean\n        )\n\n    def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        For Annotation : delete the annotation-end tag if exists.\n\n        Arguments:\n\n            child -- Element or None\n        \"\"\"\n        if child is not None:  # act like normal delete\n            super().delete(child)\n            return\n        end = self.end\n        if end:\n            end.delete()\n        # act like normal delete\n        super().delete()\n\n    def check_validity(self) -&gt; None:\n        if not self.note_body:\n            raise ValueError(\"Annotation must have a body\")\n        if not self.dc_creator:\n            raise ValueError(\"Annotation must have a creator\")\n        if not self.dc_date:\n            self.dc_date = datetime.now()\n</code></pre>"},{"location":"reference.html#odfdo.Annotation.dc_creator","title":"<code>dc_creator: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Alias for self.creator property.</p>"},{"location":"reference.html#odfdo.Annotation.dc_date","title":"<code>dc_date: datetime | None</code>  <code>property</code> <code>writable</code>","text":"<p>Alias for self.date property.</p>"},{"location":"reference.html#odfdo.Annotation.end","title":"<code>end: Element | None</code>  <code>property</code>","text":"<p>Return the corresponding annotation-end tag or None.</p>"},{"location":"reference.html#odfdo.Annotation.start","title":"<code>start: Element</code>  <code>property</code>","text":"<p>Return self.</p>"},{"location":"reference.html#odfdo.Annotation.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>For Annotation : delete the annotation-end tag if exists.</p> <p>Arguments:</p> <pre><code>child -- Element or None\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    For Annotation : delete the annotation-end tag if exists.\n\n    Arguments:\n\n        child -- Element or None\n    \"\"\"\n    if child is not None:  # act like normal delete\n        super().delete(child)\n        return\n    end = self.end\n    if end:\n        end.delete()\n    # act like normal delete\n    super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.Annotation.get_annotated","title":"<code>get_annotated(as_text=False, no_header=True, clean=True)</code>","text":"<p>Returns the annotated content from an annotation.</p> <p>If no content exists (single position annotation or annotation-end not found), returns [] (or \u201c\u201d if text flag is True). If as_text is True: returns the text content. If clean is True: suppress unwanted tags (deletions marks, \u2026) If no_header is True: existing text:h are changed in text:p By default: returns a list of odf_element, cleaned and without headers.</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list or Element or text or None</p> Source code in <code>odfdo/note.py</code> <pre><code>def get_annotated(\n    self,\n    as_text: bool = False,\n    no_header: bool = True,\n    clean: bool = True,\n) -&gt; Element | list | str | None:\n    \"\"\"Returns the annotated content from an annotation.\n\n    If no content exists (single position annotation or annotation-end not\n    found), returns [] (or \"\" if text flag is True).\n    If as_text is True: returns the text content.\n    If clean is True: suppress unwanted tags (deletions marks, ...)\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of odf_element, cleaned and without headers.\n\n    Arguments:\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list or Element or text or None\n    \"\"\"\n    end = self.end\n    if end is None:\n        if as_text:\n            return \"\"\n        return None\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_between(\n        self, end, as_text=as_text, no_header=no_header, clean=clean\n    )\n</code></pre>"},{"location":"reference.html#odfdo.AnnotationEnd","title":"<code>AnnotationEnd</code>","text":"<p>               Bases: <code>Element</code></p> <p>AnnotationEnd: the \u201coffice:annotation-end\u201d element may be used to define the end of a text range of document content that spans element boundaries. In that case, an \u201coffice:annotation\u201d element shall precede the \u201coffice:annotation-end\u201d element. Both elements shall have the same value for their office:name attribute. The \u201coffice:annotation-end\u201d element shall be preceded by an \u201coffice:annotation\u201d element that has the same value for its office:name attribute as the \u201coffice:annotation-end\u201d element. An \u201coffice:annotation-end\u201d element without a preceding \u201coffice:annotation\u201d element that has the same name assigned is ignored.</p> Source code in <code>odfdo/note.py</code> <pre><code>class AnnotationEnd(Element):\n    \"\"\"AnnotationEnd: the \"office:annotation-end\" element may be used to\n    define the end of a text range of document content that spans element\n    boundaries. In that case, an \"office:annotation\" element shall precede\n    the \"office:annotation-end\" element. Both elements shall have the same\n    value for their office:name attribute. The \"office:annotation-end\" element\n    shall be preceded by an \"office:annotation\" element that has the same\n    value for its office:name attribute as the \"office:annotation-end\"\n    element. An \"office:annotation-end\" element without a preceding\n    \"office:annotation\" element that has the same name assigned is ignored.\n    \"\"\"\n\n    _tag = \"office:annotation-end\"\n    _properties = (PropDef(\"name\", \"office:name\"),)\n\n    def __init__(\n        self,\n        annotation: Element | None = None,\n        name: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Initialize an AnnotationEnd element. Either annotation or name must be\n        provided to have proper reference for the annotation-end.\n\n        Arguments:\n\n            annotation -- odf_annotation element\n\n            name -- str\n        \"\"\"\n        # fixme : use offset\n        # TODO allow paragraph and text styles\n        super().__init__(**kwargs)\n        if self._do_init:\n            if annotation:\n                name = annotation.name  # type: ignore\n            if not name:\n                raise ValueError(\"Annotation-end must have a name\")\n            self.name = name\n\n    @property\n    def start(self) -&gt; Element | None:\n        \"\"\"Return the corresponding annotation starting tag or None.\"\"\"\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can't find start tag: no parent available\")\n        body = self.document_body\n        if not body:\n            body = parent\n        return body.get_annotation(name=name)\n\n    @property\n    def end(self) -&gt; Element:\n        \"\"\"Return self.\"\"\"\n        return self\n</code></pre>"},{"location":"reference.html#odfdo.AnnotationEnd.end","title":"<code>end: Element</code>  <code>property</code>","text":"<p>Return self.</p>"},{"location":"reference.html#odfdo.AnnotationEnd.start","title":"<code>start: Element | None</code>  <code>property</code>","text":"<p>Return the corresponding annotation starting tag or None.</p>"},{"location":"reference.html#odfdo.AnnotationEnd.__init__","title":"<code>__init__(annotation=None, name=None, **kwargs)</code>","text":"<p>Initialize an AnnotationEnd element. Either annotation or name must be provided to have proper reference for the annotation-end.</p> <p>Arguments:</p> <pre><code>annotation -- odf_annotation element\n\nname -- str\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>def __init__(\n    self,\n    annotation: Element | None = None,\n    name: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Initialize an AnnotationEnd element. Either annotation or name must be\n    provided to have proper reference for the annotation-end.\n\n    Arguments:\n\n        annotation -- odf_annotation element\n\n        name -- str\n    \"\"\"\n    # fixme : use offset\n    # TODO allow paragraph and text styles\n    super().__init__(**kwargs)\n    if self._do_init:\n        if annotation:\n            name = annotation.name  # type: ignore\n        if not name:\n            raise ValueError(\"Annotation-end must have a name\")\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.Body","title":"<code>Body</code>","text":"<p>               Bases: <code>Element</code></p> <p>Body, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Body(Element):\n    \"\"\"Body, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:body\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n\n    def get_tables(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the tables that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Table\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::table:table\", table_style=style, content=content\n        )\n\n    @property\n    def tables(self) -&gt; list[Element]:\n        \"\"\"Return all the tables.\n\n        Return: list of Table\n        \"\"\"\n        return self.get_elements(\"descendant::table:table\")\n\n    def get_table(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the table that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            content -- str regex\n\n        Return: Table or None if not found\n        \"\"\"\n        if name is None and content is None:\n            result = self._filtered_element(\"descendant::table:table\", position)\n        else:\n            result = self._filtered_element(\n                \"descendant::table:table\",\n                position,\n                table_name=name,\n                content=content,\n            )\n        return result\n</code></pre>"},{"location":"reference.html#odfdo.Body.tables","title":"<code>tables: list[Element]</code>  <code>property</code>","text":"<p>Return all the tables.</p> <p>Return: list of Table</p>"},{"location":"reference.html#odfdo.Body.get_table","title":"<code>get_table(position=0, name=None, content=None)</code>","text":"<p>Return the table that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\ncontent -- str regex\n</code></pre> <p>Return: Table or None if not found</p> Source code in <code>odfdo/body.py</code> <pre><code>def get_table(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the table that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        content -- str regex\n\n    Return: Table or None if not found\n    \"\"\"\n    if name is None and content is None:\n        result = self._filtered_element(\"descendant::table:table\", position)\n    else:\n        result = self._filtered_element(\n            \"descendant::table:table\",\n            position,\n            table_name=name,\n            content=content,\n        )\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Body.get_tables","title":"<code>get_tables(style=None, content=None)</code>","text":"<p>Return all the tables that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Table</p> Source code in <code>odfdo/body.py</code> <pre><code>def get_tables(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the tables that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Table\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::table:table\", table_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Bookmark","title":"<code>Bookmark</code>","text":"<p>               Bases: <code>Element</code></p> <p>Bookmark class for ODF \u201ctext:bookmark\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/bookmark.py</code> <pre><code>class Bookmark(Element):\n    \"\"\"\n    Bookmark class for ODF \"text:bookmark\"\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:bookmark\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.BookmarkEnd","title":"<code>BookmarkEnd</code>","text":"<p>               Bases: <code>Element</code></p> <p>BookmarkEnd class for ODF \u201ctext:bookmark-end\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/bookmark.py</code> <pre><code>class BookmarkEnd(Element):\n    \"\"\"\n    BookmarkEnd class for ODF \"text:bookmark-end\"\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:bookmark-end\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.BookmarkStart","title":"<code>BookmarkStart</code>","text":"<p>               Bases: <code>Element</code></p> <p>BookmarkStart class for ODF \u201ctext:bookmark-start\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/bookmark.py</code> <pre><code>class BookmarkStart(Element):\n    \"\"\"\n    BookmarkStart class for ODF \"text:bookmark-start\"\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:bookmark-start\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.Cell","title":"<code>Cell</code>","text":"<p>               Bases: <code>ElementTyped</code></p> <p>\u201ctable:table-cell\u201d table cell element.</p> Source code in <code>odfdo/cell.py</code> <pre><code>class Cell(ElementTyped):\n    \"\"\" \"table:table-cell\" table cell element.\"\"\"\n\n    _tag = \"table:table-cell\"\n    _caching = True\n\n    def __init__(\n        self,\n        value: Any = None,\n        text: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        formula: str | None = None,\n        repeated: int | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a cell element containing the given value. The textual\n        representation is automatically formatted but can be provided. Cell\n        type can be deduced as well, unless the number is a percentage or\n        currency. If cell type is \"currency\", the currency must be given.\n        The cell can be repeated on the given number of columns.\n\n        Arguments:\n\n            value -- bool, int, float, Decimal, date, datetime, str,\n                     timedelta\n\n            text -- str\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            repeated -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self.x = None\n        self.y = None\n        if self._do_init:\n            self.set_value(\n                value,\n                text=text,\n                cell_type=cell_type,\n                currency=currency,\n                formula=formula,\n            )\n            if repeated and repeated &gt; 1:\n                self.repeated = repeated\n            if style is not None:\n                self.style = style\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} x={self.x} y={self.y}&gt;\"\n\n    @property\n    def clone(self) -&gt; Cell:\n        clone = Element.clone.fget(self)  # type: ignore\n        clone.y = self.y\n        clone.x = self.x\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                clone._rmap = self._rmap[:]\n            clone._tmap = self._tmap[:]\n            clone._cmap = self._cmap[:]\n        return clone\n\n    @property\n    def value(\n        self,\n    ) -&gt; str | bool | int | Float | Decimal | date | datetime | timedelta | None:\n        \"\"\"Set / get the value of the cell. The type is read from the\n        'office:value-type' attribute of the cell. When setting the value,\n        the type of the value will determine the new value_type of the cell.\n\n        Warning: use this method for boolean, float or string only.\n        \"\"\"\n        value_type = self.get_attribute_string(\"office:value-type\")\n        if value_type == \"boolean\":\n            return self.get_attribute(\"office:boolean-value\")\n        if value_type in {\"float\", \"percentage\", \"currency\"}:\n            value_decimal = Decimal(str(self.get_attribute_string(\"office:value\")))\n            # Return 3 instead of 3.0 if possible\n            if int(value_decimal) == value_decimal:\n                return int(value_decimal)\n            return value_decimal\n        if value_type == \"date\":\n            value_str = str(self.get_attribute_string(\"office:date-value\"))\n            if \"T\" in value_str:\n                return DateTime.decode(value_str)\n            return Date.decode(value_str)\n        if value_type == \"time\":\n            return Duration.decode(str(self.get_attribute_string(\"office:time-value\")))\n        if value_type == \"string\":\n            value = self.get_attribute_string(\"office:string-value\")\n            if value is not None:\n                return value\n            value_list = []\n            for para in self.get_elements(\"text:p\"):\n                value_list.append(para.text_recursive)\n            return \"\\n\".join(value_list)\n        return None\n\n    @value.setter\n    def value(self, value: str | bytes | bool | int | Float | Decimal | None) -&gt; None:\n        self.clear()\n        if value is None:\n            return\n        if isinstance(value, (str, bytes)):\n            if isinstance(value, bytes):\n                value = bytes_to_str(value)\n            self.set_attribute(\"office:value-type\", \"string\")\n            self.set_attribute(\"office:string-value\", value)\n            self.text = value\n            return\n        if value is True or value is False:\n            self.set_attribute(\"office:value-type\", \"boolean\")\n            value_bool = Boolean.encode(value)\n            self.set_attribute(\"office:boolean-value\", value_bool)\n            self.text = value_bool\n            return\n        if isinstance(value, (int, Float, Decimal)):\n            self.set_attribute(\"office:value-type\", \"float\")\n            value_str = str(value)\n            self.set_attribute(\"office:value\", value_str)\n            self.text = value_str\n            return\n        raise TypeError(f\"Unknown value type, try with set_value() : {value!r}\")\n\n    @property\n    def float(self) -&gt; Float:\n        \"\"\"Set / get the value of the cell as a float (or 0.0).\"\"\"\n        for tag in (\"office:value\", \"office:string-value\", \"office:boolean-value\"):\n            read_attr = self.get_attribute(tag)\n            if isinstance(read_attr, str):\n                with contextlib.suppress(ValueError, TypeError):\n                    return Float(read_attr)\n        return 0.0\n\n    @float.setter\n    def float(self, value: str | Float | int | Decimal) -&gt; None:\n        try:\n            value_float = Float(value)\n        except (ValueError, TypeError):\n            value_float = 0.0\n        value_str = str(value_float)\n        self.clear()\n        self.set_attribute(\"office:value\", value_str)\n        self.set_attribute(\"office:value-type\", \"float\")\n        self.text = value_str\n\n    @property\n    def string(self) -&gt; str:\n        \"\"\"Set / get the value of the cell as a string (or '').\"\"\"\n        value = self.get_attribute_string(\"office:string-value\")\n        if isinstance(value, str):\n            return value\n        return \"\"\n\n    @string.setter\n    def string(\n        self,\n        value: str | bytes | int | Float | Decimal | bool | None,  # type: ignore\n    ) -&gt; None:\n        self.clear()\n        if value is None:\n            value_str = \"\"\n        else:\n            value_str = str(value)\n        self.set_attribute(\"office:value-type\", \"string\")\n        self.set_attribute(\"office:string-value\", value_str)\n        self.text = value_str\n\n    def set_value(\n        self,\n        value: (\n            str  # type: ignore\n            | bytes\n            | Float\n            | int\n            | Decimal\n            | bool\n            | datetime\n            | date\n            | timedelta\n            | None\n        ),\n        text: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        formula: str | None = None,\n    ) -&gt; None:\n        \"\"\"Set the cell state from the Python value type.\n\n        Text is how the cell is displayed. Cell type is guessed,\n        unless provided.\n\n        For monetary values, provide the name of the currency.\n\n        Arguments:\n\n            value -- Python type\n\n            text -- str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                        'currency' or 'percentage'\n\n            currency -- str\n        \"\"\"\n        self.clear()\n        text = self.set_value_and_type(\n            value=value,\n            text=text,\n            value_type=cell_type,\n            currency=currency,\n        )\n        if text is not None:\n            self.text_content = text\n        if formula is not None:\n            self.formula = formula\n\n    @property\n    def type(self) -&gt; str | None:\n        \"\"\"Get / set the type of the cell: boolean, float, date, string\n        or time.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"office:value-type\")\n\n    @type.setter\n    def type(self, cell_type: str) -&gt; None:\n        self.set_attribute(\"office:value-type\", cell_type)\n\n    @property\n    def currency(self) -&gt; str | None:\n        \"\"\"Get / set the currency used for monetary values.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"office:currency\")\n\n    @currency.setter\n    def currency(self, currency: str) -&gt; None:\n        self.set_attribute(\"office:currency\", currency)\n\n    def _set_repeated(self, repeated: int | None) -&gt; None:\n        \"\"\"Internal only. Set the numnber of times the cell is repeated, or\n        None to delete. Without changing cache.\n        \"\"\"\n        if repeated is None or repeated &lt; 2:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:number-columns-repeated\")\n            return\n        self.set_attribute(\"table:number-columns-repeated\", str(repeated))\n\n    @property\n    def repeated(self) -&gt; int | None:\n        \"\"\"Get / set the number of times the cell is repeated.\n\n        Always None when using the table API.\n\n        Return: int or None\n        \"\"\"\n        repeated = self.get_attribute(\"table:number-columns-repeated\")\n        if repeated is None:\n            return None\n        return int(repeated)\n\n    @repeated.setter\n    def repeated(self, repeated: int | None) -&gt; None:\n        self._set_repeated(repeated)\n        # update cache\n        child: Element = self\n        while True:\n            # look for Row, parent may be group of rows\n            upper = child.parent\n            if not upper:\n                # lonely cell\n                return\n            # parent may be group of rows, not table\n            if isinstance(upper, Element) and upper._tag == \"table:table-row\":\n                break\n            child = upper\n        # fixme : need to optimize this\n        if isinstance(upper, Element) and upper._tag == \"table:table-row\":\n            upper._compute_row_cache()\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get / set the style of the cell itself.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"table:style-name\")\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n\n    @property\n    def formula(self) -&gt; str | None:\n        \"\"\"Get / set the formula of the cell, or None if undefined.\n\n        The formula is not interpreted in any way.\n\n        Return: str | None\n        \"\"\"\n        return self.get_attribute_string(\"table:formula\")\n\n    @formula.setter\n    def formula(self, formula: str | None) -&gt; None:\n        self.set_attribute(\"table:formula\", formula)\n\n    def is_empty(self, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return whether the cell has no value or the value evaluates\n        to False (empty string), and no style.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            aggressive -- bool\n\n        Return: bool\n        \"\"\"\n        if self.value is not None or self.children or self.is_spanned():\n            return False\n        if not aggressive and self.style is not None:\n            return False\n        return True\n\n    def is_spanned(self) -&gt; bool:\n        \"\"\"Return whether the cell is spanned over several cells.\n\n        Returns: True | False\n        \"\"\"\n        if self.tag == \"table:covered-table-cell\":\n            return True\n        if self.get_attribute(\"table:number-columns-spanned\") is not None:\n            return True\n        if self.get_attribute(\"table:number-rows-spanned\") is not None:\n            return True\n        return False\n\n    _is_spanned = is_spanned  # compatibility\n</code></pre>"},{"location":"reference.html#odfdo.Cell.currency","title":"<code>currency: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the currency used for monetary values.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.float","title":"<code>float: Float</code>  <code>property</code> <code>writable</code>","text":"<p>Set / get the value of the cell as a float (or 0.0).</p>"},{"location":"reference.html#odfdo.Cell.formula","title":"<code>formula: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the formula of the cell, or None if undefined.</p> <p>The formula is not interpreted in any way.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.repeated","title":"<code>repeated: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the number of times the cell is repeated.</p> <p>Always None when using the table API.</p> <p>Return: int or None</p>"},{"location":"reference.html#odfdo.Cell.string","title":"<code>string: str</code>  <code>property</code> <code>writable</code>","text":"<p>Set / get the value of the cell as a string (or \u2018\u2019).</p>"},{"location":"reference.html#odfdo.Cell.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the style of the cell itself.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.type","title":"<code>type: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the type of the cell: boolean, float, date, string or time.</p> <p>Return: str | None</p>"},{"location":"reference.html#odfdo.Cell.value","title":"<code>value: str | bool | int | Float | Decimal | date | datetime | timedelta | None</code>  <code>property</code> <code>writable</code>","text":"<p>Set / get the value of the cell. The type is read from the \u2018office:value-type\u2019 attribute of the cell. When setting the value, the type of the value will determine the new value_type of the cell.</p> <p>Warning: use this method for boolean, float or string only.</p>"},{"location":"reference.html#odfdo.Cell.__init__","title":"<code>__init__(value=None, text=None, cell_type=None, currency=None, formula=None, repeated=None, style=None, **kwargs)</code>","text":"<p>Create a cell element containing the given value. The textual representation is automatically formatted but can be provided. Cell type can be deduced as well, unless the number is a percentage or currency. If cell type is \u201ccurrency\u201d, the currency must be given. The cell can be repeated on the given number of columns.</p> <p>Arguments:</p> <pre><code>value -- bool, int, float, Decimal, date, datetime, str,\n         timedelta\n\ntext -- str\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nrepeated -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/cell.py</code> <pre><code>def __init__(\n    self,\n    value: Any = None,\n    text: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    formula: str | None = None,\n    repeated: int | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a cell element containing the given value. The textual\n    representation is automatically formatted but can be provided. Cell\n    type can be deduced as well, unless the number is a percentage or\n    currency. If cell type is \"currency\", the currency must be given.\n    The cell can be repeated on the given number of columns.\n\n    Arguments:\n\n        value -- bool, int, float, Decimal, date, datetime, str,\n                 timedelta\n\n        text -- str\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        repeated -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self.x = None\n    self.y = None\n    if self._do_init:\n        self.set_value(\n            value,\n            text=text,\n            cell_type=cell_type,\n            currency=currency,\n            formula=formula,\n        )\n        if repeated and repeated &gt; 1:\n            self.repeated = repeated\n        if style is not None:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Cell.is_empty","title":"<code>is_empty(aggressive=False)</code>","text":"<p>Return whether the cell has no value or the value evaluates to False (empty string), and no style.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> <p>Return: bool</p> Source code in <code>odfdo/cell.py</code> <pre><code>def is_empty(self, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return whether the cell has no value or the value evaluates\n    to False (empty string), and no style.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        aggressive -- bool\n\n    Return: bool\n    \"\"\"\n    if self.value is not None or self.children or self.is_spanned():\n        return False\n    if not aggressive and self.style is not None:\n        return False\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Cell.is_spanned","title":"<code>is_spanned()</code>","text":"<p>Return whether the cell is spanned over several cells.</p> <p>Returns: True | False</p> Source code in <code>odfdo/cell.py</code> <pre><code>def is_spanned(self) -&gt; bool:\n    \"\"\"Return whether the cell is spanned over several cells.\n\n    Returns: True | False\n    \"\"\"\n    if self.tag == \"table:covered-table-cell\":\n        return True\n    if self.get_attribute(\"table:number-columns-spanned\") is not None:\n        return True\n    if self.get_attribute(\"table:number-rows-spanned\") is not None:\n        return True\n    return False\n</code></pre>"},{"location":"reference.html#odfdo.Cell.set_value","title":"<code>set_value(value, text=None, cell_type=None, currency=None, formula=None)</code>","text":"<p>Set the cell state from the Python value type.</p> <p>Text is how the cell is displayed. Cell type is guessed, unless provided.</p> <p>For monetary values, provide the name of the currency.</p> <p>Arguments:</p> <pre><code>value -- Python type\n\ntext -- str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n            'currency' or 'percentage'\n\ncurrency -- str\n</code></pre> Source code in <code>odfdo/cell.py</code> <pre><code>def set_value(\n    self,\n    value: (\n        str  # type: ignore\n        | bytes\n        | Float\n        | int\n        | Decimal\n        | bool\n        | datetime\n        | date\n        | timedelta\n        | None\n    ),\n    text: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    formula: str | None = None,\n) -&gt; None:\n    \"\"\"Set the cell state from the Python value type.\n\n    Text is how the cell is displayed. Cell type is guessed,\n    unless provided.\n\n    For monetary values, provide the name of the currency.\n\n    Arguments:\n\n        value -- Python type\n\n        text -- str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                    'currency' or 'percentage'\n\n        currency -- str\n    \"\"\"\n    self.clear()\n    text = self.set_value_and_type(\n        value=value,\n        text=text,\n        value_type=cell_type,\n        currency=currency,\n    )\n    if text is not None:\n        self.text_content = text\n    if formula is not None:\n        self.formula = formula\n</code></pre>"},{"location":"reference.html#odfdo.ChangeInfo","title":"<code>ChangeInfo</code>","text":"<p>               Bases: <code>Element</code>, <code>DcCreatorMixin</code>, <code>DcDateMixin</code></p> <p>The \u201coffice:change-info\u201d element represents who made a change and when. It may also contain a comment (one or more Paragrah \u201ctext:p\u201d elements) on the change.</p> The comments available in the ChangeInfo are available through <ul> <li>paragraphs property, get_paragraphs and get_paragraph methods for actual Paragraph.</li> <li>get_comments for a plain text version</li> </ul> <p>Arguments:</p> <p>creator \u2013 str (or None)</p> <p>date \u2013 datetime (or None)</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class ChangeInfo(Element, DcCreatorMixin, DcDateMixin):\n    \"\"\"The \"office:change-info\" element represents who made a change and when.\n    It may also contain a comment (one or more Paragrah \"text:p\" elements)\n    on the change.\n\n    The comments available in the ChangeInfo are available through:\n      - paragraphs property, get_paragraphs and get_paragraph methods for actual Paragraph.\n      - get_comments for a plain text version\n\n      Arguments:\n\n         creator -- str (or None)\n\n         date -- datetime (or None)\n    \"\"\"\n\n    _tag = \"office:change-info\"\n\n    def __init__(\n        self,\n        creator: str | None = None,\n        date: datetime | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.creator = creator or \"Unknown\"\n            self.date = date\n\n    def get_comments(self, joined: bool = True) -&gt; str | list[str]:\n        \"\"\"Get text content of the comments. If joined is True (default), the\n        text of different paragraphs is concatenated, else a list of strings,\n        one per paragraph, is returned.\n\n        Arguments:\n\n            joined -- boolean (default is True)\n\n        Return: str or list of str.\n        \"\"\"\n        content = self.paragraphs\n        if content is None:\n            content = []\n        text = [para.get_formatted_text(simple=True) for para in content]  # type: ignore\n        if joined:\n            return \"\\n\".join(text)\n        return text\n\n    def set_comments(self, text: str = \"\", replace: bool = True) -&gt; None:\n        \"\"\"Set the text content of the comments. If replace is True (default),\n        the new text replace old comments, else it is added at the end.\n\n        Arguments:\n\n            text -- str\n\n            replace -- boolean\n        \"\"\"\n        if replace:\n            for para in self.paragraphs:\n                self.delete(para)\n        para = Paragraph()\n        para.append_plain_text(text)\n        self.insert(para, xmlposition=LAST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.ChangeInfo.get_comments","title":"<code>get_comments(joined=True)</code>","text":"<p>Get text content of the comments. If joined is True (default), the text of different paragraphs is concatenated, else a list of strings, one per paragraph, is returned.</p> <p>Arguments:</p> <pre><code>joined -- boolean (default is True)\n</code></pre> <p>Return: str or list of str.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_comments(self, joined: bool = True) -&gt; str | list[str]:\n    \"\"\"Get text content of the comments. If joined is True (default), the\n    text of different paragraphs is concatenated, else a list of strings,\n    one per paragraph, is returned.\n\n    Arguments:\n\n        joined -- boolean (default is True)\n\n    Return: str or list of str.\n    \"\"\"\n    content = self.paragraphs\n    if content is None:\n        content = []\n    text = [para.get_formatted_text(simple=True) for para in content]  # type: ignore\n    if joined:\n        return \"\\n\".join(text)\n    return text\n</code></pre>"},{"location":"reference.html#odfdo.ChangeInfo.set_comments","title":"<code>set_comments(text='', replace=True)</code>","text":"<p>Set the text content of the comments. If replace is True (default), the new text replace old comments, else it is added at the end.</p> <p>Arguments:</p> <pre><code>text -- str\n\nreplace -- boolean\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_comments(self, text: str = \"\", replace: bool = True) -&gt; None:\n    \"\"\"Set the text content of the comments. If replace is True (default),\n    the new text replace old comments, else it is added at the end.\n\n    Arguments:\n\n        text -- str\n\n        replace -- boolean\n    \"\"\"\n    if replace:\n        for para in self.paragraphs:\n            self.delete(para)\n    para = Paragraph()\n    para.append_plain_text(text)\n    self.insert(para, xmlposition=LAST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.Chart","title":"<code>Chart</code>","text":"<p>               Bases: <code>Body</code></p> <p>Chart, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Chart(Body):\n    \"\"\"Chart, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:chart\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.Column","title":"<code>Column</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF table column \u201ctable:table-column\u201d</p> Source code in <code>odfdo/table.py</code> <pre><code>class Column(Element):\n    \"\"\"ODF table column \"table:table-column\" \"\"\"\n\n    _tag = \"table:table-column\"\n    _caching = True\n\n    def __init__(\n        self,\n        default_cell_style: str | None = None,\n        repeated: int | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a column group element of the optionally given style. Cell\n        style can be set for the whole column. If the properties apply to\n        several columns, give the number of repeated columns.\n\n        Columns don't contain cells, just style information.\n\n        You don't generally have to create columns by hand, use the Table API.\n\n        Arguments:\n\n            default_cell_style -- str\n\n            repeated -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self.x = None\n        if self._do_init:\n            if default_cell_style:\n                self.default_cell_style = default_cell_style\n            if repeated and repeated &gt; 1:\n                self.repeated = repeated\n            if style:\n                self.style = style\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} x={self.x}&gt;\"\n\n    @property\n    def clone(self) -&gt; Column:\n        clone = Element.clone.fget(self)  # type: ignore\n        clone.x = self.x\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                clone._rmap = self._rmap[:]\n            clone._tmap = self._tmap[:]\n            clone._cmap = self._cmap[:]\n        return clone\n\n    def get_default_cell_style(self) -&gt; str | None:\n        \"\"\"Get or set the default cell style for column.\n\n        (See also self.default_cell_style property.)\n        \"\"\"\n        return self.get_attribute_string(\"table:default-cell-style-name\")\n\n    def set_default_cell_style(self, style: Element | str | None) -&gt; None:\n        \"\"\"Get or set the default cell style for column.\n\n        (See also self.default_cell_style property.)\n        \"\"\"\n        self.set_style_attribute(\"table:default-cell-style-name\", style)\n\n    @property\n    def default_cell_style(self) -&gt; str | None:\n        \"\"\"Get or set the default cell style for column.\"\"\"\n        return self.get_attribute_string(\"table:default-cell-style-name\")\n\n    @default_cell_style.setter\n    def default_cell_style(self, style: Element | str | None) -&gt; None:\n        self.set_style_attribute(\"table:default-cell-style-name\", style)\n\n    def _set_repeated(self, repeated: int | None) -&gt; None:\n        \"\"\"Internal only. Set the number of times the column is repeated, or\n        None to delete it. Without changing cache.\n\n        Arguments:\n\n            repeated -- int or None\n        \"\"\"\n        if repeated is None or repeated &lt; 2:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:number-columns-repeated\")\n            return\n        self.set_attribute(\"table:number-columns-repeated\", str(repeated))\n\n    @property\n    def repeated(self) -&gt; int | None:\n        \"\"\"Get /set the number of times the column is repeated.\n\n        Always None when using the table API.\n\n        Return: int or None\n        \"\"\"\n        repeated = self.get_attribute(\"table:number-columns-repeated\")\n        if repeated is None:\n            return None\n        return int(repeated)\n\n    @repeated.setter\n    def repeated(self, repeated: int | None) -&gt; None:\n        self._set_repeated(repeated)\n        # update cache\n        current: Element = self\n        while True:\n            # look for Table, parent may be group of rows\n            upper = current.parent\n            if not upper:\n                # lonely column\n                return\n            # parent may be group of rows, not table\n            if isinstance(upper, Table):\n                break\n            current = upper\n        # fixme : need to optimize this\n        if isinstance(upper, Table):\n            upper._compute_table_cache()\n            if hasattr(self, \"_cmap\"):\n                del self._cmap[:]\n                self._cmap.extend(upper._cmap)\n            else:\n                self._cmap = upper._cmap\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get /set the style of the column itself.\n\n        Return: str\n        \"\"\"\n        return self.get_attribute_string(\"table:style-name\")\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n</code></pre>"},{"location":"reference.html#odfdo.Column.default_cell_style","title":"<code>default_cell_style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the default cell style for column.</p>"},{"location":"reference.html#odfdo.Column.repeated","title":"<code>repeated: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get /set the number of times the column is repeated.</p> <p>Always None when using the table API.</p> <p>Return: int or None</p>"},{"location":"reference.html#odfdo.Column.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get /set the style of the column itself.</p> <p>Return: str</p>"},{"location":"reference.html#odfdo.Column.__init__","title":"<code>__init__(default_cell_style=None, repeated=None, style=None, **kwargs)</code>","text":"<p>Create a column group element of the optionally given style. Cell style can be set for the whole column. If the properties apply to several columns, give the number of repeated columns.</p> <p>Columns don\u2019t contain cells, just style information.</p> <p>You don\u2019t generally have to create columns by hand, use the Table API.</p> <p>Arguments:</p> <pre><code>default_cell_style -- str\n\nrepeated -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    default_cell_style: str | None = None,\n    repeated: int | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a column group element of the optionally given style. Cell\n    style can be set for the whole column. If the properties apply to\n    several columns, give the number of repeated columns.\n\n    Columns don't contain cells, just style information.\n\n    You don't generally have to create columns by hand, use the Table API.\n\n    Arguments:\n\n        default_cell_style -- str\n\n        repeated -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self.x = None\n    if self._do_init:\n        if default_cell_style:\n            self.default_cell_style = default_cell_style\n        if repeated and repeated &gt; 1:\n            self.repeated = repeated\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Column.get_default_cell_style","title":"<code>get_default_cell_style()</code>","text":"<p>Get or set the default cell style for column.</p> <p>(See also self.default_cell_style property.)</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_default_cell_style(self) -&gt; str | None:\n    \"\"\"Get or set the default cell style for column.\n\n    (See also self.default_cell_style property.)\n    \"\"\"\n    return self.get_attribute_string(\"table:default-cell-style-name\")\n</code></pre>"},{"location":"reference.html#odfdo.Column.set_default_cell_style","title":"<code>set_default_cell_style(style)</code>","text":"<p>Get or set the default cell style for column.</p> <p>(See also self.default_cell_style property.)</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_default_cell_style(self, style: Element | str | None) -&gt; None:\n    \"\"\"Get or set the default cell style for column.\n\n    (See also self.default_cell_style property.)\n    \"\"\"\n    self.set_style_attribute(\"table:default-cell-style-name\", style)\n</code></pre>"},{"location":"reference.html#odfdo.ConnectorShape","title":"<code>ConnectorShape</code>","text":"<p>               Bases: <code>ShapeBase</code></p> <p>Create a Connector shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\nconnected_shapes -- (shape, shape)\n\nglue_points -- (point, point)\n\np1 -- (str, str)\n\np2 -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class ConnectorShape(ShapeBase):\n    \"\"\"Create a Connector shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        connected_shapes -- (shape, shape)\n\n        glue_points -- (point, point)\n\n        p1 -- (str, str)\n\n        p2 -- (str, str)\n    \"\"\"\n\n    _tag = \"draw:connector\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"start_shape\", \"draw:start-shape\"),\n        PropDef(\"end_shape\", \"draw:end-shape\"),\n        PropDef(\"start_glue_point\", \"draw:start-glue-point\"),\n        PropDef(\"end_glue_point\", \"draw:end-glue-point\"),\n        PropDef(\"x1\", \"svg:x1\"),\n        PropDef(\"y1\", \"svg:y1\"),\n        PropDef(\"x2\", \"svg:x2\"),\n        PropDef(\"y2\", \"svg:y2\"),\n    )\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        connected_shapes: tuple | None = None,\n        glue_points: tuple | None = None,\n        p1: tuple | None = None,\n        p2: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n            }\n        )\n        super().__init__(**kwargs)\n        if self._do_init:\n            if connected_shapes:\n                self.start_shape = connected_shapes[0].draw_id\n                self.end_shape = connected_shapes[1].draw_id\n            if glue_points:\n                self.start_glue_point = glue_points[0]\n                self.end_glue_point = glue_points[1]\n            if p1:\n                self.x1 = p1[0]\n                self.y1 = p1[1]\n            if p2:\n                self.x2 = p2[0]\n                self.y2 = p2[1]\n</code></pre>"},{"location":"reference.html#odfdo.Container","title":"<code>Container</code>","text":"<p>Representation of the ODF file.</p> Source code in <code>odfdo/container.py</code> <pre><code>class Container:\n    \"\"\"Representation of the ODF file.\"\"\"\n\n    def __init__(self, path: Path | str | io.BytesIO | None = None) -&gt; None:\n        self.__parts: dict[str, bytes | None] = {}\n        self.__parts_ts: dict[str, int] = {}\n        self.__path_like: Path | str | io.BytesIO | None = None\n        self.__packaging: str = ZIP\n        self.path: Path | None = None  # or Path\n        if path:\n            self.open(path)\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} type={self.mimetype} path={self.path}&gt;\"\n\n    def open(self, path_or_file: Path | str | io.BytesIO) -&gt; None:\n        \"\"\"Load the content of an ODF file.\"\"\"\n        self.__path_like = path_or_file\n        if isinstance(path_or_file, (str, Path)):\n            self.path = Path(path_or_file).expanduser()\n            if not self.path.exists():\n                raise FileNotFoundError(str(self.path))\n            self.__path_like = self.path\n        if (self.path or isinstance(self.__path_like, io.BytesIO)) and is_zipfile(\n            self.__path_like  # type: ignore\n        ):\n            self.__packaging = ZIP\n            return self._read_zip()\n        if self.path:\n            is_folder = False\n            with contextlib.suppress(OSError):\n                is_folder = self.path.is_dir()\n            if is_folder:\n                self.__packaging = FOLDER\n                return self._read_folder()\n        raise TypeError(f\"Document format not managed by odfdo: {type(path_or_file)}.\")\n\n    def _read_zip(self) -&gt; None:\n        if isinstance(self.__path_like, io.BytesIO):\n            self.__path_like.seek(0)\n        with ZipFile(self.__path_like) as zf:  # type: ignore\n            mimetype = bytes_to_str(zf.read(\"mimetype\"))\n            if mimetype not in ODF_MIMETYPES:\n                raise ValueError(f\"Document of unknown type {mimetype}\")\n            self.__parts[\"mimetype\"] = str_to_bytes(mimetype)\n        if self.path is None:\n            if isinstance(self.__path_like, io.BytesIO):\n                self.__path_like.seek(0)\n            # read the full file at once and forget file\n            with ZipFile(self.__path_like) as zf:  # type: ignore\n                for name in zf.namelist():\n                    upath = normalize_path(name)\n                    self.__parts[upath] = zf.read(name)\n            self.__path_like = None\n\n    def _read_folder(self) -&gt; None:\n        try:\n            mimetype, timestamp = self._get_folder_part(\"mimetype\")\n        except OSError:\n            printwarn(\"Corrupted or not an OpenDocument folder (missing mimetype)\")\n            mimetype = b\"\"\n            timestamp = int(time.time())\n        if bytes_to_str(mimetype) not in ODF_MIMETYPES:\n            message = f\"Document of unknown type {mimetype!r}, try with ODF Text.\"\n            printwarn(message)\n            self.__parts[\"mimetype\"] = str_to_bytes(ODF_EXTENSIONS[\"odt\"])\n            self.__parts_ts[\"mimetype\"] = timestamp\n\n    def _parse_folder(self, folder: str) -&gt; list[str]:\n        parts = []\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        root = self.path / folder\n        for path in root.iterdir():\n            if path.name.startswith(\".\"):  # no hidden files\n                continue\n            relative_path = path.relative_to(self.path)\n            if path.is_file():\n                parts.append(relative_path.as_posix())\n            if path.is_dir():\n                sub_parts = self._parse_folder(str(relative_path))\n                if sub_parts:\n                    parts.extend(sub_parts)\n                else:\n                    # store leaf directories\n                    parts.append(relative_path.as_posix() + \"/\")\n        return parts\n\n    def _get_folder_parts(self) -&gt; list[str]:\n        \"\"\"Get the list of members in the ODF folder.\"\"\"\n        return self._parse_folder(\"\")\n\n    def _get_folder_part(self, name: str) -&gt; tuple[bytes, int]:\n        \"\"\"Get bytes of a part from the ODF folder, with timestamp.\"\"\"\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        path = self.path / name\n        timestamp = int(path.stat().st_mtime)\n        if path.is_dir():\n            return (b\"\", timestamp)\n        return (path.read_bytes(), timestamp)\n\n    def _get_folder_part_timestamp(self, name: str) -&gt; int:\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        path = self.path / name\n        try:\n            timestamp = int(path.stat().st_mtime)\n        except OSError:\n            timestamp = -1\n        return timestamp\n\n    def _get_zip_part(self, name: str) -&gt; bytes | None:\n        \"\"\"Get bytes of a part from the Zip ODF file. No cache.\"\"\"\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        try:\n            with ZipFile(self.path) as zf:\n                upath = normalize_path(name)\n                self.__parts[upath] = zf.read(name)\n                return self.__parts[upath]\n        except BadZipfile:\n            return None\n\n    def _get_all_zip_part(self) -&gt; None:\n        \"\"\"Read all parts. No cache.\"\"\"\n        if self.path is None:\n            raise ValueError(\"Document path is not defined\")\n        try:\n            with ZipFile(self.path) as zf:\n                for name in zf.namelist():\n                    upath = normalize_path(name)\n                    self.__parts[upath] = zf.read(name)\n        except BadZipfile:\n            pass\n\n    def _save_zip(self, target: str | Path | io.BytesIO) -&gt; None:\n        \"\"\"Save a Zip ODF from the available parts.\"\"\"\n        parts = self.__parts\n        with ZipFile(target, \"w\", compression=ZIP_DEFLATED) as filezip:\n            # Parts to save, except manifest at the end\n            part_names = list(parts.keys())\n            try:\n                part_names.remove(ODF_MANIFEST)\n            except ValueError:\n                printwarn(f\"Missing '{ODF_MANIFEST}'\")\n            # \"Pretty-save\" parts in some order\n            # mimetype requires to be first and uncompressed\n            mimetype = parts.get(\"mimetype\")\n            if mimetype is None:\n                raise ValueError(\"Mimetype is not defined\")\n            try:\n                filezip.writestr(\"mimetype\", mimetype, ZIP_STORED)\n                part_names.remove(\"mimetype\")\n            except (ValueError, KeyError):\n                printwarn(\"Missing 'mimetype'\")\n            # XML parts\n            for path in ODF_CONTENT, ODF_META, ODF_SETTINGS, ODF_STYLES:\n                if path not in parts:\n                    printwarn(f\"Missing '{path}'\")\n                    continue\n                part = parts[path]\n                if part is None:\n                    continue\n                filezip.writestr(path, part)\n                part_names.remove(path)\n            # Everything else\n            for path in part_names:\n                data = parts[path]\n                if data is None:\n                    # Deleted\n                    continue\n                filezip.writestr(path, data)\n            # Manifest\n            with contextlib.suppress(KeyError):\n                part = parts[ODF_MANIFEST]\n                if part is not None:\n                    filezip.writestr(ODF_MANIFEST, part)\n\n    def _save_folder(self, folder: Path | str) -&gt; None:\n        \"\"\"Save a folder ODF from the available parts.\"\"\"\n\n        def dump(part_path: str, content: bytes) -&gt; None:\n            if part_path.endswith(\"/\"):  # folder\n                is_folder = True\n                pure_path = PurePath(folder, part_path[:-1])\n            else:\n                is_folder = False\n                pure_path = PurePath(folder, part_path)\n            path = Path(pure_path)\n            if is_folder:\n                path.mkdir(parents=True, exist_ok=True)\n            else:\n                path.parent.mkdir(parents=True, exist_ok=True)\n                path.write_bytes(content)\n                path.chmod(0o666)\n\n        for part_path, data in self.__parts.items():\n            if data is None:\n                # Deleted\n                continue\n            dump(part_path, data)\n\n    def _xml_content(self) -&gt; bytes:\n        mimetype = self.__parts[\"mimetype\"].decode(\"utf8\")\n        doc_xml = (\n            OFFICE_PREFIX.decode(\"utf8\")\n            + f'office:version=\"{OFFICE_VERSION}\"\\n'\n            + f'office:mimetype=\"{mimetype}\"&gt;'\n            + \"&lt;/office:document&gt;\"\n        )\n        root = fromstring(doc_xml.encode(\"utf8\"))\n        for path in ODF_META, ODF_SETTINGS, ODF_STYLES, ODF_CONTENT:\n            if path not in self.__parts:\n                printwarn(f\"Missing '{path}'\")\n                continue\n            part = self.__parts[path]\n            if part is None:\n                continue\n            if isinstance(part, bytes):\n                xpart = fromstring(part)\n            else:\n                xpart = part\n            print(xpart, part.__class__.__name__)\n            for child in xpart:\n                root.append(child)\n        return tostring(root, encoding=\"UTF-8\", xml_declaration=True)\n\n    def _save_xml(self, target: Path | str) -&gt; None:\n        \"\"\"Save a XML flat ODF format from the available parts.\"\"\"\n        target = Path(target).with_suffix(\".xml\")\n        target.write_bytes(self._xml_content())\n\n    # Public API\n\n    def get_parts(self) -&gt; list[str]:\n        \"\"\"Get the list of members.\"\"\"\n        if not self.path:\n            # maybe a file like zip archive\n            return list(self.__parts.keys())\n        if self.__packaging == ZIP:\n            parts = []\n            with ZipFile(self.path) as zf:\n                for name in zf.namelist():\n                    upath = normalize_path(name)\n                    parts.append(upath)\n            return parts\n        elif self.__packaging == FOLDER:\n            return self._get_folder_parts()\n        else:\n            raise ValueError(\"Unable to provide parts of the document\")\n\n    @property\n    def parts(self) -&gt; list[str]:\n        \"\"\"Get the list of members.\"\"\"\n        return self.get_parts()\n\n    def get_part(self, path: str) -&gt; str | bytes | None:\n        \"\"\"Get the bytes of a part of the ODF.\"\"\"\n        path = str(path)\n        if path in self.__parts:\n            part = self.__parts[path]\n            if part is None:\n                raise ValueError(f'Part \"{path}\" is deleted')\n            if self.__packaging == FOLDER:\n                cache_ts = self.__parts_ts.get(path, -1)\n                current_ts = self._get_folder_part_timestamp(path)\n                if current_ts != cache_ts:\n                    part, timestamp = self._get_folder_part(path)\n                    self.__parts[path] = part\n                    self.__parts_ts[path] = timestamp\n            return part\n        if self.__packaging == ZIP:\n            return self._get_zip_part(path)\n        if self.__packaging == FOLDER:\n            part, timestamp = self._get_folder_part(path)\n            self.__parts[path] = part\n            self.__parts_ts[path] = timestamp\n            return part\n        return None\n\n    @property\n    def mimetype(self) -&gt; str:\n        \"\"\"Return str value of mimetype of the document.\"\"\"\n        with contextlib.suppress(Exception):\n            b_mimetype = self.get_part(\"mimetype\")\n            if isinstance(b_mimetype, bytes):\n                return bytes_to_str(b_mimetype)\n        return \"\"\n\n    @mimetype.setter\n    def mimetype(self, mimetype: str | bytes) -&gt; None:\n        \"\"\"Set mimetype value of the document.\"\"\"\n        if isinstance(mimetype, str):\n            self.__parts[\"mimetype\"] = str_to_bytes(mimetype)\n        elif isinstance(mimetype, bytes):\n            self.__parts[\"mimetype\"] = mimetype\n        else:\n            raise TypeError(f'Wrong mimetype \"{mimetype!r}\"')\n\n    def set_part(self, path: str, data: bytes) -&gt; None:\n        \"\"\"Replace or add a new part.\"\"\"\n        self.__parts[path] = data\n\n    def del_part(self, path: str) -&gt; None:\n        \"\"\"Mark a part for deletion.\"\"\"\n        self.__parts[path] = None\n\n    @property\n    def clone(self) -&gt; Container:\n        \"\"\"Make a copy of this container with no path.\"\"\"\n        if self.path and self.__packaging == ZIP:\n            self._get_all_zip_part()\n        clone = deepcopy(self)\n        clone.path = None\n        return clone\n\n    def _backup_or_unlink(self, backup: bool, target: str | Path) -&gt; None:\n        if backup:\n            self._do_backup(target)\n        else:\n            self._do_unlink(target)\n\n    @staticmethod\n    def _do_backup(target: str | Path) -&gt; None:\n        path = Path(target)\n        if not path.exists():\n            return\n        back_file = Path(path.stem + \".backup\" + path.suffix)\n        if back_file.is_dir():\n            try:\n                shutil.rmtree(back_file)\n            except OSError as e:\n                printwarn(str(e))\n        try:\n            shutil.move(target, back_file)\n        except OSError as e:\n            printwarn(str(e))\n\n    @staticmethod\n    def _do_unlink(target: str | Path) -&gt; None:\n        path = Path(target)\n        if path.exists():\n            try:\n                shutil.rmtree(path)\n            except OSError as e:\n                printwarn(str(e))\n\n    def _clean_save_packaging(self, packaging: str | None) -&gt; str:\n        if not packaging:\n            packaging = self.__packaging if self.__packaging else ZIP\n        packaging = packaging.strip().lower()\n        if packaging not in PACKAGING:\n            raise ValueError(f'Packaging of type \"{packaging}\" is not supported')\n        return packaging\n\n    def _clean_save_target(\n        self,\n        target: str | Path | io.BytesIO | None,\n    ) -&gt; str | io.BytesIO:\n        if target is None:\n            target = self.path\n        if isinstance(target, Path):\n            target = str(target)\n        if isinstance(target, str):\n            while target.endswith(os.sep):\n                target = target[:-1]\n            while target.endswith(\".folder\"):\n                target = target.split(\".folder\", 1)[0]\n        return target  # type: ignore\n\n    def _save_as_zip(self, target: str | Path | io.BytesIO, backup: bool) -&gt; None:\n        if isinstance(target, (str, Path)) and backup:\n            self._do_backup(target)\n        self._save_zip(target)\n\n    def _save_as_folder(self, target: str | Path, backup: bool) -&gt; None:\n        if not isinstance(target, (str, Path)):\n            raise TypeError(\n                f\"Saving in folder format requires a folder name, not '{target!r}'\"\n            )\n        if not str(target).endswith(\".folder\"):\n            target = str(target) + \".folder\"\n        self._backup_or_unlink(backup, target)\n        self._save_folder(target)\n\n    def _save_as_xml(self, target: str | Path | io.BytesIO, backup: bool) -&gt; None:\n        if not isinstance(target, (str, Path)):\n            raise TypeError(\n                f\"Saving in XML format requires a folder name, not '{target!r}'\"\n            )\n        if not str(target).endswith(\".xml\"):\n            target = str(target) + \".xml\"\n        if isinstance(target, (str, Path)) and backup:\n            self._do_backup(target)\n        self._save_xml(target)\n\n    def save(\n        self,\n        target: str | Path | io.BytesIO | None,\n        packaging: str | None = None,\n        backup: bool = False,\n    ) -&gt; None:\n        \"\"\"Save the container to the given target, a path or a file-like\n        object.\n\n        Package the output document in the same format than current document,\n        unless \"packaging\" is different.\n\n        Arguments:\n\n            target -- str or file-like or Path\n\n            packaging -- 'zip', or for debugging purpose 'xml' or 'folder'\n\n            backup -- boolean\n        \"\"\"\n        parts = self.__parts\n        packaging = self._clean_save_packaging(packaging)\n        # Load parts else they will be considered deleted\n        for path in self.parts:\n            if path not in parts:\n                self.get_part(path)\n        target = self._clean_save_target(target)\n        if packaging == FOLDER:\n            if isinstance(target, io.BytesIO):\n                raise TypeError(\n                    \"Impossible to save on io.BytesIO with 'folder' packaging\"\n                )\n            self._save_as_folder(target, backup)\n        elif packaging == XML:\n            self._save_as_xml(target, backup)\n        else:\n            # default:\n            self._save_as_zip(target, backup)\n</code></pre>"},{"location":"reference.html#odfdo.Container.clone","title":"<code>clone: Container</code>  <code>property</code>","text":"<p>Make a copy of this container with no path.</p>"},{"location":"reference.html#odfdo.Container.mimetype","title":"<code>mimetype: str</code>  <code>property</code> <code>writable</code>","text":"<p>Return str value of mimetype of the document.</p>"},{"location":"reference.html#odfdo.Container.parts","title":"<code>parts: list[str]</code>  <code>property</code>","text":"<p>Get the list of members.</p>"},{"location":"reference.html#odfdo.Container.del_part","title":"<code>del_part(path)</code>","text":"<p>Mark a part for deletion.</p> Source code in <code>odfdo/container.py</code> <pre><code>def del_part(self, path: str) -&gt; None:\n    \"\"\"Mark a part for deletion.\"\"\"\n    self.__parts[path] = None\n</code></pre>"},{"location":"reference.html#odfdo.Container.get_part","title":"<code>get_part(path)</code>","text":"<p>Get the bytes of a part of the ODF.</p> Source code in <code>odfdo/container.py</code> <pre><code>def get_part(self, path: str) -&gt; str | bytes | None:\n    \"\"\"Get the bytes of a part of the ODF.\"\"\"\n    path = str(path)\n    if path in self.__parts:\n        part = self.__parts[path]\n        if part is None:\n            raise ValueError(f'Part \"{path}\" is deleted')\n        if self.__packaging == FOLDER:\n            cache_ts = self.__parts_ts.get(path, -1)\n            current_ts = self._get_folder_part_timestamp(path)\n            if current_ts != cache_ts:\n                part, timestamp = self._get_folder_part(path)\n                self.__parts[path] = part\n                self.__parts_ts[path] = timestamp\n        return part\n    if self.__packaging == ZIP:\n        return self._get_zip_part(path)\n    if self.__packaging == FOLDER:\n        part, timestamp = self._get_folder_part(path)\n        self.__parts[path] = part\n        self.__parts_ts[path] = timestamp\n        return part\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Container.get_parts","title":"<code>get_parts()</code>","text":"<p>Get the list of members.</p> Source code in <code>odfdo/container.py</code> <pre><code>def get_parts(self) -&gt; list[str]:\n    \"\"\"Get the list of members.\"\"\"\n    if not self.path:\n        # maybe a file like zip archive\n        return list(self.__parts.keys())\n    if self.__packaging == ZIP:\n        parts = []\n        with ZipFile(self.path) as zf:\n            for name in zf.namelist():\n                upath = normalize_path(name)\n                parts.append(upath)\n        return parts\n    elif self.__packaging == FOLDER:\n        return self._get_folder_parts()\n    else:\n        raise ValueError(\"Unable to provide parts of the document\")\n</code></pre>"},{"location":"reference.html#odfdo.Container.open","title":"<code>open(path_or_file)</code>","text":"<p>Load the content of an ODF file.</p> Source code in <code>odfdo/container.py</code> <pre><code>def open(self, path_or_file: Path | str | io.BytesIO) -&gt; None:\n    \"\"\"Load the content of an ODF file.\"\"\"\n    self.__path_like = path_or_file\n    if isinstance(path_or_file, (str, Path)):\n        self.path = Path(path_or_file).expanduser()\n        if not self.path.exists():\n            raise FileNotFoundError(str(self.path))\n        self.__path_like = self.path\n    if (self.path or isinstance(self.__path_like, io.BytesIO)) and is_zipfile(\n        self.__path_like  # type: ignore\n    ):\n        self.__packaging = ZIP\n        return self._read_zip()\n    if self.path:\n        is_folder = False\n        with contextlib.suppress(OSError):\n            is_folder = self.path.is_dir()\n        if is_folder:\n            self.__packaging = FOLDER\n            return self._read_folder()\n    raise TypeError(f\"Document format not managed by odfdo: {type(path_or_file)}.\")\n</code></pre>"},{"location":"reference.html#odfdo.Container.save","title":"<code>save(target, packaging=None, backup=False)</code>","text":"<p>Save the container to the given target, a path or a file-like object.</p> <p>Package the output document in the same format than current document, unless \u201cpackaging\u201d is different.</p> <p>Arguments:</p> <pre><code>target -- str or file-like or Path\n\npackaging -- 'zip', or for debugging purpose 'xml' or 'folder'\n\nbackup -- boolean\n</code></pre> Source code in <code>odfdo/container.py</code> <pre><code>def save(\n    self,\n    target: str | Path | io.BytesIO | None,\n    packaging: str | None = None,\n    backup: bool = False,\n) -&gt; None:\n    \"\"\"Save the container to the given target, a path or a file-like\n    object.\n\n    Package the output document in the same format than current document,\n    unless \"packaging\" is different.\n\n    Arguments:\n\n        target -- str or file-like or Path\n\n        packaging -- 'zip', or for debugging purpose 'xml' or 'folder'\n\n        backup -- boolean\n    \"\"\"\n    parts = self.__parts\n    packaging = self._clean_save_packaging(packaging)\n    # Load parts else they will be considered deleted\n    for path in self.parts:\n        if path not in parts:\n            self.get_part(path)\n    target = self._clean_save_target(target)\n    if packaging == FOLDER:\n        if isinstance(target, io.BytesIO):\n            raise TypeError(\n                \"Impossible to save on io.BytesIO with 'folder' packaging\"\n            )\n        self._save_as_folder(target, backup)\n    elif packaging == XML:\n        self._save_as_xml(target, backup)\n    else:\n        # default:\n        self._save_as_zip(target, backup)\n</code></pre>"},{"location":"reference.html#odfdo.Container.set_part","title":"<code>set_part(path, data)</code>","text":"<p>Replace or add a new part.</p> Source code in <code>odfdo/container.py</code> <pre><code>def set_part(self, path: str, data: bytes) -&gt; None:\n    \"\"\"Replace or add a new part.\"\"\"\n    self.__parts[path] = data\n</code></pre>"},{"location":"reference.html#odfdo.Content","title":"<code>Content</code>","text":"<p>               Bases: <code>XmlPart</code></p> Source code in <code>odfdo/content.py</code> <pre><code>class Content(XmlPart):\n    # The following two seem useless but they match styles API\n\n    def _get_style_contexts(self, family: str | None) -&gt; tuple:\n        if family == \"font-face\":\n            return (self.get_element(\"//office:font-face-decls\"),)\n        return (\n            self.get_element(\"//office:font-face-decls\"),\n            self.get_element(\"//office:automatic-styles\"),\n        )\n\n    def __str__(self) -&gt; str:\n        return str(self.body)\n\n    # Public API\n\n    def get_styles(self, family: str | None = None) -&gt; list[Style]:\n        \"\"\"Return the list of styles in the Content part, optionally limited\n        to the given family.\n\n        Arguments:\n\n            family -- str or None\n\n        Return: list of Style\n        \"\"\"\n        result: list[Style] = []\n        for context in self._get_style_contexts(family):\n            if context is None:\n                continue\n            result.extend(context.get_styles(family=family))\n        return result\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Element | None = None,\n        display_name: str | None = None,\n    ) -&gt; Style | None:\n        \"\"\"Return the style uniquely identified by the name/family pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is None, the default style is fetched.\n\n        If the name is not the internal name but the name you gave in the\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                      'number'\n\n            name_or_element -- str or Style\n\n            display_name -- str\n\n        Return: Style or None if not found\n        \"\"\"\n        for context in self._get_style_contexts(family):\n            if context is None:\n                continue\n            style = context.get_style(\n                family,\n                name_or_element=name_or_element,\n                display_name=display_name,\n            )\n            if style is not None:\n                return style\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Content.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the name/family pair. If the argument is already a style object, it will return it.</p> <p>If the name is None, the default style is fetched.</p> <p>If the name is not the internal name but the name you gave in the desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n          'number'\n\nname_or_element -- str or Style\n\ndisplay_name -- str\n</code></pre> <p>Return: Style or None if not found</p> Source code in <code>odfdo/content.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Element | None = None,\n    display_name: str | None = None,\n) -&gt; Style | None:\n    \"\"\"Return the style uniquely identified by the name/family pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is None, the default style is fetched.\n\n    If the name is not the internal name but the name you gave in the\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                  'number'\n\n        name_or_element -- str or Style\n\n        display_name -- str\n\n    Return: Style or None if not found\n    \"\"\"\n    for context in self._get_style_contexts(family):\n        if context is None:\n            continue\n        style = context.get_style(\n            family,\n            name_or_element=name_or_element,\n            display_name=display_name,\n        )\n        if style is not None:\n            return style\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Content.get_styles","title":"<code>get_styles(family=None)</code>","text":"<p>Return the list of styles in the Content part, optionally limited to the given family.</p> <p>Arguments:</p> <pre><code>family -- str or None\n</code></pre> <p>Return: list of Style</p> Source code in <code>odfdo/content.py</code> <pre><code>def get_styles(self, family: str | None = None) -&gt; list[Style]:\n    \"\"\"Return the list of styles in the Content part, optionally limited\n    to the given family.\n\n    Arguments:\n\n        family -- str or None\n\n    Return: list of Style\n    \"\"\"\n    result: list[Style] = []\n    for context in self._get_style_contexts(family):\n        if context is None:\n            continue\n        result.extend(context.get_styles(family=family))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Database","title":"<code>Database</code>","text":"<p>               Bases: <code>Body</code></p> <p>Database, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Database(Body):\n    \"\"\"Database, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:database\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.Document","title":"<code>Document</code>","text":"<p>Abstraction of the ODF document.</p> <p>To create a new Document, several possibilities:</p> <pre><code>- Document() or Document(\"text\") -&gt; an \"empty\" document of type text\n- Document(\"spreadsheet\") -&gt; an \"empty\" document of type spreadsheet\n- Document(\"presentation\") -&gt; an \"empty\" document of type presentation\n- Document(\"drawing\") -&gt; an \"empty\" document of type drawing\n\nMeaning of \u201cempty\u201d: these documents are copies of the default\ntemplates documents provided with this library, which, as templates,\nare not really empty. It may be useful to clear the newly created\ndocument: document.body.clear(), or adjust meta informations like\ndescription or default language: document.meta.language = 'fr-FR'\n</code></pre> <p>If the argument is not a known template type, or is a Path, Document(file) will load the content of the ODF file.</p> <p>To explicitly create a document from a custom template, use the Document.new(path) method whose argument is the path to the template file.</p> Source code in <code>odfdo/document.py</code> <pre><code>class Document:\n    \"\"\"Abstraction of the ODF document.\n\n    To create a new Document, several possibilities:\n\n        - Document() or Document(\"text\") -&gt; an \"empty\" document of type text\n        - Document(\"spreadsheet\") -&gt; an \"empty\" document of type spreadsheet\n        - Document(\"presentation\") -&gt; an \"empty\" document of type presentation\n        - Document(\"drawing\") -&gt; an \"empty\" document of type drawing\n\n        Meaning of \u201cempty\u201d: these documents are copies of the default\n        templates documents provided with this library, which, as templates,\n        are not really empty. It may be useful to clear the newly created\n        document: document.body.clear(), or adjust meta informations like\n        description or default language: document.meta.language = 'fr-FR'\n\n    If the argument is not a known template type, or is a Path,\n    Document(file) will load the content of the ODF file.\n\n    To explicitly create a document from a custom template, use the\n    Document.new(path) method whose argument is the path to the template file.\n    \"\"\"\n\n    def __init__(\n        self,\n        target: str | bytes | Path | Container | io.BytesIO | None = \"text\",\n    ) -&gt; None:\n        # Cache of XML parts\n        self.__xmlparts: dict[str, XmlPart] = {}\n        # Cache of the body\n        self.__body: Element | None = None\n        self.container: Container | None = None\n        if isinstance(target, bytes):\n            # eager conversion\n            target = bytes_to_str(target)\n        if target is None:\n            # empty document, you probably don't wnat this.\n            self.container = Container()\n            return\n        if isinstance(target, Path):\n            # let's assume we open a container on existing file\n            self.container = Container(target)\n            return\n        if isinstance(target, Container):\n            # special internal case, use an existing container\n            self.container = target\n            return\n        if isinstance(target, str):\n            if target in ODF_TEMPLATES:\n                # assuming a new document from templates\n                self.container = container_from_template(target)\n                return\n            # let's assume we open a container on existing file\n            self.container = Container(target)\n            return\n        if isinstance(target, io.BytesIO):\n            self.container = Container(target)\n            return\n        raise TypeError(f\"Unknown Document source type: '{target!r}'\")\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} type={self.get_type()} path={self.path}&gt;\"\n\n    def __str__(self) -&gt; str:\n        try:\n            return str(self.get_formatted_text())\n        except NotImplementedError:\n            return self.body.text_recursive\n\n    @classmethod\n    def new(cls, template: str | Path | io.BytesIO = \"text\") -&gt; Document:\n        \"\"\"Create a Document from a template.\n\n        The template argument is expected to be the path to a ODF template.\n\n        Arguments:\n\n            template -- str or Path or file-like (io.BytesIO)\n\n        Return : ODF document -- Document\n        \"\"\"\n        container = container_from_template(template)\n        return cls(container)\n\n    # Public API\n\n    @property\n    def path(self) -&gt; Path | None:\n        \"\"\"Shortcut to Document.Container.path.\"\"\"\n        if not self.container:\n            return None\n        return self.container.path\n\n    @path.setter\n    def path(self, path_or_str: str | Path) -&gt; None:\n        \"\"\"Shortcut to Document.Container.path\n\n        Only accepting str or Path.\"\"\"\n        if not self.container:\n            return\n        self.container.path = Path(path_or_str)\n\n    def get_parts(self) -&gt; list[str]:\n        \"\"\"Return available part names with path inside the archive, e.g.\n        ['content.xml', ..., 'Pictures/100000000000032000000258912EB1C3.jpg']\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        return self.container.parts\n\n    @property\n    def parts(self) -&gt; list[str]:\n        \"\"\"Return available part names with path inside the archive, e.g.\n        ['content.xml', ..., 'Pictures/100000000000032000000258912EB1C3.jpg']\n        \"\"\"\n        return self.get_parts()\n\n    def get_part(self, path: str) -&gt; XmlPart | str | bytes | None:\n        \"\"\"Return the bytes of the given part. The path is relative to the\n        archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n        'content', 'meta', 'settings', 'styles' and 'manifest' are shortcuts\n        to the real path, e.g. content.xml, and return a dedicated object with\n        its own API.\n\n        path formated as URI, so always use '/' separator\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        # \"./ObjectReplacements/Object 1\"\n        path = path.lstrip(\"./\")\n        path = _get_part_path(path)\n        cls = _get_part_class(path)\n        # Raw bytes\n        if cls is None:\n            return self.container.get_part(path)\n        # XML part\n        part = self.__xmlparts.get(path)\n        if part is None:\n            self.__xmlparts[path] = part = cls(path, self.container)\n        return part\n\n    def set_part(self, path: str, data: bytes) -&gt; None:\n        \"\"\"Set the bytes of the given part. The path is relative to the\n        archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n        path formated as URI, so always use '/' separator\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        # \"./ObjectReplacements/Object 1\"\n        path = path.lstrip(\"./\")\n        path = _get_part_path(path)\n        cls = _get_part_class(path)\n        # XML part overwritten\n        if cls is not None:\n            with suppress(KeyError):\n                self.__xmlparts[path]\n        self.container.set_part(path, data)\n\n    def del_part(self, path: str) -&gt; None:\n        \"\"\"Mark a part for deletion. The path is relative to the archive,\n        e.g. \"Pictures/1003200258912EB1C3.jpg\"\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        path = _get_part_path(path)\n        cls = _get_part_class(path)\n        if path == ODF_MANIFEST or cls is not None:\n            raise ValueError(f\"part '{path}' is mandatory\")\n        self.container.del_part(path)\n\n    @property\n    def mimetype(self) -&gt; str:\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        return self.container.mimetype\n\n    @mimetype.setter\n    def mimetype(self, mimetype: str) -&gt; None:\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        self.container.mimetype = mimetype\n\n    def get_type(self) -&gt; str:\n        \"\"\"Get the ODF type (also called class) of this document.\n\n        Return: 'chart', 'database', 'formula', 'graphics',\n            'graphics-template', 'image', 'presentation',\n            'presentation-template', 'spreadsheet', 'spreadsheet-template',\n            'text', 'text-master', 'text-template' or 'text-web'\n        \"\"\"\n        # The mimetype must be with the form:\n        # application/vnd.oasis.opendocument.text\n\n        # Isolate and return the last part\n        return self.mimetype.rsplit(\".\", 1)[-1]\n\n    @property\n    def body(self) -&gt; Element:\n        \"\"\"Return the body element of the content part, where actual content\n        is stored.\n        \"\"\"\n        if self.__body is None:\n            self.__body = self.content.body\n        return self.__body\n\n    @property\n    def meta(self) -&gt; Meta:\n        \"\"\"Return the meta part (meta.xml) of the document, where meta data\n        are stored.\"\"\"\n        metadata = self.get_part(ODF_META)\n        if metadata is None or not isinstance(metadata, Meta):\n            raise ValueError(\"Empty Meta\")\n        return metadata\n\n    @property\n    def manifest(self) -&gt; Manifest:\n        \"\"\"Return the manifest part (manifest.xml) of the document.\"\"\"\n        manifest = self.get_part(ODF_MANIFEST)\n        if manifest is None or not isinstance(manifest, Manifest):\n            raise ValueError(\"Empty Manifest\")\n        return manifest\n\n    def _get_formatted_text_footnotes(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Separate text from notes\n        if rst_mode:\n            result.append(\"\\n\")\n        else:\n            result.append(\"----\\n\")\n        for citation, body in context[\"footnotes\"]:\n            if rst_mode:\n                result.append(f\".. [#] {body}\\n\")\n            else:\n                result.append(f\"[{citation}] {body}\\n\")\n        # Append a \\n after the notes\n        result.append(\"\\n\")\n        # Reset for the next paragraph\n        context[\"footnotes\"] = []\n\n    def _get_formatted_text_annotations(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Insert the annotations\n        # With a separation\n        if rst_mode:\n            result.append(\"\\n\")\n        else:\n            result.append(\"----\\n\")\n        for annotation in context[\"annotations\"]:\n            if rst_mode:\n                result.append(f\".. [#] {annotation}\\n\")\n            else:\n                result.append(f\"[*] {annotation}\\n\")\n        context[\"annotations\"] = []\n\n    def _get_formatted_text_images(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Insert the images ref, only in rst mode\n        result.append(\"\\n\")\n        for ref, filename, (width, height) in context[\"images\"]:\n            result.append(f\".. {ref} image:: {filename}\\n\")\n            if width is not None:\n                result.append(f\"   :width: {width}\\n\")\n            if height is not None:\n                result.append(f\"   :height: {height}\\n\")\n        context[\"images\"] = []\n\n    def _get_formatted_text_endnotes(\n        self,\n        result: list[str],\n        context: dict,\n        rst_mode: bool,\n    ) -&gt; None:\n        # Append the end notes\n        if rst_mode:\n            result.append(\"\\n\\n\")\n        else:\n            result.append(\"\\n========\\n\")\n        for citation, body in context[\"endnotes\"]:\n            if rst_mode:\n                result.append(f\".. [*] {body}\\n\")\n            else:\n                result.append(f\"({citation}) {body}\\n\")\n\n    def get_formatted_text(self, rst_mode: bool = False) -&gt; str:\n        \"\"\"Return content as text, with some formatting.\"\"\"\n        # For the moment, only \"type='text'\"\n        doc_type = self.get_type()\n        if doc_type == \"spreadsheet\":\n            return self._tables_csv()\n        if doc_type in {\n            \"text\",\n            \"text-template\",\n            \"presentation\",\n            \"presentation-template\",\n        }:\n            return self._formatted_text(rst_mode)\n        raise NotImplementedError(f\"Type of document '{doc_type}' not supported yet\")\n\n    def _tables_csv(self) -&gt; str:\n        return \"\\n\\n\".join(str(table) for table in self.body.tables)\n\n    def _formatted_text(self, rst_mode: bool) -&gt; str:\n        # Initialize an empty context\n        context = {\n            \"document\": self,\n            \"footnotes\": [],\n            \"endnotes\": [],\n            \"annotations\": [],\n            \"rst_mode\": rst_mode,\n            \"img_counter\": 0,\n            \"images\": [],\n            \"no_img_level\": 0,\n        }\n        body = self.body\n        # Get the text\n        result = []\n        for child in body.children:\n            # self._get_formatted_text_child(result, element, context, rst_mode)\n            # if child.tag == \"table:table\":\n            #     result.append(child.get_formatted_text(context))\n            #     return\n            result.append(child.get_formatted_text(context))\n            if context[\"footnotes\"]:\n                self._get_formatted_text_footnotes(result, context, rst_mode)\n            if context[\"annotations\"]:\n                self._get_formatted_text_annotations(result, context, rst_mode)\n            # Insert the images ref, only in rst mode\n            if context[\"images\"]:\n                self._get_formatted_text_images(result, context, rst_mode)\n        if context[\"endnotes\"]:\n            self._get_formatted_text_endnotes(result, context, rst_mode)\n        return \"\".join(result)\n\n    def get_formated_meta(self) -&gt; str:\n        \"\"\"Return meta informations as text, with some formatting.\"\"\"\n        result: list[str] = []\n\n        # Simple values\n        def print_info(name: str, value: Any) -&gt; None:\n            if value:\n                result.append(f\"{name}: {value}\")\n\n        meta = self.meta\n        print_info(\"Title\", meta.title)\n        print_info(\"Subject\", meta.subject)\n        print_info(\"Description\", meta.description)\n        print_info(\"Language\", meta.language)\n        print_info(\"Modification date\", meta.date)\n        print_info(\"Creation date\", meta.creation_date)\n        print_info(\"Initial creator\", meta.initial_creator)\n        print_info(\"Keyword\", meta.keyword)\n        print_info(\"Editing duration\", meta.editing_duration)\n        print_info(\"Editing cycles\", meta.editing_cycles)\n        print_info(\"Generator\", meta.generator)\n\n        # Statistic\n        result.append(\"Statistic:\")\n        statistic = meta.statistic\n        if statistic:\n            for name, data in statistic.items():\n                result.append(f\"  - {name[5:].replace('-', ' ').capitalize()}: {data}\")\n\n        # User defined metadata\n        result.append(\"User defined metadata:\")\n        user_metadata = meta.user_defined_metadata\n        for name, data2 in user_metadata.items():\n            result.append(f\"  - {name}: {data2}\")\n\n        # And the description\n        print_info(\"Description\", meta.get_description())\n\n        return \"\\n\".join(result) + \"\\n\"\n\n    def add_file(self, path_or_file: str | Path) -&gt; str:\n        \"\"\"Insert a file from a path or a file-like object in the container.\n\n        Return the full path to reference in the content.\n\n        Arguments:\n\n            path_or_file -- str or Path or file-like\n\n        Return: str (URI)\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        name = \"\"\n        # Folder for added files (FIXME hard-coded and copied)\n        manifest = self.manifest\n        medias = manifest.get_paths()\n        # uuid = str(uuid4())\n\n        if isinstance(path_or_file, (str, Path)):\n            path = Path(path_or_file)\n            extension = path.suffix.lower()\n            name = f\"{path.stem}{extension}\"\n            if posixpath.join(\"Pictures\", name) in medias:\n                name = f\"{path.stem}_{uuid4()}{extension}\"\n        else:\n            path = None\n            name = getattr(path_or_file, \"name\", None)\n            if not name:\n                name = str(uuid4())\n        media_type, _encoding = guess_type(name)\n        if not media_type:\n            media_type = \"application/octet-stream\"\n        if manifest.get_media_type(\"Pictures/\") is None:\n            manifest.add_full_path(\"Pictures/\")\n        full_path = posixpath.join(\"Pictures\", name)\n        if path is None:\n            self.container.set_part(full_path, path_or_file.read())  # type:ignore\n        else:\n            self.container.set_part(full_path, path.read_bytes())\n        manifest.add_full_path(full_path, media_type)\n        return full_path\n\n    @property\n    def clone(self) -&gt; Document:\n        \"\"\"Return an exact copy of the document.\n\n        Return: Document\n        \"\"\"\n        clone = object.__new__(self.__class__)\n        for name in self.__dict__:\n            if name == \"_Document__body\":\n                setattr(clone, name, None)\n            elif name == \"_Document__xmlparts\":\n                setattr(clone, name, {})\n            elif name == \"container\":\n                if not self.container:\n                    raise ValueError(\"Empty Container\")\n                setattr(clone, name, self.container.clone)\n            else:\n                value = deepcopy(getattr(self, name))\n                setattr(clone, name, value)\n        return clone\n\n    def save(\n        self,\n        target: str | Path | io.BytesIO | None = None,\n        packaging: str = ZIP,\n        pretty: bool = False,\n        backup: bool = False,\n    ) -&gt; None:\n        \"\"\"Save the document, at the same place it was opened or at the given\n        target path. Target can also be a file-like object. It can be saved\n        as a Zip file (default), flat XML format or as files in a folder\n        (for debugging purpose). XML parts can be pretty printed.\n\n        Arguments:\n\n            target -- str or file-like object\n\n            packaging -- 'zip', 'folder', 'xml'\n\n            pretty -- bool\n\n            backup -- bool\n        \"\"\"\n        if not self.container:\n            raise ValueError(\"Empty Container\")\n        # Some advertising\n        self.meta.set_generator_default()\n        # Synchronize data with container\n        container = self.container\n        for path, part in self.__xmlparts.items():\n            if part is not None:\n                container.set_part(path, part.serialize(pretty))\n        # Save the container\n        container.save(target, packaging=packaging, backup=backup)\n\n    @property\n    def content(self) -&gt; Content:\n        content: Content | None = self.get_part(ODF_CONTENT)  # type:ignore\n        if content is None:\n            raise ValueError(\"Empty Content\")\n        return content\n\n    @property\n    def styles(self) -&gt; Styles:\n        styles: Styles | None = self.get_part(ODF_STYLES)  # type:ignore\n        if styles is None:\n            raise ValueError(\"Empty Styles\")\n        return styles\n\n    # Styles over several parts\n\n    def get_styles(\n        self,\n        family: str | bytes = \"\",\n        automatic: bool = False,\n    ) -&gt; list[Style | Element]:\n        # compatibility with old versions:\n\n        if isinstance(family, bytes):\n            family = bytes_to_str(family)\n        return self.content.get_styles(family=family) + self.styles.get_styles(\n            family=family, automatic=automatic\n        )\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Style | None = None,\n        display_name: str | None = None,\n    ) -&gt; Style | None:\n        \"\"\"Return the style uniquely identified by the name/family pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is None, the default style is fetched.\n\n        If the name is not the internal name but the name you gave in a\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                      'number', 'page-layout', 'master-page'\n\n            name -- str or Element or None\n\n            display_name -- str\n\n        Return: Style or None if not found.\n        \"\"\"\n        # 1. content.xml\n        element = self.content.get_style(\n            family, name_or_element=name_or_element, display_name=display_name\n        )\n        if element is not None:\n            return element\n        # 2. styles.xml\n        return self.styles.get_style(\n            family,\n            name_or_element=name_or_element,\n            display_name=display_name,\n        )\n\n    @staticmethod\n    def _pseudo_style_attribute(style_element: Style | Element, attribute: str) -&gt; Any:\n        if hasattr(style_element, attribute):\n            return getattr(style_element, attribute)\n        return \"\"\n\n    def _set_automatic_name(self, style: Style, family: str) -&gt; None:\n        \"\"\"Generate a name for the new automatic style.\"\"\"\n        if not hasattr(style, \"name\"):\n            # do nothing\n            return\n        styles = self.get_styles(family=family, automatic=True)\n        max_index = 0\n        for existing_style in styles:\n            if not hasattr(existing_style, \"name\"):\n                continue\n            if not existing_style.name.startswith(AUTOMATIC_PREFIX):\n                continue\n            try:\n                index = int(existing_style.name[len(AUTOMATIC_PREFIX) :])  # type: ignore\n            except ValueError:\n                continue\n            max_index = max(max_index, index)\n\n        style.name = f\"{AUTOMATIC_PREFIX}{max_index+1}\"\n\n    def _insert_style_get_common_styles(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:styles\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_automatic_styles(\n        self,\n        style: Style,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.content.get_element(\"office:automatic-styles\")\n        # A name ?\n        if name:\n            if hasattr(style, \"name\"):\n                style.name = name\n            existing = self.content.get_style(family, name)\n        else:\n            self._set_automatic_name(style, family)\n            existing = None\n        return existing, style_container\n\n    def _insert_style_get_default_styles(\n        self,\n        style: Style,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:styles\")\n        style.tag = \"style:default-style\"\n        if name:\n            style.del_attribute(\"style:name\")\n        existing = self.styles.get_style(family)\n        return existing, style_container\n\n    def _insert_style_get_master_page(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:master-styles\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_font_face_default(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.styles.get_element(\"office:font-face-decls\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_font_face(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        style_container = self.content.get_element(\"office:font-face-decls\")\n        existing = self.content.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_page_layout(\n        self,\n        family: str,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        # force to automatic\n        style_container = self.styles.get_element(\"office:automatic-styles\")\n        existing = self.styles.get_style(family, name)\n        return existing, style_container\n\n    def _insert_style_get_draw_fill_image(\n        self,\n        name: str,\n    ) -&gt; tuple[Any, Any]:\n        # special case for 'draw:fill-image' pseudo style\n        # not family and style_element.__class__.__name__ == \"DrawFillImage\"\n        style_container = self.styles.get_element(\"office:styles\")\n        existing = self.styles.get_style(\"\", name)\n        return existing, style_container\n\n    def _insert_style_standard(\n        self,\n        style: Style,\n        name: str,\n        family: str,\n        automatic: bool,\n        default: bool,\n    ) -&gt; tuple[Any, Any]:\n        # Common style\n        if name and automatic is False and default is False:\n            return self._insert_style_get_common_styles(family, name)\n        # Automatic style\n        elif automatic is True and default is False:\n            return self._insert_style_get_automatic_styles(style, family, name)\n        # Default style\n        elif automatic is False and default is True:\n            return self._insert_style_get_default_styles(style, family, name)\n        else:\n            raise AttributeError(\"Invalid combination of arguments\")\n\n    def insert_style(  # noqa: C901\n        self,\n        style: Style | str,\n        name: str = \"\",\n        automatic: bool = False,\n        default: bool = False,\n    ) -&gt; Any:\n        \"\"\"Insert the given style object in the document, as required by the\n        style family and type.\n\n        The style is expected to be a common style with a name. In case it\n        was created with no name, the given can be set on the fly.\n\n        If automatic is True, the style will be inserted as an automatic\n        style.\n\n        If default is True, the style will be inserted as a default style and\n        would replace any existing default style of the same family. Any name\n        or display name would be ignored.\n\n        Automatic and default arguments are mutually exclusive.\n\n        All styles can't be used as default styles. Default styles are\n        allowed for the following families: paragraph, text, section, table,\n        table-column, table-row, table-cell, table-page, chart, drawing-page,\n        graphic, presentation, control and ruby.\n\n        Arguments:\n\n            style -- Style or str\n\n            name -- str\n\n            automatic -- bool\n\n            default -- bool\n\n        Return : style name -- str\n        \"\"\"\n\n        # if style is a str, assume it is the Style definition\n        if isinstance(style, str):\n            style_element: Style = Element.from_tag(style)  # type: ignore\n        else:\n            style_element = style\n        if not isinstance(style_element, Element):\n            raise TypeError(f\"Unknown Style type: '{style!r}'\")\n\n        # Get family and name\n        family = self._pseudo_style_attribute(style_element, \"family\")\n        if not name:\n            name = self._pseudo_style_attribute(style_element, \"name\")\n\n        # Master page style\n        if family == \"master-page\":\n            existing, style_container = self._insert_style_get_master_page(family, name)\n        # Font face declarations\n        elif family == \"font-face\":\n            if default:\n                existing, style_container = self._insert_style_get_font_face_default(\n                    family, name\n                )\n            else:\n                existing, style_container = self._insert_style_get_font_face(\n                    family, name\n                )\n        # page layout style\n        elif family == \"page-layout\":\n            existing, style_container = self._insert_style_get_page_layout(family, name)\n        # Common style\n        elif family in FAMILY_ODF_STD or family in {\"number\"}:\n            existing, style_container = self._insert_style_standard(\n                style_element, name, family, automatic, default\n            )\n        elif not family and style_element.__class__.__name__ == \"DrawFillImage\":\n            # special case for 'draw:fill-image' pseudo style\n            existing, style_container = self._insert_style_get_draw_fill_image(name)\n        # Invalid style\n        else:\n            raise ValueError(\n                \"Invalid style: \"\n                f\"{style_element}, tag:{style_element.tag}, family:{family}\"\n            )\n\n        # Insert it!\n        if existing is not None:\n            style_container.delete(existing)\n        style_container.append(style_element)\n        return self._pseudo_style_attribute(style_element, \"name\")\n\n    def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n        \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n        name (or all by default).\n\n        Arguments:\n\n            name -- str\n\n        Return: list\n        \"\"\"\n        # Header, footer, etc. have styles too\n        return self.content.root.get_styled_elements(\n            name\n        ) + self.styles.root.get_styled_elements(name)\n\n    def show_styles(\n        self,\n        automatic: bool = True,\n        common: bool = True,\n        properties: bool = False,\n    ) -&gt; str:\n        infos = []\n        for style in self.get_styles():\n            try:\n                name = style.name  # type: ignore\n            except AttributeError:\n                print(\"--------------\")\n                print(style.__class__)\n                print(style.serialize())\n                raise\n            if style.__class__.__name__ == \"DrawFillImage\":\n                family = \"\"\n            else:\n                family = str(style.family)  # type: ignore\n            parent = style.parent\n            is_auto = parent and parent.tag == \"office:automatic-styles\"\n            if is_auto and automatic is False or not is_auto and common is False:\n                continue\n            is_used = bool(self.get_styled_elements(name))\n            infos.append(\n                {\n                    \"type\": \"auto  \" if is_auto else \"common\",\n                    \"used\": \"y\" if is_used else \"n\",\n                    \"family\": family,\n                    \"parent\": self._pseudo_style_attribute(style, \"parent_style\") or \"\",\n                    \"name\": name or \"\",\n                    \"display_name\": self._pseudo_style_attribute(style, \"display_name\")\n                    or \"\",\n                    \"properties\": style.get_properties() if properties else None,  # type: ignore\n                }\n            )\n        if not infos:\n            return \"\"\n        # Sort by family and name\n        infos.sort(key=itemgetter(\"family\", \"name\"))\n        # Show common and used first\n        infos.sort(key=itemgetter(\"type\", \"used\"), reverse=True)\n        max_family = str(max([len(x[\"family\"]) for x in infos]))  # type: ignore\n        max_parent = str(max([len(x[\"parent\"]) for x in infos]))  # type: ignore\n        formater = (\n            \"%(type)s used:%(used)s family:%(family)-0\"\n            + max_family\n            + \"s parent:%(parent)-0\"\n            + max_parent\n            + \"s name:%(name)s\"\n        )\n        output = []\n        for info in infos:\n            line = formater % info\n            if info[\"display_name\"]:\n                line += \" display_name:\" + info[\"display_name\"]  # type: ignore\n            output.append(line)\n            if info[\"properties\"]:\n                for name, value in info[\"properties\"].items():  # type: ignore\n                    output.append(f\"   - {name}: {value}\")\n        output.append(\"\")\n        return \"\\n\".join(output)\n\n    def delete_styles(self) -&gt; int:\n        \"\"\"Remove all style information from content and all styles.\n\n        Return: number of deleted styles\n        \"\"\"\n        # First remove references to styles\n        for element in self.get_styled_elements():\n            for attribute in (\n                \"text:style-name\",\n                \"draw:style-name\",\n                \"draw:text-style-name\",\n                \"table:style-name\",\n                \"style:page-layout-name\",\n            ):\n                try:\n                    element.del_attribute(attribute)\n                except KeyError:\n                    continue\n        # Then remove supposedly orphaned styles\n        deleted = 0\n        for style in self.get_styles():\n            if style.name is None:  # type: ignore\n                # Don't delete default styles\n                continue\n            # elif type(style) is odf_master_page:\n            #    # Don't suppress header and footer, just styling was removed\n            #    continue\n            style.delete()\n            deleted += 1\n        return deleted\n\n    def merge_styles_from(self, document: Document) -&gt; None:\n        \"\"\"Copy all the styles of a document into ourself.\n\n        Styles with the same type and name will be replaced, so only unique\n        styles will be preserved.\n        \"\"\"\n        manifest = self.manifest\n        document_manifest = document.manifest\n        for style in document.get_styles():\n            tagname = style.tag\n            family = self._pseudo_style_attribute(style, \"family\")\n            stylename = style.name  # type: ignore\n            container = style.parent\n            container_name = container.tag  # type: ignore\n            partname = container.parent.tag  # type: ignore\n            # The destination part\n            if partname == \"office:document-styles\":\n                part: Content | Styles = self.styles\n            elif partname == \"office:document-content\":\n                part = self.content\n            else:\n                raise NotImplementedError(partname)\n            # Implemented containers\n            if container_name not in {\n                \"office:styles\",\n                \"office:automatic-styles\",\n                \"office:master-styles\",\n                \"office:font-face-decls\",\n            }:\n                raise NotImplementedError(container_name)\n            dest = part.get_element(f\"//{container_name}\")\n            # Implemented style types\n            # if tagname not in registered_styles:\n            #    raise NotImplementedError(tagname)\n            duplicate = part.get_style(family, stylename)\n            if duplicate is not None:\n                duplicate.delete()\n            dest.append(style)\n            # Copy images from the header/footer\n            if tagname == \"style:master-page\":\n                query = \"descendant::draw:image\"\n                for image in style.get_elements(query):\n                    url = image.url  # type: ignore\n                    part_url = document.get_part(url)\n                    # Manually add the part to keep the name\n                    self.set_part(url, part_url)  # type: ignore\n                    media_type = document_manifest.get_media_type(url)\n                    manifest.add_full_path(url, media_type)  # type: ignore\n            # Copy images from the fill-image\n            elif tagname == \"draw:fill-image\":\n                url = style.url  # type: ignore\n                part_url = document.get_part(url)\n                self.set_part(url, part_url)  # type: ignore\n                media_type = document_manifest.get_media_type(url)\n                manifest.add_full_path(url, media_type)  # type: ignore\n\n    def add_page_break_style(self) -&gt; None:\n        \"\"\"Ensure that the document contains the style required for a manual page break.\n\n        Then a manual page break can be added to the document with:\n            from paragraph import PageBreak\n            ...\n            document.body.append(PageBreak())\n\n        Note: this style uses the property 'fo:break-after', another\n        possibility could be the property 'fo:break-before'\n        \"\"\"\n        if existing := self.get_style(  # noqa: SIM102\n            family=\"paragraph\",\n            name_or_element=\"odfdopagebreak\",\n        ):\n            if properties := existing.get_properties():  # noqa: SIM102\n                if properties[\"fo:break-after\"] == \"page\":\n                    return\n        style = (\n            '&lt;style:style style:family=\"paragraph\" style:parent-style-name=\"Standard\" '\n            'style:name=\"odfdopagebreak\"&gt;'\n            '&lt;style:paragraph-properties fo:break-after=\"page\"/&gt;&lt;/style:style&gt;'\n        )\n        self.insert_style(style, automatic=False)\n\n    def get_style_properties(\n        self, family: str, name: str, area: str | None = None\n    ) -&gt; dict[str, str] | None:\n        \"\"\"Return the properties of the required style as a dict.\"\"\"\n        style = self.get_style(family, name)\n        if style is None:\n            return None\n        return style.get_properties(area=area)  # type: ignore\n\n    def get_cell_style_properties(  # noqa: C901\n        self, table: str | int, coord: tuple | list | str\n    ) -&gt; dict[str, str]:  # type: ignore\n        \"\"\"Return the style properties of a table cell of a .ods document,\n        from the cell style or from the row style.\"\"\"\n\n        def _get_table(table: int | str) -&gt; Table | None:\n            table_pos = 0\n            table_name = None\n            if isinstance(table, int):\n                table_pos = table\n            elif isinstance(table, str):\n                table_name = table_name\n            else:\n                raise TypeError(f\"Table parameter must be int or str: {table!r}\")\n            return self.body.get_table(\n                position=table_pos, name=table_name  # type: ignore\n            )\n\n        if not (sheet := _get_table(table)):\n            return {}\n        cell = sheet.get_cell(coord, clone=False)\n        if cell.style:\n            return (\n                self.get_style_properties(\"table-cell\", cell.style, \"table-cell\") or {}\n            )\n        try:\n            row = sheet.get_row(cell.y, clone=False, create=False)  # type: ignore\n            if row.style:  # noqa: SIM102\n                if props := self.get_style_properties(\n                    \"table-row\", row.style, \"table-cell\"\n                ):\n                    return props\n            column = sheet.get_column(cell.x)  # type: ignore\n            style = column.default_cell_style\n            if style:  # noqa: SIM102\n                if props := self.get_style_properties(\n                    \"table-cell\", style, \"table-cell\"\n                ):\n                    return props\n        except ValueError:\n            pass\n        return {}\n\n    def get_cell_background_color(\n        self,\n        table: str | int,\n        coord: tuple | list | str,\n        default: str = \"#ffffff\",\n    ) -&gt; str:\n        \"\"\"Return the background color of a table cell of a .ods document,\n        from the cell style, or from the row or column.\n\n        If color is not defined, return default value..\"\"\"\n        found = self.get_cell_style_properties(table, coord).get(\"fo:background-color\")\n        return found or default\n</code></pre>"},{"location":"reference.html#odfdo.Document.body","title":"<code>body: Element</code>  <code>property</code>","text":"<p>Return the body element of the content part, where actual content is stored.</p>"},{"location":"reference.html#odfdo.Document.clone","title":"<code>clone: Document</code>  <code>property</code>","text":"<p>Return an exact copy of the document.</p> <p>Return: Document</p>"},{"location":"reference.html#odfdo.Document.manifest","title":"<code>manifest: Manifest</code>  <code>property</code>","text":"<p>Return the manifest part (manifest.xml) of the document.</p>"},{"location":"reference.html#odfdo.Document.meta","title":"<code>meta: Meta</code>  <code>property</code>","text":"<p>Return the meta part (meta.xml) of the document, where meta data are stored.</p>"},{"location":"reference.html#odfdo.Document.parts","title":"<code>parts: list[str]</code>  <code>property</code>","text":"<p>Return available part names with path inside the archive, e.g. [\u2018content.xml\u2019, \u2026, \u2018Pictures/100000000000032000000258912EB1C3.jpg\u2019]</p>"},{"location":"reference.html#odfdo.Document.path","title":"<code>path: Path | None</code>  <code>property</code> <code>writable</code>","text":"<p>Shortcut to Document.Container.path.</p>"},{"location":"reference.html#odfdo.Document.add_file","title":"<code>add_file(path_or_file)</code>","text":"<p>Insert a file from a path or a file-like object in the container.</p> <p>Return the full path to reference in the content.</p> <p>Arguments:</p> <pre><code>path_or_file -- str or Path or file-like\n</code></pre> <p>Return: str (URI)</p> Source code in <code>odfdo/document.py</code> <pre><code>def add_file(self, path_or_file: str | Path) -&gt; str:\n    \"\"\"Insert a file from a path or a file-like object in the container.\n\n    Return the full path to reference in the content.\n\n    Arguments:\n\n        path_or_file -- str or Path or file-like\n\n    Return: str (URI)\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    name = \"\"\n    # Folder for added files (FIXME hard-coded and copied)\n    manifest = self.manifest\n    medias = manifest.get_paths()\n    # uuid = str(uuid4())\n\n    if isinstance(path_or_file, (str, Path)):\n        path = Path(path_or_file)\n        extension = path.suffix.lower()\n        name = f\"{path.stem}{extension}\"\n        if posixpath.join(\"Pictures\", name) in medias:\n            name = f\"{path.stem}_{uuid4()}{extension}\"\n    else:\n        path = None\n        name = getattr(path_or_file, \"name\", None)\n        if not name:\n            name = str(uuid4())\n    media_type, _encoding = guess_type(name)\n    if not media_type:\n        media_type = \"application/octet-stream\"\n    if manifest.get_media_type(\"Pictures/\") is None:\n        manifest.add_full_path(\"Pictures/\")\n    full_path = posixpath.join(\"Pictures\", name)\n    if path is None:\n        self.container.set_part(full_path, path_or_file.read())  # type:ignore\n    else:\n        self.container.set_part(full_path, path.read_bytes())\n    manifest.add_full_path(full_path, media_type)\n    return full_path\n</code></pre>"},{"location":"reference.html#odfdo.Document.add_page_break_style","title":"<code>add_page_break_style()</code>","text":"<p>Ensure that the document contains the style required for a manual page break.</p> Then a manual page break can be added to the document with <p>from paragraph import PageBreak \u2026 document.body.append(PageBreak())</p> <p>Note: this style uses the property \u2018fo:break-after\u2019, another possibility could be the property \u2018fo:break-before\u2019</p> Source code in <code>odfdo/document.py</code> <pre><code>def add_page_break_style(self) -&gt; None:\n    \"\"\"Ensure that the document contains the style required for a manual page break.\n\n    Then a manual page break can be added to the document with:\n        from paragraph import PageBreak\n        ...\n        document.body.append(PageBreak())\n\n    Note: this style uses the property 'fo:break-after', another\n    possibility could be the property 'fo:break-before'\n    \"\"\"\n    if existing := self.get_style(  # noqa: SIM102\n        family=\"paragraph\",\n        name_or_element=\"odfdopagebreak\",\n    ):\n        if properties := existing.get_properties():  # noqa: SIM102\n            if properties[\"fo:break-after\"] == \"page\":\n                return\n    style = (\n        '&lt;style:style style:family=\"paragraph\" style:parent-style-name=\"Standard\" '\n        'style:name=\"odfdopagebreak\"&gt;'\n        '&lt;style:paragraph-properties fo:break-after=\"page\"/&gt;&lt;/style:style&gt;'\n    )\n    self.insert_style(style, automatic=False)\n</code></pre>"},{"location":"reference.html#odfdo.Document.del_part","title":"<code>del_part(path)</code>","text":"<p>Mark a part for deletion. The path is relative to the archive, e.g. \u201cPictures/1003200258912EB1C3.jpg\u201d</p> Source code in <code>odfdo/document.py</code> <pre><code>def del_part(self, path: str) -&gt; None:\n    \"\"\"Mark a part for deletion. The path is relative to the archive,\n    e.g. \"Pictures/1003200258912EB1C3.jpg\"\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    path = _get_part_path(path)\n    cls = _get_part_class(path)\n    if path == ODF_MANIFEST or cls is not None:\n        raise ValueError(f\"part '{path}' is mandatory\")\n    self.container.del_part(path)\n</code></pre>"},{"location":"reference.html#odfdo.Document.delete_styles","title":"<code>delete_styles()</code>","text":"<p>Remove all style information from content and all styles.</p> <p>Return: number of deleted styles</p> Source code in <code>odfdo/document.py</code> <pre><code>def delete_styles(self) -&gt; int:\n    \"\"\"Remove all style information from content and all styles.\n\n    Return: number of deleted styles\n    \"\"\"\n    # First remove references to styles\n    for element in self.get_styled_elements():\n        for attribute in (\n            \"text:style-name\",\n            \"draw:style-name\",\n            \"draw:text-style-name\",\n            \"table:style-name\",\n            \"style:page-layout-name\",\n        ):\n            try:\n                element.del_attribute(attribute)\n            except KeyError:\n                continue\n    # Then remove supposedly orphaned styles\n    deleted = 0\n    for style in self.get_styles():\n        if style.name is None:  # type: ignore\n            # Don't delete default styles\n            continue\n        # elif type(style) is odf_master_page:\n        #    # Don't suppress header and footer, just styling was removed\n        #    continue\n        style.delete()\n        deleted += 1\n    return deleted\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_cell_background_color","title":"<code>get_cell_background_color(table, coord, default='#ffffff')</code>","text":"<p>Return the background color of a table cell of a .ods document, from the cell style, or from the row or column.</p> <p>If color is not defined, return default value..</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_cell_background_color(\n    self,\n    table: str | int,\n    coord: tuple | list | str,\n    default: str = \"#ffffff\",\n) -&gt; str:\n    \"\"\"Return the background color of a table cell of a .ods document,\n    from the cell style, or from the row or column.\n\n    If color is not defined, return default value..\"\"\"\n    found = self.get_cell_style_properties(table, coord).get(\"fo:background-color\")\n    return found or default\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_cell_style_properties","title":"<code>get_cell_style_properties(table, coord)</code>","text":"<p>Return the style properties of a table cell of a .ods document, from the cell style or from the row style.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_cell_style_properties(  # noqa: C901\n    self, table: str | int, coord: tuple | list | str\n) -&gt; dict[str, str]:  # type: ignore\n    \"\"\"Return the style properties of a table cell of a .ods document,\n    from the cell style or from the row style.\"\"\"\n\n    def _get_table(table: int | str) -&gt; Table | None:\n        table_pos = 0\n        table_name = None\n        if isinstance(table, int):\n            table_pos = table\n        elif isinstance(table, str):\n            table_name = table_name\n        else:\n            raise TypeError(f\"Table parameter must be int or str: {table!r}\")\n        return self.body.get_table(\n            position=table_pos, name=table_name  # type: ignore\n        )\n\n    if not (sheet := _get_table(table)):\n        return {}\n    cell = sheet.get_cell(coord, clone=False)\n    if cell.style:\n        return (\n            self.get_style_properties(\"table-cell\", cell.style, \"table-cell\") or {}\n        )\n    try:\n        row = sheet.get_row(cell.y, clone=False, create=False)  # type: ignore\n        if row.style:  # noqa: SIM102\n            if props := self.get_style_properties(\n                \"table-row\", row.style, \"table-cell\"\n            ):\n                return props\n        column = sheet.get_column(cell.x)  # type: ignore\n        style = column.default_cell_style\n        if style:  # noqa: SIM102\n            if props := self.get_style_properties(\n                \"table-cell\", style, \"table-cell\"\n            ):\n                return props\n    except ValueError:\n        pass\n    return {}\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_formated_meta","title":"<code>get_formated_meta()</code>","text":"<p>Return meta informations as text, with some formatting.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_formated_meta(self) -&gt; str:\n    \"\"\"Return meta informations as text, with some formatting.\"\"\"\n    result: list[str] = []\n\n    # Simple values\n    def print_info(name: str, value: Any) -&gt; None:\n        if value:\n            result.append(f\"{name}: {value}\")\n\n    meta = self.meta\n    print_info(\"Title\", meta.title)\n    print_info(\"Subject\", meta.subject)\n    print_info(\"Description\", meta.description)\n    print_info(\"Language\", meta.language)\n    print_info(\"Modification date\", meta.date)\n    print_info(\"Creation date\", meta.creation_date)\n    print_info(\"Initial creator\", meta.initial_creator)\n    print_info(\"Keyword\", meta.keyword)\n    print_info(\"Editing duration\", meta.editing_duration)\n    print_info(\"Editing cycles\", meta.editing_cycles)\n    print_info(\"Generator\", meta.generator)\n\n    # Statistic\n    result.append(\"Statistic:\")\n    statistic = meta.statistic\n    if statistic:\n        for name, data in statistic.items():\n            result.append(f\"  - {name[5:].replace('-', ' ').capitalize()}: {data}\")\n\n    # User defined metadata\n    result.append(\"User defined metadata:\")\n    user_metadata = meta.user_defined_metadata\n    for name, data2 in user_metadata.items():\n        result.append(f\"  - {name}: {data2}\")\n\n    # And the description\n    print_info(\"Description\", meta.get_description())\n\n    return \"\\n\".join(result) + \"\\n\"\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_formatted_text","title":"<code>get_formatted_text(rst_mode=False)</code>","text":"<p>Return content as text, with some formatting.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_formatted_text(self, rst_mode: bool = False) -&gt; str:\n    \"\"\"Return content as text, with some formatting.\"\"\"\n    # For the moment, only \"type='text'\"\n    doc_type = self.get_type()\n    if doc_type == \"spreadsheet\":\n        return self._tables_csv()\n    if doc_type in {\n        \"text\",\n        \"text-template\",\n        \"presentation\",\n        \"presentation-template\",\n    }:\n        return self._formatted_text(rst_mode)\n    raise NotImplementedError(f\"Type of document '{doc_type}' not supported yet\")\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_part","title":"<code>get_part(path)</code>","text":"<p>Return the bytes of the given part. The path is relative to the archive, e.g. \u201cPictures/1003200258912EB1C3.jpg\u201d.</p> <p>\u2018content\u2019, \u2018meta\u2019, \u2018settings\u2019, \u2018styles\u2019 and \u2018manifest\u2019 are shortcuts to the real path, e.g. content.xml, and return a dedicated object with its own API.</p> <p>path formated as URI, so always use \u2018/\u2019 separator</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_part(self, path: str) -&gt; XmlPart | str | bytes | None:\n    \"\"\"Return the bytes of the given part. The path is relative to the\n    archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n    'content', 'meta', 'settings', 'styles' and 'manifest' are shortcuts\n    to the real path, e.g. content.xml, and return a dedicated object with\n    its own API.\n\n    path formated as URI, so always use '/' separator\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    # \"./ObjectReplacements/Object 1\"\n    path = path.lstrip(\"./\")\n    path = _get_part_path(path)\n    cls = _get_part_class(path)\n    # Raw bytes\n    if cls is None:\n        return self.container.get_part(path)\n    # XML part\n    part = self.__xmlparts.get(path)\n    if part is None:\n        self.__xmlparts[path] = part = cls(path, self.container)\n    return part\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_parts","title":"<code>get_parts()</code>","text":"<p>Return available part names with path inside the archive, e.g. [\u2018content.xml\u2019, \u2026, \u2018Pictures/100000000000032000000258912EB1C3.jpg\u2019]</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_parts(self) -&gt; list[str]:\n    \"\"\"Return available part names with path inside the archive, e.g.\n    ['content.xml', ..., 'Pictures/100000000000032000000258912EB1C3.jpg']\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    return self.container.parts\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the name/family pair. If the argument is already a style object, it will return it.</p> <p>If the name is None, the default style is fetched.</p> <p>If the name is not the internal name but the name you gave in a desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n          'number', 'page-layout', 'master-page'\n\nname -- str or Element or None\n\ndisplay_name -- str\n</code></pre> <p>Return: Style or None if not found.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Style | None = None,\n    display_name: str | None = None,\n) -&gt; Style | None:\n    \"\"\"Return the style uniquely identified by the name/family pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is None, the default style is fetched.\n\n    If the name is not the internal name but the name you gave in a\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                  'number', 'page-layout', 'master-page'\n\n        name -- str or Element or None\n\n        display_name -- str\n\n    Return: Style or None if not found.\n    \"\"\"\n    # 1. content.xml\n    element = self.content.get_style(\n        family, name_or_element=name_or_element, display_name=display_name\n    )\n    if element is not None:\n        return element\n    # 2. styles.xml\n    return self.styles.get_style(\n        family,\n        name_or_element=name_or_element,\n        display_name=display_name,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_style_properties","title":"<code>get_style_properties(family, name, area=None)</code>","text":"<p>Return the properties of the required style as a dict.</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_style_properties(\n    self, family: str, name: str, area: str | None = None\n) -&gt; dict[str, str] | None:\n    \"\"\"Return the properties of the required style as a dict.\"\"\"\n    style = self.get_style(family, name)\n    if style is None:\n        return None\n    return style.get_properties(area=area)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_styled_elements","title":"<code>get_styled_elements(name='')</code>","text":"<p>Brute-force to find paragraphs, tables, etc. using the given style name (or all by default).</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: list</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n    \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n    name (or all by default).\n\n    Arguments:\n\n        name -- str\n\n    Return: list\n    \"\"\"\n    # Header, footer, etc. have styles too\n    return self.content.root.get_styled_elements(\n        name\n    ) + self.styles.root.get_styled_elements(name)\n</code></pre>"},{"location":"reference.html#odfdo.Document.get_type","title":"<code>get_type()</code>","text":"<p>Get the ODF type (also called class) of this document.</p> \u2018chart\u2019, \u2018database\u2019, \u2018formula\u2019, \u2018graphics\u2019, <p>\u2018graphics-template\u2019, \u2018image\u2019, \u2018presentation\u2019, \u2018presentation-template\u2019, \u2018spreadsheet\u2019, \u2018spreadsheet-template\u2019, \u2018text\u2019, \u2018text-master\u2019, \u2018text-template\u2019 or \u2018text-web\u2019</p> Source code in <code>odfdo/document.py</code> <pre><code>def get_type(self) -&gt; str:\n    \"\"\"Get the ODF type (also called class) of this document.\n\n    Return: 'chart', 'database', 'formula', 'graphics',\n        'graphics-template', 'image', 'presentation',\n        'presentation-template', 'spreadsheet', 'spreadsheet-template',\n        'text', 'text-master', 'text-template' or 'text-web'\n    \"\"\"\n    # The mimetype must be with the form:\n    # application/vnd.oasis.opendocument.text\n\n    # Isolate and return the last part\n    return self.mimetype.rsplit(\".\", 1)[-1]\n</code></pre>"},{"location":"reference.html#odfdo.Document.insert_style","title":"<code>insert_style(style, name='', automatic=False, default=False)</code>","text":"<p>Insert the given style object in the document, as required by the style family and type.</p> <p>The style is expected to be a common style with a name. In case it was created with no name, the given can be set on the fly.</p> <p>If automatic is True, the style will be inserted as an automatic style.</p> <p>If default is True, the style will be inserted as a default style and would replace any existing default style of the same family. Any name or display name would be ignored.</p> <p>Automatic and default arguments are mutually exclusive.</p> <p>All styles can\u2019t be used as default styles. Default styles are allowed for the following families: paragraph, text, section, table, table-column, table-row, table-cell, table-page, chart, drawing-page, graphic, presentation, control and ruby.</p> <p>Arguments:</p> <pre><code>style -- Style or str\n\nname -- str\n\nautomatic -- bool\n\ndefault -- bool\n</code></pre> <p>Return : style name \u2013 str</p> Source code in <code>odfdo/document.py</code> <pre><code>def insert_style(  # noqa: C901\n    self,\n    style: Style | str,\n    name: str = \"\",\n    automatic: bool = False,\n    default: bool = False,\n) -&gt; Any:\n    \"\"\"Insert the given style object in the document, as required by the\n    style family and type.\n\n    The style is expected to be a common style with a name. In case it\n    was created with no name, the given can be set on the fly.\n\n    If automatic is True, the style will be inserted as an automatic\n    style.\n\n    If default is True, the style will be inserted as a default style and\n    would replace any existing default style of the same family. Any name\n    or display name would be ignored.\n\n    Automatic and default arguments are mutually exclusive.\n\n    All styles can't be used as default styles. Default styles are\n    allowed for the following families: paragraph, text, section, table,\n    table-column, table-row, table-cell, table-page, chart, drawing-page,\n    graphic, presentation, control and ruby.\n\n    Arguments:\n\n        style -- Style or str\n\n        name -- str\n\n        automatic -- bool\n\n        default -- bool\n\n    Return : style name -- str\n    \"\"\"\n\n    # if style is a str, assume it is the Style definition\n    if isinstance(style, str):\n        style_element: Style = Element.from_tag(style)  # type: ignore\n    else:\n        style_element = style\n    if not isinstance(style_element, Element):\n        raise TypeError(f\"Unknown Style type: '{style!r}'\")\n\n    # Get family and name\n    family = self._pseudo_style_attribute(style_element, \"family\")\n    if not name:\n        name = self._pseudo_style_attribute(style_element, \"name\")\n\n    # Master page style\n    if family == \"master-page\":\n        existing, style_container = self._insert_style_get_master_page(family, name)\n    # Font face declarations\n    elif family == \"font-face\":\n        if default:\n            existing, style_container = self._insert_style_get_font_face_default(\n                family, name\n            )\n        else:\n            existing, style_container = self._insert_style_get_font_face(\n                family, name\n            )\n    # page layout style\n    elif family == \"page-layout\":\n        existing, style_container = self._insert_style_get_page_layout(family, name)\n    # Common style\n    elif family in FAMILY_ODF_STD or family in {\"number\"}:\n        existing, style_container = self._insert_style_standard(\n            style_element, name, family, automatic, default\n        )\n    elif not family and style_element.__class__.__name__ == \"DrawFillImage\":\n        # special case for 'draw:fill-image' pseudo style\n        existing, style_container = self._insert_style_get_draw_fill_image(name)\n    # Invalid style\n    else:\n        raise ValueError(\n            \"Invalid style: \"\n            f\"{style_element}, tag:{style_element.tag}, family:{family}\"\n        )\n\n    # Insert it!\n    if existing is not None:\n        style_container.delete(existing)\n    style_container.append(style_element)\n    return self._pseudo_style_attribute(style_element, \"name\")\n</code></pre>"},{"location":"reference.html#odfdo.Document.merge_styles_from","title":"<code>merge_styles_from(document)</code>","text":"<p>Copy all the styles of a document into ourself.</p> <p>Styles with the same type and name will be replaced, so only unique styles will be preserved.</p> Source code in <code>odfdo/document.py</code> <pre><code>def merge_styles_from(self, document: Document) -&gt; None:\n    \"\"\"Copy all the styles of a document into ourself.\n\n    Styles with the same type and name will be replaced, so only unique\n    styles will be preserved.\n    \"\"\"\n    manifest = self.manifest\n    document_manifest = document.manifest\n    for style in document.get_styles():\n        tagname = style.tag\n        family = self._pseudo_style_attribute(style, \"family\")\n        stylename = style.name  # type: ignore\n        container = style.parent\n        container_name = container.tag  # type: ignore\n        partname = container.parent.tag  # type: ignore\n        # The destination part\n        if partname == \"office:document-styles\":\n            part: Content | Styles = self.styles\n        elif partname == \"office:document-content\":\n            part = self.content\n        else:\n            raise NotImplementedError(partname)\n        # Implemented containers\n        if container_name not in {\n            \"office:styles\",\n            \"office:automatic-styles\",\n            \"office:master-styles\",\n            \"office:font-face-decls\",\n        }:\n            raise NotImplementedError(container_name)\n        dest = part.get_element(f\"//{container_name}\")\n        # Implemented style types\n        # if tagname not in registered_styles:\n        #    raise NotImplementedError(tagname)\n        duplicate = part.get_style(family, stylename)\n        if duplicate is not None:\n            duplicate.delete()\n        dest.append(style)\n        # Copy images from the header/footer\n        if tagname == \"style:master-page\":\n            query = \"descendant::draw:image\"\n            for image in style.get_elements(query):\n                url = image.url  # type: ignore\n                part_url = document.get_part(url)\n                # Manually add the part to keep the name\n                self.set_part(url, part_url)  # type: ignore\n                media_type = document_manifest.get_media_type(url)\n                manifest.add_full_path(url, media_type)  # type: ignore\n        # Copy images from the fill-image\n        elif tagname == \"draw:fill-image\":\n            url = style.url  # type: ignore\n            part_url = document.get_part(url)\n            self.set_part(url, part_url)  # type: ignore\n            media_type = document_manifest.get_media_type(url)\n            manifest.add_full_path(url, media_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Document.new","title":"<code>new(template='text')</code>  <code>classmethod</code>","text":"<p>Create a Document from a template.</p> <p>The template argument is expected to be the path to a ODF template.</p> <p>Arguments:</p> <pre><code>template -- str or Path or file-like (io.BytesIO)\n</code></pre> <p>Return : ODF document \u2013 Document</p> Source code in <code>odfdo/document.py</code> <pre><code>@classmethod\ndef new(cls, template: str | Path | io.BytesIO = \"text\") -&gt; Document:\n    \"\"\"Create a Document from a template.\n\n    The template argument is expected to be the path to a ODF template.\n\n    Arguments:\n\n        template -- str or Path or file-like (io.BytesIO)\n\n    Return : ODF document -- Document\n    \"\"\"\n    container = container_from_template(template)\n    return cls(container)\n</code></pre>"},{"location":"reference.html#odfdo.Document.save","title":"<code>save(target=None, packaging=ZIP, pretty=False, backup=False)</code>","text":"<p>Save the document, at the same place it was opened or at the given target path. Target can also be a file-like object. It can be saved as a Zip file (default), flat XML format or as files in a folder (for debugging purpose). XML parts can be pretty printed.</p> <p>Arguments:</p> <pre><code>target -- str or file-like object\n\npackaging -- 'zip', 'folder', 'xml'\n\npretty -- bool\n\nbackup -- bool\n</code></pre> Source code in <code>odfdo/document.py</code> <pre><code>def save(\n    self,\n    target: str | Path | io.BytesIO | None = None,\n    packaging: str = ZIP,\n    pretty: bool = False,\n    backup: bool = False,\n) -&gt; None:\n    \"\"\"Save the document, at the same place it was opened or at the given\n    target path. Target can also be a file-like object. It can be saved\n    as a Zip file (default), flat XML format or as files in a folder\n    (for debugging purpose). XML parts can be pretty printed.\n\n    Arguments:\n\n        target -- str or file-like object\n\n        packaging -- 'zip', 'folder', 'xml'\n\n        pretty -- bool\n\n        backup -- bool\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    # Some advertising\n    self.meta.set_generator_default()\n    # Synchronize data with container\n    container = self.container\n    for path, part in self.__xmlparts.items():\n        if part is not None:\n            container.set_part(path, part.serialize(pretty))\n    # Save the container\n    container.save(target, packaging=packaging, backup=backup)\n</code></pre>"},{"location":"reference.html#odfdo.Document.set_part","title":"<code>set_part(path, data)</code>","text":"<p>Set the bytes of the given part. The path is relative to the archive, e.g. \u201cPictures/1003200258912EB1C3.jpg\u201d.</p> <p>path formated as URI, so always use \u2018/\u2019 separator</p> Source code in <code>odfdo/document.py</code> <pre><code>def set_part(self, path: str, data: bytes) -&gt; None:\n    \"\"\"Set the bytes of the given part. The path is relative to the\n    archive, e.g. \"Pictures/1003200258912EB1C3.jpg\".\n\n    path formated as URI, so always use '/' separator\n    \"\"\"\n    if not self.container:\n        raise ValueError(\"Empty Container\")\n    # \"./ObjectReplacements/Object 1\"\n    path = path.lstrip(\"./\")\n    path = _get_part_path(path)\n    cls = _get_part_class(path)\n    # XML part overwritten\n    if cls is not None:\n        with suppress(KeyError):\n            self.__xmlparts[path]\n    self.container.set_part(path, data)\n</code></pre>"},{"location":"reference.html#odfdo.DrawFillImage","title":"<code>DrawFillImage</code>","text":"<p>               Bases: <code>DrawImage</code></p> Source code in <code>odfdo/image.py</code> <pre><code>class DrawFillImage(DrawImage):\n    _tag = \"draw:fill-image\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"display_name\", \"draw:display-name\"),\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"height\", \"svg:height\"),\n        PropDef(\"width\", \"svg:width\"),\n    )\n\n    def __init__(\n        self,\n        name: str | None = None,\n        display_name: str | None = None,\n        height: str | None = None,\n        width: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"The \"draw:fill-image\" element specifies a link to a bitmap\n        resource. Fill image are not available as automatic styles.\n        The \"draw:fill-image\" element is usable within the following element:\n        \"office:styles\"\n\n        Arguments:\n\n            name -- str\n\n            display_name -- str\n\n            height -- str\n\n            width -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n            self.display_name = display_name\n            self.height = height\n            self.width = width\n</code></pre>"},{"location":"reference.html#odfdo.DrawFillImage.__init__","title":"<code>__init__(name=None, display_name=None, height=None, width=None, **kwargs)</code>","text":"<p>The \u201cdraw:fill-image\u201d element specifies a link to a bitmap resource. Fill image are not available as automatic styles. The \u201cdraw:fill-image\u201d element is usable within the following element: \u201coffice:styles\u201d</p> <p>Arguments:</p> <pre><code>name -- str\n\ndisplay_name -- str\n\nheight -- str\n\nwidth -- str\n</code></pre> Source code in <code>odfdo/image.py</code> <pre><code>def __init__(\n    self,\n    name: str | None = None,\n    display_name: str | None = None,\n    height: str | None = None,\n    width: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"The \"draw:fill-image\" element specifies a link to a bitmap\n    resource. Fill image are not available as automatic styles.\n    The \"draw:fill-image\" element is usable within the following element:\n    \"office:styles\"\n\n    Arguments:\n\n        name -- str\n\n        display_name -- str\n\n        height -- str\n\n        width -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n        self.display_name = display_name\n        self.height = height\n        self.width = width\n</code></pre>"},{"location":"reference.html#odfdo.DrawGroup","title":"<code>DrawGroup</code>","text":"<p>               Bases: <code>Element</code>, <code>AnchorMix</code>, <code>ZMix</code>, <code>PosMix</code></p> <p>The DrawGroup \u201cdraw:g\u201d element represents a group of drawing shapes.</p> <p>Warning: implementation is currently minimal.</p> <p>Drawing shapes contained by a \u201cdraw:g\u201d element that is itself contained by a \u201cdraw:a\u201d element, act as hyperlinks using the xlink:href attribute of the containing \u201cdraw:a\u201d element. If the included drawing shapes are themselves contained within \u201cdraw:a\u201d elements, then the xlink:href attributes of those \u201cdraw:a\u201d elements act as the hyperlink information for the shapes they contain.</p> <p>The \u201cdraw:g\u201d element has the following attributes: draw:caption-id, draw:class-names, draw:id, draw:name, draw:style-name, draw:z-index, presentation:class-names, presentation:style-name, svg:y, table:end-cell-address, table:end-x, table:end-y, table:table-background, text:anchor-page-number, text:anchor-type, and xml:id.</p> <p>The \u201cdraw:g\u201d element has the following child elements: \u201cdr3d:scene\u201d, \u201cdraw:a\u201d, \u201cdraw:caption\u201d, \u201cdraw:circle\u201d, \u201cdraw:connector\u201d, \u201cdraw:control\u201d, \u201cdraw:custom-shape\u201d, \u201cdraw:ellipse\u201d, \u201cdraw:frame\u201d, \u201cdraw:g\u201d, \u201cdraw:glue-point\u201d, \u201cdraw:line\u201d, \u201cdraw:measure\u201d, \u201cdraw:page-thumbnail\u201d, \u201cdraw:path\u201d, \u201cdraw:polygon\u201d, \u201cdraw:polyline\u201d, \u201cdraw:rect\u201d, \u201cdraw:regular-polygon\u201d, \u201coffice:event-listeners\u201d, \u201csvg:desc\u201d and \u201csvg:title\u201d.</p> Source code in <code>odfdo/shapes.py</code> <pre><code>class DrawGroup(Element, AnchorMix, ZMix, PosMix):\n    \"\"\"The DrawGroup \"draw:g\" element represents a group of drawing shapes.\n\n    Warning: implementation is currently minimal.\n\n    Drawing shapes contained by a \"draw:g\" element that is itself\n    contained by a \"draw:a\" element, act as hyperlinks using the\n    xlink:href attribute of the containing \"draw:a\" element. If the\n    included drawing shapes are themselves contained within \"draw:a\"\n    elements, then the xlink:href attributes of those \"draw:a\" elements\n    act as the hyperlink information for the shapes they contain.\n\n    The \"draw:g\" element has the following attributes: draw:caption-id,\n    draw:class-names, draw:id, draw:name, draw:style-name, draw:z-index,\n    presentation:class-names, presentation:style-name, svg:y,\n    table:end-cell-address, table:end-x, table:end-y,\n    table:table-background, text:anchor-page-number, text:anchor-type,\n    and xml:id.\n\n    The \"draw:g\" element has the following child elements: \"dr3d:scene\",\n    \"draw:a\", \"draw:caption\", \"draw:circle\", \"draw:connector\",\n    \"draw:control\", \"draw:custom-shape\", \"draw:ellipse\", \"draw:frame\",\n    \"draw:g\", \"draw:glue-point\", \"draw:line\", \"draw:measure\",\n    \"draw:page-thumbnail\", \"draw:path\", \"draw:polygon\", \"draw:polyline\",\n    \"draw:rect\", \"draw:regular-polygon\", \"office:event-listeners\",\n    \"svg:desc\" and \"svg:title\".\n    \"\"\"\n\n    _tag = \"draw:g\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"draw_id\", \"draw:id\"),\n        PropDef(\"caption_id\", \"draw:caption-id\"),\n        PropDef(\"draw_class_names\", \"draw:class-names\"),\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"style\", \"draw:style-name\"),\n        # ('z_index', 'draw:z-index'),\n        PropDef(\"presentation_class_names\", \"presentation:class-names\"),\n        PropDef(\"presentation_style\", \"presentation:style-name\"),\n        PropDef(\"table_end_cell\", \"table:end-cell-address\"),\n        PropDef(\"table_end_x\", \"table:end-x\"),\n        PropDef(\"table_end_y\", \"table:end-y\"),\n        PropDef(\"table_background\", \"table:table-background\"),\n        # ('anchor_page', 'text:anchor-page-number'),\n        # ('anchor_type', 'text:anchor-type'),\n        PropDef(\"xml_id\", \"xml:id\"),\n        PropDef(\"pos_x\", \"svg:x\"),\n        PropDef(\"pos_y\", \"svg:y\"),\n    )\n\n    def __init__(\n        self,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        z_index: int = 0,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if z_index is not None:\n                self.z_index = z_index\n            if name:\n                self.name = name\n            if draw_id is not None:\n                self.draw_id = draw_id\n            if style is not None:\n                self.style = style\n            if position is not None:\n                self.position = position\n            if anchor_type:\n                self.anchor_type = anchor_type\n            if anchor_page is not None:\n                self.anchor_page = anchor_page\n            if presentation_style is not None:\n                self.presentation_style = presentation_style\n</code></pre>"},{"location":"reference.html#odfdo.DrawImage","title":"<code>DrawImage</code>","text":"<p>               Bases: <code>Element</code></p> <p>The \u201cdraw:image\u201d element represents an image. An image can be either: - A link to an external resource or - Embedded in the document (Not implemented in this version)</p> <p>Warning: image elements must be stored in a frame \u201cdraw:frame\u201d, see Frame().</p> Source code in <code>odfdo/image.py</code> <pre><code>class DrawImage(Element):\n    \"\"\"The \"draw:image\" element represents an image. An image can be\n    either:\n    - A link to an external resource or\n    - Embedded in the document (Not implemented in this version)\n\n    Warning: image elements must be stored in a frame \"draw:frame\",\n    see Frame().\n    \"\"\"\n\n    _tag = \"draw:image\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"url\", \"xlink:href\"),\n        PropDef(\"type\", \"xlink:type\"),\n        PropDef(\"show\", \"xlink:show\"),\n        PropDef(\"actuate\", \"xlink:actuate\"),\n        PropDef(\"filter_name\", \"draw:filter-name\"),\n    )\n\n    def __init__(\n        self,\n        url: str = \"\",\n        xlink_type: str = \"simple\",\n        show: str = \"embed\",\n        actuate: str = \"onLoad\",\n        filter_name: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Initialisation of an DrawImage.\n\n        Arguments:\n\n            url -- str\n\n            type -- str\n\n            show -- str\n\n            actuate -- str\n\n            filter_name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.url = url\n            self.type = xlink_type\n            self.show = show\n            self.actuate = actuate\n            self.filter_name = filter_name\n</code></pre>"},{"location":"reference.html#odfdo.DrawImage.__init__","title":"<code>__init__(url='', xlink_type='simple', show='embed', actuate='onLoad', filter_name=None, **kwargs)</code>","text":"<p>Initialisation of an DrawImage.</p> <p>Arguments:</p> <pre><code>url -- str\n\ntype -- str\n\nshow -- str\n\nactuate -- str\n\nfilter_name -- str\n</code></pre> Source code in <code>odfdo/image.py</code> <pre><code>def __init__(\n    self,\n    url: str = \"\",\n    xlink_type: str = \"simple\",\n    show: str = \"embed\",\n    actuate: str = \"onLoad\",\n    filter_name: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Initialisation of an DrawImage.\n\n    Arguments:\n\n        url -- str\n\n        type -- str\n\n        show -- str\n\n        actuate -- str\n\n        filter_name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.url = url\n        self.type = xlink_type\n        self.show = show\n        self.actuate = actuate\n        self.filter_name = filter_name\n</code></pre>"},{"location":"reference.html#odfdo.DrawPage","title":"<code>DrawPage</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF draw page \u201cdraw:page\u201d, for pages of presentation and drawings.</p> Source code in <code>odfdo/draw_page.py</code> <pre><code>class DrawPage(Element):\n    \"\"\"ODF draw page \"draw:page\", for pages of presentation and drawings.\"\"\"\n\n    _tag = \"draw:page\"\n    _properties = (\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"draw_id\", \"draw:id\"),\n        PropDef(\"master_page\", \"draw:master-page-name\"),\n        PropDef(\n            \"presentation_page_layout\", \"presentation:presentation-page-layout-name\"\n        ),\n        PropDef(\"style\", \"draw:style-name\"),\n    )\n\n    def __init__(\n        self,\n        draw_id: str | None = None,\n        name: str | None = None,\n        master_page: str | None = None,\n        presentation_page_layout: str | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            draw_id -- str\n\n            name -- str\n\n            master_page -- str\n\n            presentation_page_layout -- str\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if draw_id:\n                self.draw_id = draw_id\n            if name:\n                self.name = name\n            if master_page:\n                self.master_page = master_page\n            if presentation_page_layout:\n                self.presentation_page_layout = presentation_page_layout\n            if style:\n                self.style = style\n\n    def set_transition(\n        self,\n        smil_type: str,\n        subtype: str | None = None,\n        dur: str = \"2s\",\n    ) -&gt; None:\n        # Create the new animation\n        anim_page = AnimPar(presentation_node_type=\"timing-root\")\n        anim_begin = AnimPar(smil_begin=f\"{self.draw_id}.begin\")\n        transition = AnimTransFilter(\n            smil_dur=dur, smil_type=smil_type, smil_subtype=subtype\n        )\n        anim_page.append(anim_begin)\n        anim_begin.append(transition)\n\n        # Replace when already a transition:\n        #   anim:seq =&gt; After the frame's transition\n        #   cf page 349 of OpenDocument-v1.0-os.pdf\n        #   Conclusion: We must delete the first child 'anim:par'\n        existing = self.get_element(\"anim:par\")\n        if existing:\n            self.delete(existing)\n        self.append(anim_page)\n\n    def get_shapes(self) -&gt; list[Element]:\n        query = \"(descendant::\" + \"|descendant::\".join(registered_shapes) + \")\"\n        return self.get_elements(query)\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        result: list[str] = []\n        for child in self.children:\n            if child.tag == \"presentation:notes\":\n                # No need for an advanced odf_notes.get_formatted_text()\n                # because the text seems to be only contained in paragraphs\n                # and frames, that we already handle\n                for sub_child in child.children:\n                    result.append(sub_child.get_formatted_text(context))\n                result.append(\"\\n\")\n            result.append(child.get_formatted_text(context))\n        result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.DrawPage.__init__","title":"<code>__init__(draw_id=None, name=None, master_page=None, presentation_page_layout=None, style=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>draw_id -- str\n\nname -- str\n\nmaster_page -- str\n\npresentation_page_layout -- str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/draw_page.py</code> <pre><code>def __init__(\n    self,\n    draw_id: str | None = None,\n    name: str | None = None,\n    master_page: str | None = None,\n    presentation_page_layout: str | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        draw_id -- str\n\n        name -- str\n\n        master_page -- str\n\n        presentation_page_layout -- str\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if draw_id:\n            self.draw_id = draw_id\n        if name:\n            self.name = name\n        if master_page:\n            self.master_page = master_page\n        if presentation_page_layout:\n            self.presentation_page_layout = presentation_page_layout\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Drawing","title":"<code>Drawing</code>","text":"<p>               Bases: <code>Body</code></p> <p>Drawing, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Drawing(Body):\n    \"\"\"Drawing, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:drawing\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.EText","title":"<code>EText</code>","text":"<p>               Bases: <code>str</code></p> <p>Representation of an XML text node. Created to hide the specifics of lxml in searching text nodes using XPath.</p> <p>Constructed like any str object but only accepts lxml text objects.</p> Source code in <code>odfdo/element.py</code> <pre><code>class EText(str):\n    \"\"\"Representation of an XML text node. Created to hide the specifics of\n    lxml in searching text nodes using XPath.\n\n    Constructed like any str object but only accepts lxml text objects.\n    \"\"\"\n\n    # There's some black magic in inheriting from str\n    def __init__(\n        self,\n        text_result: str | bytes,\n    ) -&gt; None:\n        self.__parent = text_result.getparent()  # type: ignore\n        self.__is_text = text_result.is_text\n        self.__is_tail = text_result.is_tail\n\n    @property\n    def parent(self) -&gt; Element | None:\n        parent = self.__parent\n        # XXX happens just because of the unit test\n        if parent is None:\n            return None\n        return Element.from_tag(tag_or_elem=parent)\n\n    def is_text(self) -&gt; bool:\n        return self.__is_text\n\n    def is_tail(self) -&gt; bool:\n        return self.__is_tail\n</code></pre>"},{"location":"reference.html#odfdo.Element","title":"<code>Element</code>","text":"<p>               Bases: <code>CachedElement</code></p> <p>Super class of all ODF classes.</p> <p>Representation of an XML element. Abstraction of the XML library behind.</p> Source code in <code>odfdo/element.py</code> <pre><code>class Element(CachedElement):\n    \"\"\"Super class of all ODF classes.\n\n    Representation of an XML element. Abstraction of the XML library behind.\n    \"\"\"\n\n    _tag: str = \"\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n\n    def __init__(self, **kwargs: Any) -&gt; None:\n        tag_or_elem = kwargs.pop(\"tag_or_elem\", None)\n        if tag_or_elem is None:\n            # Instance for newly created object: create new lxml element and\n            # continue by subclass __init__\n            # If the tag key word exists, make a custom element\n            self._do_init = True\n            tag = kwargs.pop(\"tag\", self._tag)\n            self.__element = self.make_etree_element(tag)\n        else:\n            # called with an existing lxml element, sould be a result of\n            # from_tag() casting, do not execute the subclass __init__\n            if not isinstance(tag_or_elem, _Element):\n                raise TypeError(f'\"{type(tag_or_elem)}\" is not an element node')\n            self._do_init = False\n            self.__element = tag_or_elem\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag}&gt;\"\n\n    def __str__(self) -&gt; str:\n        return self.text_recursive\n\n    @classmethod\n    def from_tag(cls, tag_or_elem: str | _Element) -&gt; Element:\n        \"\"\"Element class and subclass factory.\n\n        Turn an lxml Element or ODF string tag into an ODF XML Element\n        of the relevant class.\n\n        Arguments:\n\n            tag_or_elem -- ODF str tag or lxml.Element\n\n        Return: Element (or subclass) instance\n        \"\"\"\n        if isinstance(tag_or_elem, str):\n            # assume the argument is a prefix:name tag\n            elem = cls.make_etree_element(tag_or_elem)\n        else:\n            elem = tag_or_elem\n        klass = _class_registry.get(elem.tag, cls)\n        return klass(tag_or_elem=elem)\n\n    @classmethod\n    def from_tag_for_clone(\n        cls: type,\n        tree_element: _Element,\n        cache: tuple | None,\n    ) -&gt; Element:\n        tag = to_str(tree_element.tag)\n        klass = _class_registry.get(tag, cls)\n        element = klass(tag_or_elem=tree_element)\n        if cache and element._caching:\n            element._tmap = cache[0]\n            element._cmap = cache[1]\n            if len(cache) == 3:\n                element._rmap = cache[2]\n        return element\n\n    @staticmethod\n    def make_etree_element(tag: str) -&gt; _Element:\n        if not isinstance(tag, str):\n            raise TypeError(f\"Tag is not str: {tag!r}\")\n        tag = tag.strip()\n        if not tag:\n            raise ValueError(\"Tag is empty\")\n        if \"&lt;\" not in tag:\n            # Qualified name\n            # XXX don't build the element from scratch or lxml will pollute with\n            # repeated namespace declarations\n            tag = f\"&lt;{tag}/&gt;\"\n        # XML fragment\n        root = fromstring(NAMESPACES_XML % str_to_bytes(tag))\n        return root[0]\n\n    @staticmethod\n    def _generic_attrib_getter(attr_name: str, family: str | None = None) -&gt; Callable:\n        name = _get_lxml_tag(attr_name)\n\n        def getter(self: Element) -&gt; str | bool | None:\n            try:\n                if family and self.family != family:  # type: ignore\n                    return None\n            except AttributeError:\n                return None\n            value = self.__element.get(name)\n            if value is None:\n                return None\n            elif value in (\"true\", \"false\"):\n                return Boolean.decode(value)\n            return str(value)\n\n        return getter\n\n    @staticmethod\n    def _generic_attrib_setter(attr_name: str, family: str | None = None) -&gt; Callable:\n        name = _get_lxml_tag(attr_name)\n\n        def setter(self: Element, value: Any) -&gt; None:\n            try:\n                if family and self.family != family:  # type: ignore\n                    return None\n            except AttributeError:\n                return None\n            if value is None:\n                with contextlib.suppress(KeyError):\n                    del self.__element.attrib[name]\n                return\n            if isinstance(value, bool):\n                value = Boolean.encode(value)\n            self.__element.set(name, str(value))\n\n        return setter\n\n    @classmethod\n    def _define_attribut_property(cls: type[Element]) -&gt; None:\n        for prop in cls._properties:\n            setattr(\n                cls,\n                prop.name,\n                property(\n                    cls._generic_attrib_getter(prop.attr, prop.family or None),\n                    cls._generic_attrib_setter(prop.attr, prop.family or None),\n                    None,\n                    f\"Get/set the attribute {prop.attr}\",\n                ),\n            )\n\n    @staticmethod\n    def _make_before_regex(\n        before: str | None,\n        after: str | None,\n    ) -&gt; re.Pattern:\n        # 1) before xor after is not None\n        if before is not None:\n            return re.compile(before)\n        else:\n            if after is None:\n                raise ValueError(\"Both 'before' and 'after' are None\")\n            return re.compile(after)\n\n    @staticmethod\n    def _search_negative_position(\n        xpath_result: list,\n        regex: re.Pattern,\n    ) -&gt; tuple[str, re.Match]:\n        # Found the last text that matches the regex\n        text = None\n        for a_text in xpath_result:\n            if regex.search(str(a_text)) is not None:\n                text = a_text\n        if text is None:\n            raise ValueError(f\"Text not found: '{xpath_result}'\")\n        if not isinstance(text, str):\n            raise TypeError(f\"Text not found or text not of type str: '{text}'\")\n        return text, list(regex.finditer(text))[-1]\n\n    @staticmethod\n    def _search_positive_position(\n        xpath_result: list,\n        regex: re.Pattern,\n        position: int,\n    ) -&gt; tuple[str, re.Match]:\n        # Found the last text that matches the regex\n        count = 0\n        for text in xpath_result:\n            found_nb = len(regex.findall(str(text)))\n            if found_nb + count &gt;= position + 1:\n                break\n            count += found_nb\n        else:\n            raise ValueError(f\"Text not found: '{xpath_result}'\")\n        if not isinstance(text, str):\n            raise TypeError(f\"Text not found or text not of type str: '{text}'\")\n        return text, list(regex.finditer(text))[position - count]\n\n    def _insert_before_after(\n        self,\n        current: _Element,\n        element: _Element,\n        before: str | None,\n        after: str | None,\n        position: int,\n        xpath_text: XPath,\n    ) -&gt; tuple[int, str]:\n        regex = self._make_before_regex(before, after)\n        xpath_result = xpath_text(current)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n        # position = -1\n        if position &lt; 0:\n            text, sre = self._search_negative_position(xpath_result, regex)\n        # position &gt;= 0\n        else:\n            text, sre = self._search_positive_position(xpath_result, regex, position)\n        # Compute pos\n        if before is None:\n            pos = sre.end()\n        else:\n            pos = sre.start()\n        return pos, text\n\n    def _insert_find_text(\n        self,\n        current: _Element,\n        element: _Element,\n        before: str | None,\n        after: str | None,\n        position: int,\n        xpath_text: XPath,\n    ) -&gt; tuple[int, str]:\n        # Find the text\n        xpath_result = xpath_text(current)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n        count = 0\n        for text in xpath_result:\n            if not isinstance(text, str):\n                continue\n            found_nb = len(text)\n            if found_nb + count &gt;= position:\n                break\n            count += found_nb\n        else:\n            raise ValueError(\"Text not found\")\n        # We insert before the character\n        pos = position - count\n        return pos, text\n\n    def _insert(\n        self,\n        element: Element,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n        main_text: bool = False,\n    ) -&gt; None:\n        \"\"\"Insert an element before or after the characters in the text which\n        match the regex before/after.\n\n        When the regex matches more of one part of the text, position can be\n        set to choice which part must be used. If before and after are None,\n        we use only position that is the number of characters. If position is\n        positive and before=after=None, we insert before the position\n        character. But if position=-1, we insert after the last character.\n\n\n        Arguments:\n\n        element -- Element\n\n        before -- str regex\n\n        after -- str regex\n\n        position -- int\n        \"\"\"\n        # not implemented: if main_text is True, filter out the annotations texts in computation.\n        current = self.__element\n        xelement = element.__element\n\n        if main_text:\n            xpath_text = _xpath_text_main_descendant\n        else:\n            xpath_text = _xpath_text_descendant\n\n        # 1) before xor after is not None\n        if (before is not None) ^ (after is not None):\n            pos, text = self._insert_before_after(\n                current,\n                xelement,\n                before,\n                after,\n                position,\n                xpath_text,\n            )\n        # 2) before=after=None =&gt; only with position\n        elif before is None and after is None:\n            # Hack if position is negative =&gt; quickly\n            if position &lt; 0:\n                current.append(xelement)\n                return\n            pos, text = self._insert_find_text(\n                current,\n                xelement,\n                before,\n                after,\n                position,\n                xpath_text,\n            )\n        else:\n            raise ValueError(\"bad combination of arguments\")\n\n        # Compute new texts\n        text_before = text[:pos] if text[:pos] else None\n        text_after = text[pos:] if text[pos:] else None\n\n        # Insert!\n        parent = text.getparent()  # type: ignore\n        if text.is_text:  # type: ignore\n            parent.text = text_before\n            element.tail = text_after\n            parent.insert(0, xelement)\n        else:\n            parent.addnext(xelement)\n            parent.tail = text_before\n            element.tail = text_after\n\n    def _insert_between(  # noqa: C901\n        self,\n        element: Element,\n        from_: str,\n        to: str,\n    ) -&gt; None:\n        \"\"\"Insert the given empty element to wrap the text beginning with\n        \"from_\" and ending with \"to\".\n\n        Example 1: '&lt;p&gt;toto tata titi&lt;/p&gt;\n\n        We want to insert a link around \"tata\".\n\n        Result 1: '&lt;p&gt;toto &lt;a&gt;tata&lt;/a&gt; titi&lt;/p&gt;\n\n        Example 2: '&lt;p&gt;&lt;span&gt;toto&lt;/span&gt; tata titi&lt;/p&gt;\n\n        We want to insert a link around \"tata\".\n\n        Result 2: '&lt;p&gt;&lt;span&gt;toto&lt;/span&gt; &lt;a&gt;tata&lt;/a&gt; titi&lt;/p&gt;\n\n        Example 3: '&lt;p&gt;toto &lt;span&gt; tata &lt;/span&gt; titi&lt;/p&gt;'\n\n        We want to insert a link from \"tata\" to \"titi\" included.\n\n        Result 3: '&lt;p&gt;toto &lt;span&gt; &lt;/span&gt;'\n                  '&lt;a&gt;&lt;span&gt;tata &lt;/span&gt; titi&lt;/a&gt;&lt;/p&gt;'\n\n        Example 4: '&lt;p&gt;toto &lt;span&gt;tata titi&lt;/span&gt; tutu&lt;/p&gt;'\n\n        We want to insert a link from \"titi\" to \"tutu\"\n\n        Result 4: '&lt;p&gt;toto &lt;span&gt;tata &lt;/span&gt;&lt;a&gt;&lt;span&gt;titi&lt;/span&gt;&lt;/a&gt;'\n                  '&lt;a&gt; tutu&lt;/a&gt;&lt;/p&gt;'\n\n        Example 5: '&lt;p&gt;toto &lt;span&gt;tata titi&lt;/span&gt; '\n                   '&lt;span&gt;tutu tyty&lt;/span&gt;&lt;/p&gt;'\n\n        We want to insert a link from \"titi\" to \"tutu\"\n\n        Result 5: '&lt;p&gt;toto &lt;span&gt;tata &lt;/span&gt;&lt;a&gt;&lt;span&gt;titi&lt;/span&gt;&lt;a&gt; '\n                  '&lt;a&gt; &lt;span&gt;tutu&lt;/span&gt;&lt;/a&gt;&lt;span&gt; tyty&lt;/span&gt;&lt;/p&gt;'\n        \"\"\"\n        current = self.__element\n        wrapper = element.__element\n\n        xpath_result = _xpath_text_descendant(current)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n\n        for text in xpath_result:\n            if not isinstance(text, str):\n                raise TypeError(\"Text not found or text not of type str\")\n            if from_ not in text:\n                continue\n            from_index = text.index(from_)\n            text_before = text[:from_index]\n            text_after = text[from_index:]\n            from_container = text.getparent()  # type: ignore\n            if not isinstance(from_container, _Element):\n                raise TypeError(\"Bad XPath result\")\n            # Include from_index to match a single word\n            to_index = text.find(to, from_index)\n            if to_index &gt;= 0:\n                # Simple case: \"from\" and \"to\" in the same element\n                to_end = to_index + len(to)\n                if text.is_text:  # type: ignore\n                    from_container.text = text_before\n                    wrapper.text = text[to_index:to_end]\n                    wrapper.tail = text[to_end:]\n                    from_container.insert(0, wrapper)\n                else:\n                    from_container.tail = text_before\n                    wrapper.text = text[to_index:to_end]\n                    wrapper.tail = text[to_end:]\n                    parent = from_container.getparent()\n                    index = parent.index(from_container)  # type: ignore\n                    parent.insert(index + 1, wrapper)  # type: ignore\n                return\n            else:\n                # Exit to the second part where we search for the end text\n                break\n        else:\n            raise ValueError(\"Start text not found\")\n\n        # The container is split in two\n        container2 = deepcopy(from_container)\n        if text.is_text:  # type: ignore\n            from_container.text = text_before\n            from_container.tail = None\n            container2.text = text_after\n            from_container.tail = None\n        else:\n            from_container.tail = text_before\n            container2.tail = text_after\n        # Stack the copy into the surrounding element\n        wrapper.append(container2)\n        parent = from_container.getparent()\n        index = parent.index(from_container)  # type: ignore\n        parent.insert(index + 1, wrapper)  # type: ignore\n\n        xpath_result = _xpath_text_descendant(wrapper)\n        if not isinstance(xpath_result, list):\n            raise TypeError(\"Bad XPath result\")\n\n        for text in xpath_result:\n            if not isinstance(text, str):\n                raise TypeError(\"Text not found or text not of type str\")\n            if to not in text:\n                continue\n            to_end = text.index(to) + len(to)\n            text_before = text[:to_end]\n            text_after = text[to_end:]\n            container_to = text.getparent()  # type: ignore\n            if not isinstance(container_to, _Element):\n                raise TypeError(\"Bad XPath result\")\n            if text.is_text:  # type: ignore\n                container_to.text = text_before\n                container_to.tail = text_after\n            else:\n                container_to.tail = text_before\n                next_one = container_to.getnext()\n                if next_one is None:\n                    next_one = container_to.getparent()\n                next_one.tail = text_after  # type: ignore\n            return\n        raise ValueError(\"End text not found\")\n\n    @property\n    def tag(self) -&gt; str:\n        \"\"\"Get/set the underlying xml tag with the given qualified name.\n\n        Warning: direct change of tag does not change the element class.\n\n        Arguments:\n\n            qname -- str (e.g. \"text:span\")\n        \"\"\"\n        return _get_prefixed_name(self.__element.tag)\n\n    @tag.setter\n    def tag(self, qname: str) -&gt; None:\n        self.__element.tag = _get_lxml_tag(qname)\n\n    def elements_repeated_sequence(\n        self,\n        xpath_instance: XPath,\n        name: str,\n    ) -&gt; list[tuple[int, int]]:\n        \"\"\"Utility method for table module.\"\"\"\n        lxml_tag = _get_lxml_tag_or_name(name)\n        element = self.__element\n        sub_elements = xpath_instance(element)\n        if not isinstance(sub_elements, list):\n            raise TypeError(\"Bad XPath result.\")\n        result: list[tuple[int, int]] = []\n        idx = -1\n        for sub_element in sub_elements:\n            if not isinstance(sub_element, _Element):\n                continue\n            idx += 1\n            value = sub_element.get(lxml_tag)\n            if value is None:\n                result.append((idx, 1))\n                continue\n            try:\n                int_value = int(value)\n            except ValueError:\n                int_value = 1\n            result.append((idx, max(int_value, 1)))\n        return result\n\n    def get_elements(self, xpath_query: XPath | str) -&gt; list[Element]:\n        cache: tuple | None = None\n        element = self.__element\n        if isinstance(xpath_query, str):\n            new_xpath_query = xpath_compile(xpath_query)\n            result = new_xpath_query(element)\n        else:\n            result = xpath_query(element)\n        if not isinstance(result, list):\n            raise TypeError(\"Bad XPath result\")\n\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                cache = (self._tmap, self._cmap, self._rmap)\n            else:\n                cache = (self._tmap, self._cmap)\n        return [\n            Element.from_tag_for_clone(e, cache)\n            for e in result\n            if isinstance(e, _Element)\n        ]\n\n    # fixme : need original get_element as wrapper of get_elements\n\n    def get_element(self, xpath_query: XPath | str) -&gt; Element | None:\n        element = self.__element\n        result = element.xpath(f\"({xpath_query})[1]\", namespaces=ODF_NAMESPACES)\n        if result:\n            return Element.from_tag(result[0])  # type:ignore\n        return None\n\n    def _get_element_idx(self, xpath_query: XPath | str, idx: int) -&gt; Element | None:\n        element = self.__element\n        result = element.xpath(f\"({xpath_query})[{idx + 1}]\", namespaces=ODF_NAMESPACES)\n        if result:\n            return Element.from_tag(result[0])  # type:ignore\n        return None\n\n    def _get_element_idx2(self, xpath_instance: XPath, idx: int) -&gt; Element | None:\n        element = self.__element\n        result = xpath_instance(element, idx=idx + 1)\n        if result:\n            return Element.from_tag(result[0])  # type:ignore\n        return None\n\n    @property\n    def attributes(self) -&gt; dict[str, str]:\n        return {\n            _get_prefixed_name(str(key)): str(value)\n            for key, value in self.__element.attrib.items()\n        }\n\n    def get_attribute(self, name: str) -&gt; str | bool | None:\n        \"\"\"Return the attribute value as type str | bool | None.\"\"\"\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        value = element.get(lxml_tag)\n        if value is None:\n            return None\n        elif value in (\"true\", \"false\"):\n            return Boolean.decode(value)\n        return str(value)\n\n    def get_attribute_integer(self, name: str) -&gt; int | None:\n        \"\"\"Return either the attribute as type int, or None.\"\"\"\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        value = element.get(lxml_tag)\n        if value is None:\n            return None\n        try:\n            return int(value)\n        except ValueError:\n            return None\n\n    def get_attribute_string(self, name: str) -&gt; str | None:\n        \"\"\"Return either the attribute as type str, or None.\"\"\"\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        value = element.get(lxml_tag)\n        if value is None:\n            return None\n        return str(value)\n\n    def set_attribute(\n        self, name: str, value: bool | str | tuple[int, int, int] | None\n    ) -&gt; None:\n        if name in ODF_COLOR_PROPERTY:\n            if isinstance(value, bool):\n                raise TypeError(f\"Wrong color type {value!r}\")\n            if value != \"transparent\":\n                value = hexa_color(value)\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        if isinstance(value, bool):\n            value = Boolean.encode(value)\n        elif value is None:\n            with contextlib.suppress(KeyError):\n                del element.attrib[lxml_tag]\n            return\n        element.set(lxml_tag, str(value))\n\n    def set_style_attribute(self, name: str, value: Element | str) -&gt; None:\n        \"\"\"Shortcut to accept a style object as a value.\"\"\"\n        if isinstance(value, Element):\n            value = str(value.name)  # type:ignore\n        return self.set_attribute(name, value)\n\n    def del_attribute(self, name: str) -&gt; None:\n        element = self.__element\n        lxml_tag = _get_lxml_tag_or_name(name)\n        del element.attrib[lxml_tag]\n\n    @property\n    def text(self) -&gt; str:\n        \"\"\"Get / set the text content of the element.\"\"\"\n        return self.__element.text or \"\"\n\n    @text.setter\n    def text(self, text: str | None) -&gt; None:\n        if text is None:\n            text = \"\"\n        try:\n            self.__element.text = text\n        except TypeError as e:\n            raise TypeError(f'Str type expected: \"{type(text)}\"') from e\n\n    @property\n    def text_recursive(self) -&gt; str:\n        return \"\".join(str(x) for x in self.__element.itertext())\n\n    @property\n    def tail(self) -&gt; str | None:\n        \"\"\"Get / set the text immediately following the element.\"\"\"\n        return self.__element.tail\n\n    @tail.setter\n    def tail(self, text: str | None) -&gt; None:\n        self.__element.tail = text or \"\"\n\n    def search(self, pattern: str) -&gt; int | None:\n        \"\"\"Return the first position of the pattern in the text content of\n        the element, or None if not found.\n\n        Python regular expression syntax applies.\n\n        Arguments:\n\n            pattern -- str\n\n        Return: int or None\n        \"\"\"\n        match = re.search(pattern, self.text_recursive)\n        if match is None:\n            return None\n        return match.start()\n\n    def match(self, pattern: str) -&gt; bool:\n        \"\"\"return True if the pattern is found one or more times anywhere in\n        the text content of the element.\n\n        Python regular expression syntax applies.\n\n        Arguments:\n\n            pattern -- str\n\n        Return: bool\n        \"\"\"\n        return self.search(pattern) is not None\n\n    def replace(self, pattern: str, new: str | None = None) -&gt; int:\n        \"\"\"Replace the pattern with the given text, or delete if text is an\n        empty string, and return the number of replacements. By default, only\n        return the number of occurences that would be replaced.\n\n        It cannot replace patterns found across several element, like a word\n        split into two consecutive spans.\n\n        Python regular expression syntax applies.\n\n        Arguments:\n\n            pattern -- str\n\n            new -- str\n\n        Return: int\n        \"\"\"\n        if not isinstance(pattern, str):\n            # Fail properly if the pattern is an non-ascii bytestring\n            pattern = str(pattern)\n        cpattern = re.compile(pattern)\n        count = 0\n        for text in self.xpath(\"descendant::text()\"):\n            if new is None:\n                count += len(cpattern.findall(str(text)))\n            else:\n                new_text, number = cpattern.subn(new, str(text))\n                container = text.parent\n                if text.is_text():  # type: ignore\n                    container.text = new_text  # type: ignore\n                else:\n                    container.tail = new_text  # type: ignore\n                count += number\n        return count\n\n    @property\n    def root(self) -&gt; Element:\n        element = self.__element\n        tree = element.getroottree()\n        root = tree.getroot()\n        return Element.from_tag(root)\n\n    @property\n    def parent(self) -&gt; Element | None:\n        element = self.__element\n        parent = element.getparent()\n        if parent is None:\n            # Already at root\n            return None\n        return Element.from_tag(parent)\n\n    @property\n    def is_bound(self) -&gt; bool:\n        return self.parent is not None\n\n    # def get_next_sibling(self):\n    #     element = self.__element\n    #     next_one = element.getnext()\n    #     if next_one is None:\n    #         return None\n    #     return Element.from_tag(next_one)\n    #\n    # def get_prev_sibling(self):\n    #     element = self.__element\n    #     prev = element.getprevious()\n    #     if prev is None:\n    #         return None\n    #     return Element.from_tag(prev)\n\n    @property\n    def children(self) -&gt; list[Element]:\n        element = self.__element\n        return [\n            Element.from_tag(e)\n            for e in element.iterchildren()\n            if isinstance(e, _Element)\n        ]\n\n    def index(self, child: Element) -&gt; int:\n        \"\"\"Return the position of the child in this element.\n\n        Inspired by lxml\n        \"\"\"\n        return self.__element.index(child.__element)\n\n    @property\n    def text_content(self) -&gt; str:\n        \"\"\"Get / set the text of the embedded paragraph, including embeded\n        annotations, cells...\n\n        Set create a paragraph if missing\n        \"\"\"\n        return \"\\n\".join(\n            child.text_recursive for child in self.get_elements(\"descendant::text:p\")\n        )\n\n    @text_content.setter\n    def text_content(self, text: str | None) -&gt; None:\n        paragraphs = self.get_elements(\"text:p\")\n        if not paragraphs:\n            # E.g., text:p in draw:text-box in draw:frame\n            paragraphs = self.get_elements(\"*/text:p\")\n        if paragraphs:\n            paragraph = paragraphs.pop(0)\n            for obsolete in paragraphs:\n                obsolete.delete()\n        else:\n            paragraph = Element.from_tag(\"text:p\")\n            self.insert(paragraph, FIRST_CHILD)\n        # As \"text_content\" returned all text nodes, \"text_content\"\n        # will overwrite all text nodes and children that may contain them\n        element = paragraph.__element\n        # Clear but the attributes\n        del element[:]\n        element.text = text\n\n    def _erase_text_content(self) -&gt; None:\n        paragraphs = self.get_elements(\"text:p\")\n        if not paragraphs:\n            # E.g., text:p in draw:text-box in draw:frame\n            paragraphs = self.get_elements(\"*/text:p\")\n        if paragraphs:\n            paragraphs.pop(0)\n            for obsolete in paragraphs:\n                obsolete.delete()\n\n    def is_empty(self) -&gt; bool:\n        \"\"\"Check if the element is empty : no text, no children, no tail.\n\n        Return: Boolean\n        \"\"\"\n        element = self.__element\n        if element.tail is not None:\n            return False\n        if element.text is not None:\n            return False\n        if list(element.iterchildren()):\n            return False\n        return True\n\n    def _get_successor(self, target: Element) -&gt; tuple[Element | None, Element | None]:\n        element = self.__element\n        next_one = element.getnext()\n        if next_one is not None:\n            return Element.from_tag(next_one), target\n        parent = self.parent\n        if parent is None:\n            return None, None\n        return parent._get_successor(target.parent)  # type:ignore\n\n    def _get_between_base(  # noqa:C901\n        self,\n        tag1: Element,\n        tag2: Element,\n    ) -&gt; list[Element]:\n        def find_any_id(elem: Element) -&gt; tuple[str, str, str]:\n            elem_tag = elem.tag\n            for attribute in (\n                \"text:id\",\n                \"text:change-id\",\n                \"text:name\",\n                \"office:name\",\n                \"text:ref-name\",\n                \"xml:id\",\n            ):\n                idx = elem.get_attribute(attribute)\n                if idx is not None:\n                    return elem_tag, attribute, str(idx)\n            raise ValueError(f\"No Id found in {elem.serialize()}\")\n\n        def common_ancestor(\n            tag1: str,\n            attr1: str,\n            val1: str,\n            tag2: str,\n            attr2: str,\n            val2: str,\n        ) -&gt; Element | None:\n            root = self.root\n            request1 = f'descendant::{tag1}[@{attr1}=\"{val1}\"]'\n            request2 = f'descendant::{tag2}[@{attr2}=\"{val2}\"]'\n            ancestor = root.xpath(request1)[0]\n            if ancestor is None:\n                return None\n            while True:\n                # print \"up\",\n                new_ancestor = ancestor.parent\n                if new_ancestor is None:\n                    return None\n                has_tag2 = new_ancestor.xpath(request2)\n                ancestor = new_ancestor\n                if not has_tag2:\n                    continue\n                # print 'found'\n                break\n            # print up.serialize()\n            return ancestor\n\n        elem1_tag, elem1_attr, elem1_val = find_any_id(tag1)\n        elem2_tag, elem2_attr, elem2_val = find_any_id(tag2)\n        ancestor_result = common_ancestor(\n            elem1_tag,\n            elem1_attr,\n            elem1_val,\n            elem2_tag,\n            elem2_attr,\n            elem2_val,\n        )\n        if ancestor_result is None:\n            raise RuntimeError(f\"No common ancestor for {elem1_tag} {elem2_tag}\")\n        ancestor = ancestor_result.clone\n        path1 = f'{elem1_tag}[@{elem1_attr}=\"{elem1_val}\"]'\n        path2 = f'{elem2_tag}[@{elem2_attr}=\"{elem2_val}\"]'\n        result = ancestor.clone\n        for child in result.children:\n            result.delete(child)\n        result.text = \"\"\n        result.tail = \"\"\n        target = result\n        current = ancestor.children[0]\n\n        state = 0\n        while True:\n            if current is None:\n                raise RuntimeError(f\"No current ancestor for {elem1_tag} {elem2_tag}\")\n            # print 'current', state, current.serialize()\n            if state == 0:  # before tag 1\n                if current.xpath(f\"descendant-or-self::{path1}\"):\n                    if current.xpath(f\"self::{path1}\"):\n                        tail = current.tail\n                        if tail:\n                            # got a tail =&gt; the parent should be either t:p or t:h\n                            target.text = tail  # type: ignore\n                        current, target = current._get_successor(target)  # type: ignore\n                        state = 1\n                        continue\n                    # got T1 in chidren, need further analysis\n                    new_target = current.clone\n                    for child in new_target.children:\n                        new_target.delete(child)\n                    new_target.text = \"\"\n                    new_target.tail = \"\"\n                    target.append(new_target)  # type: ignore\n                    target = new_target\n                    current = current.children[0]\n                    continue\n                else:\n                    # before tag1 : forget element, go to next one\n                    current, target = current._get_successor(target)  # type: ignore\n                    continue\n            elif state == 1:  # collect elements\n                further = False\n                if current.xpath(f\"descendant-or-self::{path2}\"):\n                    if current.xpath(f\"self::{path2}\"):\n                        # end of trip\n                        break\n                    # got T2 in chidren, need further analysis\n                    further = True\n                # further analysis needed :\n                if further:\n                    new_target = current.clone\n                    for child in new_target.children:\n                        new_target.delete(child)\n                    new_target.text = \"\"\n                    new_target.tail = \"\"\n                    target.append(new_target)  # type: ignore\n                    target = new_target\n                    current = current.children[0]\n                    continue\n                # collect\n                target.append(current.clone)  # type: ignore\n                current, target = current._get_successor(target)  # type: ignore\n                continue\n        # Now resu should be the \"parent\" of inserted parts\n        # - a text:h or text:p sigle item (simple case)\n        # - a upper element, with some text:p, text:h in it =&gt; need to be\n        #   stripped to have a list of text:p, text:h\n        if result.tag in {\"text:p\", \"text:h\"}:\n            inner = [result]\n        else:\n            inner = result.children\n        return inner\n\n    def get_between(\n        self,\n        tag1: Element,\n        tag2: Element,\n        as_text: bool = False,\n        clean: bool = True,\n        no_header: bool = True,\n    ) -&gt; list | Element | str:\n        \"\"\"Returns elements between tag1 and tag2, tag1 and tag2 shall\n        be unique and having an id attribute.\n        (WARN: buggy if tag1/tag2 defines a malformed odf xml.)\n        If as_text is True: returns the text content.\n        If clean is True: suppress unwanted tags (deletions marks, ...)\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of Element, cleaned and without headers.\n\n        Implementation and standard retrictions:\n        Only text:h and text:p sould be 'cut' by an insert tag, so inner parts\n        of insert tags are:\n\n            - any text:h, text:p or sub tag of these\n\n            - some text, part of a parent text:h or text:p\n\n        Arguments:\n\n            tag1 -- Element\n\n            tag2 -- Element\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list of odf_paragraph or odf_header\n        \"\"\"\n        inner = self._get_between_base(tag1, tag2)\n\n        if clean:\n            clean_tags = (\n                \"text:change\",\n                \"text:change-start\",\n                \"text:change-end\",\n                \"text:reference-mark\",\n                \"text:reference-mark-start\",\n                \"text:reference-mark-end\",\n            )\n            request_self = \" | \".join([f\"self::{tag}\" for tag in clean_tags])\n            inner = [e for e in inner if not e.xpath(request_self)]\n            request = \" | \".join([f\"descendant::{tag}\" for tag in clean_tags])\n            for element in inner:\n                to_del = element.xpath(request)\n                for elem in to_del:\n                    if isinstance(elem, Element):\n                        element.delete(elem)\n        if no_header:  # crude replace t:h by t:p\n            new_inner = []\n            for element in inner:\n                if element.tag == \"text:h\":\n                    children = element.children\n                    text = element.__element.text\n                    para = Element.from_tag(\"text:p\")\n                    para.text = text or \"\"\n                    for c in children:\n                        para.append(c)\n                    new_inner.append(para)\n                else:\n                    new_inner.append(element)\n            inner = new_inner\n        if as_text:\n            return \"\\n\".join([e.get_formatted_text() for e in inner])\n        else:\n            return inner\n\n    def insert(\n        self,\n        element: Element,\n        xmlposition: int | None = None,\n        position: int | None = None,\n        start: bool = False,\n    ) -&gt; None:\n        \"\"\"Insert an element relatively to ourself.\n\n        Insert either using DOM vocabulary or by numeric position.\n        If text start is True, insert the element before any existing text.\n\n        Position start at 0.\n\n        Arguments:\n\n            element -- Element\n\n            xmlposition -- FIRST_CHILD, LAST_CHILD, NEXT_SIBLING\n                           or PREV_SIBLING\n\n            start -- Boolean\n\n            position -- int\n        \"\"\"\n        # child_tag = element.tag\n        current = self.__element\n        _element = element.__element\n        if start:\n            text = current.text\n            if text is not None:\n                current.text = None\n                tail = _element.tail\n                if tail is None:\n                    tail = text\n                else:\n                    tail = tail + text\n                _element.tail = tail\n            position = 0\n        if position is not None:\n            current.insert(position, _element)\n        elif xmlposition is FIRST_CHILD:\n            current.insert(0, _element)\n        elif xmlposition is LAST_CHILD:\n            current.append(_element)\n        elif xmlposition is NEXT_SIBLING:\n            parent = current.getparent()\n            index = parent.index(current)  # type: ignore\n            parent.insert(index + 1, _element)  # type: ignore\n        elif xmlposition is PREV_SIBLING:\n            parent = current.getparent()\n            index = parent.index(current)  # type: ignore\n            parent.insert(index, _element)  # type: ignore\n        else:\n            raise ValueError(\"(xml)position must be defined\")\n\n    def extend(self, odf_elements: Iterable[Element]) -&gt; None:\n        \"\"\"Fast append elements at the end of ourself using extend.\"\"\"\n        if odf_elements:\n            current = self.__element\n            elements = [element.__element for element in odf_elements]\n            current.extend(elements)\n\n    def append(self, str_or_element: str | Element) -&gt; None:\n        \"\"\"Insert element or text in the last position.\"\"\"\n        current = self.__element\n        if isinstance(str_or_element, str):\n            # Has children ?\n            children = list(current.iterchildren())\n            if children:\n                # Append to tail of the last child\n                last_child = children[-1]\n                text = last_child.tail\n                text = text if text is not None else \"\"\n                text += str_or_element\n                last_child.tail = text\n            else:\n                # Append to text of the element\n                text = current.text\n                text = text if text is not None else \"\"\n                text += str_or_element\n                current.text = text\n        elif isinstance(str_or_element, Element):\n            current.append(str_or_element.__element)\n        else:\n            raise TypeError(f'Element or string expected, not \"{type(str_or_element)}\"')\n\n    def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        if keep_tail is True (default), the tail text is not erased.\n\n        Arguments:\n\n            child -- Element\n\n            keep_tail -- boolean (default to True), True for most usages.\n        \"\"\"\n        if child is None:\n            parent = self.parent\n            if parent is None:\n                raise ValueError(f\"Can't delete the root element\\n{self.serialize()}\")\n            child = self\n        else:\n            parent = self\n        if keep_tail and child.__element.tail is not None:\n            current = child.__element\n            tail = str(current.tail)\n            current.tail = None\n            prev = current.getprevious()\n            if prev is not None:\n                if prev.tail is None:\n                    prev.tail = tail\n                else:\n                    prev.tail += tail\n            else:\n                if parent.__element.text is None:\n                    parent.__element.text = tail\n                else:\n                    parent.__element.text += tail\n        parent.__element.remove(child.__element)\n\n    def replace_element(self, old_element: Element, new_element: Element) -&gt; None:\n        \"\"\"Replaces in place a sub element with the element passed as second\n        argument.\n\n        Warning : no clone for old element.\n        \"\"\"\n        current = self.__element\n        current.replace(old_element.__element, new_element.__element)\n\n    def strip_elements(\n        self,\n        sub_elements: Element | Iterable[Element],\n    ) -&gt; Element | list:\n        \"\"\"Remove the tags of provided elements, keeping inner childs and text.\n\n        Return : the striped element.\n\n        Warning : no clone in sub_elements list.\n\n        Arguments:\n\n            sub_elements -- Element or list of Element\n        \"\"\"\n        if not sub_elements:\n            return self\n        if isinstance(sub_elements, Element):\n            sub_elements = (sub_elements,)\n        replacer = _get_lxml_tag(\"text:this-will-be-removed\")\n        for element in sub_elements:\n            element.__element.tag = replacer\n        strip = (\"text:this-will-be-removed\",)\n        return self.strip_tags(strip=strip, default=None)\n\n    def strip_tags(\n        self,\n        strip: Iterable[str] | None = None,\n        protect: Iterable[str] | None = None,\n        default: str | None = \"text:p\",\n    ) -&gt; Element | list:\n        \"\"\"Remove the tags listed in strip, recursively, keeping inner childs\n        and text. Tags listed in protect stop the removal one level depth. If\n        the first level element is stripped, default is used to embed the\n        content in the default element. If default is None and first level is\n        striped, a list of text and children is returned. Return : the striped\n        element.\n\n        strip_tags should be used by on purpose methods (strip_span ...)\n        (Method name taken from lxml).\n\n        Arguments:\n\n            strip -- iterable list of str odf tags, or None\n\n            protect -- iterable list of str odf tags, or None\n\n            default -- str odf tag, or None\n\n        Return:\n\n            Element.\n        \"\"\"\n        if not strip:\n            return self\n        if not protect:\n            protect = ()\n        protected = False\n        element, modified = Element._strip_tags(self, strip, protect, protected)\n        if modified and isinstance(element, list) and default:\n            new = Element.from_tag(default)\n            for content in element:\n                if isinstance(content, Element):\n                    new.append(content)\n                else:\n                    new.text = content\n            element = new\n        return element\n\n    @staticmethod\n    def _strip_tags(  # noqa:C901\n        element: Element,\n        strip: Iterable[str],\n        protect: Iterable[str],\n        protected: bool,\n    ) -&gt; tuple[Element | list, bool]:\n        \"\"\"Sub method for strip_tags().\"\"\"\n        element_clone = element.clone\n        modified = False\n        children = []\n        if protect and element.tag in protect:\n            protect_below = True\n        else:\n            protect_below = False\n        for child in element_clone.children:\n            striped_child, is_modified = Element._strip_tags(\n                child, strip, protect, protect_below\n            )\n            if is_modified:\n                modified = True\n            if isinstance(striped_child, list):\n                children.extend(striped_child)\n            else:\n                children.append(striped_child)\n\n        text = element_clone.text\n        tail = element_clone.tail\n        if not protected and strip and element.tag in strip:\n            element_result: list[Element | str] = []\n            if text is not None:\n                element_result.append(text)\n            for child in children:\n                element_result.append(child)\n            if tail is not None:\n                element_result.append(tail)\n            return (element_result, True)\n        else:\n            if not modified:\n                return (element, False)\n            element.clear()\n            try:\n                for key, value in element_clone.attributes.items():\n                    element.set_attribute(key, value)\n            except ValueError:\n                sys.stderr.write(f\"strip_tags(): bad attribute in {element_clone}\\n\")\n            if text is not None:\n                element.append(text)\n            for child in children:\n                element.append(child)\n            if tail is not None:\n                element.tail = tail\n            return (element, True)\n\n    def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n        \"\"\"Apply XPath query to the element and its subtree. Return list of\n        Element or EText instances translated from the nodes found.\n        \"\"\"\n        element = self.__element\n        xpath_instance = xpath_compile(xpath_query)\n        elements = xpath_instance(element)\n        result: list[Element | EText] = []\n        if hasattr(elements, \"__iter__\"):\n            for obj in elements:  # type: ignore\n                if isinstance(obj, (str, bytes)):\n                    result.append(EText(obj))\n                elif isinstance(obj, _Element):\n                    result.append(Element.from_tag(obj))\n                # else:\n                #     result.append(obj)\n        return result\n\n    def clear(self) -&gt; None:\n        \"\"\"Remove text, children and attributes from the element.\"\"\"\n        self.__element.clear()\n        if hasattr(self, \"_tmap\"):\n            self._tmap: list[int] = []\n        if hasattr(self, \"_cmap\"):\n            self._cmap: list[int] = []\n        if hasattr(self, \"_rmap\"):\n            self._rmap: list[int] = []\n        if hasattr(self, \"_indexes\"):\n            remember = False\n            if \"_rmap\" in self._indexes:\n                remember = True\n            self._indexes: dict[str, dict] = {}\n            self._indexes[\"_cmap\"] = {}\n            self._indexes[\"_tmap\"] = {}\n            if remember:\n                self._indexes[\"_rmap\"] = {}\n\n    @property\n    def clone(self) -&gt; Element:\n        clone = deepcopy(self.__element)\n        root = lxml_Element(\"ROOT\", nsmap=ODF_NAMESPACES)\n        root.append(clone)\n        return self.from_tag(clone)\n\n        # slow data = tostring(self.__element, encoding='unicode')\n        # return self.from_tag(data)\n\n    @staticmethod\n    def _strip_namespaces(data: str) -&gt; str:\n        \"\"\"Remove xmlns:* fields from serialized XML.\"\"\"\n        return re.sub(r' xmlns:\\w*=\"[\\w:\\-\\/\\.#]*\"', \"\", data)\n\n    def serialize(self, pretty: bool = False, with_ns: bool = False) -&gt; str:\n        \"\"\"Return text serialization of XML element.\"\"\"\n        # This copy bypasses serialization side-effects in lxml\n        native = deepcopy(self.__element)\n        data = tostring(\n            native, with_tail=False, pretty_print=pretty, encoding=\"unicode\"\n        )\n        if with_ns:\n            return data\n        # Remove namespaces\n        return self._strip_namespaces(data)\n\n    # Element helpers usable from any context\n\n    @property\n    def document_body(self) -&gt; Element | None:\n        \"\"\"Return the first children of document body if any: 'office:body/*[1]'\"\"\"\n        return self.get_element(\"//office:body/*[1]\")\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        \"\"\"This function should return a beautiful version of the text.\"\"\"\n        return \"\"\n\n    def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n        \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n        name (or all by default).\n\n        Arguments:\n\n            name -- str\n\n        Return: list\n        \"\"\"\n        # FIXME incomplete (and possibly inaccurate)\n        return (\n            self._filtered_elements(\"descendant::*\", text_style=name)\n            + self._filtered_elements(\"descendant::*\", draw_style=name)\n            + self._filtered_elements(\"descendant::*\", draw_text_style=name)\n            + self._filtered_elements(\"descendant::*\", table_style=name)\n            + self._filtered_elements(\"descendant::*\", page_layout=name)\n            + self._filtered_elements(\"descendant::*\", master_page=name)\n            + self._filtered_elements(\"descendant::*\", parent_style=name)\n        )\n\n    # Common attributes\n\n    def _get_inner_text(self, tag: str) -&gt; str | None:\n        element = self.get_element(tag)\n        if element is None:\n            return None\n        return element.text\n\n    def _set_inner_text(self, tag: str, text: str) -&gt; None:\n        element = self.get_element(tag)\n        if element is None:\n            element = Element.from_tag(tag)\n            self.append(element)\n        element.text = text\n\n    # SVG\n\n    @property\n    def svg_title(self) -&gt; str | None:\n        return self._get_inner_text(\"svg:title\")\n\n    @svg_title.setter\n    def svg_title(self, title: str) -&gt; None:\n        self._set_inner_text(\"svg:title\", title)\n\n    @property\n    def svg_description(self) -&gt; str | None:\n        return self._get_inner_text(\"svg:desc\")\n\n    @svg_description.setter\n    def svg_description(self, description: str) -&gt; None:\n        self._set_inner_text(\"svg:desc\", description)\n\n    # Sections\n\n    def get_sections(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the sections that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"text:section\", text_style=style, content=content\n        )\n\n    @property\n    def sections(\n        self,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the sections.\n\n        Return: list of Element\n        \"\"\"\n        return self.get_elements(\"text:section\")\n\n    def get_section(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the section that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:section\", position, content=content\n        )\n\n    # Paragraphs\n\n    def get_paragraphs(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the paragraphs that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Paragraph\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:p\", text_style=style, content=content\n        )\n\n    @property\n    def paragraphs(self) -&gt; list[Element]:\n        \"\"\"Return all the paragraphs.\n\n        Return: list of Paragraph\n        \"\"\"\n        return self.get_elements(\"descendant::text:p\")\n\n    def get_paragraph(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the paragraph that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Paragraph or None if not found\n        \"\"\"\n        return self._filtered_element(\"descendant::text:p\", position, content=content)\n\n    # Span\n\n    def get_spans(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the spans that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Span\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:span\", text_style=style, content=content\n        )\n\n    @property\n    def spans(self) -&gt; list[Element]:\n        \"\"\"Return all the spans.\n\n        Return: list of Span\n        \"\"\"\n        return self.get_elements(\"descendant::text:span\")\n\n    def get_span(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the span that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Span or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:span\", position, content=content\n        )\n\n    # Headers\n\n    def get_headers(\n        self,\n        style: str | None = None,\n        outline_level: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the Headers that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Header\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:h\",\n            text_style=style,\n            outline_level=outline_level,\n            content=content,\n        )\n\n    @property\n    def headers(self) -&gt; list[Element]:\n        \"\"\"Return all the Headers.\n\n        Return: list of Header\n        \"\"\"\n        return self.get_elements(\"descendant::text:h\")\n\n    def get_header(\n        self,\n        position: int = 0,\n        outline_level: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the Header that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Header or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:h\",\n            position,\n            outline_level=outline_level,\n            content=content,\n        )\n\n    # Lists\n\n    def get_lists(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the lists that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of List\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:list\", text_style=style, content=content\n        )\n\n    @property\n    def lists(self) -&gt; list[Element]:\n        \"\"\"Return all the lists.\n\n        Return: list of List\n        \"\"\"\n        return self.get_elements(\"descendant::text:list\")\n\n    def get_list(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the list that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: List or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:list\", position, content=content\n        )\n\n    # Frames\n\n    def get_frames(\n        self,\n        presentation_class: str | None = None,\n        style: str | None = None,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the frames that match the criteria.\n\n        Arguments:\n\n            presentation_class -- str\n\n            style -- str\n\n            title -- str regex\n\n            description -- str regex\n\n            content -- str regex\n\n        Return: list of Frame\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:frame\",\n            presentation_class=presentation_class,\n            draw_style=style,\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    @property\n    def frames(self) -&gt; list[Element]:\n        \"\"\"Return all the frames.\n\n        Return: list of Frame\n        \"\"\"\n        return self.get_elements(\"descendant::draw:frame\")\n\n    def get_frame(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        presentation_class: str | None = None,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the section that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            presentation_class -- str\n\n            title -- str regex\n\n            description -- str regex\n\n            content -- str regex\n\n        Return: Frame or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:frame\",\n            position,\n            draw_name=name,\n            presentation_class=presentation_class,\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    # Images\n\n    def get_images(\n        self,\n        style: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the images matching the criteria.\n\n        Arguments:\n\n            style -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:image\", text_style=style, url=url, content=content\n        )\n\n    @property\n    def images(self) -&gt; list[Element]:\n        \"\"\"Return all the images.\n\n        Return: list of Element\n        \"\"\"\n        return self.get_elements(\"descendant::draw:image\")\n\n    def get_image(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the image matching the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        # The frame is holding the name\n        if name is not None:\n            frame = self._filtered_element(\n                \"descendant::draw:frame\", position, draw_name=name\n            )\n            if frame is None:\n                return None\n            # The name is supposedly unique\n            return frame.get_element(\"draw:image\")\n        return self._filtered_element(\n            \"descendant::draw:image\", position, url=url, content=content\n        )\n\n    # Named Range\n\n    def get_named_ranges(self) -&gt; list[Element]:\n        \"\"\"Return all the tables named ranges.\n\n        Return: list of odf_named_range\n        \"\"\"\n        named_ranges = self.get_elements(\n            \"descendant::table:named-expressions/table:named-range\"\n        )\n        return named_ranges\n\n    def get_named_range(self, name: str) -&gt; Element | None:\n        \"\"\"Return the named range of specified name, or None if not found.\n\n        Arguments:\n\n            name -- str\n\n        Return: NamedRange\n        \"\"\"\n        named_range = self.get_elements(\n            f'descendant::table:named-expressions/table:named-range[@table:name=\"{name}\"][1]'\n        )\n        if named_range:\n            return named_range[0]\n        else:\n            return None\n\n    def append_named_range(self, named_range: Element) -&gt; None:\n        \"\"\"Append the named range to the spreadsheet, replacing existing named\n        range of same name if any.\n\n        Arguments:\n\n            named_range --  NamedRange\n        \"\"\"\n        if self.tag != \"office:spreadsheet\":\n            raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n        named_expressions = self.get_element(\"table:named-expressions\")\n        if not named_expressions:\n            named_expressions = Element.from_tag(\"table:named-expressions\")\n            self.append(named_expressions)\n        # exists ?\n        current = named_expressions.get_element(\n            f'table:named-range[@table:name=\"{named_range.name}\"][1]'  # type:ignore\n        )\n        if current:\n            named_expressions.delete(current)\n        named_expressions.append(named_range)\n\n    def delete_named_range(self, name: str) -&gt; None:\n        \"\"\"Delete the Named Range of specified name from the spreadsheet.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        if self.tag != \"office:spreadsheet\":\n            raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n        named_range = self.get_named_range(name)\n        if not named_range:\n            return\n        named_range.delete()\n        named_expressions = self.get_element(\"table:named-expressions\")\n        if not named_expressions:\n            return\n        element = named_expressions.__element\n        children = list(element.iterchildren())\n        if not children:\n            self.delete(named_expressions)\n\n    # Notes\n\n    def get_notes(\n        self,\n        note_class: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the notes that match the criteria.\n\n        Arguments:\n\n            note_class -- 'footnote' or 'endnote'\n\n            content -- str regex\n\n        Return: list of Note\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:note\", note_class=note_class, content=content\n        )\n\n    def get_note(\n        self,\n        position: int = 0,\n        note_id: str | None = None,\n        note_class: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the note that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            note_id -- str\n\n            note_class -- 'footnote' or 'endnote'\n\n            content -- str regex\n\n        Return: Note or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:note\",\n            position,\n            text_id=note_id,\n            note_class=note_class,\n            content=content,\n        )\n\n    # Annotations\n\n    def get_annotations(\n        self,\n        creator: str | None = None,\n        start_date: datetime | None = None,\n        end_date: datetime | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the annotations that match the criteria.\n\n        Arguments:\n\n            creator -- str\n\n            start_date -- datetime instance\n\n            end_date --  datetime instance\n\n            content -- str regex\n\n        Return: list of Annotation\n        \"\"\"\n        annotations = []\n        for annotation in self._filtered_elements(\n            \"descendant::office:annotation\", content=content\n        ):\n            if creator is not None and creator != annotation.dc_creator:\n                continue\n            date = annotation.date\n            if date is None:\n                continue\n            if start_date is not None and date &lt; start_date:\n                continue\n            if end_date is not None and date &gt;= end_date:\n                continue\n            annotations.append(annotation)\n        return annotations\n\n    def get_annotation(\n        self,\n        position: int = 0,\n        creator: str | None = None,\n        start_date: datetime | None = None,\n        end_date: datetime | None = None,\n        content: str | None = None,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the annotation that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            creator -- str\n\n            start_date -- datetime instance\n\n            end_date -- datetime instance\n\n            content -- str regex\n\n            name -- str\n\n        Return: Annotation or None if not found\n        \"\"\"\n        if name is not None:\n            return self._filtered_element(\n                \"descendant::office:annotation\", 0, office_name=name\n            )\n        annotations = self.get_annotations(\n            creator=creator, start_date=start_date, end_date=end_date, content=content\n        )\n        if not annotations:\n            return None\n        try:\n            return annotations[position]\n        except IndexError:\n            return None\n\n    def get_annotation_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the annotation ends.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::office:annotation-end\")\n\n    def get_annotation_end(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the annotation end that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::office:annotation-end\", position, office_name=name\n        )\n\n    # office:names\n\n    def get_office_names(self) -&gt; list[str]:\n        \"\"\"Return all the used office:name tags values of the element.\n\n        Return: list of unique str\n        \"\"\"\n        name_xpath_query = xpath_compile(\"//@office:name\")\n        response = name_xpath_query(self.__element)\n        if not isinstance(response, list):\n            return []\n        return list({str(name) for name in response if name})\n\n    # Variables\n\n    def get_variable_decls(self) -&gt; Element:\n        \"\"\"Return the container for variable declarations. Created if not\n        found.\n\n        Return: Element\n        \"\"\"\n        variable_decls = self.get_element(\"//text:variable-decls\")\n        if variable_decls is None:\n            body = self.document_body\n            if not body:\n                raise ValueError(\"Empty document.body\")\n            body.insert(Element.from_tag(\"text:variable-decls\"), FIRST_CHILD)\n            variable_decls = body.get_element(\"//text:variable-decls\")\n\n        return variable_decls  # type:ignore\n\n    def get_variable_decl_list(self) -&gt; list[Element]:\n        \"\"\"Return all the variable declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:variable-decl\")\n\n    def get_variable_decl(self, name: str, position: int = 0) -&gt; Element | None:\n        \"\"\"return the variable declaration for the given name.\n\n        Arguments:\n\n            name -- str\n\n            position -- int\n\n        return: Element or none if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:variable-decl\", position, text_name=name\n        )\n\n    def get_variable_sets(self, name: str | None = None) -&gt; list[Element]:\n        \"\"\"Return all the variable sets that match the criteria.\n\n        Arguments:\n\n            name -- str\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:variable-set\", text_name=name)\n\n    def get_variable_set(self, name: str, position: int = -1) -&gt; Element | None:\n        \"\"\"Return the variable set for the given name (last one by default).\n\n        Arguments:\n\n            name -- str\n\n            position -- int\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:variable-set\", position, text_name=name\n        )\n\n    def get_variable_set_value(\n        self,\n        name: str,\n        value_type: str | None = None,\n    ) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n        \"\"\"Return the last value of the given variable name.\n\n        Arguments:\n\n            name -- str\n\n            value_type -- 'boolean', 'currency', 'date', 'float',\n                          'percentage', 'string', 'time' or automatic\n\n        Return: most appropriate Python type\n        \"\"\"\n        variable_set = self.get_variable_set(name)\n        if not variable_set:\n            return None\n        return variable_set.get_value(value_type)  # type: ignore\n\n    # User fields\n\n    def get_user_field_decls(self) -&gt; Element | None:\n        \"\"\"Return the container for user field declarations. Created if not\n        found.\n\n        Return: Element\n        \"\"\"\n        user_field_decls = self.get_element(\"//text:user-field-decls\")\n        if user_field_decls is None:\n            body = self.document_body\n            if not body:\n                raise ValueError(\"Empty document.body\")\n            body.insert(Element.from_tag(\"text:user-field-decls\"), FIRST_CHILD)\n            user_field_decls = body.get_element(\"//text:user-field-decls\")\n\n        return user_field_decls\n\n    def get_user_field_decl_list(self) -&gt; list[Element]:\n        \"\"\"Return all the user field declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:user-field-decl\")\n\n    def get_user_field_decl(self, name: str, position: int = 0) -&gt; Element | None:\n        \"\"\"return the user field declaration for the given name.\n\n        return: Element or none if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:user-field-decl\", position, text_name=name\n        )\n\n    def get_user_field_value(\n        self, name: str, value_type: str | None = None\n    ) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n        \"\"\"Return the value of the given user field name.\n\n        Arguments:\n\n            name -- str\n\n            value_type -- 'boolean', 'currency', 'date', 'float',\n                          'percentage', 'string', 'time' or automatic\n\n        Return: most appropriate Python type\n        \"\"\"\n        user_field_decl = self.get_user_field_decl(name)\n        if user_field_decl is None:\n            return None\n        return user_field_decl.get_value(value_type)  # type: ignore\n\n    # User defined fields\n    # They are fields who should contain a copy of a user defined medtadata\n\n    def get_user_defined_list(self) -&gt; list[Element]:\n        \"\"\"Return all the user defined field declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:user-defined\")\n\n    @property\n    def user_defined_list(self) -&gt; list[Element]:\n        \"\"\"Return all the user defined field declarations.\n\n        Return: list of Element\n        \"\"\"\n        return self.get_user_defined_list()\n\n    def get_user_defined(self, name: str, position: int = 0) -&gt; Element | None:\n        \"\"\"return the user defined declaration for the given name.\n\n        return: Element or none if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:user-defined\", position, text_name=name\n        )\n\n    def get_user_defined_value(\n        self, name: str, value_type: str | None = None\n    ) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n        \"\"\"Return the value of the given user defined field name.\n\n        Arguments:\n\n            name -- str\n\n            value_type -- 'boolean', 'date', 'float',\n                          'string', 'time' or automatic\n\n        Return: most appropriate Python type\n        \"\"\"\n        user_defined = self.get_user_defined(name)\n        if user_defined is None:\n            return None\n        return user_defined.get_value(value_type)  # type: ignore\n\n    # Draw Pages\n\n    def get_draw_pages(\n        self,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw pages that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of DrawPage\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:page\", draw_style=style, content=content\n        )\n\n    def get_draw_page(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw page that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            content -- str regex\n\n        Return: DrawPage or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:page\", position, draw_name=name, content=content\n        )\n\n    # Links\n\n    def get_links(\n        self,\n        name: str | None = None,\n        title: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the links that match the criteria.\n\n        Arguments:\n\n            name -- str\n\n            title -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:a\",\n            office_name=name,\n            office_title=title,\n            url=url,\n            content=content,\n        )\n\n    def get_link(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        title: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the link that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n            title -- str\n\n            url -- str regex\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:a\",\n            position,\n            office_name=name,\n            office_title=title,\n            url=url,\n            content=content,\n        )\n\n    # Bookmarks\n\n    def get_bookmarks(self) -&gt; list[Element]:\n        \"\"\"Return all the bookmarks.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:bookmark\")\n\n    def get_bookmark(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the bookmark that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Bookmark or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:bookmark\", position, text_name=name\n        )\n\n    def get_bookmark_starts(self) -&gt; list[Element]:\n        \"\"\"Return all the bookmark starts.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:bookmark-start\")\n\n    def get_bookmark_start(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the bookmark start that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:bookmark-start\", position, text_name=name\n        )\n\n    def get_bookmark_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the bookmark ends.\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:bookmark-end\")\n\n    def get_bookmark_end(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the bookmark end that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:bookmark-end\", position, text_name=name\n        )\n\n    # Reference marks\n\n    def get_reference_marks_single(self) -&gt; list[Element]:\n        \"\"\"Return all the reference marks. Search only the tags\n        text:reference-mark.\n        Consider using : get_reference_marks()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:reference-mark\")\n\n    def get_reference_mark_single(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark that matches the criteria. Search only the\n        tags text:reference-mark.\n        Consider using : get_reference_mark()\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:reference-mark\", position, text_name=name\n        )\n\n    def get_reference_mark_starts(self) -&gt; list[Element]:\n        \"\"\"Return all the reference mark starts. Search only the tags\n        text:reference-mark-start.\n        Consider using : get_reference_marks()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:reference-mark-start\")\n\n    def get_reference_mark_start(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark start that matches the criteria. Search\n        only the tags text:reference-mark-start.\n        Consider using : get_reference_mark()\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:reference-mark-start\", position, text_name=name\n        )\n\n    def get_reference_mark_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the reference mark ends. Search only the tags\n        text:reference-mark-end.\n        Consider using : get_reference_marks()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:reference-mark-end\")\n\n    def get_reference_mark_end(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark end that matches the criteria. Search only\n        the tags text:reference-mark-end.\n        Consider using : get_reference_marks()\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:reference-mark-end\", position, text_name=name\n        )\n\n    def get_reference_marks(self) -&gt; list[Element]:\n        \"\"\"Return all the reference marks, either single position reference\n        (text:reference-mark) or start of range reference\n        (text:reference-mark-start).\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n        )\n\n    def get_reference_mark(\n        self,\n        position: int = 0,\n        name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the reference mark that match the criteria. Either single\n        position reference mark (text:reference-mark) or start of range\n        reference (text:reference-mark-start).\n\n        Arguments:\n\n            position -- int\n\n            name -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        if name:\n            request = (\n                f\"descendant::text:reference-mark-start\"\n                f'[@text:name=\"{name}\"] '\n                f\"| descendant::text:reference-mark\"\n                f'[@text:name=\"{name}\"]'\n            )\n            return self._filtered_element(request, position=0)\n        request = (\n            \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n        )\n        return self._filtered_element(request, position)\n\n    def get_references(self, name: str | None = None) -&gt; list[Element]:\n        \"\"\"Return all the references (text:reference-ref). If name is\n        provided, returns the references of that name.\n\n        Return: list of Element\n\n        Arguments:\n\n            name -- str or None\n        \"\"\"\n        if name is None:\n            return self._filtered_elements(\"descendant::text:reference-ref\")\n        request = f'descendant::text:reference-ref[@text:ref-name=\"{name}\"]'\n        return self._filtered_elements(request)\n\n    # Shapes elements\n\n    # Groups\n\n    def get_draw_groups(\n        self,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        return self._filtered_elements(\n            \"descendant::draw:g\",\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    def get_draw_group(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        title: str | None = None,\n        description: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        return self._filtered_element(\n            \"descendant::draw:g\",\n            position,\n            draw_name=name,\n            svg_title=title,\n            svg_desc=description,\n            content=content,\n        )\n\n    # Lines\n\n    def get_draw_lines(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw lines that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:line\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_line(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw line that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:line\", position, draw_id=id, content=content\n        )\n\n    # Rectangles\n\n    def get_draw_rectangles(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw rectangles that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:rect\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_rectangle(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw rectangle that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:rect\", position, draw_id=id, content=content\n        )\n\n    # Ellipse\n\n    def get_draw_ellipses(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw ellipses that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:ellipse\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_ellipse(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw ellipse that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:ellipse\", position, draw_id=id, content=content\n        )\n\n    # Connectors\n\n    def get_draw_connectors(\n        self,\n        draw_style: str | None = None,\n        draw_text_style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Element]:\n        \"\"\"Return all the draw connectors that match the criteria.\n\n        Arguments:\n\n            draw_style -- str\n\n            draw_text_style -- str\n\n            content -- str regex\n\n        Return: list of odf_shape\n        \"\"\"\n        return self._filtered_elements(\n            \"descendant::draw:connector\",\n            draw_style=draw_style,\n            draw_text_style=draw_text_style,\n            content=content,\n        )\n\n    def get_draw_connector(\n        self,\n        position: int = 0,\n        id: str | None = None,  # noqa:A002\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the draw connector that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            id -- str\n\n            content -- str regex\n\n        Return: odf_shape or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::draw:connector\", position, draw_id=id, content=content\n        )\n\n    def get_orphan_draw_connectors(self) -&gt; list[Element]:\n        \"\"\"Return a list of connectors which don't have any shape connected\n        to them.\n        \"\"\"\n        connectors = []\n        for connector in self.get_draw_connectors():\n            start_shape = connector.get_attribute(\"draw:start-shape\")\n            end_shape = connector.get_attribute(\"draw:end-shape\")\n            if start_shape is None and end_shape is None:\n                connectors.append(connector)\n        return connectors\n\n    # Tracked changes and text change\n\n    def get_tracked_changes(self) -&gt; Element | None:\n        \"\"\"Return the tracked-changes part in the text body.\n\n        Return: Element or None\n        \"\"\"\n        return self.get_element(\"//text:tracked-changes\")\n\n    @property\n    def tracked_changes(self) -&gt; Element | None:\n        \"\"\"Return the tracked-changes part in the text body.\n\n        Return: Element or None\n        \"\"\"\n        return self.get_tracked_changes()\n\n    def get_changes_ids(self) -&gt; list[Element | EText]:\n        \"\"\"Return a list of ids that refers to a change region in the tracked\n        changes list.\n        \"\"\"\n        # Insertion changes\n        xpath_query = \"descendant::text:change-start/@text:change-id\"\n        # Deletion changes\n        xpath_query += \" | descendant::text:change/@text:change-id\"\n        return self.xpath(xpath_query)\n\n    def get_text_change_deletions(self) -&gt; list[Element]:\n        \"\"\"Return all the text changes of deletion kind: the tags text:change.\n        Consider using : get_text_changes()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:text:change\")\n\n    def get_text_change_deletion(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change of deletion kind that matches the criteria.\n        Search only for the tags text:change.\n        Consider using : get_text_change()\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:change\", position, change_id=idx\n        )\n\n    def get_text_change_starts(self) -&gt; list[Element]:\n        \"\"\"Return all the text change-start. Search only for the tags\n        text:change-start.\n        Consider using : get_text_changes()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:change-start\")\n\n    def get_text_change_start(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change-start that matches the criteria. Search\n        only the tags text:change-start.\n        Consider using : get_text_change()\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:change-start\", position, change_id=idx\n        )\n\n    def get_text_change_ends(self) -&gt; list[Element]:\n        \"\"\"Return all the text change-end. Search only the tags\n        text:change-end.\n        Consider using : get_text_changes()\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"descendant::text:change-end\")\n\n    def get_text_change_end(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change-end that matches the criteria. Search only\n        the tags text:change-end.\n        Consider using : get_text_change()\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"descendant::text:change-end\", position, change_id=idx\n        )\n\n    def get_text_changes(self) -&gt; list[Element]:\n        \"\"\"Return all the text changes, either single deletion\n        (text:change) or start of range of changes (text:change-start).\n\n        Return: list of Element\n        \"\"\"\n        request = \"descendant::text:change-start | descendant::text:change\"\n        return self._filtered_elements(request)\n\n    @property\n    def text_changes(self) -&gt; list[Element]:\n        \"\"\"Return all the text changes, either single deletion\n        (text:change) or start of range of changes (text:change-start).\n\n        Return: list of Element\n        \"\"\"\n        return self.get_text_changes()\n\n    def get_text_change(\n        self,\n        position: int = 0,\n        idx: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the text change that matches the criteria. Either single\n        deletion (text:change) or start of range of changes (text:change-start).\n        position : index of the element to retrieve if several matches, default\n        is 0.\n        idx : change-id of the element.\n\n        Arguments:\n\n            position -- int\n\n            idx -- str\n\n        Return: Element or None if not found\n        \"\"\"\n        if idx:\n            request = (\n                f'descendant::text:change-start[@text:change-id=\"{idx}\"] '\n                f'| descendant::text:change[@text:change-id=\"{idx}\"]'\n            )\n            return self._filtered_element(request, 0)\n        request = \"descendant::text:change-start | descendant::text:change\"\n        return self._filtered_element(request, position)\n\n    # Table Of Content\n\n    def get_tocs(self) -&gt; list[Element]:\n        \"\"\"Return all the tables of contents.\n\n        Return: list of odf_toc\n        \"\"\"\n        return self.get_elements(\"text:table-of-content\")\n\n    @property\n    def tocs(self) -&gt; list[Element]:\n        \"\"\"Return all the tables of contents.\n\n        Return: list of odf_toc\n        \"\"\"\n        return self.get_elements(\"text:table-of-content\")\n\n    def get_toc(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the table of contents that matches the criteria.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: odf_toc or None if not found\n        \"\"\"\n        return self._filtered_element(\n            \"text:table-of-content\", position, content=content\n        )\n\n    @property\n    def toc(self) -&gt; Element | None:\n        \"\"\"Return the first table of contents.\n\n        Return: odf_toc or None if not found\n        \"\"\"\n        return self.get_toc()\n\n    # Styles\n\n    @staticmethod\n    def _get_style_tagname(family: str | None, is_default: bool = False) -&gt; str:\n        \"\"\"Widely match possible tag names given the family (or not).\"\"\"\n        if not family:\n            tagname = \"(style:default-style|*[@style:name]|draw:fill-image|draw:marker)\"\n        elif is_default:\n            # Default style\n            tagname = \"style:default-style\"\n        else:\n            tagname = _family_style_tagname(family)\n            # if famattr:\n            #    # Include family default style\n            #    tagname = '(%s|style:default-style)' % tagname\n            if family in FAMILY_ODF_STD:\n                # Include family default style\n                tagname = f\"({tagname}|style:default-style)\"\n        return tagname\n\n    def get_styles(self, family: str | None = None) -&gt; list[Element]:\n        # Both common and default styles\n        tagname = self._get_style_tagname(family)\n        return self._filtered_elements(tagname, family=family)\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Element | None = None,\n        display_name: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the style uniquely identified by the family/name pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is not the internal name but the name you gave in the\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                      'number'\n\n            name_or_element -- str or Style\n\n            display_name -- str\n\n        Return: odf_style or None if not found\n        \"\"\"\n        if isinstance(name_or_element, Element):\n            name = self.get_attribute(\"style:name\")\n            if name is not None:\n                return name_or_element\n            else:\n                raise ValueError(f\"Not a odf_style ? {name_or_element!r}\")\n        style_name = name_or_element\n        is_default = not (style_name or display_name)\n        tagname = self._get_style_tagname(family, is_default=is_default)\n        # famattr became None if no \"style:family\" attribute\n        if family:\n            return self._filtered_element(\n                tagname,\n                0,\n                style_name=style_name,\n                display_name=display_name,\n                family=family,\n            )\n        else:\n            return self._filtered_element(\n                tagname,\n                0,\n                draw_name=style_name or display_name,\n                family=family,\n            )\n\n    def _filtered_element(\n        self,\n        query_string: str,\n        position: int,\n        **kwargs: Any,\n    ) -&gt; Element | None:\n        results = self._filtered_elements(query_string, **kwargs)\n        try:\n            return results[position]\n        except IndexError:\n            return None\n\n    def _filtered_elements(\n        self,\n        query_string: str,\n        content: str | None = None,\n        url: str | None = None,\n        svg_title: str | None = None,\n        svg_desc: str | None = None,\n        dc_creator: str | None = None,\n        dc_date: datetime | None = None,\n        **kwargs: Any,\n    ) -&gt; list[Element]:\n        query = make_xpath_query(query_string, **kwargs)\n        elements = self.get_elements(query)\n        # Filter the elements with the regex (TODO use XPath)\n        if content is not None:\n            elements = [element for element in elements if element.match(content)]\n        if url is not None:\n            filtered = []\n            for element in elements:\n                url_attr = element.get_attribute(\"xlink:href\")\n                if isinstance(url_attr, str) and search(url, url_attr) is not None:\n                    filtered.append(element)\n            elements = filtered\n        if dc_date is None:\n            dt_dc_date = None\n        else:\n            dt_dc_date = DateTime.encode(dc_date)\n        for variable, childname in [\n            (svg_title, \"svg:title\"),\n            (svg_desc, \"svg:desc\"),\n            (dc_creator, \"descendant::dc:creator\"),\n            (dt_dc_date, \"descendant::dc:date\"),\n        ]:\n            if not variable:\n                continue\n            filtered = []\n            for element in elements:\n                child = element.get_element(childname)\n                if child and child.match(variable):\n                    filtered.append(element)\n            elements = filtered\n        return elements\n</code></pre>"},{"location":"reference.html#odfdo.Element.document_body","title":"<code>document_body: Element | None</code>  <code>property</code>","text":"<p>Return the first children of document body if any: \u2018office:body/*[1]\u2019</p>"},{"location":"reference.html#odfdo.Element.frames","title":"<code>frames: list[Element]</code>  <code>property</code>","text":"<p>Return all the frames.</p> <p>Return: list of Frame</p>"},{"location":"reference.html#odfdo.Element.headers","title":"<code>headers: list[Element]</code>  <code>property</code>","text":"<p>Return all the Headers.</p> <p>Return: list of Header</p>"},{"location":"reference.html#odfdo.Element.images","title":"<code>images: list[Element]</code>  <code>property</code>","text":"<p>Return all the images.</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.lists","title":"<code>lists: list[Element]</code>  <code>property</code>","text":"<p>Return all the lists.</p> <p>Return: list of List</p>"},{"location":"reference.html#odfdo.Element.paragraphs","title":"<code>paragraphs: list[Element]</code>  <code>property</code>","text":"<p>Return all the paragraphs.</p> <p>Return: list of Paragraph</p>"},{"location":"reference.html#odfdo.Element.sections","title":"<code>sections: list[Element]</code>  <code>property</code>","text":"<p>Return all the sections.</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.spans","title":"<code>spans: list[Element]</code>  <code>property</code>","text":"<p>Return all the spans.</p> <p>Return: list of Span</p>"},{"location":"reference.html#odfdo.Element.tag","title":"<code>tag: str</code>  <code>property</code> <code>writable</code>","text":"<p>Get/set the underlying xml tag with the given qualified name.</p> <p>Warning: direct change of tag does not change the element class.</p> <p>Arguments:</p> <pre><code>qname -- str (e.g. \"text:span\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.tail","title":"<code>tail: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the text immediately following the element.</p>"},{"location":"reference.html#odfdo.Element.text","title":"<code>text: str</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the text content of the element.</p>"},{"location":"reference.html#odfdo.Element.text_changes","title":"<code>text_changes: list[Element]</code>  <code>property</code>","text":"<p>Return all the text changes, either single deletion (text:change) or start of range of changes (text:change-start).</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.text_content","title":"<code>text_content: str</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the text of the embedded paragraph, including embeded annotations, cells\u2026</p> <p>Set create a paragraph if missing</p>"},{"location":"reference.html#odfdo.Element.toc","title":"<code>toc: Element | None</code>  <code>property</code>","text":"<p>Return the first table of contents.</p> <p>Return: odf_toc or None if not found</p>"},{"location":"reference.html#odfdo.Element.tocs","title":"<code>tocs: list[Element]</code>  <code>property</code>","text":"<p>Return all the tables of contents.</p> <p>Return: list of odf_toc</p>"},{"location":"reference.html#odfdo.Element.tracked_changes","title":"<code>tracked_changes: Element | None</code>  <code>property</code>","text":"<p>Return the tracked-changes part in the text body.</p> <p>Return: Element or None</p>"},{"location":"reference.html#odfdo.Element.user_defined_list","title":"<code>user_defined_list: list[Element]</code>  <code>property</code>","text":"<p>Return all the user defined field declarations.</p> <p>Return: list of Element</p>"},{"location":"reference.html#odfdo.Element.append","title":"<code>append(str_or_element)</code>","text":"<p>Insert element or text in the last position.</p> Source code in <code>odfdo/element.py</code> <pre><code>def append(self, str_or_element: str | Element) -&gt; None:\n    \"\"\"Insert element or text in the last position.\"\"\"\n    current = self.__element\n    if isinstance(str_or_element, str):\n        # Has children ?\n        children = list(current.iterchildren())\n        if children:\n            # Append to tail of the last child\n            last_child = children[-1]\n            text = last_child.tail\n            text = text if text is not None else \"\"\n            text += str_or_element\n            last_child.tail = text\n        else:\n            # Append to text of the element\n            text = current.text\n            text = text if text is not None else \"\"\n            text += str_or_element\n            current.text = text\n    elif isinstance(str_or_element, Element):\n        current.append(str_or_element.__element)\n    else:\n        raise TypeError(f'Element or string expected, not \"{type(str_or_element)}\"')\n</code></pre>"},{"location":"reference.html#odfdo.Element.append_named_range","title":"<code>append_named_range(named_range)</code>","text":"<p>Append the named range to the spreadsheet, replacing existing named range of same name if any.</p> <p>Arguments:</p> <pre><code>named_range --  NamedRange\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def append_named_range(self, named_range: Element) -&gt; None:\n    \"\"\"Append the named range to the spreadsheet, replacing existing named\n    range of same name if any.\n\n    Arguments:\n\n        named_range --  NamedRange\n    \"\"\"\n    if self.tag != \"office:spreadsheet\":\n        raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n    named_expressions = self.get_element(\"table:named-expressions\")\n    if not named_expressions:\n        named_expressions = Element.from_tag(\"table:named-expressions\")\n        self.append(named_expressions)\n    # exists ?\n    current = named_expressions.get_element(\n        f'table:named-range[@table:name=\"{named_range.name}\"][1]'  # type:ignore\n    )\n    if current:\n        named_expressions.delete(current)\n    named_expressions.append(named_range)\n</code></pre>"},{"location":"reference.html#odfdo.Element.clear","title":"<code>clear()</code>","text":"<p>Remove text, children and attributes from the element.</p> Source code in <code>odfdo/element.py</code> <pre><code>def clear(self) -&gt; None:\n    \"\"\"Remove text, children and attributes from the element.\"\"\"\n    self.__element.clear()\n    if hasattr(self, \"_tmap\"):\n        self._tmap: list[int] = []\n    if hasattr(self, \"_cmap\"):\n        self._cmap: list[int] = []\n    if hasattr(self, \"_rmap\"):\n        self._rmap: list[int] = []\n    if hasattr(self, \"_indexes\"):\n        remember = False\n        if \"_rmap\" in self._indexes:\n            remember = True\n        self._indexes: dict[str, dict] = {}\n        self._indexes[\"_cmap\"] = {}\n        self._indexes[\"_tmap\"] = {}\n        if remember:\n            self._indexes[\"_rmap\"] = {}\n</code></pre>"},{"location":"reference.html#odfdo.Element.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>if keep_tail is True (default), the tail text is not erased.</p> <p>Arguments:</p> <pre><code>child -- Element\n\nkeep_tail -- boolean (default to True), True for most usages.\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    if keep_tail is True (default), the tail text is not erased.\n\n    Arguments:\n\n        child -- Element\n\n        keep_tail -- boolean (default to True), True for most usages.\n    \"\"\"\n    if child is None:\n        parent = self.parent\n        if parent is None:\n            raise ValueError(f\"Can't delete the root element\\n{self.serialize()}\")\n        child = self\n    else:\n        parent = self\n    if keep_tail and child.__element.tail is not None:\n        current = child.__element\n        tail = str(current.tail)\n        current.tail = None\n        prev = current.getprevious()\n        if prev is not None:\n            if prev.tail is None:\n                prev.tail = tail\n            else:\n                prev.tail += tail\n        else:\n            if parent.__element.text is None:\n                parent.__element.text = tail\n            else:\n                parent.__element.text += tail\n    parent.__element.remove(child.__element)\n</code></pre>"},{"location":"reference.html#odfdo.Element.delete_named_range","title":"<code>delete_named_range(name)</code>","text":"<p>Delete the Named Range of specified name from the spreadsheet.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def delete_named_range(self, name: str) -&gt; None:\n    \"\"\"Delete the Named Range of specified name from the spreadsheet.\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    if self.tag != \"office:spreadsheet\":\n        raise ValueError(f\"Element is no 'office:spreadsheet' : {self.tag}\")\n    named_range = self.get_named_range(name)\n    if not named_range:\n        return\n    named_range.delete()\n    named_expressions = self.get_element(\"table:named-expressions\")\n    if not named_expressions:\n        return\n    element = named_expressions.__element\n    children = list(element.iterchildren())\n    if not children:\n        self.delete(named_expressions)\n</code></pre>"},{"location":"reference.html#odfdo.Element.elements_repeated_sequence","title":"<code>elements_repeated_sequence(xpath_instance, name)</code>","text":"<p>Utility method for table module.</p> Source code in <code>odfdo/element.py</code> <pre><code>def elements_repeated_sequence(\n    self,\n    xpath_instance: XPath,\n    name: str,\n) -&gt; list[tuple[int, int]]:\n    \"\"\"Utility method for table module.\"\"\"\n    lxml_tag = _get_lxml_tag_or_name(name)\n    element = self.__element\n    sub_elements = xpath_instance(element)\n    if not isinstance(sub_elements, list):\n        raise TypeError(\"Bad XPath result.\")\n    result: list[tuple[int, int]] = []\n    idx = -1\n    for sub_element in sub_elements:\n        if not isinstance(sub_element, _Element):\n            continue\n        idx += 1\n        value = sub_element.get(lxml_tag)\n        if value is None:\n            result.append((idx, 1))\n            continue\n        try:\n            int_value = int(value)\n        except ValueError:\n            int_value = 1\n        result.append((idx, max(int_value, 1)))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Element.extend","title":"<code>extend(odf_elements)</code>","text":"<p>Fast append elements at the end of ourself using extend.</p> Source code in <code>odfdo/element.py</code> <pre><code>def extend(self, odf_elements: Iterable[Element]) -&gt; None:\n    \"\"\"Fast append elements at the end of ourself using extend.\"\"\"\n    if odf_elements:\n        current = self.__element\n        elements = [element.__element for element in odf_elements]\n        current.extend(elements)\n</code></pre>"},{"location":"reference.html#odfdo.Element.from_tag","title":"<code>from_tag(tag_or_elem)</code>  <code>classmethod</code>","text":"<p>Element class and subclass factory.</p> <p>Turn an lxml Element or ODF string tag into an ODF XML Element of the relevant class.</p> <p>Arguments:</p> <pre><code>tag_or_elem -- ODF str tag or lxml.Element\n</code></pre> <p>Return: Element (or subclass) instance</p> Source code in <code>odfdo/element.py</code> <pre><code>@classmethod\ndef from_tag(cls, tag_or_elem: str | _Element) -&gt; Element:\n    \"\"\"Element class and subclass factory.\n\n    Turn an lxml Element or ODF string tag into an ODF XML Element\n    of the relevant class.\n\n    Arguments:\n\n        tag_or_elem -- ODF str tag or lxml.Element\n\n    Return: Element (or subclass) instance\n    \"\"\"\n    if isinstance(tag_or_elem, str):\n        # assume the argument is a prefix:name tag\n        elem = cls.make_etree_element(tag_or_elem)\n    else:\n        elem = tag_or_elem\n    klass = _class_registry.get(elem.tag, cls)\n    return klass(tag_or_elem=elem)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotation","title":"<code>get_annotation(position=0, creator=None, start_date=None, end_date=None, content=None, name=None)</code>","text":"<p>Return the annotation that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncreator -- str\n\nstart_date -- datetime instance\n\nend_date -- datetime instance\n\ncontent -- str regex\n\nname -- str\n</code></pre> <p>Return: Annotation or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotation(\n    self,\n    position: int = 0,\n    creator: str | None = None,\n    start_date: datetime | None = None,\n    end_date: datetime | None = None,\n    content: str | None = None,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the annotation that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        creator -- str\n\n        start_date -- datetime instance\n\n        end_date -- datetime instance\n\n        content -- str regex\n\n        name -- str\n\n    Return: Annotation or None if not found\n    \"\"\"\n    if name is not None:\n        return self._filtered_element(\n            \"descendant::office:annotation\", 0, office_name=name\n        )\n    annotations = self.get_annotations(\n        creator=creator, start_date=start_date, end_date=end_date, content=content\n    )\n    if not annotations:\n        return None\n    try:\n        return annotations[position]\n    except IndexError:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotation_end","title":"<code>get_annotation_end(position=0, name=None)</code>","text":"<p>Return the annotation end that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotation_end(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the annotation end that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::office:annotation-end\", position, office_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotation_ends","title":"<code>get_annotation_ends()</code>","text":"<p>Return all the annotation ends.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotation_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the annotation ends.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::office:annotation-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_annotations","title":"<code>get_annotations(creator=None, start_date=None, end_date=None, content=None)</code>","text":"<p>Return all the annotations that match the criteria.</p> <p>Arguments:</p> <pre><code>creator -- str\n\nstart_date -- datetime instance\n\nend_date --  datetime instance\n\ncontent -- str regex\n</code></pre> <p>Return: list of Annotation</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_annotations(\n    self,\n    creator: str | None = None,\n    start_date: datetime | None = None,\n    end_date: datetime | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the annotations that match the criteria.\n\n    Arguments:\n\n        creator -- str\n\n        start_date -- datetime instance\n\n        end_date --  datetime instance\n\n        content -- str regex\n\n    Return: list of Annotation\n    \"\"\"\n    annotations = []\n    for annotation in self._filtered_elements(\n        \"descendant::office:annotation\", content=content\n    ):\n        if creator is not None and creator != annotation.dc_creator:\n            continue\n        date = annotation.date\n        if date is None:\n            continue\n        if start_date is not None and date &lt; start_date:\n            continue\n        if end_date is not None and date &gt;= end_date:\n            continue\n        annotations.append(annotation)\n    return annotations\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_attribute","title":"<code>get_attribute(name)</code>","text":"<p>Return the attribute value as type str | bool | None.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_attribute(self, name: str) -&gt; str | bool | None:\n    \"\"\"Return the attribute value as type str | bool | None.\"\"\"\n    element = self.__element\n    lxml_tag = _get_lxml_tag_or_name(name)\n    value = element.get(lxml_tag)\n    if value is None:\n        return None\n    elif value in (\"true\", \"false\"):\n        return Boolean.decode(value)\n    return str(value)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_attribute_integer","title":"<code>get_attribute_integer(name)</code>","text":"<p>Return either the attribute as type int, or None.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_attribute_integer(self, name: str) -&gt; int | None:\n    \"\"\"Return either the attribute as type int, or None.\"\"\"\n    element = self.__element\n    lxml_tag = _get_lxml_tag_or_name(name)\n    value = element.get(lxml_tag)\n    if value is None:\n        return None\n    try:\n        return int(value)\n    except ValueError:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_attribute_string","title":"<code>get_attribute_string(name)</code>","text":"<p>Return either the attribute as type str, or None.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_attribute_string(self, name: str) -&gt; str | None:\n    \"\"\"Return either the attribute as type str, or None.\"\"\"\n    element = self.__element\n    lxml_tag = _get_lxml_tag_or_name(name)\n    value = element.get(lxml_tag)\n    if value is None:\n        return None\n    return str(value)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_between","title":"<code>get_between(tag1, tag2, as_text=False, clean=True, no_header=True)</code>","text":"<p>Returns elements between tag1 and tag2, tag1 and tag2 shall be unique and having an id attribute. (WARN: buggy if tag1/tag2 defines a malformed odf xml.) If as_text is True: returns the text content. If clean is True: suppress unwanted tags (deletions marks, \u2026) If no_header is True: existing text:h are changed in text:p By default: returns a list of Element, cleaned and without headers.</p> <p>Implementation and standard retrictions: Only text:h and text:p sould be \u2018cut\u2019 by an insert tag, so inner parts of insert tags are:</p> <pre><code>- any text:h, text:p or sub tag of these\n\n- some text, part of a parent text:h or text:p\n</code></pre> <p>Arguments:</p> <pre><code>tag1 -- Element\n\ntag2 -- Element\n\nas_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list of odf_paragraph or odf_header</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_between(\n    self,\n    tag1: Element,\n    tag2: Element,\n    as_text: bool = False,\n    clean: bool = True,\n    no_header: bool = True,\n) -&gt; list | Element | str:\n    \"\"\"Returns elements between tag1 and tag2, tag1 and tag2 shall\n    be unique and having an id attribute.\n    (WARN: buggy if tag1/tag2 defines a malformed odf xml.)\n    If as_text is True: returns the text content.\n    If clean is True: suppress unwanted tags (deletions marks, ...)\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of Element, cleaned and without headers.\n\n    Implementation and standard retrictions:\n    Only text:h and text:p sould be 'cut' by an insert tag, so inner parts\n    of insert tags are:\n\n        - any text:h, text:p or sub tag of these\n\n        - some text, part of a parent text:h or text:p\n\n    Arguments:\n\n        tag1 -- Element\n\n        tag2 -- Element\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list of odf_paragraph or odf_header\n    \"\"\"\n    inner = self._get_between_base(tag1, tag2)\n\n    if clean:\n        clean_tags = (\n            \"text:change\",\n            \"text:change-start\",\n            \"text:change-end\",\n            \"text:reference-mark\",\n            \"text:reference-mark-start\",\n            \"text:reference-mark-end\",\n        )\n        request_self = \" | \".join([f\"self::{tag}\" for tag in clean_tags])\n        inner = [e for e in inner if not e.xpath(request_self)]\n        request = \" | \".join([f\"descendant::{tag}\" for tag in clean_tags])\n        for element in inner:\n            to_del = element.xpath(request)\n            for elem in to_del:\n                if isinstance(elem, Element):\n                    element.delete(elem)\n    if no_header:  # crude replace t:h by t:p\n        new_inner = []\n        for element in inner:\n            if element.tag == \"text:h\":\n                children = element.children\n                text = element.__element.text\n                para = Element.from_tag(\"text:p\")\n                para.text = text or \"\"\n                for c in children:\n                    para.append(c)\n                new_inner.append(para)\n            else:\n                new_inner.append(element)\n        inner = new_inner\n    if as_text:\n        return \"\\n\".join([e.get_formatted_text() for e in inner])\n    else:\n        return inner\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark","title":"<code>get_bookmark(position=0, name=None)</code>","text":"<p>Return the bookmark that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Bookmark or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the bookmark that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Bookmark or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:bookmark\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_end","title":"<code>get_bookmark_end(position=0, name=None)</code>","text":"<p>Return the bookmark end that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_end(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the bookmark end that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:bookmark-end\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_ends","title":"<code>get_bookmark_ends()</code>","text":"<p>Return all the bookmark ends.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the bookmark ends.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:bookmark-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_start","title":"<code>get_bookmark_start(position=0, name=None)</code>","text":"<p>Return the bookmark start that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_start(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the bookmark start that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:bookmark-start\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmark_starts","title":"<code>get_bookmark_starts()</code>","text":"<p>Return all the bookmark starts.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmark_starts(self) -&gt; list[Element]:\n    \"\"\"Return all the bookmark starts.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:bookmark-start\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_bookmarks","title":"<code>get_bookmarks()</code>","text":"<p>Return all the bookmarks.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_bookmarks(self) -&gt; list[Element]:\n    \"\"\"Return all the bookmarks.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:bookmark\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_changes_ids","title":"<code>get_changes_ids()</code>","text":"<p>Return a list of ids that refers to a change region in the tracked changes list.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_changes_ids(self) -&gt; list[Element | EText]:\n    \"\"\"Return a list of ids that refers to a change region in the tracked\n    changes list.\n    \"\"\"\n    # Insertion changes\n    xpath_query = \"descendant::text:change-start/@text:change-id\"\n    # Deletion changes\n    xpath_query += \" | descendant::text:change/@text:change-id\"\n    return self.xpath(xpath_query)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_connector","title":"<code>get_draw_connector(position=0, id=None, content=None)</code>","text":"<p>Return the draw connector that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_connector(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw connector that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:connector\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_connectors","title":"<code>get_draw_connectors(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw connectors that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_connectors(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw connectors that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:connector\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_ellipse","title":"<code>get_draw_ellipse(position=0, id=None, content=None)</code>","text":"<p>Return the draw ellipse that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_ellipse(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw ellipse that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:ellipse\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_ellipses","title":"<code>get_draw_ellipses(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw ellipses that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_ellipses(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw ellipses that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:ellipse\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_line","title":"<code>get_draw_line(position=0, id=None, content=None)</code>","text":"<p>Return the draw line that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_line(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw line that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:line\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_lines","title":"<code>get_draw_lines(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw lines that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_lines(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw lines that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:line\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_page","title":"<code>get_draw_page(position=0, name=None, content=None)</code>","text":"<p>Return the draw page that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\ncontent -- str regex\n</code></pre> <p>Return: DrawPage or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_page(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw page that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        content -- str regex\n\n    Return: DrawPage or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:page\", position, draw_name=name, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_pages","title":"<code>get_draw_pages(style=None, content=None)</code>","text":"<p>Return all the draw pages that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of DrawPage</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_pages(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw pages that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of DrawPage\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:page\", draw_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_rectangle","title":"<code>get_draw_rectangle(position=0, id=None, content=None)</code>","text":"<p>Return the draw rectangle that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nid -- str\n\ncontent -- str regex\n</code></pre> <p>Return: odf_shape or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_rectangle(\n    self,\n    position: int = 0,\n    id: str | None = None,  # noqa:A002\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the draw rectangle that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        id -- str\n\n        content -- str regex\n\n    Return: odf_shape or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:rect\", position, draw_id=id, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_draw_rectangles","title":"<code>get_draw_rectangles(draw_style=None, draw_text_style=None, content=None)</code>","text":"<p>Return all the draw rectangles that match the criteria.</p> <p>Arguments:</p> <pre><code>draw_style -- str\n\ndraw_text_style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of odf_shape</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_draw_rectangles(\n    self,\n    draw_style: str | None = None,\n    draw_text_style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the draw rectangles that match the criteria.\n\n    Arguments:\n\n        draw_style -- str\n\n        draw_text_style -- str\n\n        content -- str regex\n\n    Return: list of odf_shape\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:rect\",\n        draw_style=draw_style,\n        draw_text_style=draw_text_style,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_formatted_text","title":"<code>get_formatted_text(context=None)</code>","text":"<p>This function should return a beautiful version of the text.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_formatted_text(self, context: dict | None = None) -&gt; str:\n    \"\"\"This function should return a beautiful version of the text.\"\"\"\n    return \"\"\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_frame","title":"<code>get_frame(position=0, name=None, presentation_class=None, title=None, description=None, content=None)</code>","text":"<p>Return the section that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\npresentation_class -- str\n\ntitle -- str regex\n\ndescription -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: Frame or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_frame(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    presentation_class: str | None = None,\n    title: str | None = None,\n    description: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the section that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        presentation_class -- str\n\n        title -- str regex\n\n        description -- str regex\n\n        content -- str regex\n\n    Return: Frame or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::draw:frame\",\n        position,\n        draw_name=name,\n        presentation_class=presentation_class,\n        svg_title=title,\n        svg_desc=description,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_frames","title":"<code>get_frames(presentation_class=None, style=None, title=None, description=None, content=None)</code>","text":"<p>Return all the frames that match the criteria.</p> <p>Arguments:</p> <pre><code>presentation_class -- str\n\nstyle -- str\n\ntitle -- str regex\n\ndescription -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: list of Frame</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_frames(\n    self,\n    presentation_class: str | None = None,\n    style: str | None = None,\n    title: str | None = None,\n    description: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the frames that match the criteria.\n\n    Arguments:\n\n        presentation_class -- str\n\n        style -- str\n\n        title -- str regex\n\n        description -- str regex\n\n        content -- str regex\n\n    Return: list of Frame\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:frame\",\n        presentation_class=presentation_class,\n        draw_style=style,\n        svg_title=title,\n        svg_desc=description,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_header","title":"<code>get_header(position=0, outline_level=None, content=None)</code>","text":"<p>Return the Header that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Header or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_header(\n    self,\n    position: int = 0,\n    outline_level: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the Header that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Header or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:h\",\n        position,\n        outline_level=outline_level,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_headers","title":"<code>get_headers(style=None, outline_level=None, content=None)</code>","text":"<p>Return all the Headers that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Header</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_headers(\n    self,\n    style: str | None = None,\n    outline_level: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the Headers that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Header\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:h\",\n        text_style=style,\n        outline_level=outline_level,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_image","title":"<code>get_image(position=0, name=None, url=None, content=None)</code>","text":"<p>Return the image matching the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_image(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the image matching the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    # The frame is holding the name\n    if name is not None:\n        frame = self._filtered_element(\n            \"descendant::draw:frame\", position, draw_name=name\n        )\n        if frame is None:\n            return None\n        # The name is supposedly unique\n        return frame.get_element(\"draw:image\")\n    return self._filtered_element(\n        \"descendant::draw:image\", position, url=url, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_images","title":"<code>get_images(style=None, url=None, content=None)</code>","text":"<p>Return all the images matching the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_images(\n    self,\n    style: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the images matching the criteria.\n\n    Arguments:\n\n        style -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::draw:image\", text_style=style, url=url, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_link","title":"<code>get_link(position=0, name=None, title=None, url=None, content=None)</code>","text":"<p>Return the link that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n\ntitle -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_link(\n    self,\n    position: int = 0,\n    name: str | None = None,\n    title: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the link that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n        title -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:a\",\n        position,\n        office_name=name,\n        office_title=title,\n        url=url,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_links","title":"<code>get_links(name=None, title=None, url=None, content=None)</code>","text":"<p>Return all the links that match the criteria.</p> <p>Arguments:</p> <pre><code>name -- str\n\ntitle -- str\n\nurl -- str regex\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_links(\n    self,\n    name: str | None = None,\n    title: str | None = None,\n    url: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the links that match the criteria.\n\n    Arguments:\n\n        name -- str\n\n        title -- str\n\n        url -- str regex\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:a\",\n        office_name=name,\n        office_title=title,\n        url=url,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_list","title":"<code>get_list(position=0, content=None)</code>","text":"<p>Return the list that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: List or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_list(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the list that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: List or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:list\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_lists","title":"<code>get_lists(style=None, content=None)</code>","text":"<p>Return all the lists that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of List</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_lists(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the lists that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of List\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:list\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_named_range","title":"<code>get_named_range(name)</code>","text":"<p>Return the named range of specified name, or None if not found.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: NamedRange</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_named_range(self, name: str) -&gt; Element | None:\n    \"\"\"Return the named range of specified name, or None if not found.\n\n    Arguments:\n\n        name -- str\n\n    Return: NamedRange\n    \"\"\"\n    named_range = self.get_elements(\n        f'descendant::table:named-expressions/table:named-range[@table:name=\"{name}\"][1]'\n    )\n    if named_range:\n        return named_range[0]\n    else:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_named_ranges","title":"<code>get_named_ranges()</code>","text":"<p>Return all the tables named ranges.</p> <p>Return: list of odf_named_range</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_named_ranges(self) -&gt; list[Element]:\n    \"\"\"Return all the tables named ranges.\n\n    Return: list of odf_named_range\n    \"\"\"\n    named_ranges = self.get_elements(\n        \"descendant::table:named-expressions/table:named-range\"\n    )\n    return named_ranges\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_note","title":"<code>get_note(position=0, note_id=None, note_class=None, content=None)</code>","text":"<p>Return the note that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\nnote_id -- str\n\nnote_class -- 'footnote' or 'endnote'\n\ncontent -- str regex\n</code></pre> <p>Return: Note or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_note(\n    self,\n    position: int = 0,\n    note_id: str | None = None,\n    note_class: str | None = None,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the note that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        note_id -- str\n\n        note_class -- 'footnote' or 'endnote'\n\n        content -- str regex\n\n    Return: Note or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:note\",\n        position,\n        text_id=note_id,\n        note_class=note_class,\n        content=content,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_notes","title":"<code>get_notes(note_class=None, content=None)</code>","text":"<p>Return all the notes that match the criteria.</p> <p>Arguments:</p> <pre><code>note_class -- 'footnote' or 'endnote'\n\ncontent -- str regex\n</code></pre> <p>Return: list of Note</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_notes(\n    self,\n    note_class: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the notes that match the criteria.\n\n    Arguments:\n\n        note_class -- 'footnote' or 'endnote'\n\n        content -- str regex\n\n    Return: list of Note\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:note\", note_class=note_class, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_office_names","title":"<code>get_office_names()</code>","text":"<p>Return all the used office:name tags values of the element.</p> <p>Return: list of unique str</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_office_names(self) -&gt; list[str]:\n    \"\"\"Return all the used office:name tags values of the element.\n\n    Return: list of unique str\n    \"\"\"\n    name_xpath_query = xpath_compile(\"//@office:name\")\n    response = name_xpath_query(self.__element)\n    if not isinstance(response, list):\n        return []\n    return list({str(name) for name in response if name})\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_orphan_draw_connectors","title":"<code>get_orphan_draw_connectors()</code>","text":"<p>Return a list of connectors which don\u2019t have any shape connected to them.</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_orphan_draw_connectors(self) -&gt; list[Element]:\n    \"\"\"Return a list of connectors which don't have any shape connected\n    to them.\n    \"\"\"\n    connectors = []\n    for connector in self.get_draw_connectors():\n        start_shape = connector.get_attribute(\"draw:start-shape\")\n        end_shape = connector.get_attribute(\"draw:end-shape\")\n        if start_shape is None and end_shape is None:\n            connectors.append(connector)\n    return connectors\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_paragraph","title":"<code>get_paragraph(position=0, content=None)</code>","text":"<p>Return the paragraph that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Paragraph or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_paragraph(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the paragraph that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Paragraph or None if not found\n    \"\"\"\n    return self._filtered_element(\"descendant::text:p\", position, content=content)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_paragraphs","title":"<code>get_paragraphs(style=None, content=None)</code>","text":"<p>Return all the paragraphs that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Paragraph</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_paragraphs(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the paragraphs that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Paragraph\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:p\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark","title":"<code>get_reference_mark(position=0, name=None)</code>","text":"<p>Return the reference mark that match the criteria. Either single position reference mark (text:reference-mark) or start of range reference (text:reference-mark-start).</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark that match the criteria. Either single\n    position reference mark (text:reference-mark) or start of range\n    reference (text:reference-mark-start).\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    if name:\n        request = (\n            f\"descendant::text:reference-mark-start\"\n            f'[@text:name=\"{name}\"] '\n            f\"| descendant::text:reference-mark\"\n            f'[@text:name=\"{name}\"]'\n        )\n        return self._filtered_element(request, position=0)\n    request = (\n        \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n    )\n    return self._filtered_element(request, position)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_end","title":"<code>get_reference_mark_end(position=0, name=None)</code>","text":"<p>Return the reference mark end that matches the criteria. Search only the tags text:reference-mark-end. Consider using : get_reference_marks()</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_end(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark end that matches the criteria. Search only\n    the tags text:reference-mark-end.\n    Consider using : get_reference_marks()\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:reference-mark-end\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_ends","title":"<code>get_reference_mark_ends()</code>","text":"<p>Return all the reference mark ends. Search only the tags text:reference-mark-end. Consider using : get_reference_marks()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the reference mark ends. Search only the tags\n    text:reference-mark-end.\n    Consider using : get_reference_marks()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:reference-mark-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_single","title":"<code>get_reference_mark_single(position=0, name=None)</code>","text":"<p>Return the reference mark that matches the criteria. Search only the tags text:reference-mark. Consider using : get_reference_mark()</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_single(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark that matches the criteria. Search only the\n    tags text:reference-mark.\n    Consider using : get_reference_mark()\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:reference-mark\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_start","title":"<code>get_reference_mark_start(position=0, name=None)</code>","text":"<p>Return the reference mark start that matches the criteria. Search only the tags text:reference-mark-start. Consider using : get_reference_mark()</p> <p>Arguments:</p> <pre><code>position -- int\n\nname -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_start(\n    self,\n    position: int = 0,\n    name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the reference mark start that matches the criteria. Search\n    only the tags text:reference-mark-start.\n    Consider using : get_reference_mark()\n\n    Arguments:\n\n        position -- int\n\n        name -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:reference-mark-start\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_mark_starts","title":"<code>get_reference_mark_starts()</code>","text":"<p>Return all the reference mark starts. Search only the tags text:reference-mark-start. Consider using : get_reference_marks()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_mark_starts(self) -&gt; list[Element]:\n    \"\"\"Return all the reference mark starts. Search only the tags\n    text:reference-mark-start.\n    Consider using : get_reference_marks()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:reference-mark-start\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_marks","title":"<code>get_reference_marks()</code>","text":"<p>Return all the reference marks, either single position reference (text:reference-mark) or start of range reference (text:reference-mark-start).</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_marks(self) -&gt; list[Element]:\n    \"\"\"Return all the reference marks, either single position reference\n    (text:reference-mark) or start of range reference\n    (text:reference-mark-start).\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:reference-mark-start | descendant::text:reference-mark\"\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_reference_marks_single","title":"<code>get_reference_marks_single()</code>","text":"<p>Return all the reference marks. Search only the tags text:reference-mark. Consider using : get_reference_marks()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_reference_marks_single(self) -&gt; list[Element]:\n    \"\"\"Return all the reference marks. Search only the tags\n    text:reference-mark.\n    Consider using : get_reference_marks()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:reference-mark\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_references","title":"<code>get_references(name=None)</code>","text":"<p>Return all the references (text:reference-ref). If name is provided, returns the references of that name.</p> <p>Return: list of Element</p> <p>Arguments:</p> <pre><code>name -- str or None\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def get_references(self, name: str | None = None) -&gt; list[Element]:\n    \"\"\"Return all the references (text:reference-ref). If name is\n    provided, returns the references of that name.\n\n    Return: list of Element\n\n    Arguments:\n\n        name -- str or None\n    \"\"\"\n    if name is None:\n        return self._filtered_elements(\"descendant::text:reference-ref\")\n    request = f'descendant::text:reference-ref[@text:ref-name=\"{name}\"]'\n    return self._filtered_elements(request)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_section","title":"<code>get_section(position=0, content=None)</code>","text":"<p>Return the section that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_section(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the section that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:section\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_sections","title":"<code>get_sections(style=None, content=None)</code>","text":"<p>Return all the sections that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_sections(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the sections that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\n        \"text:section\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_span","title":"<code>get_span(position=0, content=None)</code>","text":"<p>Return the span that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Span or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_span(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the span that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Span or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:span\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_spans","title":"<code>get_spans(style=None, content=None)</code>","text":"<p>Return all the spans that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Span</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_spans(\n    self,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Element]:\n    \"\"\"Return all the spans that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Span\n    \"\"\"\n    return self._filtered_elements(\n        \"descendant::text:span\", text_style=style, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the family/name pair. If the argument is already a style object, it will return it.</p> <p>If the name is not the internal name but the name you gave in the desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n          'number'\n\nname_or_element -- str or Style\n\ndisplay_name -- str\n</code></pre> <p>Return: odf_style or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Element | None = None,\n    display_name: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the style uniquely identified by the family/name pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is not the internal name but the name you gave in the\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text', 'graphic', 'table', 'list',\n                  'number'\n\n        name_or_element -- str or Style\n\n        display_name -- str\n\n    Return: odf_style or None if not found\n    \"\"\"\n    if isinstance(name_or_element, Element):\n        name = self.get_attribute(\"style:name\")\n        if name is not None:\n            return name_or_element\n        else:\n            raise ValueError(f\"Not a odf_style ? {name_or_element!r}\")\n    style_name = name_or_element\n    is_default = not (style_name or display_name)\n    tagname = self._get_style_tagname(family, is_default=is_default)\n    # famattr became None if no \"style:family\" attribute\n    if family:\n        return self._filtered_element(\n            tagname,\n            0,\n            style_name=style_name,\n            display_name=display_name,\n            family=family,\n        )\n    else:\n        return self._filtered_element(\n            tagname,\n            0,\n            draw_name=style_name or display_name,\n            family=family,\n        )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_styled_elements","title":"<code>get_styled_elements(name='')</code>","text":"<p>Brute-force to find paragraphs, tables, etc. using the given style name (or all by default).</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: list</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_styled_elements(self, name: str = \"\") -&gt; list[Element]:\n    \"\"\"Brute-force to find paragraphs, tables, etc. using the given style\n    name (or all by default).\n\n    Arguments:\n\n        name -- str\n\n    Return: list\n    \"\"\"\n    # FIXME incomplete (and possibly inaccurate)\n    return (\n        self._filtered_elements(\"descendant::*\", text_style=name)\n        + self._filtered_elements(\"descendant::*\", draw_style=name)\n        + self._filtered_elements(\"descendant::*\", draw_text_style=name)\n        + self._filtered_elements(\"descendant::*\", table_style=name)\n        + self._filtered_elements(\"descendant::*\", page_layout=name)\n        + self._filtered_elements(\"descendant::*\", master_page=name)\n        + self._filtered_elements(\"descendant::*\", parent_style=name)\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change","title":"<code>get_text_change(position=0, idx=None)</code>","text":"<p>Return the text change that matches the criteria. Either single deletion (text:change) or start of range of changes (text:change-start). position : index of the element to retrieve if several matches, default is 0. idx : change-id of the element.</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change that matches the criteria. Either single\n    deletion (text:change) or start of range of changes (text:change-start).\n    position : index of the element to retrieve if several matches, default\n    is 0.\n    idx : change-id of the element.\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    if idx:\n        request = (\n            f'descendant::text:change-start[@text:change-id=\"{idx}\"] '\n            f'| descendant::text:change[@text:change-id=\"{idx}\"]'\n        )\n        return self._filtered_element(request, 0)\n    request = \"descendant::text:change-start | descendant::text:change\"\n    return self._filtered_element(request, position)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_deletion","title":"<code>get_text_change_deletion(position=0, idx=None)</code>","text":"<p>Return the text change of deletion kind that matches the criteria. Search only for the tags text:change. Consider using : get_text_change()</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_deletion(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change of deletion kind that matches the criteria.\n    Search only for the tags text:change.\n    Consider using : get_text_change()\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:change\", position, change_id=idx\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_deletions","title":"<code>get_text_change_deletions()</code>","text":"<p>Return all the text changes of deletion kind: the tags text:change. Consider using : get_text_changes()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_deletions(self) -&gt; list[Element]:\n    \"\"\"Return all the text changes of deletion kind: the tags text:change.\n    Consider using : get_text_changes()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:text:change\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_end","title":"<code>get_text_change_end(position=0, idx=None)</code>","text":"<p>Return the text change-end that matches the criteria. Search only the tags text:change-end. Consider using : get_text_change()</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_end(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change-end that matches the criteria. Search only\n    the tags text:change-end.\n    Consider using : get_text_change()\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:change-end\", position, change_id=idx\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_ends","title":"<code>get_text_change_ends()</code>","text":"<p>Return all the text change-end. Search only the tags text:change-end. Consider using : get_text_changes()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_ends(self) -&gt; list[Element]:\n    \"\"\"Return all the text change-end. Search only the tags\n    text:change-end.\n    Consider using : get_text_changes()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:change-end\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_start","title":"<code>get_text_change_start(position=0, idx=None)</code>","text":"<p>Return the text change-start that matches the criteria. Search only the tags text:change-start. Consider using : get_text_change()</p> <p>Arguments:</p> <pre><code>position -- int\n\nidx -- str\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_start(\n    self,\n    position: int = 0,\n    idx: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the text change-start that matches the criteria. Search\n    only the tags text:change-start.\n    Consider using : get_text_change()\n\n    Arguments:\n\n        position -- int\n\n        idx -- str\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:change-start\", position, change_id=idx\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_change_starts","title":"<code>get_text_change_starts()</code>","text":"<p>Return all the text change-start. Search only for the tags text:change-start. Consider using : get_text_changes()</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_change_starts(self) -&gt; list[Element]:\n    \"\"\"Return all the text change-start. Search only for the tags\n    text:change-start.\n    Consider using : get_text_changes()\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:change-start\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_text_changes","title":"<code>get_text_changes()</code>","text":"<p>Return all the text changes, either single deletion (text:change) or start of range of changes (text:change-start).</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_text_changes(self) -&gt; list[Element]:\n    \"\"\"Return all the text changes, either single deletion\n    (text:change) or start of range of changes (text:change-start).\n\n    Return: list of Element\n    \"\"\"\n    request = \"descendant::text:change-start | descendant::text:change\"\n    return self._filtered_elements(request)\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_toc","title":"<code>get_toc(position=0, content=None)</code>","text":"<p>Return the table of contents that matches the criteria.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: odf_toc or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_toc(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the table of contents that matches the criteria.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: odf_toc or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"text:table-of-content\", position, content=content\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_tocs","title":"<code>get_tocs()</code>","text":"<p>Return all the tables of contents.</p> <p>Return: list of odf_toc</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_tocs(self) -&gt; list[Element]:\n    \"\"\"Return all the tables of contents.\n\n    Return: list of odf_toc\n    \"\"\"\n    return self.get_elements(\"text:table-of-content\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_tracked_changes","title":"<code>get_tracked_changes()</code>","text":"<p>Return the tracked-changes part in the text body.</p> <p>Return: Element or None</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_tracked_changes(self) -&gt; Element | None:\n    \"\"\"Return the tracked-changes part in the text body.\n\n    Return: Element or None\n    \"\"\"\n    return self.get_element(\"//text:tracked-changes\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_defined","title":"<code>get_user_defined(name, position=0)</code>","text":"<p>return the user defined declaration for the given name.</p> <p>return: Element or none if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_defined(self, name: str, position: int = 0) -&gt; Element | None:\n    \"\"\"return the user defined declaration for the given name.\n\n    return: Element or none if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:user-defined\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_defined_list","title":"<code>get_user_defined_list()</code>","text":"<p>Return all the user defined field declarations.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_defined_list(self) -&gt; list[Element]:\n    \"\"\"Return all the user defined field declarations.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:user-defined\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_defined_value","title":"<code>get_user_defined_value(name, value_type=None)</code>","text":"<p>Return the value of the given user defined field name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nvalue_type -- 'boolean', 'date', 'float',\n              'string', 'time' or automatic\n</code></pre> <p>Return: most appropriate Python type</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_defined_value(\n    self, name: str, value_type: str | None = None\n) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n    \"\"\"Return the value of the given user defined field name.\n\n    Arguments:\n\n        name -- str\n\n        value_type -- 'boolean', 'date', 'float',\n                      'string', 'time' or automatic\n\n    Return: most appropriate Python type\n    \"\"\"\n    user_defined = self.get_user_defined(name)\n    if user_defined is None:\n        return None\n    return user_defined.get_value(value_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_decl","title":"<code>get_user_field_decl(name, position=0)</code>","text":"<p>return the user field declaration for the given name.</p> <p>return: Element or none if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_decl(self, name: str, position: int = 0) -&gt; Element | None:\n    \"\"\"return the user field declaration for the given name.\n\n    return: Element or none if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:user-field-decl\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_decl_list","title":"<code>get_user_field_decl_list()</code>","text":"<p>Return all the user field declarations.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_decl_list(self) -&gt; list[Element]:\n    \"\"\"Return all the user field declarations.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:user-field-decl\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_decls","title":"<code>get_user_field_decls()</code>","text":"<p>Return the container for user field declarations. Created if not found.</p> <p>Return: Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_decls(self) -&gt; Element | None:\n    \"\"\"Return the container for user field declarations. Created if not\n    found.\n\n    Return: Element\n    \"\"\"\n    user_field_decls = self.get_element(\"//text:user-field-decls\")\n    if user_field_decls is None:\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Empty document.body\")\n        body.insert(Element.from_tag(\"text:user-field-decls\"), FIRST_CHILD)\n        user_field_decls = body.get_element(\"//text:user-field-decls\")\n\n    return user_field_decls\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_user_field_value","title":"<code>get_user_field_value(name, value_type=None)</code>","text":"<p>Return the value of the given user field name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nvalue_type -- 'boolean', 'currency', 'date', 'float',\n              'percentage', 'string', 'time' or automatic\n</code></pre> <p>Return: most appropriate Python type</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_user_field_value(\n    self, name: str, value_type: str | None = None\n) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n    \"\"\"Return the value of the given user field name.\n\n    Arguments:\n\n        name -- str\n\n        value_type -- 'boolean', 'currency', 'date', 'float',\n                      'percentage', 'string', 'time' or automatic\n\n    Return: most appropriate Python type\n    \"\"\"\n    user_field_decl = self.get_user_field_decl(name)\n    if user_field_decl is None:\n        return None\n    return user_field_decl.get_value(value_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_decl","title":"<code>get_variable_decl(name, position=0)</code>","text":"<p>return the variable declaration for the given name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nposition -- int\n</code></pre> <p>return: Element or none if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_decl(self, name: str, position: int = 0) -&gt; Element | None:\n    \"\"\"return the variable declaration for the given name.\n\n    Arguments:\n\n        name -- str\n\n        position -- int\n\n    return: Element or none if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:variable-decl\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_decl_list","title":"<code>get_variable_decl_list()</code>","text":"<p>Return all the variable declarations.</p> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_decl_list(self) -&gt; list[Element]:\n    \"\"\"Return all the variable declarations.\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:variable-decl\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_decls","title":"<code>get_variable_decls()</code>","text":"<p>Return the container for variable declarations. Created if not found.</p> <p>Return: Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_decls(self) -&gt; Element:\n    \"\"\"Return the container for variable declarations. Created if not\n    found.\n\n    Return: Element\n    \"\"\"\n    variable_decls = self.get_element(\"//text:variable-decls\")\n    if variable_decls is None:\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Empty document.body\")\n        body.insert(Element.from_tag(\"text:variable-decls\"), FIRST_CHILD)\n        variable_decls = body.get_element(\"//text:variable-decls\")\n\n    return variable_decls  # type:ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_set","title":"<code>get_variable_set(name, position=-1)</code>","text":"<p>Return the variable set for the given name (last one by default).</p> <p>Arguments:</p> <pre><code>name -- str\n\nposition -- int\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_set(self, name: str, position: int = -1) -&gt; Element | None:\n    \"\"\"Return the variable set for the given name (last one by default).\n\n    Arguments:\n\n        name -- str\n\n        position -- int\n\n    Return: Element or None if not found\n    \"\"\"\n    return self._filtered_element(\n        \"descendant::text:variable-set\", position, text_name=name\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_set_value","title":"<code>get_variable_set_value(name, value_type=None)</code>","text":"<p>Return the last value of the given variable name.</p> <p>Arguments:</p> <pre><code>name -- str\n\nvalue_type -- 'boolean', 'currency', 'date', 'float',\n              'percentage', 'string', 'time' or automatic\n</code></pre> <p>Return: most appropriate Python type</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_set_value(\n    self,\n    name: str,\n    value_type: str | None = None,\n) -&gt; bool | str | int | float | Decimal | datetime | timedelta | None:\n    \"\"\"Return the last value of the given variable name.\n\n    Arguments:\n\n        name -- str\n\n        value_type -- 'boolean', 'currency', 'date', 'float',\n                      'percentage', 'string', 'time' or automatic\n\n    Return: most appropriate Python type\n    \"\"\"\n    variable_set = self.get_variable_set(name)\n    if not variable_set:\n        return None\n    return variable_set.get_value(value_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Element.get_variable_sets","title":"<code>get_variable_sets(name=None)</code>","text":"<p>Return all the variable sets that match the criteria.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/element.py</code> <pre><code>def get_variable_sets(self, name: str | None = None) -&gt; list[Element]:\n    \"\"\"Return all the variable sets that match the criteria.\n\n    Arguments:\n\n        name -- str\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"descendant::text:variable-set\", text_name=name)\n</code></pre>"},{"location":"reference.html#odfdo.Element.index","title":"<code>index(child)</code>","text":"<p>Return the position of the child in this element.</p> <p>Inspired by lxml</p> Source code in <code>odfdo/element.py</code> <pre><code>def index(self, child: Element) -&gt; int:\n    \"\"\"Return the position of the child in this element.\n\n    Inspired by lxml\n    \"\"\"\n    return self.__element.index(child.__element)\n</code></pre>"},{"location":"reference.html#odfdo.Element.insert","title":"<code>insert(element, xmlposition=None, position=None, start=False)</code>","text":"<p>Insert an element relatively to ourself.</p> <p>Insert either using DOM vocabulary or by numeric position. If text start is True, insert the element before any existing text.</p> <p>Position start at 0.</p> <p>Arguments:</p> <pre><code>element -- Element\n\nxmlposition -- FIRST_CHILD, LAST_CHILD, NEXT_SIBLING\n               or PREV_SIBLING\n\nstart -- Boolean\n\nposition -- int\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def insert(\n    self,\n    element: Element,\n    xmlposition: int | None = None,\n    position: int | None = None,\n    start: bool = False,\n) -&gt; None:\n    \"\"\"Insert an element relatively to ourself.\n\n    Insert either using DOM vocabulary or by numeric position.\n    If text start is True, insert the element before any existing text.\n\n    Position start at 0.\n\n    Arguments:\n\n        element -- Element\n\n        xmlposition -- FIRST_CHILD, LAST_CHILD, NEXT_SIBLING\n                       or PREV_SIBLING\n\n        start -- Boolean\n\n        position -- int\n    \"\"\"\n    # child_tag = element.tag\n    current = self.__element\n    _element = element.__element\n    if start:\n        text = current.text\n        if text is not None:\n            current.text = None\n            tail = _element.tail\n            if tail is None:\n                tail = text\n            else:\n                tail = tail + text\n            _element.tail = tail\n        position = 0\n    if position is not None:\n        current.insert(position, _element)\n    elif xmlposition is FIRST_CHILD:\n        current.insert(0, _element)\n    elif xmlposition is LAST_CHILD:\n        current.append(_element)\n    elif xmlposition is NEXT_SIBLING:\n        parent = current.getparent()\n        index = parent.index(current)  # type: ignore\n        parent.insert(index + 1, _element)  # type: ignore\n    elif xmlposition is PREV_SIBLING:\n        parent = current.getparent()\n        index = parent.index(current)  # type: ignore\n        parent.insert(index, _element)  # type: ignore\n    else:\n        raise ValueError(\"(xml)position must be defined\")\n</code></pre>"},{"location":"reference.html#odfdo.Element.is_empty","title":"<code>is_empty()</code>","text":"<p>Check if the element is empty : no text, no children, no tail.</p> <p>Return: Boolean</p> Source code in <code>odfdo/element.py</code> <pre><code>def is_empty(self) -&gt; bool:\n    \"\"\"Check if the element is empty : no text, no children, no tail.\n\n    Return: Boolean\n    \"\"\"\n    element = self.__element\n    if element.tail is not None:\n        return False\n    if element.text is not None:\n        return False\n    if list(element.iterchildren()):\n        return False\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Element.match","title":"<code>match(pattern)</code>","text":"<p>return True if the pattern is found one or more times anywhere in the text content of the element.</p> <p>Python regular expression syntax applies.</p> <p>Arguments:</p> <pre><code>pattern -- str\n</code></pre> <p>Return: bool</p> Source code in <code>odfdo/element.py</code> <pre><code>def match(self, pattern: str) -&gt; bool:\n    \"\"\"return True if the pattern is found one or more times anywhere in\n    the text content of the element.\n\n    Python regular expression syntax applies.\n\n    Arguments:\n\n        pattern -- str\n\n    Return: bool\n    \"\"\"\n    return self.search(pattern) is not None\n</code></pre>"},{"location":"reference.html#odfdo.Element.replace","title":"<code>replace(pattern, new=None)</code>","text":"<p>Replace the pattern with the given text, or delete if text is an empty string, and return the number of replacements. By default, only return the number of occurences that would be replaced.</p> <p>It cannot replace patterns found across several element, like a word split into two consecutive spans.</p> <p>Python regular expression syntax applies.</p> <p>Arguments:</p> <pre><code>pattern -- str\n\nnew -- str\n</code></pre> <p>Return: int</p> Source code in <code>odfdo/element.py</code> <pre><code>def replace(self, pattern: str, new: str | None = None) -&gt; int:\n    \"\"\"Replace the pattern with the given text, or delete if text is an\n    empty string, and return the number of replacements. By default, only\n    return the number of occurences that would be replaced.\n\n    It cannot replace patterns found across several element, like a word\n    split into two consecutive spans.\n\n    Python regular expression syntax applies.\n\n    Arguments:\n\n        pattern -- str\n\n        new -- str\n\n    Return: int\n    \"\"\"\n    if not isinstance(pattern, str):\n        # Fail properly if the pattern is an non-ascii bytestring\n        pattern = str(pattern)\n    cpattern = re.compile(pattern)\n    count = 0\n    for text in self.xpath(\"descendant::text()\"):\n        if new is None:\n            count += len(cpattern.findall(str(text)))\n        else:\n            new_text, number = cpattern.subn(new, str(text))\n            container = text.parent\n            if text.is_text():  # type: ignore\n                container.text = new_text  # type: ignore\n            else:\n                container.tail = new_text  # type: ignore\n            count += number\n    return count\n</code></pre>"},{"location":"reference.html#odfdo.Element.replace_element","title":"<code>replace_element(old_element, new_element)</code>","text":"<p>Replaces in place a sub element with the element passed as second argument.</p> <p>Warning : no clone for old element.</p> Source code in <code>odfdo/element.py</code> <pre><code>def replace_element(self, old_element: Element, new_element: Element) -&gt; None:\n    \"\"\"Replaces in place a sub element with the element passed as second\n    argument.\n\n    Warning : no clone for old element.\n    \"\"\"\n    current = self.__element\n    current.replace(old_element.__element, new_element.__element)\n</code></pre>"},{"location":"reference.html#odfdo.Element.search","title":"<code>search(pattern)</code>","text":"<p>Return the first position of the pattern in the text content of the element, or None if not found.</p> <p>Python regular expression syntax applies.</p> <p>Arguments:</p> <pre><code>pattern -- str\n</code></pre> <p>Return: int or None</p> Source code in <code>odfdo/element.py</code> <pre><code>def search(self, pattern: str) -&gt; int | None:\n    \"\"\"Return the first position of the pattern in the text content of\n    the element, or None if not found.\n\n    Python regular expression syntax applies.\n\n    Arguments:\n\n        pattern -- str\n\n    Return: int or None\n    \"\"\"\n    match = re.search(pattern, self.text_recursive)\n    if match is None:\n        return None\n    return match.start()\n</code></pre>"},{"location":"reference.html#odfdo.Element.serialize","title":"<code>serialize(pretty=False, with_ns=False)</code>","text":"<p>Return text serialization of XML element.</p> Source code in <code>odfdo/element.py</code> <pre><code>def serialize(self, pretty: bool = False, with_ns: bool = False) -&gt; str:\n    \"\"\"Return text serialization of XML element.\"\"\"\n    # This copy bypasses serialization side-effects in lxml\n    native = deepcopy(self.__element)\n    data = tostring(\n        native, with_tail=False, pretty_print=pretty, encoding=\"unicode\"\n    )\n    if with_ns:\n        return data\n    # Remove namespaces\n    return self._strip_namespaces(data)\n</code></pre>"},{"location":"reference.html#odfdo.Element.set_style_attribute","title":"<code>set_style_attribute(name, value)</code>","text":"<p>Shortcut to accept a style object as a value.</p> Source code in <code>odfdo/element.py</code> <pre><code>def set_style_attribute(self, name: str, value: Element | str) -&gt; None:\n    \"\"\"Shortcut to accept a style object as a value.\"\"\"\n    if isinstance(value, Element):\n        value = str(value.name)  # type:ignore\n    return self.set_attribute(name, value)\n</code></pre>"},{"location":"reference.html#odfdo.Element.strip_elements","title":"<code>strip_elements(sub_elements)</code>","text":"<p>Remove the tags of provided elements, keeping inner childs and text.</p> <p>Return : the striped element.</p> <p>Warning : no clone in sub_elements list.</p> <p>Arguments:</p> <pre><code>sub_elements -- Element or list of Element\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def strip_elements(\n    self,\n    sub_elements: Element | Iterable[Element],\n) -&gt; Element | list:\n    \"\"\"Remove the tags of provided elements, keeping inner childs and text.\n\n    Return : the striped element.\n\n    Warning : no clone in sub_elements list.\n\n    Arguments:\n\n        sub_elements -- Element or list of Element\n    \"\"\"\n    if not sub_elements:\n        return self\n    if isinstance(sub_elements, Element):\n        sub_elements = (sub_elements,)\n    replacer = _get_lxml_tag(\"text:this-will-be-removed\")\n    for element in sub_elements:\n        element.__element.tag = replacer\n    strip = (\"text:this-will-be-removed\",)\n    return self.strip_tags(strip=strip, default=None)\n</code></pre>"},{"location":"reference.html#odfdo.Element.strip_tags","title":"<code>strip_tags(strip=None, protect=None, default='text:p')</code>","text":"<p>Remove the tags listed in strip, recursively, keeping inner childs and text. Tags listed in protect stop the removal one level depth. If the first level element is stripped, default is used to embed the content in the default element. If default is None and first level is striped, a list of text and children is returned. Return : the striped element.</p> <p>strip_tags should be used by on purpose methods (strip_span \u2026) (Method name taken from lxml).</p> <p>Arguments:</p> <pre><code>strip -- iterable list of str odf tags, or None\n\nprotect -- iterable list of str odf tags, or None\n\ndefault -- str odf tag, or None\n</code></pre> <p>Return:</p> <pre><code>Element.\n</code></pre> Source code in <code>odfdo/element.py</code> <pre><code>def strip_tags(\n    self,\n    strip: Iterable[str] | None = None,\n    protect: Iterable[str] | None = None,\n    default: str | None = \"text:p\",\n) -&gt; Element | list:\n    \"\"\"Remove the tags listed in strip, recursively, keeping inner childs\n    and text. Tags listed in protect stop the removal one level depth. If\n    the first level element is stripped, default is used to embed the\n    content in the default element. If default is None and first level is\n    striped, a list of text and children is returned. Return : the striped\n    element.\n\n    strip_tags should be used by on purpose methods (strip_span ...)\n    (Method name taken from lxml).\n\n    Arguments:\n\n        strip -- iterable list of str odf tags, or None\n\n        protect -- iterable list of str odf tags, or None\n\n        default -- str odf tag, or None\n\n    Return:\n\n        Element.\n    \"\"\"\n    if not strip:\n        return self\n    if not protect:\n        protect = ()\n    protected = False\n    element, modified = Element._strip_tags(self, strip, protect, protected)\n    if modified and isinstance(element, list) and default:\n        new = Element.from_tag(default)\n        for content in element:\n            if isinstance(content, Element):\n                new.append(content)\n            else:\n                new.text = content\n        element = new\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Element.xpath","title":"<code>xpath(xpath_query)</code>","text":"<p>Apply XPath query to the element and its subtree. Return list of Element or EText instances translated from the nodes found.</p> Source code in <code>odfdo/element.py</code> <pre><code>def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n    \"\"\"Apply XPath query to the element and its subtree. Return list of\n    Element or EText instances translated from the nodes found.\n    \"\"\"\n    element = self.__element\n    xpath_instance = xpath_compile(xpath_query)\n    elements = xpath_instance(element)\n    result: list[Element | EText] = []\n    if hasattr(elements, \"__iter__\"):\n        for obj in elements:  # type: ignore\n            if isinstance(obj, (str, bytes)):\n                result.append(EText(obj))\n            elif isinstance(obj, _Element):\n                result.append(Element.from_tag(obj))\n            # else:\n            #     result.append(obj)\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.ElementTyped","title":"<code>ElementTyped</code>","text":"<p>               Bases: <code>Element</code></p> Source code in <code>odfdo/element_typed.py</code> <pre><code>class ElementTyped(Element):\n    def set_value_and_type(  # noqa: C901\n        self,\n        value: Any,\n        value_type: str | None = None,\n        text: str | None = None,\n        currency: str | None = None,\n    ) -&gt; str | None:\n        # Remove possible previous value and type\n        for name in (\n            \"office:value-type\",\n            \"office:boolean-value\",\n            \"office:value\",\n            \"office:date-value\",\n            \"office:string-value\",\n            \"office:time-value\",\n            \"table:formula\",\n            \"office:currency\",\n            \"calcext:value-type\",\n            \"loext:value-type\",\n        ):\n            with contextlib.suppress(KeyError):\n                self.del_attribute(name)\n        if isinstance(value, bytes):\n            value = bytes_to_str(value)\n        if isinstance(value_type, bytes):\n            value_type = bytes_to_str(value_type)\n        if isinstance(text, bytes):\n            text = bytes_to_str(text)\n        if isinstance(currency, bytes):\n            currency = bytes_to_str(currency)\n        if value is None:\n            self._erase_text_content()\n            return text\n        if isinstance(value, bool):\n            if value_type is None:\n                value_type = \"boolean\"\n            if text is None:\n                text = \"true\" if value else \"false\"\n            value = Boolean.encode(value)\n        elif isinstance(value, (int, float, Decimal)):\n            if value_type == \"percentage\":\n                text = \"%d %%\" % int(value * 100)\n            if value_type is None:\n                value_type = \"float\"\n            if text is None:\n                text = str(value)\n            value = str(value)\n        elif isinstance(value, datetime):\n            if value_type is None:\n                value_type = \"date\"\n            if text is None:\n                text = str(DateTime.encode(value))\n            value = DateTime.encode(value)\n        elif isinstance(value, date):\n            if value_type is None:\n                value_type = \"date\"\n            if text is None:\n                text = str(Date.encode(value))\n            value = Date.encode(value)\n        elif isinstance(value, str):\n            if value_type is None:\n                value_type = \"string\"\n            if text is None:\n                text = value\n        elif isinstance(value, timedelta):\n            if value_type is None:\n                value_type = \"time\"\n            if text is None:\n                text = str(Duration.encode(value))\n            value = Duration.encode(value)\n        elif value is not None:\n            raise TypeError(f\"Type unknown: '{value!r}'\")\n\n        if value_type is not None:\n            self.set_attribute(\"office:value-type\", value_type)\n            self.set_attribute(\"calcext:value-type\", value_type)\n        if value_type == \"boolean\":\n            self.set_attribute(\"office:boolean-value\", value)\n        elif value_type == \"currency\":\n            self.set_attribute(\"office:value\", value)\n            self.set_attribute(\"office:currency\", currency)\n        elif value_type == \"date\":\n            self.set_attribute(\"office:date-value\", value)\n        elif value_type in (\"float\", \"percentage\"):\n            self.set_attribute(\"office:value\", value)\n            self.set_attribute(\"calcext:value\", value)\n        elif value_type == \"string\":\n            self.set_attribute(\"office:string-value\", value)\n        elif value_type == \"time\":\n            self.set_attribute(\"office:time-value\", value)\n\n        return text\n\n    def _get_typed_value(  # noqa: C901\n        self,\n        value_type: str | None = None,\n        try_get_text: bool = True,\n    ) -&gt; tuple[Any, str | None]:\n        \"\"\"Return Python typed value.\n\n        Only for \"with office:value-type\" elements, not for meta fields.\"\"\"\n        value: Decimal | str | bool | None = None\n        if value_type is None:\n            read_value_type = self.get_attribute(\"office:value-type\")\n            if isinstance(read_value_type, bool):\n                raise TypeError(\n                    f'Wrong type for \"office:value-type\": {type(read_value_type)}'\n                )\n            value_type = read_value_type\n        # value_type = to_str(value_type)\n        if value_type == \"boolean\":\n            value = self.get_attribute(\"office:boolean-value\")\n            return (value, value_type)\n        if value_type in {\"float\", \"percentage\", \"currency\"}:\n            read_number = self.get_attribute(\"office:value\")\n            if not isinstance(read_number, (Decimal, str)):\n                raise TypeError(f'Wrong type for \"office:value\": {type(read_number)}')\n            value = Decimal(read_number)\n            # Return 3 instead of 3.0 if possible\n            with contextlib.suppress(ValueError):\n                if int(value) == value:\n                    return (int(value), value_type)\n            return (value, value_type)\n        if value_type == \"date\":\n            read_attribute = self.get_attribute(\"office:date-value\")\n            if not isinstance(read_attribute, str):\n                raise TypeError(\n                    f'Wrong type for \"office:date-value\": {type(read_attribute)}'\n                )\n            if \"T\" in read_attribute:\n                return (DateTime.decode(read_attribute), value_type)\n            return (Date.decode(read_attribute), value_type)\n        if value_type == \"string\":\n            value = self.get_attribute(\"office:string-value\")\n            if value is not None:\n                return (str(value), value_type)\n            if try_get_text:\n                list_value = [\n                    para.text_recursive for para in self.get_elements(\"text:p\")\n                ]\n                if list_value:\n                    return (\"\\n\".join(list_value), value_type)\n            return (None, value_type)\n        if value_type == \"time\":\n            read_value = self.get_attribute(\"office:time-value\")\n            if not isinstance(read_value, str):\n                raise TypeError(\n                    f'Wrong type for \"office:time-value\": {type(read_value)}'\n                )\n            time_value = Duration.decode(read_value)\n            return (time_value, value_type)\n        if value_type is None:\n            return (None, None)\n        raise ValueError(f'Unexpected value type: \"{value_type}\"')\n\n    def get_value(\n        self,\n        value_type: str | None = None,\n        try_get_text: bool = True,\n        get_type: bool = False,\n    ) -&gt; Any | tuple[Any, str]:\n        \"\"\"Return Python typed value.\n\n        Only for \"with office:value-type\" elements, not for meta fields.\"\"\"\n        if get_type:\n            return self._get_typed_value(\n                value_type=value_type,\n                try_get_text=try_get_text,\n            )\n        return self._get_typed_value(\n            value_type=value_type,\n            try_get_text=try_get_text,\n        )[0]\n</code></pre>"},{"location":"reference.html#odfdo.ElementTyped.get_value","title":"<code>get_value(value_type=None, try_get_text=True, get_type=False)</code>","text":"<p>Return Python typed value.</p> <p>Only for \u201cwith office:value-type\u201d elements, not for meta fields.</p> Source code in <code>odfdo/element_typed.py</code> <pre><code>def get_value(\n    self,\n    value_type: str | None = None,\n    try_get_text: bool = True,\n    get_type: bool = False,\n) -&gt; Any | tuple[Any, str]:\n    \"\"\"Return Python typed value.\n\n    Only for \"with office:value-type\" elements, not for meta fields.\"\"\"\n    if get_type:\n        return self._get_typed_value(\n            value_type=value_type,\n            try_get_text=try_get_text,\n        )\n    return self._get_typed_value(\n        value_type=value_type,\n        try_get_text=try_get_text,\n    )[0]\n</code></pre>"},{"location":"reference.html#odfdo.EllipseShape","title":"<code>EllipseShape</code>","text":"<p>               Bases: <code>ShapeBase</code></p> <p>Create a ellipse shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\nposition -- (str, str)\n\nsize -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class EllipseShape(ShapeBase):\n    \"\"\"Create a ellipse shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        position -- (str, str)\n\n        size -- (str, str)\n\n    \"\"\"\n\n    _tag = \"draw:ellipse\"\n    _properties: tuple[PropDef, ...] = ()\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        position: tuple | None = None,\n        size: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n                \"size\": size,\n                \"position\": position,\n            }\n        )\n        super().__init__(**kwargs)\n</code></pre>"},{"location":"reference.html#odfdo.Frame","title":"<code>Frame</code>","text":"<p>               Bases: <code>Element</code>, <code>AnchorMix</code>, <code>PosMix</code>, <code>ZMix</code>, <code>SizeMix</code></p> <p>ODF Frame \u201cdraw:frame\u201d</p> <p>Frames are not useful by themselves. You should consider calling Frame.image_frame() or Frame.text_frame directly.</p> Source code in <code>odfdo/frame.py</code> <pre><code>class Frame(Element, AnchorMix, PosMix, ZMix, SizeMix):\n    \"\"\"ODF Frame \"draw:frame\"\n\n    Frames are not useful by themselves. You should consider calling\n    Frame.image_frame() or Frame.text_frame directly.\n    \"\"\"\n\n    _tag = \"draw:frame\"\n    _properties = (\n        PropDef(\"name\", \"draw:name\"),\n        PropDef(\"draw_id\", \"draw:id\"),\n        PropDef(\"width\", \"svg:width\"),\n        PropDef(\"height\", \"svg:height\"),\n        PropDef(\"style\", \"draw:style-name\"),\n        PropDef(\"pos_x\", \"svg:x\"),\n        PropDef(\"pos_y\", \"svg:y\"),\n        PropDef(\"presentation_class\", \"presentation:class\"),\n        PropDef(\"layer\", \"draw:layer\"),\n        PropDef(\"presentation_style\", \"presentation:style-name\"),\n    )\n\n    def __init__(  # noqa:  C901\n        self,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        size: tuple = (\"1cm\", \"1cm\"),\n        z_index: int = 0,\n        presentation_class: str | None = None,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        layer: str | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a frame element of the given size. Position is relative to the\n        context the frame is inserted in. If positioned by page, give the page\n        number and the x, y position.\n\n        Size is a (width, height) tuple and position is a (left, top) tuple; items\n        are strings including the unit, e.g. ('10cm', '15cm').\n\n        Frames are not useful by themselves. You should consider calling:\n            Frame.image_frame()\n        or\n            Frame.text_frame()\n\n\n        Arguments:\n\n            name -- str\n\n            draw_id -- str\n\n            style -- str\n\n            position -- (str, str)\n\n            size -- (str, str)\n\n            z_index -- int (default 0)\n\n            presentation_class -- str\n\n            anchor_type -- 'page', 'frame', 'paragraph', 'char' or 'as-char'\n\n            anchor_page -- int, page number is anchor_type is 'page'\n\n            layer -- str\n\n            presentation_style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.size = size\n            self.z_index = z_index\n            if name:\n                self.name = name\n            if draw_id is not None:\n                self.draw_id = draw_id\n            if style is not None:\n                self.style = style\n            if position is not None:\n                self.position = position\n            if presentation_class is not None:\n                self.presentation_class = presentation_class\n            if anchor_type:\n                self.anchor_type = anchor_type\n            if position and not anchor_type:\n                self.anchor_type = \"paragraph\"\n            if anchor_page is not None:\n                self.anchor_page = anchor_page\n            if layer is not None:\n                self.layer = layer\n            if presentation_style is not None:\n                self.presentation_style = presentation_style\n\n    @classmethod\n    def image_frame(\n        cls,\n        image: Element | str,\n        text: str | None = None,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        size: tuple = (\"1cm\", \"1cm\"),\n        z_index: int = 0,\n        presentation_class: str | None = None,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        layer: str | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; Element:\n        \"\"\"Create a ready-to-use image, since image must be embedded in a\n        frame.\n\n        The optionnal text will appear above the image.\n\n        Arguments:\n\n            image -- DrawImage or str, DrawImage element or URL of the image\n\n            text -- str, text for the image\n\n            See Frame() initialization for the other arguments\n\n        Return: Frame\n        \"\"\"\n        frame = cls(\n            name=name,\n            draw_id=draw_id,\n            style=style,\n            position=position,\n            size=size,\n            z_index=z_index,\n            presentation_class=presentation_class,\n            anchor_type=anchor_type,\n            anchor_page=anchor_page,\n            layer=layer,\n            presentation_style=presentation_style,\n            **kwargs,\n        )\n        image_element = frame.set_image(image)\n        if text:\n            image_element.text_content = text\n        return frame\n\n    @classmethod\n    def text_frame(\n        cls,\n        text_or_element: Iterable[Element] | Element | str,\n        text_style: str | None = None,\n        name: str | None = None,\n        draw_id: str | None = None,\n        style: str | None = None,\n        position: tuple | None = None,\n        size: tuple = (\"1cm\", \"1cm\"),\n        z_index: int = 0,\n        presentation_class: str | None = None,\n        anchor_type: str | None = None,\n        anchor_page: int | None = None,\n        layer: str | None = None,\n        presentation_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; Element:\n        \"\"\"Create a ready-to-use text box, since text box must be embedded in\n        a frame.\n\n        The optionnal text will appear above the image.\n\n        Arguments:\n\n            text_or_element -- str or Element, or list of them, text content\n                               of the text box.\n\n            text_style -- str, name of the style for the text\n\n            See Frame() initialization for the other arguments\n\n        Return: Frame\n        \"\"\"\n        frame = cls(\n            name=name,\n            draw_id=draw_id,\n            style=style,\n            position=position,\n            size=size,\n            z_index=z_index,\n            presentation_class=presentation_class,\n            anchor_type=anchor_type,\n            anchor_page=anchor_page,\n            layer=layer,\n            presentation_style=presentation_style,\n            **kwargs,\n        )\n        frame.set_text_box(text_or_element, text_style)\n        return frame\n\n    @property\n    def text_content(self) -&gt; str:\n        text_box = self.get_element(\"draw:text-box\")\n        if text_box is None:\n            return \"\"\n        return text_box.text_content\n\n    @text_content.setter\n    def text_content(self, text_or_element: Element | str) -&gt; None:\n        text_box = self.get_element(\"draw:text-box\")\n        if text_box is None:\n            text_box = Element.from_tag(\"draw:text-box\")\n            self.append(text_box)\n        if isinstance(text_or_element, Element):\n            text_box.clear()\n            text_box.append(text_or_element)\n        else:\n            text_box.text_content = text_or_element\n\n    def get_image(\n        self,\n        position: int = 0,\n        name: str | None = None,\n        url: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        return self.get_element(\"draw:image\")\n\n    def set_image(self, url_or_element: Element | str) -&gt; Element:\n        image = self.get_image()\n        if image is None:\n            if isinstance(url_or_element, Element):\n                image = url_or_element\n                self.append(image)\n            else:\n                image = DrawImage(url_or_element)\n                self.append(image)\n        else:\n            if isinstance(url_or_element, Element):\n                image.delete()\n                image = url_or_element\n                self.append(image)\n            else:\n                image.set_url(url_or_element)  # type: ignore\n        return image\n\n    def get_text_box(self) -&gt; Element | None:\n        return self.get_element(\"draw:text-box\")\n\n    def set_text_box(\n        self,\n        text_or_element: Iterable[Element | str] | Element | str,\n        text_style: str | None = None,\n    ) -&gt; Element:\n        text_box = self.get_text_box()\n        if text_box is None:\n            text_box = Element.from_tag(\"draw:text-box\")\n            self.append(text_box)\n        else:\n            text_box.clear()\n        if isinstance(text_or_element, (Element, str)):\n            text_or_element_list: Iterable[Element | str] = [text_or_element]\n        else:\n            text_or_element_list = text_or_element\n        for item in text_or_element_list:\n            if isinstance(item, str):\n                text_box.append(Paragraph(item, style=text_style))\n            else:\n                text_box.append(item)\n        return text_box\n\n    @staticmethod\n    def _get_formatted_text_subresult(context: dict, element: Element) -&gt; str:\n        str_list = [\"  \"]\n        for child in element.children:\n            str_list.append(child.get_formatted_text(context))\n        subresult = \"\".join(str_list)\n        subresult = subresult.replace(\"\\n\", \"\\n  \")\n        return subresult.rstrip(\" \")\n\n    def get_formatted_text(  # noqa:  C901\n        self,\n        context: dict | None = None,\n    ) -&gt; str:\n        if not context:\n            context = {}\n        result = []\n        for element in self.children:\n            tag = element.tag\n            if tag == \"draw:image\":\n                if context[\"rst_mode\"]:\n                    filename = element.get_attribute(\"xlink:href\")\n\n                    # Compute width and height\n                    width, height = self.size\n                    if width is not None:\n                        width = Unit(width)\n                        width = width.convert(\"px\", DPI)\n                    if height is not None:\n                        height = Unit(height)\n                        height = height.convert(\"px\", DPI)\n\n                    # Insert or not ?\n                    if context[\"no_img_level\"]:\n                        context[\"img_counter\"] += 1\n                        ref = f\"|img{context['img_counter']}|\"\n                        result.append(ref)\n                        context[\"images\"].append((ref, filename, (width, height)))\n                    else:\n                        result.append(f\"\\n.. image:: {filename}\\n\")\n                        if width is not None:\n                            result.append(f\"   :width: {width}\\n\")\n                        if height is not None:\n                            result.append(f\"   :height: {height}\\n\")\n                else:\n                    result.append(f\"[Image {element.get_attribute('xlink:href')}]\\n\")\n            elif tag == \"draw:text-box\":\n                result.append(self._get_formatted_text_subresult(context, element))\n            else:\n                result.append(element.get_formatted_text(context))\n        result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.Frame.__init__","title":"<code>__init__(name=None, draw_id=None, style=None, position=None, size=('1cm', '1cm'), z_index=0, presentation_class=None, anchor_type=None, anchor_page=None, layer=None, presentation_style=None, **kwargs)</code>","text":"<p>Create a frame element of the given size. Position is relative to the context the frame is inserted in. If positioned by page, give the page number and the x, y position.</p> <p>Size is a (width, height) tuple and position is a (left, top) tuple; items are strings including the unit, e.g. (\u201810cm\u2019, \u201815cm\u2019).</p> <p>Frames are not useful by themselves. You should consider calling:     Frame.image_frame() or     Frame.text_frame()</p> <p>Arguments:</p> <pre><code>name -- str\n\ndraw_id -- str\n\nstyle -- str\n\nposition -- (str, str)\n\nsize -- (str, str)\n\nz_index -- int (default 0)\n\npresentation_class -- str\n\nanchor_type -- 'page', 'frame', 'paragraph', 'char' or 'as-char'\n\nanchor_page -- int, page number is anchor_type is 'page'\n\nlayer -- str\n\npresentation_style -- str\n</code></pre> Source code in <code>odfdo/frame.py</code> <pre><code>def __init__(  # noqa:  C901\n    self,\n    name: str | None = None,\n    draw_id: str | None = None,\n    style: str | None = None,\n    position: tuple | None = None,\n    size: tuple = (\"1cm\", \"1cm\"),\n    z_index: int = 0,\n    presentation_class: str | None = None,\n    anchor_type: str | None = None,\n    anchor_page: int | None = None,\n    layer: str | None = None,\n    presentation_style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a frame element of the given size. Position is relative to the\n    context the frame is inserted in. If positioned by page, give the page\n    number and the x, y position.\n\n    Size is a (width, height) tuple and position is a (left, top) tuple; items\n    are strings including the unit, e.g. ('10cm', '15cm').\n\n    Frames are not useful by themselves. You should consider calling:\n        Frame.image_frame()\n    or\n        Frame.text_frame()\n\n\n    Arguments:\n\n        name -- str\n\n        draw_id -- str\n\n        style -- str\n\n        position -- (str, str)\n\n        size -- (str, str)\n\n        z_index -- int (default 0)\n\n        presentation_class -- str\n\n        anchor_type -- 'page', 'frame', 'paragraph', 'char' or 'as-char'\n\n        anchor_page -- int, page number is anchor_type is 'page'\n\n        layer -- str\n\n        presentation_style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.size = size\n        self.z_index = z_index\n        if name:\n            self.name = name\n        if draw_id is not None:\n            self.draw_id = draw_id\n        if style is not None:\n            self.style = style\n        if position is not None:\n            self.position = position\n        if presentation_class is not None:\n            self.presentation_class = presentation_class\n        if anchor_type:\n            self.anchor_type = anchor_type\n        if position and not anchor_type:\n            self.anchor_type = \"paragraph\"\n        if anchor_page is not None:\n            self.anchor_page = anchor_page\n        if layer is not None:\n            self.layer = layer\n        if presentation_style is not None:\n            self.presentation_style = presentation_style\n</code></pre>"},{"location":"reference.html#odfdo.Frame.image_frame","title":"<code>image_frame(image, text=None, name=None, draw_id=None, style=None, position=None, size=('1cm', '1cm'), z_index=0, presentation_class=None, anchor_type=None, anchor_page=None, layer=None, presentation_style=None, **kwargs)</code>  <code>classmethod</code>","text":"<p>Create a ready-to-use image, since image must be embedded in a frame.</p> <p>The optionnal text will appear above the image.</p> <p>Arguments:</p> <pre><code>image -- DrawImage or str, DrawImage element or URL of the image\n\ntext -- str, text for the image\n\nSee Frame() initialization for the other arguments\n</code></pre> <p>Return: Frame</p> Source code in <code>odfdo/frame.py</code> <pre><code>@classmethod\ndef image_frame(\n    cls,\n    image: Element | str,\n    text: str | None = None,\n    name: str | None = None,\n    draw_id: str | None = None,\n    style: str | None = None,\n    position: tuple | None = None,\n    size: tuple = (\"1cm\", \"1cm\"),\n    z_index: int = 0,\n    presentation_class: str | None = None,\n    anchor_type: str | None = None,\n    anchor_page: int | None = None,\n    layer: str | None = None,\n    presentation_style: str | None = None,\n    **kwargs: Any,\n) -&gt; Element:\n    \"\"\"Create a ready-to-use image, since image must be embedded in a\n    frame.\n\n    The optionnal text will appear above the image.\n\n    Arguments:\n\n        image -- DrawImage or str, DrawImage element or URL of the image\n\n        text -- str, text for the image\n\n        See Frame() initialization for the other arguments\n\n    Return: Frame\n    \"\"\"\n    frame = cls(\n        name=name,\n        draw_id=draw_id,\n        style=style,\n        position=position,\n        size=size,\n        z_index=z_index,\n        presentation_class=presentation_class,\n        anchor_type=anchor_type,\n        anchor_page=anchor_page,\n        layer=layer,\n        presentation_style=presentation_style,\n        **kwargs,\n    )\n    image_element = frame.set_image(image)\n    if text:\n        image_element.text_content = text\n    return frame\n</code></pre>"},{"location":"reference.html#odfdo.Frame.text_frame","title":"<code>text_frame(text_or_element, text_style=None, name=None, draw_id=None, style=None, position=None, size=('1cm', '1cm'), z_index=0, presentation_class=None, anchor_type=None, anchor_page=None, layer=None, presentation_style=None, **kwargs)</code>  <code>classmethod</code>","text":"<p>Create a ready-to-use text box, since text box must be embedded in a frame.</p> <p>The optionnal text will appear above the image.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or Element, or list of them, text content\n                   of the text box.\n\ntext_style -- str, name of the style for the text\n\nSee Frame() initialization for the other arguments\n</code></pre> <p>Return: Frame</p> Source code in <code>odfdo/frame.py</code> <pre><code>@classmethod\ndef text_frame(\n    cls,\n    text_or_element: Iterable[Element] | Element | str,\n    text_style: str | None = None,\n    name: str | None = None,\n    draw_id: str | None = None,\n    style: str | None = None,\n    position: tuple | None = None,\n    size: tuple = (\"1cm\", \"1cm\"),\n    z_index: int = 0,\n    presentation_class: str | None = None,\n    anchor_type: str | None = None,\n    anchor_page: int | None = None,\n    layer: str | None = None,\n    presentation_style: str | None = None,\n    **kwargs: Any,\n) -&gt; Element:\n    \"\"\"Create a ready-to-use text box, since text box must be embedded in\n    a frame.\n\n    The optionnal text will appear above the image.\n\n    Arguments:\n\n        text_or_element -- str or Element, or list of them, text content\n                           of the text box.\n\n        text_style -- str, name of the style for the text\n\n        See Frame() initialization for the other arguments\n\n    Return: Frame\n    \"\"\"\n    frame = cls(\n        name=name,\n        draw_id=draw_id,\n        style=style,\n        position=position,\n        size=size,\n        z_index=z_index,\n        presentation_class=presentation_class,\n        anchor_type=anchor_type,\n        anchor_page=anchor_page,\n        layer=layer,\n        presentation_style=presentation_style,\n        **kwargs,\n    )\n    frame.set_text_box(text_or_element, text_style)\n    return frame\n</code></pre>"},{"location":"reference.html#odfdo.Header","title":"<code>Header</code>","text":"<p>               Bases: <code>Paragraph</code></p> <p>Specialised paragraph for headings \u201ctext:h\u201d.</p> Source code in <code>odfdo/header.py</code> <pre><code>class Header(Paragraph):\n    \"\"\"Specialised paragraph for headings \"text:h\".\"\"\"\n\n    _tag = \"text:h\"\n    _properties = (\n        PropDef(\"level\", \"text:outline-level\"),\n        PropDef(\"restart_numbering\", \"text:restart-numbering\"),\n        PropDef(\"start_value\", \"text:start-value\"),\n        PropDef(\"suppress_numbering\", \"text:suppress-numbering\"),\n    )\n\n    def __init__(\n        self,\n        level: int = 1,\n        text: str | None = None,\n        restart_numbering: bool = False,\n        start_value: int | None = None,\n        suppress_numbering: bool = False,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a header element of the given style and level, containing the\n        optional given text.\n\n        Level count begins at 1.\n\n        Arguments:\n\n            level -- int\n\n            text -- str\n\n            restart_numbering -- bool\n\n            start_value -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.level = int(level)\n            if text:\n                self.text = text\n            if restart_numbering:\n                self.restart_numbering = True\n            if start_value is not None:\n                self.start_value = start_value\n            if suppress_numbering:\n                self.suppress_numbering = True\n            if style:\n                self.style = style\n\n    def get_formatted_text(\n        self,\n        context: dict | None = None,\n        simple: bool = False,\n    ) -&gt; str:\n        if not context:\n            context = {\n                \"document\": None,\n                \"footnotes\": [],\n                \"endnotes\": [],\n                \"annotations\": [],\n                \"rst_mode\": False,\n                \"img_counter\": 0,\n                \"images\": [],\n                \"no_img_level\": 0,\n            }\n        context[\"no_img_level\"] += 1\n        title = super().get_formatted_text(context)\n        context[\"no_img_level\"] -= 1\n        title = title.strip()\n        title = sub(r\"\\s+\", \" \", title)\n\n        # No rst_mode ?\n        if not context[\"rst_mode\"]:\n            return title\n        # If here in rst_mode!\n\n        # Get the level, max 5!\n        LEVEL_STYLES = \"#=-~`+^\u00b0'.\"\n        level = int(self.level)\n        if level &gt; len(LEVEL_STYLES):\n            raise ValueError(\"Too many levels of heading\")\n\n        # And return the result\n        result = [\"\\n\", title, \"\\n\", LEVEL_STYLES[level - 1] * len(title), \"\\n\"]\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.Header.__init__","title":"<code>__init__(level=1, text=None, restart_numbering=False, start_value=None, suppress_numbering=False, style=None, **kwargs)</code>","text":"<p>Create a header element of the given style and level, containing the optional given text.</p> <p>Level count begins at 1.</p> <p>Arguments:</p> <pre><code>level -- int\n\ntext -- str\n\nrestart_numbering -- bool\n\nstart_value -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/header.py</code> <pre><code>def __init__(\n    self,\n    level: int = 1,\n    text: str | None = None,\n    restart_numbering: bool = False,\n    start_value: int | None = None,\n    suppress_numbering: bool = False,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a header element of the given style and level, containing the\n    optional given text.\n\n    Level count begins at 1.\n\n    Arguments:\n\n        level -- int\n\n        text -- str\n\n        restart_numbering -- bool\n\n        start_value -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.level = int(level)\n        if text:\n            self.text = text\n        if restart_numbering:\n            self.restart_numbering = True\n        if start_value is not None:\n            self.start_value = start_value\n        if suppress_numbering:\n            self.suppress_numbering = True\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Image","title":"<code>Image</code>","text":"<p>               Bases: <code>Body</code></p> <p>Image, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Image(Body):\n    \"\"\"Image, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:image\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.IndexTitle","title":"<code>IndexTitle</code>","text":"<p>               Bases: <code>Element</code></p> <p>The \u201ctext:index-title\u201d element contains the title of an index.</p> <p>The element has the following attributes: text:name, text:protected, text:protection-key, text:protection-key-digest-algorithm, text:style-name, xml:id.</p> <p>The actual title is stored in a child element</p> Source code in <code>odfdo/toc.py</code> <pre><code>class IndexTitle(Element):\n    \"\"\"The \"text:index-title\" element contains the title of an index.\n\n    The element has the following attributes:\n    text:name, text:protected, text:protection-key,\n    text:protection-key-digest-algorithm, text:style-name, xml:id.\n\n    The actual title is stored in a child element\n    \"\"\"\n\n    _tag = \"text:index-title\"\n    _properties = (\n        PropDef(\"name\", \"text:name\"),\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"xml_id\", \"xml:id\"),\n        PropDef(\"protected\", \"text:protected\"),\n        PropDef(\"protection_key\", \"text:protection-key\"),\n        PropDef(\n            \"protection_key_digest_algorithm\", \"text:protection-key-digest-algorithm\"\n        ),\n    )\n\n    def __init__(\n        self,\n        name: str | None = None,\n        style: str | None = None,\n        title_text: str | None = None,\n        title_text_style: str | None = None,\n        xml_id: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if name:\n                self.name = name\n            if style:\n                self.style = style\n            if xml_id:\n                self.xml_id = xml_id\n            if title_text:\n                self.set_title_text(title_text, title_text_style)\n\n    def set_title_text(\n        self,\n        title_text: str,\n        title_text_style: str | None = None,\n    ) -&gt; None:\n        title = Paragraph(title_text, style=title_text_style)\n        self.append(title)\n</code></pre>"},{"location":"reference.html#odfdo.IndexTitleTemplate","title":"<code>IndexTitleTemplate</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF \u201ctext:index-title-template\u201d</p> <p>Arguments:</p> <pre><code>style -- str\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>class IndexTitleTemplate(Element):\n    \"\"\"ODF \"text:index-title-template\"\n\n    Arguments:\n\n        style -- str\n    \"\"\"\n\n    _tag = \"text:index-title-template\"\n    _properties = (PropDef(\"style\", \"text:style-name\"),)\n\n    def __init__(self, style: str | None = None, **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init and style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.LineBreak","title":"<code>LineBreak</code>","text":"<p>               Bases: <code>Element</code></p> <p>This element represents a line break \u201ctext:line-break\u201d</p> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>class LineBreak(Element):\n    \"\"\"This element represents a line break \"text:line-break\" \"\"\"\n\n    _tag = \"text:line-break\"\n\n    def __init__(self, **kwargs: Any) -&gt; None:\n        super().__init__(**kwargs)\n</code></pre>"},{"location":"reference.html#odfdo.LineShape","title":"<code>LineShape</code>","text":"<p>               Bases: <code>ShapeBase</code></p> <p>Create a line shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\np1 -- (str, str)\n\np2 -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class LineShape(ShapeBase):\n    \"\"\"Create a line shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        p1 -- (str, str)\n\n        p2 -- (str, str)\n    \"\"\"\n\n    _tag = \"draw:line\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"x1\", \"svg:x1\"),\n        PropDef(\"y1\", \"svg:y1\"),\n        PropDef(\"x2\", \"svg:x2\"),\n        PropDef(\"y2\", \"svg:y2\"),\n    )\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        p1: tuple | None = None,\n        p2: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n            }\n        )\n        super().__init__(**kwargs)\n        if self._do_init:\n            if p1:\n                self.x1 = p1[0]\n                self.y1 = p1[1]\n            if p2:\n                self.x2 = p2[0]\n                self.y2 = p2[1]\n</code></pre>"},{"location":"reference.html#odfdo.Link","title":"<code>Link</code>","text":"<p>               Bases: <code>ParagraphBase</code></p> <p>Link class, \u201ctext:a\u201d ODF element.</p> Source code in <code>odfdo/link.py</code> <pre><code>class Link(ParagraphBase):\n    \"\"\"Link class, \"text:a\" ODF element.\"\"\"\n\n    _tag = \"text:a\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"url\", \"xlink:href\"),\n        PropDef(\"name\", \"office:name\"),\n        PropDef(\"title\", \"office:title\"),\n        PropDef(\"target_frame\", \"office:target-frame-name\"),\n        PropDef(\"show\", \"xlink:show\"),\n        PropDef(\"visited_style\", \"text:visited-style-name\"),\n        PropDef(\"style\", \"text:style-name\"),\n    )\n\n    def __init__(\n        self,\n        url: str | None = \"\",\n        name: str | None = None,\n        title: str | None = None,\n        text: str | None = None,\n        target_frame: str | None = None,\n        style: str | None = None,\n        visited_style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            url -- str\n\n            name -- str\n\n            title -- str\n\n            text -- str\n\n            target_frame -- '_self', '_blank', '_parent', '_top'\n\n            style -- str\n\n            visited_style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.url = url\n            if name is not None:\n                self.name = name\n            if title is not None:\n                self.title = title\n            if text is not None:\n                self.text = text\n            if target_frame is not None:\n                self.target_frame = target_frame\n                # show can be: 'new' or 'replace'\"\n                if target_frame == \"_blank\":\n                    self.show = \"new\"\n                else:\n                    self.show = \"replace\"\n            if style is not None:\n                self.style = style\n            if visited_style is not None:\n                self.visited_style = visited_style\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag} link={self.url}&gt;\"\n\n    def __str__(self) -&gt; str:\n        if self.name:\n            return f\"[{self.name}]({self.url})\"\n        return f\"({self.url})\"\n</code></pre>"},{"location":"reference.html#odfdo.Link.__init__","title":"<code>__init__(url='', name=None, title=None, text=None, target_frame=None, style=None, visited_style=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>url -- str\n\nname -- str\n\ntitle -- str\n\ntext -- str\n\ntarget_frame -- '_self', '_blank', '_parent', '_top'\n\nstyle -- str\n\nvisited_style -- str\n</code></pre> Source code in <code>odfdo/link.py</code> <pre><code>def __init__(\n    self,\n    url: str | None = \"\",\n    name: str | None = None,\n    title: str | None = None,\n    text: str | None = None,\n    target_frame: str | None = None,\n    style: str | None = None,\n    visited_style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        url -- str\n\n        name -- str\n\n        title -- str\n\n        text -- str\n\n        target_frame -- '_self', '_blank', '_parent', '_top'\n\n        style -- str\n\n        visited_style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.url = url\n        if name is not None:\n            self.name = name\n        if title is not None:\n            self.title = title\n        if text is not None:\n            self.text = text\n        if target_frame is not None:\n            self.target_frame = target_frame\n            # show can be: 'new' or 'replace'\"\n            if target_frame == \"_blank\":\n                self.show = \"new\"\n            else:\n                self.show = \"replace\"\n        if style is not None:\n            self.style = style\n        if visited_style is not None:\n            self.visited_style = visited_style\n</code></pre>"},{"location":"reference.html#odfdo.List","title":"<code>List</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF List \u201ctext:list\u201d.</p> Source code in <code>odfdo/list.py</code> <pre><code>class List(Element):\n    \"\"\"ODF List \"text:list\".\"\"\"\n\n    _tag = \"text:list\"\n    _properties = (PropDef(\"style\", \"text:style-name\"),)\n\n    def __init__(\n        self,\n        list_content: str | Element | Iterable[str | Element] | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a list element, optionaly loading the list by a list of\n        item (str or elements).\n\n        The list_content argument is just a shortcut for the most common case.\n        To create more complex lists, first create an empty list, and fill it\n        afterwards.\n\n        Arguments:\n\n            list_content -- str or Element, or a list of str or Element\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if list_content:\n                if isinstance(list_content, (Element, str)):\n                    self.append(ListItem(list_content))\n                elif hasattr(list_content, \"__iter__\"):\n                    for item in list_content:\n                        self.append(ListItem(item))\n            if style is not None:\n                self.style = style\n\n    def get_items(self, content: str | None = None) -&gt; list[Element]:\n        \"\"\"Return all the list items that match the criteria.\n\n        Arguments:\n\n            style -- str\n\n            content -- str regex\n\n        Return: list of Element\n        \"\"\"\n        return self._filtered_elements(\"text:list-item\", content=content)\n\n    def get_item(\n        self,\n        position: int = 0,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        \"\"\"Return the list item that matches the criteria. In nested lists,\n        return the list item that really contains that content.\n\n        Arguments:\n\n            position -- int\n\n            content -- str regex\n\n        Return: Element or None if not found\n        \"\"\"\n        # Custom implementation because of nested lists\n        if content:\n            # Don't search recursively but on the very own paragraph(s) of\n            # each list item\n            for paragraph in self.get_elements(\"descendant::text:p\"):\n                if paragraph.match(content):\n                    return paragraph.get_element(\"parent::text:list-item\")\n            return None\n        return self._filtered_element(\"text:list-item\", position)\n\n    def set_list_header(\n        self,\n        text_or_element: str | Element | Iterable[str | Element],\n    ) -&gt; None:\n        if isinstance(text_or_element, (str, Element)):\n            actual_list: list[str | Element] | tuple = [text_or_element]\n        elif isinstance(text_or_element, (list, tuple)):\n            actual_list = text_or_element\n        else:\n            raise TypeError\n        # Remove existing header\n        for element in self.get_elements(\"text:p\"):\n            self.delete(element)\n        for paragraph in reversed(actual_list):\n            if isinstance(paragraph, str):\n                paragraph = Paragraph(paragraph)\n            self.insert(paragraph, FIRST_CHILD)\n\n    def insert_item(\n        self,\n        item: ListItem | str | Element | None,\n        position: int | None = None,\n        before: Element | None = None,\n        after: Element | None = None,\n    ) -&gt; None:\n        if not isinstance(item, ListItem):\n            item = ListItem(item)\n        if before is not None:\n            before.insert(item, xmlposition=PREV_SIBLING)\n        elif after is not None:\n            after.insert(item, xmlposition=NEXT_SIBLING)\n        elif position is not None:\n            self.insert(item, position=position)\n        else:\n            raise ValueError(\"Position must be defined\")\n\n    def append_item(\n        self,\n        item: ListItem | str | Element | None,\n    ) -&gt; None:\n        if not isinstance(item, ListItem):\n            item = ListItem(item)\n        self.append(item)\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        if context is None:\n            context = {}\n        rst_mode = context[\"rst_mode\"]\n        result = []\n        if rst_mode:\n            result.append(\"\\n\")\n        for list_item in self.get_elements(\"text:list-item\"):\n            textbuf = []\n            for child in list_item.children:\n                text = child.get_formatted_text(context)\n                tag = child.tag\n                if tag == \"text:h\":\n                    # A title in a list is a bug\n                    return text\n                if tag == \"text:list\" and not text.lstrip().startswith(\"-\"):\n                    # If the list didn't indent, don't either\n                    # (inner title)\n                    return text\n                textbuf.append(text)\n            text_sum = \"\".join(textbuf)\n            text_sum = text_sum.strip(\"\\n\")\n            # Indent the text\n            text_sum = text_sum.replace(\"\\n\", \"\\n  \")\n            text_sum = f\"- {text_sum}\\n\"\n            result.append(text_sum)\n        if rst_mode:\n            result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.List.__init__","title":"<code>__init__(list_content=None, style=None, **kwargs)</code>","text":"<p>Create a list element, optionaly loading the list by a list of item (str or elements).</p> <p>The list_content argument is just a shortcut for the most common case. To create more complex lists, first create an empty list, and fill it afterwards.</p> <p>Arguments:</p> <pre><code>list_content -- str or Element, or a list of str or Element\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/list.py</code> <pre><code>def __init__(\n    self,\n    list_content: str | Element | Iterable[str | Element] | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a list element, optionaly loading the list by a list of\n    item (str or elements).\n\n    The list_content argument is just a shortcut for the most common case.\n    To create more complex lists, first create an empty list, and fill it\n    afterwards.\n\n    Arguments:\n\n        list_content -- str or Element, or a list of str or Element\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if list_content:\n            if isinstance(list_content, (Element, str)):\n                self.append(ListItem(list_content))\n            elif hasattr(list_content, \"__iter__\"):\n                for item in list_content:\n                    self.append(ListItem(item))\n        if style is not None:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.List.get_item","title":"<code>get_item(position=0, content=None)</code>","text":"<p>Return the list item that matches the criteria. In nested lists, return the list item that really contains that content.</p> <p>Arguments:</p> <pre><code>position -- int\n\ncontent -- str regex\n</code></pre> <p>Return: Element or None if not found</p> Source code in <code>odfdo/list.py</code> <pre><code>def get_item(\n    self,\n    position: int = 0,\n    content: str | None = None,\n) -&gt; Element | None:\n    \"\"\"Return the list item that matches the criteria. In nested lists,\n    return the list item that really contains that content.\n\n    Arguments:\n\n        position -- int\n\n        content -- str regex\n\n    Return: Element or None if not found\n    \"\"\"\n    # Custom implementation because of nested lists\n    if content:\n        # Don't search recursively but on the very own paragraph(s) of\n        # each list item\n        for paragraph in self.get_elements(\"descendant::text:p\"):\n            if paragraph.match(content):\n                return paragraph.get_element(\"parent::text:list-item\")\n        return None\n    return self._filtered_element(\"text:list-item\", position)\n</code></pre>"},{"location":"reference.html#odfdo.List.get_items","title":"<code>get_items(content=None)</code>","text":"<p>Return all the list items that match the criteria.</p> <p>Arguments:</p> <pre><code>style -- str\n\ncontent -- str regex\n</code></pre> <p>Return: list of Element</p> Source code in <code>odfdo/list.py</code> <pre><code>def get_items(self, content: str | None = None) -&gt; list[Element]:\n    \"\"\"Return all the list items that match the criteria.\n\n    Arguments:\n\n        style -- str\n\n        content -- str regex\n\n    Return: list of Element\n    \"\"\"\n    return self._filtered_elements(\"text:list-item\", content=content)\n</code></pre>"},{"location":"reference.html#odfdo.ListItem","title":"<code>ListItem</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF element \u201ctext:list-item\u201d, item of a List.</p> Source code in <code>odfdo/list.py</code> <pre><code>class ListItem(Element):\n    \"\"\"ODF element \"text:list-item\", item of a List.\"\"\"\n\n    _tag = \"text:list-item\"\n\n    def __init__(\n        self,\n        text_or_element: str | Element | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a list item element, optionaly passing at creation time a\n        string or Element as content.\n\n        Arguments:\n\n            text_or_element -- str or ODF Element\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if isinstance(text_or_element, str):\n                self.text_content = text_or_element\n            elif isinstance(text_or_element, Element):\n                self.append(text_or_element)\n            elif text_or_element is not None:\n                raise TypeError(\"Expected str or Element\")\n</code></pre>"},{"location":"reference.html#odfdo.ListItem.__init__","title":"<code>__init__(text_or_element=None, **kwargs)</code>","text":"<p>Create a list item element, optionaly passing at creation time a string or Element as content.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or ODF Element\n</code></pre> Source code in <code>odfdo/list.py</code> <pre><code>def __init__(\n    self,\n    text_or_element: str | Element | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a list item element, optionaly passing at creation time a\n    string or Element as content.\n\n    Arguments:\n\n        text_or_element -- str or ODF Element\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if isinstance(text_or_element, str):\n            self.text_content = text_or_element\n        elif isinstance(text_or_element, Element):\n            self.append(text_or_element)\n        elif text_or_element is not None:\n            raise TypeError(\"Expected str or Element\")\n</code></pre>"},{"location":"reference.html#odfdo.Manifest","title":"<code>Manifest</code>","text":"<p>               Bases: <code>XmlPart</code></p> Source code in <code>odfdo/manifest.py</code> <pre><code>class Manifest(XmlPart):\n    def get_paths(self) -&gt; list[Element | EText]:\n        \"\"\"Return the list of full paths in the manifest.\n\n        Return: list of str\n        \"\"\"\n        xpath_query = \"//manifest:file-entry/attribute::manifest:full-path\"\n        return self.xpath(xpath_query)\n\n    def _file_entry(self, full_path: str) -&gt; Element:\n        xpath_query = (\n            f'//manifest:file-entry[attribute::manifest:full-path=\"{full_path}\"]'\n        )\n        result = self.xpath(xpath_query)\n        if not result:\n            raise KeyError(f\"Path not found: '{full_path}'\")\n        return result[0]  # type: ignore\n\n    def get_path_medias(self) -&gt; list[tuple]:\n        \"\"\"Return the list of (full_path, media_type) pairs in the manifest.\n\n        Return: list of str tuples\n        \"\"\"\n        xpath_query = \"//manifest:file-entry\"\n        result = []\n        for file_entry in self.xpath(xpath_query):\n            if not isinstance(file_entry, Element):\n                continue\n            result.append(\n                (\n                    file_entry.get_attribute_string(\"manifest:full-path\"),\n                    file_entry.get_attribute_string(\"manifest:media-type\"),\n                )\n            )\n        return result\n\n    def get_media_type(self, full_path: str) -&gt; str | None:\n        \"\"\"Get the media type of an existing path.\n\n        Return: str\n        \"\"\"\n        xpath_query = (\n            f'//manifest:file-entry[attribute::manifest:full-path=\"{full_path}\"]'\n            \"/attribute::manifest:media-type\"\n        )\n        result = self.xpath(xpath_query)\n        if not result:\n            return None\n        return str(result[0])\n\n    def set_media_type(self, full_path: str, media_type: str) -&gt; None:\n        \"\"\"Set the media type of an existing path.\n\n        Arguments:\n\n            full_path -- str\n\n            media_type -- str\n        \"\"\"\n        file_entry = self._file_entry(full_path)\n        file_entry.set_attribute(\"manifest:media-type\", media_type)\n\n    @staticmethod\n    def make_file_entry(full_path: str, media_type: str) -&gt; Element:\n        tag = (\n            f\"&lt;manifest:file-entry \"\n            f'manifest:media-type=\"{media_type}\" '\n            f'manifest:full-path=\"{full_path}\"/&gt;'\n        )\n        return Element.from_tag(tag)\n\n    def add_full_path(self, full_path: str, media_type: str = \"\") -&gt; None:\n        # Existing?\n        existing = self.get_media_type(full_path)\n        if existing is not None:\n            self.set_media_type(full_path, media_type)\n        root = self.root\n        root.append(self.make_file_entry(full_path, media_type))\n\n    def del_full_path(self, full_path: str) -&gt; None:\n        file_entry = self._file_entry(full_path)\n        self.root.delete(file_entry)\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.get_media_type","title":"<code>get_media_type(full_path)</code>","text":"<p>Get the media type of an existing path.</p> <p>Return: str</p> Source code in <code>odfdo/manifest.py</code> <pre><code>def get_media_type(self, full_path: str) -&gt; str | None:\n    \"\"\"Get the media type of an existing path.\n\n    Return: str\n    \"\"\"\n    xpath_query = (\n        f'//manifest:file-entry[attribute::manifest:full-path=\"{full_path}\"]'\n        \"/attribute::manifest:media-type\"\n    )\n    result = self.xpath(xpath_query)\n    if not result:\n        return None\n    return str(result[0])\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.get_path_medias","title":"<code>get_path_medias()</code>","text":"<p>Return the list of (full_path, media_type) pairs in the manifest.</p> <p>Return: list of str tuples</p> Source code in <code>odfdo/manifest.py</code> <pre><code>def get_path_medias(self) -&gt; list[tuple]:\n    \"\"\"Return the list of (full_path, media_type) pairs in the manifest.\n\n    Return: list of str tuples\n    \"\"\"\n    xpath_query = \"//manifest:file-entry\"\n    result = []\n    for file_entry in self.xpath(xpath_query):\n        if not isinstance(file_entry, Element):\n            continue\n        result.append(\n            (\n                file_entry.get_attribute_string(\"manifest:full-path\"),\n                file_entry.get_attribute_string(\"manifest:media-type\"),\n            )\n        )\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.get_paths","title":"<code>get_paths()</code>","text":"<p>Return the list of full paths in the manifest.</p> <p>Return: list of str</p> Source code in <code>odfdo/manifest.py</code> <pre><code>def get_paths(self) -&gt; list[Element | EText]:\n    \"\"\"Return the list of full paths in the manifest.\n\n    Return: list of str\n    \"\"\"\n    xpath_query = \"//manifest:file-entry/attribute::manifest:full-path\"\n    return self.xpath(xpath_query)\n</code></pre>"},{"location":"reference.html#odfdo.Manifest.set_media_type","title":"<code>set_media_type(full_path, media_type)</code>","text":"<p>Set the media type of an existing path.</p> <p>Arguments:</p> <pre><code>full_path -- str\n\nmedia_type -- str\n</code></pre> Source code in <code>odfdo/manifest.py</code> <pre><code>def set_media_type(self, full_path: str, media_type: str) -&gt; None:\n    \"\"\"Set the media type of an existing path.\n\n    Arguments:\n\n        full_path -- str\n\n        media_type -- str\n    \"\"\"\n    file_entry = self._file_entry(full_path)\n    file_entry.set_attribute(\"manifest:media-type\", media_type)\n</code></pre>"},{"location":"reference.html#odfdo.Meta","title":"<code>Meta</code>","text":"<p>               Bases: <code>XmlPart</code>, <code>DcCreatorMixin</code>, <code>DcDateMixin</code></p> Source code in <code>odfdo/meta.py</code> <pre><code>class Meta(XmlPart, DcCreatorMixin, DcDateMixin):\n    def __init__(self, *args: Any, **kwargs: Any) -&gt; None:\n        super().__init__(*args, **kwargs)\n        self._generator_modified: bool = False\n\n    def get_meta_body(self) -&gt; Element:\n        return self.get_element(\"//office:meta\")\n\n    def get_title(self) -&gt; str | None:\n        \"\"\"Get the title of the document.\n\n        This is not the first heading but the title metadata.\n\n        (Also available as \"self.title\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//dc:title\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_title(self, title: str) -&gt; None:\n        \"\"\"Set the title of the document.\n\n        This is not the first heading but the title metadata.\n\n        (Also available as \"self.title\" property.)\n\n        Arguments:\n\n            title -- str\n        \"\"\"\n        element = self.get_element(\"//dc:title\")\n        if element is None:\n            element = Element.from_tag(\"dc:title\")\n            self.get_meta_body().append(element)\n        element.text = title\n\n    @property\n    def title(self) -&gt; str | None:\n        \"\"\"Get or set the title of the document &lt;dc:title&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_title()\n\n    @title.setter\n    def title(self, title: str) -&gt; None:\n        return self.set_title(title)\n\n    def get_description(self) -&gt; str | None:\n        \"\"\"Get the description of the document. Also known as comments.\n\n        (Also available as \"self.description\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//dc:description\")\n        if element is None:\n            return None\n        return element.text\n\n    # As named in OOo\n    get_comments = get_description\n\n    def set_description(self, description: str) -&gt; None:\n        \"\"\"Set the description of the document. Also known as comments.\n\n        (Also available as \"self.description\" property.)\n\n        Arguments:\n\n            description -- str\n        \"\"\"\n        element = self.get_element(\"//dc:description\")\n        if element is None:\n            element = Element.from_tag(\"dc:description\")\n            self.get_meta_body().append(element)\n        element.text = description\n\n    set_comments = set_description\n\n    @property\n    def description(self) -&gt; str | None:\n        \"\"\"Get or set the description of a document &lt;dc:description&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_description()\n\n    @description.setter\n    def description(self, description: str) -&gt; None:\n        return self.set_description(description)\n\n    def get_subject(self) -&gt; str | None:\n        \"\"\"Get the subject of the document.\n\n        (Also available as \"self.subject\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//dc:subject\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_subject(self, subject: str) -&gt; None:\n        \"\"\"Set the subject of the document.\n\n        (Also available as \"self.subject\" property.)\n\n        Arguments:\n\n            subject -- str\n        \"\"\"\n        element = self.get_element(\"//dc:subject\")\n        if element is None:\n            element = Element.from_tag(\"dc:subject\")\n            self.get_meta_body().append(element)\n        element.text = subject\n\n    @property\n    def subject(self) -&gt; str | None:\n        \"\"\"Get or set the subject of a document &lt;dc:subject&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_subject()\n\n    @subject.setter\n    def subject(self, subject: str) -&gt; None:\n        return self.set_subject(subject)\n\n    def get_language(self) -&gt; str | None:\n        \"\"\"Get the default language of the document.\n\n        (Also available as \"self.language\" property.)\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.get_language()\n            fr-FR\n        \"\"\"\n        element = self.get_element(\"//dc:language\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_language(self, language: str) -&gt; None:\n        \"\"\"Set the default language of the document.\n\n        (Also available as \"self.language\" property.)\n\n        Arguments:\n\n            language -- str\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_language('fr-FR')\n        \"\"\"\n        language = str(language)\n        if not self._is_RFC3066(language):\n            raise TypeError(\n                'Language must be \"xx\" lang or \"xx-YY\" lang-COUNTRY code (RFC3066)'\n            )\n        element = self.get_element(\"//dc:language\")\n        if element is None:\n            element = Element.from_tag(\"dc:language\")\n            self.get_meta_body().append(element)\n        element.text = language\n\n    @staticmethod\n    def _is_RFC3066(lang: str) -&gt; bool:\n        def test_part1(part1: str) -&gt; bool:\n            if not 2 &lt;= len(part1) &lt;= 3:\n                return False\n            return all(x in ascii_letters for x in part1)\n\n        def test_part2(part2: str) -&gt; bool:\n            return all(x in ascii_letters or x in digits for x in part2)\n\n        if not lang or not isinstance(lang, str):\n            return False\n        if \"-\" not in lang:\n            return test_part1(lang)\n        parts = lang.split(\"-\")\n        if len(parts) &gt; 3:\n            return False\n        if not test_part1(parts[0]):\n            return False\n        return all(test_part2(p) for p in parts[1:])\n\n    @property\n    def language(self) -&gt; str | None:\n        \"\"\"Get or set the default language of the document &lt;dc:language&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_language()\n\n    @language.setter\n    def language(self, language: str) -&gt; None:\n        return self.set_language(language)\n\n    def get_creation_date(self) -&gt; datetime | None:\n        \"\"\"Get the creation date of the document.\n\n        (Also available as \"self.creation_date\" property.)\n\n        Return: datetime (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:creation-date\")\n        if element is None:\n            return None\n        creation_date = element.text\n        return DateTime.decode(creation_date)\n\n    def set_creation_date(self, date: datetime | None = None) -&gt; None:\n        \"\"\"Set the creation date of the document.\n\n        If provided datetime is None, use current time.\n\n        (Also available as \"self.creation_date\" property.)\n\n        Arguments:\n\n            date -- datetime\n        \"\"\"\n        element = self.get_element(\"//meta:creation-date\")\n        if element is None:\n            element = Element.from_tag(\"meta:creation-date\")\n            self.get_meta_body().append(element)\n        if date is None:\n            date = datetime.now()\n        element.text = DateTime.encode(date)\n\n    @property\n    def creation_date(self) -&gt; datetime | None:\n        \"\"\"Get or set the date and time when a document was created\n        &lt;meta:creation-date&gt;.\n\n        If provided datetime is None, use current time.\n\n        Return: datetime (or None if inexistant)\n        \"\"\"\n        return self.get_creation_date()\n\n    @creation_date.setter\n    def creation_date(self, date: datetime | None = None) -&gt; None:\n        return self.set_creation_date(date)\n\n    @property\n    def print_date(self) -&gt; datetime | None:\n        \"\"\"Get or set the date and time when a document when a document was last printed\n        &lt;meta:print-date&gt;\n\n        If provided datetime is None, use current time.\n\n        Return: datetime (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:print-date\")\n        if element is None:\n            return None\n        date = element.text\n        return DateTime.decode(date)\n\n    @print_date.setter\n    def print_date(self, date: datetime | None = None) -&gt; None:\n        element = self.get_element(\"//meta:print-date\")\n        if element is None:\n            element = Element.from_tag(\"meta:print-date\")\n            self.get_meta_body().append(element)\n        if date is None:\n            date = datetime.now()\n        element.text = DateTime.encode(date)\n\n    def get_template(self) -&gt; MetaTemplate | None:\n        \"\"\"Get the MetaTemplate &lt;meta:template&gt; element or None.\"\"\"\n        element = self.get_element(\"//meta:template\")\n        if element is None:\n            return None\n        return element\n\n    @property\n    def template(self) -&gt; MetaTemplate | None:\n        \"\"\"Get the MetaTemplate &lt;meta:template&gt; element or None.\"\"\"\n        return self.get_template()\n\n    def set_template(\n        self,\n        date: datetime | None = None,\n        href: str = \"\",\n        title: str = \"\",\n    ) -&gt; None:\n        \"\"\"Set the MetaTemplate &lt;meta:template&gt; element.\"\"\"\n        template = MetaTemplate(date=date, href=href, title=title)\n        current = self.template\n        if isinstance(current, MetaTemplate):\n            current.delete()\n        self.get_meta_body().append(template)\n\n    def get_auto_reload(self) -&gt; MetaAutoReload | None:\n        \"\"\"Get the MetaAutoReload &lt;meta:auto-reload&gt; element or None.\"\"\"\n        element = self.get_element(\"//meta:auto-reload\")\n        if element is None:\n            return None\n        return element\n\n    @property\n    def auto_reload(self) -&gt; MetaAutoReload | None:\n        \"\"\"Get the MetaAutoReload &lt;meta:auto-reload&gt; element or None.\"\"\"\n        return self.get_auto_reload()\n\n    def set_auto_reload(self, delay: timedelta, href: str = \"\") -&gt; None:\n        \"\"\"Set the MetaAutoReload &lt;meta:auto-reload&gt; element.\"\"\"\n        autoreload = MetaAutoReload(delay=delay, href=href)\n        current = self.auto_reload\n        if isinstance(current, MetaAutoReload):\n            current.delete()\n        self.get_meta_body().append(autoreload)\n\n    def get_hyperlink_behaviour(self) -&gt; MetaHyperlinkBehaviour | None:\n        \"\"\"Get the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element or None.\"\"\"\n        element = self.get_element(\"//meta:hyperlink-behaviour\")\n        if element is None:\n            return None\n        return element\n\n    @property\n    def hyperlink_behaviour(self) -&gt; MetaAutoReload | None:\n        \"\"\"Get the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element or None.\"\"\"\n        return self.get_hyperlink_behaviour()\n\n    def set_hyperlink_behaviour(\n        self,\n        target_frame_name: str = \"_blank\",\n        show: str = \"replace\",\n    ) -&gt; None:\n        \"\"\"Set the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element.\"\"\"\n        behaviour = MetaHyperlinkBehaviour(\n            target_frame_name=target_frame_name, show=show\n        )\n        current = self.hyperlink_behaviour\n        if isinstance(current, MetaHyperlinkBehaviour):\n            current.delete()\n        self.get_meta_body().append(behaviour)\n\n    def get_initial_creator(self) -&gt; str | None:\n        \"\"\"Get the first creator of the document.\n\n        (Also available as \"self.initial_creator\" property.)\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.get_initial_creator()\n            Unknown\n        \"\"\"\n        element = self.get_element(\"//meta:initial-creator\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_initial_creator(self, creator: str) -&gt; None:\n        \"\"\"Set the first creator of the document.\n\n        (Also available as \"self.initial_creator\" property.)\n\n        Arguments:\n\n            creator -- str\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_initial_creator(\"Plato\")\n        \"\"\"\n        element = self.get_element(\"//meta:initial-creator\")\n        if element is None:\n            element = Element.from_tag(\"meta:initial-creator\")\n            self.get_meta_body().append(element)\n        element.text = creator\n\n    @property\n    def initial_creator(self) -&gt; str | None:\n        \"\"\"Get or set the initial creator of a document\n        &lt;meta:initial-creator&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_initial_creator()\n\n    @initial_creator.setter\n    def initial_creator(self, creator: str) -&gt; None:\n        return self.set_initial_creator(creator)\n\n    @property\n    def printed_by(self) -&gt; str | None:\n        \"\"\"Get or set the name of the last person who printed a document.\n        &lt;meta:printed-by&gt;\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:printed-by\")\n        if element is None:\n            return None\n        return element.text\n\n    @printed_by.setter\n    def printed_by(self, printed_by: str) -&gt; None:\n        element = self.get_element(\"//meta:printed-by\")\n        if element is None:\n            element = Element.from_tag(\"meta:printed-by\")\n            self.get_meta_body().append(element)\n        element.text = printed_by\n\n    def get_keywords(self) -&gt; str | None:\n        \"\"\"Get the keywords of the document. Return the field as-is, without\n        any assumption on the keyword separator.\n\n        (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:keyword\")\n        if element is None:\n            return None\n        return element.text\n\n    def set_keywords(self, keywords: str) -&gt; None:\n        \"\"\"Set the keywords of the document. Although the name is plural, a\n        str string is required, so join your list first.\n\n        (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n        Arguments:\n\n            keywords -- str\n        \"\"\"\n        element = self.get_element(\"//meta:keyword\")\n        if element is None:\n            element = Element.from_tag(\"meta:keyword\")\n            self.get_meta_body().append(element)\n        element.text = keywords\n\n    @property\n    def keyword(self) -&gt; str | None:\n        \"\"\"Get or set some keyword(s) keyword pertaining to a document\n        &lt;dc:keyword&gt;.\n\n        Return: str (or None if inexistant)\n        \"\"\"\n        return self.get_keywords()\n\n    @keyword.setter\n    def keyword(self, keyword: str) -&gt; None:\n        return self.set_keywords(keyword)\n\n    keywords = keyword\n\n    def get_editing_duration(self) -&gt; timedelta | None:\n        \"\"\"Get the time the document was edited, as reported by the\n        generator.\n\n        (Also available as \"self.editing_duration\" property.)\n\n        Return: timedelta (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:editing-duration\")\n        if element is None:\n            return None\n        duration = element.text\n        return Duration.decode(duration)\n\n    def set_editing_duration(self, duration: timedelta) -&gt; None:\n        \"\"\"Set the time the document was edited.\n\n        (Also available as \"self.editing_duration\" property.)\n\n        Arguments:\n\n            duration -- timedelta\n        \"\"\"\n        if not isinstance(duration, timedelta):\n            raise TypeError(\"duration must be a timedelta\")\n        element = self.get_element(\"//meta:editing-duration\")\n        if element is None:\n            element = Element.from_tag(\"meta:editing-duration\")\n            self.get_meta_body().append(element)\n        element.text = Duration.encode(duration)\n\n    @property\n    def editing_duration(self) -&gt; timedelta | None:\n        \"\"\"Get or set the total time spent editing a document\n        &lt;meta:editing-duration&gt;.\n\n        Return: timedelta (or None if inexistant)\n        \"\"\"\n        return self.get_editing_duration()\n\n    @editing_duration.setter\n    def editing_duration(self, duration: timedelta) -&gt; None:\n        return self.set_editing_duration(duration)\n\n    def get_editing_cycles(self) -&gt; int | None:\n        \"\"\"Get the number of times the document was edited, as reported by\n        the generator.\n\n        (Also available as \"self.editing_cycles\" property.)\n\n        Return: int (or None if inexistant)\n        \"\"\"\n        element = self.get_element(\"//meta:editing-cycles\")\n        if element is None:\n            return None\n        cycles = element.text\n        return int(cycles)\n\n    def set_editing_cycles(self, cycles: int) -&gt; None:\n        \"\"\"Set the number of times the document was edited.\n\n        (Also available as \"self.editing_cycles\" property.)\n\n        Arguments:\n\n            cycles -- int\n        \"\"\"\n        if not isinstance(cycles, int):\n            raise TypeError(\"cycles must be an int\")\n        if cycles &lt; 1:\n            raise ValueError(\"cycles must be a positive int\")\n        element = self.get_element(\"//meta:editing-cycles\")\n        if element is None:\n            element = Element.from_tag(\"meta:editing-cycles\")\n            self.get_meta_body().append(element)\n        element.text = str(cycles)\n\n    @property\n    def editing_cycles(self) -&gt; int | None:\n        \"\"\"Get or set the number of times a document has been edited\n        &lt;meta:editing-cycles&gt;.\n\n        When a document is created, this value is set to 1. Each time\n        a document is saved, the editing-cycles number is incremented by 1.\n\n        Return: int (or None if inexistant)\n        \"\"\"\n        return self.get_editing_cycles()\n\n    @editing_cycles.setter\n    def editing_cycles(self, cycles: int) -&gt; None:\n        return self.set_editing_cycles(cycles)\n\n    @property\n    def generator(self) -&gt; str | None:\n        \"\"\"Get or set the signature of the software that generated this\n        document.\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.generator\n            KOffice/2.0.0\n            &gt;&gt;&gt; document.meta.generator = \"Odfdo experiment\"\n        \"\"\"\n        element = self.get_element(\"//meta:generator\")\n        if element is None:\n            return None\n        return element.text\n\n    @generator.setter\n    def generator(self, generator: str) -&gt; None:\n        element = self.get_element(\"//meta:generator\")\n        if element is None:\n            element = Element.from_tag(\"meta:generator\")\n            self.get_meta_body().append(element)\n        element.text = generator\n        self._generator_modified = True\n\n    def get_generator(self) -&gt; str | None:\n        \"\"\"Get the signature of the software that generated this document.\n\n        (Also available as \"self.generator\" property.)\n\n        Return: str (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.get_generator()\n            KOffice/2.0.0\n        \"\"\"\n        return self.generator\n\n    def set_generator(self, generator: str) -&gt; None:\n        \"\"\"Set the signature of the software that generated this document.\n\n        (Also available as \"self.generator\" property.)\n\n        Arguments:\n\n            generator -- str\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_generator(\"Odfdo experiment\")\n        \"\"\"\n        self.generator = generator\n\n    def set_generator_default(self) -&gt; None:\n        \"\"\"Set the signature of the software that generated this document\n        to ourself.\n\n        Example::\n\n            &gt;&gt;&gt; document.meta.set_generator_default()\n        \"\"\"\n        if not self._generator_modified:\n            self.generator = GENERATOR\n\n    def get_statistic(self) -&gt; dict[str, int] | None:\n        \"\"\"Get the statistics about a document.\n\n        (Also available as \"self.statistic\" property.)\n\n        Return: dict (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.get_statistic():\n            {'meta:table-count': 1,\n             'meta:image-count': 2,\n             'meta:object-count': 3,\n             'meta:page-count': 4,\n             'meta:paragraph-count': 5,\n             'meta:word-count': 6,\n             'meta:character-count': 7}\n        \"\"\"\n        element = self.get_element(\"//meta:document-statistic\")\n        if element is None:\n            return None\n        statistic = {}\n        for key, value in element.attributes.items():\n            statistic[to_str(key)] = int(value)\n        return statistic\n\n    def set_statistic(self, statistic: dict[str, int]) -&gt; None:\n        \"\"\"Set the statistics about a document.\n\n        (Also available as \"self.statistic\" property.)\n\n        Arguments:\n\n            statistic -- dict\n\n        Example::\n\n            &gt;&gt;&gt; statistic = {'meta:table-count': 1,\n                             'meta:image-count': 2,\n                             'meta:object-count': 3,\n                             'meta:page-count': 4,\n                             'meta:paragraph-count': 5,\n                             'meta:word-count': 6,\n                             'meta:character-count': 7}\n            &gt;&gt;&gt; document.meta.set_statistic(statistic)\n        \"\"\"\n        if not isinstance(statistic, dict):\n            raise TypeError(\"Statistic must be a dict\")\n        element = self.get_element(\"//meta:document-statistic\")\n        for key, value in statistic.items():\n            try:\n                ivalue = int(value)\n            except ValueError as e:\n                raise TypeError(\"Statistic value must be a int\") from e\n            element.set_attribute(to_str(key), str(ivalue))\n\n    @property\n    def statistic(self) -&gt; dict[str, int] | None:\n        \"\"\"Get or set the statistics about a document\n        &lt;meta:document-statistic&gt;.\n\n        Return: dict (or None if inexistant)\n\n        Example::\n\n            &gt;&gt;&gt; document.get_statistic():\n            {'meta:table-count': 1,\n             'meta:image-count': 2,\n             'meta:object-count': 3,\n             'meta:page-count': 4,\n             'meta:paragraph-count': 5,\n             'meta:word-count': 6,\n             'meta:character-count': 7}\n        \"\"\"\n        return self.get_statistic()\n\n    @statistic.setter\n    def statistic(self, statistic: dict[str, int]) -&gt; None:\n        return self.set_statistic(statistic)\n\n    def get_user_defined_metadata(self) -&gt; dict[str, Any]:\n        \"\"\"Get all additional user-defined metadata for a document.\n\n        (Also available as \"self.user_defined_metadata\" property.)\n\n        Return a dict of str/value mapping.\n\n        Value types can be: Decimal, date, time, boolean or str.\n        \"\"\"\n        result: dict[str, Any] = {}\n        for item in self.get_elements(\"//meta:user-defined\"):\n            if not isinstance(item, Element):\n                continue\n            # Read the values\n            name = item.get_attribute_string(\"meta:name\")\n            if name is None:\n                continue\n            value = self._get_meta_value(item)\n            result[name] = value\n        return result\n\n    def clear_user_defined_metadata(self) -&gt; None:\n        \"\"\"Remove all user-defined metadata.\"\"\"\n        while True:\n            element = self.get_element(\"//meta:user-defined\")\n            if isinstance(element, Element):\n                element.delete()\n                continue\n            break\n\n    @property\n    def user_defined_metadata(self) -&gt; dict[str, Any]:\n        \"\"\"Get or set all additional user-defined metadata for a document.\n\n        Return a dict of str/value mapping.\n\n        Value types can be: Decimal, date, time, boolean or str.\n        \"\"\"\n        return self.get_user_defined_metadata()\n\n    @user_defined_metadata.setter\n    def user_defined_metadata(self, metadata: dict[str, Any]) -&gt; None:\n        self.clear_user_defined_metadata()\n        for key, val in metadata.items():\n            self.set_user_defined_metadata(name=key, value=val)\n\n    def get_user_defined_metadata_of_name(self, keyname: str) -&gt; dict[str, Any] | None:\n        \"\"\"Return the content of the user defined metadata of that name.\n        Return None if no name matchs or a dic of fields.\n\n        Arguments:\n\n            name -- string, name (meta:name content)\n        \"\"\"\n        result = {}\n        found = False\n        for item in self.get_elements(\"//meta:user-defined\"):\n            if not isinstance(item, Element):\n                continue\n            # Read the values\n            name = item.get_attribute(\"meta:name\")\n            if name == keyname:\n                found = True\n                break\n        if not found:\n            return None\n        result[\"name\"] = name\n        value, value_type, text = self._get_meta_value(item, full=True)  # type: ignore\n        result[\"value\"] = value\n        result[\"value_type\"] = value_type\n        result[\"text\"] = text\n        return result\n\n    def set_user_defined_metadata(self, name: str, value: Any) -&gt; None:\n        if isinstance(value, bool):\n            value_type = \"boolean\"\n            value = \"true\" if value else \"false\"\n        elif isinstance(value, (int, float, Decimal)):\n            value_type = \"float\"\n            value = str(value)\n        elif isinstance(value, dtdate):\n            value_type = \"date\"\n            value = str(Date.encode(value))\n        elif isinstance(value, datetime):\n            value_type = \"date\"\n            value = str(DateTime.encode(value))\n        elif isinstance(value, str):\n            value_type = \"string\"\n        elif isinstance(value, timedelta):\n            value_type = \"time\"\n            value = str(Duration.encode(value))\n        else:\n            raise TypeError(f'unexpected type \"{type(value)}\" for value')\n        # Already the same element ?\n        for metadata in self.get_elements(\"//meta:user-defined\"):\n            if not isinstance(metadata, Element):\n                continue\n            if metadata.get_attribute(\"meta:name\") == name:\n                break\n        else:\n            metadata = Element.from_tag(\"meta:user-defined\")\n            metadata.set_attribute(\"meta:name\", name)\n            self.get_meta_body().append(metadata)\n        metadata.set_attribute(\"meta:value-type\", value_type)\n        metadata.text = value\n\n    def _get_meta_value(\n        self, element: Element, full: bool = False\n    ) -&gt; Any | tuple[Any, str, str]:\n        \"\"\"get_value() deicated to the meta data part, for one meta element.\"\"\"\n        if full:\n            return self._get_meta_value_full(element)\n        else:\n            return self._get_meta_value_full(element)[0]\n\n    @staticmethod\n    def _get_meta_value_full(element: Element) -&gt; tuple[Any, str, str]:\n        \"\"\"get_value deicated to the meta data part, for one meta element.\"\"\"\n        # name = element.get_attribute('meta:name')\n        value_type = element.get_attribute_string(\"meta:value-type\")\n        if value_type is None:\n            value_type = \"string\"\n        text = element.text\n        # Interpretation\n        if value_type == \"boolean\":\n            return (Boolean.decode(text), value_type, text)\n        if value_type in (\"float\", \"percentage\", \"currency\"):\n            return (Decimal(text), value_type, text)\n        if value_type == \"date\":\n            if \"T\" in text:\n                return (DateTime.decode(text), value_type, text)\n            else:\n                return (Date.decode(text), value_type, text)\n        if value_type == \"string\":\n            return (text, value_type, text)\n        if value_type == \"time\":\n            return (Duration.decode(text), value_type, text)\n        raise TypeError(f\"Unknown value type: '{value_type!r}'\")\n</code></pre>"},{"location":"reference.html#odfdo.Meta.auto_reload","title":"<code>auto_reload: MetaAutoReload | None</code>  <code>property</code>","text":"<p>Get the MetaAutoReload  element or None."},{"location":"reference.html#odfdo.Meta.creation_date","title":"<code>creation_date: datetime | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the date and time when a document was created . <p>If provided datetime is None, use current time.</p> <p>Return: datetime (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.description","title":"<code>description: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the description of a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.editing_cycles","title":"<code>editing_cycles: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the number of times a document has been edited . <p>When a document is created, this value is set to 1. Each time a document is saved, the editing-cycles number is incremented by 1.</p> <p>Return: int (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.editing_duration","title":"<code>editing_duration: timedelta | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the total time spent editing a document . <p>Return: timedelta (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.generator","title":"<code>generator: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the signature of the software that generated this document.</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.generator\nKOffice/2.0.0\n&gt;&gt;&gt; document.meta.generator = \"Odfdo experiment\"\n</code></pre>"},{"location":"reference.html#odfdo.Meta.hyperlink_behaviour","title":"<code>hyperlink_behaviour: MetaAutoReload | None</code>  <code>property</code>","text":"<p>Get the MetaHyperlinkBehaviour  element or None."},{"location":"reference.html#odfdo.Meta.initial_creator","title":"<code>initial_creator: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the initial creator of a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.keyword","title":"<code>keyword: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set some keyword(s) keyword pertaining to a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.language","title":"<code>language: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the default language of the document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.print_date","title":"<code>print_date: datetime | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the date and time when a document when a document was last printed  <p>If provided datetime is None, use current time.</p> <p>Return: datetime (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.printed_by","title":"<code>printed_by: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the name of the last person who printed a document.  <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.statistic","title":"<code>statistic: dict[str, int] | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the statistics about a document . <p>Return: dict (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.get_statistic():\n{'meta:table-count': 1,\n 'meta:image-count': 2,\n 'meta:object-count': 3,\n 'meta:page-count': 4,\n 'meta:paragraph-count': 5,\n 'meta:word-count': 6,\n 'meta:character-count': 7}\n</code></pre>"},{"location":"reference.html#odfdo.Meta.subject","title":"<code>subject: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the subject of a document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.template","title":"<code>template: MetaTemplate | None</code>  <code>property</code>","text":"<p>Get the MetaTemplate  element or None."},{"location":"reference.html#odfdo.Meta.title","title":"<code>title: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the title of the document . <p>Return: str (or None if inexistant)</p>"},{"location":"reference.html#odfdo.Meta.user_defined_metadata","title":"<code>user_defined_metadata: dict[str, Any]</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set all additional user-defined metadata for a document.</p> <p>Return a dict of str/value mapping.</p> <p>Value types can be: Decimal, date, time, boolean or str.</p>"},{"location":"reference.html#odfdo.Meta.clear_user_defined_metadata","title":"<code>clear_user_defined_metadata()</code>","text":"<p>Remove all user-defined metadata.</p> Source code in <code>odfdo/meta.py</code> <pre><code>def clear_user_defined_metadata(self) -&gt; None:\n    \"\"\"Remove all user-defined metadata.\"\"\"\n    while True:\n        element = self.get_element(\"//meta:user-defined\")\n        if isinstance(element, Element):\n            element.delete()\n            continue\n        break\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_auto_reload","title":"<code>get_auto_reload()</code>","text":"<p>Get the MetaAutoReload  element or None. Source code in <code>odfdo/meta.py</code> <pre><code>def get_auto_reload(self) -&gt; MetaAutoReload | None:\n    \"\"\"Get the MetaAutoReload &lt;meta:auto-reload&gt; element or None.\"\"\"\n    element = self.get_element(\"//meta:auto-reload\")\n    if element is None:\n        return None\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_creation_date","title":"<code>get_creation_date()</code>","text":"<p>Get the creation date of the document.</p> <p>(Also available as \u201cself.creation_date\u201d property.)</p> <p>Return: datetime (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_creation_date(self) -&gt; datetime | None:\n    \"\"\"Get the creation date of the document.\n\n    (Also available as \"self.creation_date\" property.)\n\n    Return: datetime (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:creation-date\")\n    if element is None:\n        return None\n    creation_date = element.text\n    return DateTime.decode(creation_date)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_description","title":"<code>get_description()</code>","text":"<p>Get the description of the document. Also known as comments.</p> <p>(Also available as \u201cself.description\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_description(self) -&gt; str | None:\n    \"\"\"Get the description of the document. Also known as comments.\n\n    (Also available as \"self.description\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//dc:description\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_editing_cycles","title":"<code>get_editing_cycles()</code>","text":"<p>Get the number of times the document was edited, as reported by the generator.</p> <p>(Also available as \u201cself.editing_cycles\u201d property.)</p> <p>Return: int (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_editing_cycles(self) -&gt; int | None:\n    \"\"\"Get the number of times the document was edited, as reported by\n    the generator.\n\n    (Also available as \"self.editing_cycles\" property.)\n\n    Return: int (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:editing-cycles\")\n    if element is None:\n        return None\n    cycles = element.text\n    return int(cycles)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_editing_duration","title":"<code>get_editing_duration()</code>","text":"<p>Get the time the document was edited, as reported by the generator.</p> <p>(Also available as \u201cself.editing_duration\u201d property.)</p> <p>Return: timedelta (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_editing_duration(self) -&gt; timedelta | None:\n    \"\"\"Get the time the document was edited, as reported by the\n    generator.\n\n    (Also available as \"self.editing_duration\" property.)\n\n    Return: timedelta (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:editing-duration\")\n    if element is None:\n        return None\n    duration = element.text\n    return Duration.decode(duration)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_generator","title":"<code>get_generator()</code>","text":"<p>Get the signature of the software that generated this document.</p> <p>(Also available as \u201cself.generator\u201d property.)</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.get_generator()\nKOffice/2.0.0\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_generator(self) -&gt; str | None:\n    \"\"\"Get the signature of the software that generated this document.\n\n    (Also available as \"self.generator\" property.)\n\n    Return: str (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.get_generator()\n        KOffice/2.0.0\n    \"\"\"\n    return self.generator\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_hyperlink_behaviour","title":"<code>get_hyperlink_behaviour()</code>","text":"<p>Get the MetaHyperlinkBehaviour  element or None. Source code in <code>odfdo/meta.py</code> <pre><code>def get_hyperlink_behaviour(self) -&gt; MetaHyperlinkBehaviour | None:\n    \"\"\"Get the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element or None.\"\"\"\n    element = self.get_element(\"//meta:hyperlink-behaviour\")\n    if element is None:\n        return None\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_initial_creator","title":"<code>get_initial_creator()</code>","text":"<p>Get the first creator of the document.</p> <p>(Also available as \u201cself.initial_creator\u201d property.)</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.get_initial_creator()\nUnknown\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_initial_creator(self) -&gt; str | None:\n    \"\"\"Get the first creator of the document.\n\n    (Also available as \"self.initial_creator\" property.)\n\n    Return: str (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.get_initial_creator()\n        Unknown\n    \"\"\"\n    element = self.get_element(\"//meta:initial-creator\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_keywords","title":"<code>get_keywords()</code>","text":"<p>Get the keywords of the document. Return the field as-is, without any assumption on the keyword separator.</p> <p>(Also available as \u201cself.keyword\u201d and \u201cself.keywords\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_keywords(self) -&gt; str | None:\n    \"\"\"Get the keywords of the document. Return the field as-is, without\n    any assumption on the keyword separator.\n\n    (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//meta:keyword\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_language","title":"<code>get_language()</code>","text":"<p>Get the default language of the document.</p> <p>(Also available as \u201cself.language\u201d property.)</p> <p>Return: str (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.get_language()\nfr-FR\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_language(self) -&gt; str | None:\n    \"\"\"Get the default language of the document.\n\n    (Also available as \"self.language\" property.)\n\n    Return: str (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.get_language()\n        fr-FR\n    \"\"\"\n    element = self.get_element(\"//dc:language\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_statistic","title":"<code>get_statistic()</code>","text":"<p>Get the statistics about a document.</p> <p>(Also available as \u201cself.statistic\u201d property.)</p> <p>Return: dict (or None if inexistant)</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.get_statistic():\n{'meta:table-count': 1,\n 'meta:image-count': 2,\n 'meta:object-count': 3,\n 'meta:page-count': 4,\n 'meta:paragraph-count': 5,\n 'meta:word-count': 6,\n 'meta:character-count': 7}\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_statistic(self) -&gt; dict[str, int] | None:\n    \"\"\"Get the statistics about a document.\n\n    (Also available as \"self.statistic\" property.)\n\n    Return: dict (or None if inexistant)\n\n    Example::\n\n        &gt;&gt;&gt; document.get_statistic():\n        {'meta:table-count': 1,\n         'meta:image-count': 2,\n         'meta:object-count': 3,\n         'meta:page-count': 4,\n         'meta:paragraph-count': 5,\n         'meta:word-count': 6,\n         'meta:character-count': 7}\n    \"\"\"\n    element = self.get_element(\"//meta:document-statistic\")\n    if element is None:\n        return None\n    statistic = {}\n    for key, value in element.attributes.items():\n        statistic[to_str(key)] = int(value)\n    return statistic\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_subject","title":"<code>get_subject()</code>","text":"<p>Get the subject of the document.</p> <p>(Also available as \u201cself.subject\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_subject(self) -&gt; str | None:\n    \"\"\"Get the subject of the document.\n\n    (Also available as \"self.subject\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//dc:subject\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_template","title":"<code>get_template()</code>","text":"<p>Get the MetaTemplate  element or None. Source code in <code>odfdo/meta.py</code> <pre><code>def get_template(self) -&gt; MetaTemplate | None:\n    \"\"\"Get the MetaTemplate &lt;meta:template&gt; element or None.\"\"\"\n    element = self.get_element(\"//meta:template\")\n    if element is None:\n        return None\n    return element\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_title","title":"<code>get_title()</code>","text":"<p>Get the title of the document.</p> <p>This is not the first heading but the title metadata.</p> <p>(Also available as \u201cself.title\u201d property.)</p> <p>Return: str (or None if inexistant)</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_title(self) -&gt; str | None:\n    \"\"\"Get the title of the document.\n\n    This is not the first heading but the title metadata.\n\n    (Also available as \"self.title\" property.)\n\n    Return: str (or None if inexistant)\n    \"\"\"\n    element = self.get_element(\"//dc:title\")\n    if element is None:\n        return None\n    return element.text\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_user_defined_metadata","title":"<code>get_user_defined_metadata()</code>","text":"<p>Get all additional user-defined metadata for a document.</p> <p>(Also available as \u201cself.user_defined_metadata\u201d property.)</p> <p>Return a dict of str/value mapping.</p> <p>Value types can be: Decimal, date, time, boolean or str.</p> Source code in <code>odfdo/meta.py</code> <pre><code>def get_user_defined_metadata(self) -&gt; dict[str, Any]:\n    \"\"\"Get all additional user-defined metadata for a document.\n\n    (Also available as \"self.user_defined_metadata\" property.)\n\n    Return a dict of str/value mapping.\n\n    Value types can be: Decimal, date, time, boolean or str.\n    \"\"\"\n    result: dict[str, Any] = {}\n    for item in self.get_elements(\"//meta:user-defined\"):\n        if not isinstance(item, Element):\n            continue\n        # Read the values\n        name = item.get_attribute_string(\"meta:name\")\n        if name is None:\n            continue\n        value = self._get_meta_value(item)\n        result[name] = value\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Meta.get_user_defined_metadata_of_name","title":"<code>get_user_defined_metadata_of_name(keyname)</code>","text":"<p>Return the content of the user defined metadata of that name. Return None if no name matchs or a dic of fields.</p> <p>Arguments:</p> <pre><code>name -- string, name (meta:name content)\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def get_user_defined_metadata_of_name(self, keyname: str) -&gt; dict[str, Any] | None:\n    \"\"\"Return the content of the user defined metadata of that name.\n    Return None if no name matchs or a dic of fields.\n\n    Arguments:\n\n        name -- string, name (meta:name content)\n    \"\"\"\n    result = {}\n    found = False\n    for item in self.get_elements(\"//meta:user-defined\"):\n        if not isinstance(item, Element):\n            continue\n        # Read the values\n        name = item.get_attribute(\"meta:name\")\n        if name == keyname:\n            found = True\n            break\n    if not found:\n        return None\n    result[\"name\"] = name\n    value, value_type, text = self._get_meta_value(item, full=True)  # type: ignore\n    result[\"value\"] = value\n    result[\"value_type\"] = value_type\n    result[\"text\"] = text\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_auto_reload","title":"<code>set_auto_reload(delay, href='')</code>","text":"<p>Set the MetaAutoReload  element. Source code in <code>odfdo/meta.py</code> <pre><code>def set_auto_reload(self, delay: timedelta, href: str = \"\") -&gt; None:\n    \"\"\"Set the MetaAutoReload &lt;meta:auto-reload&gt; element.\"\"\"\n    autoreload = MetaAutoReload(delay=delay, href=href)\n    current = self.auto_reload\n    if isinstance(current, MetaAutoReload):\n        current.delete()\n    self.get_meta_body().append(autoreload)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_creation_date","title":"<code>set_creation_date(date=None)</code>","text":"<p>Set the creation date of the document.</p> <p>If provided datetime is None, use current time.</p> <p>(Also available as \u201cself.creation_date\u201d property.)</p> <p>Arguments:</p> <pre><code>date -- datetime\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_creation_date(self, date: datetime | None = None) -&gt; None:\n    \"\"\"Set the creation date of the document.\n\n    If provided datetime is None, use current time.\n\n    (Also available as \"self.creation_date\" property.)\n\n    Arguments:\n\n        date -- datetime\n    \"\"\"\n    element = self.get_element(\"//meta:creation-date\")\n    if element is None:\n        element = Element.from_tag(\"meta:creation-date\")\n        self.get_meta_body().append(element)\n    if date is None:\n        date = datetime.now()\n    element.text = DateTime.encode(date)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_description","title":"<code>set_description(description)</code>","text":"<p>Set the description of the document. Also known as comments.</p> <p>(Also available as \u201cself.description\u201d property.)</p> <p>Arguments:</p> <pre><code>description -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_description(self, description: str) -&gt; None:\n    \"\"\"Set the description of the document. Also known as comments.\n\n    (Also available as \"self.description\" property.)\n\n    Arguments:\n\n        description -- str\n    \"\"\"\n    element = self.get_element(\"//dc:description\")\n    if element is None:\n        element = Element.from_tag(\"dc:description\")\n        self.get_meta_body().append(element)\n    element.text = description\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_editing_cycles","title":"<code>set_editing_cycles(cycles)</code>","text":"<p>Set the number of times the document was edited.</p> <p>(Also available as \u201cself.editing_cycles\u201d property.)</p> <p>Arguments:</p> <pre><code>cycles -- int\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_editing_cycles(self, cycles: int) -&gt; None:\n    \"\"\"Set the number of times the document was edited.\n\n    (Also available as \"self.editing_cycles\" property.)\n\n    Arguments:\n\n        cycles -- int\n    \"\"\"\n    if not isinstance(cycles, int):\n        raise TypeError(\"cycles must be an int\")\n    if cycles &lt; 1:\n        raise ValueError(\"cycles must be a positive int\")\n    element = self.get_element(\"//meta:editing-cycles\")\n    if element is None:\n        element = Element.from_tag(\"meta:editing-cycles\")\n        self.get_meta_body().append(element)\n    element.text = str(cycles)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_editing_duration","title":"<code>set_editing_duration(duration)</code>","text":"<p>Set the time the document was edited.</p> <p>(Also available as \u201cself.editing_duration\u201d property.)</p> <p>Arguments:</p> <pre><code>duration -- timedelta\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_editing_duration(self, duration: timedelta) -&gt; None:\n    \"\"\"Set the time the document was edited.\n\n    (Also available as \"self.editing_duration\" property.)\n\n    Arguments:\n\n        duration -- timedelta\n    \"\"\"\n    if not isinstance(duration, timedelta):\n        raise TypeError(\"duration must be a timedelta\")\n    element = self.get_element(\"//meta:editing-duration\")\n    if element is None:\n        element = Element.from_tag(\"meta:editing-duration\")\n        self.get_meta_body().append(element)\n    element.text = Duration.encode(duration)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_generator","title":"<code>set_generator(generator)</code>","text":"<p>Set the signature of the software that generated this document.</p> <p>(Also available as \u201cself.generator\u201d property.)</p> <p>Arguments:</p> <pre><code>generator -- str\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_generator(\"Odfdo experiment\")\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_generator(self, generator: str) -&gt; None:\n    \"\"\"Set the signature of the software that generated this document.\n\n    (Also available as \"self.generator\" property.)\n\n    Arguments:\n\n        generator -- str\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_generator(\"Odfdo experiment\")\n    \"\"\"\n    self.generator = generator\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_generator_default","title":"<code>set_generator_default()</code>","text":"<p>Set the signature of the software that generated this document to ourself.</p> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_generator_default()\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_generator_default(self) -&gt; None:\n    \"\"\"Set the signature of the software that generated this document\n    to ourself.\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_generator_default()\n    \"\"\"\n    if not self._generator_modified:\n        self.generator = GENERATOR\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_hyperlink_behaviour","title":"<code>set_hyperlink_behaviour(target_frame_name='_blank', show='replace')</code>","text":"<p>Set the MetaHyperlinkBehaviour  element. Source code in <code>odfdo/meta.py</code> <pre><code>def set_hyperlink_behaviour(\n    self,\n    target_frame_name: str = \"_blank\",\n    show: str = \"replace\",\n) -&gt; None:\n    \"\"\"Set the MetaHyperlinkBehaviour &lt;meta:hyperlink-behaviour&gt; element.\"\"\"\n    behaviour = MetaHyperlinkBehaviour(\n        target_frame_name=target_frame_name, show=show\n    )\n    current = self.hyperlink_behaviour\n    if isinstance(current, MetaHyperlinkBehaviour):\n        current.delete()\n    self.get_meta_body().append(behaviour)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_initial_creator","title":"<code>set_initial_creator(creator)</code>","text":"<p>Set the first creator of the document.</p> <p>(Also available as \u201cself.initial_creator\u201d property.)</p> <p>Arguments:</p> <pre><code>creator -- str\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_initial_creator(\"Plato\")\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_initial_creator(self, creator: str) -&gt; None:\n    \"\"\"Set the first creator of the document.\n\n    (Also available as \"self.initial_creator\" property.)\n\n    Arguments:\n\n        creator -- str\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_initial_creator(\"Plato\")\n    \"\"\"\n    element = self.get_element(\"//meta:initial-creator\")\n    if element is None:\n        element = Element.from_tag(\"meta:initial-creator\")\n        self.get_meta_body().append(element)\n    element.text = creator\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_keywords","title":"<code>set_keywords(keywords)</code>","text":"<p>Set the keywords of the document. Although the name is plural, a str string is required, so join your list first.</p> <p>(Also available as \u201cself.keyword\u201d and \u201cself.keywords\u201d property.)</p> <p>Arguments:</p> <pre><code>keywords -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_keywords(self, keywords: str) -&gt; None:\n    \"\"\"Set the keywords of the document. Although the name is plural, a\n    str string is required, so join your list first.\n\n    (Also available as \"self.keyword\" and \"self.keywords\" property.)\n\n    Arguments:\n\n        keywords -- str\n    \"\"\"\n    element = self.get_element(\"//meta:keyword\")\n    if element is None:\n        element = Element.from_tag(\"meta:keyword\")\n        self.get_meta_body().append(element)\n    element.text = keywords\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_language","title":"<code>set_language(language)</code>","text":"<p>Set the default language of the document.</p> <p>(Also available as \u201cself.language\u201d property.)</p> <p>Arguments:</p> <pre><code>language -- str\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; document.meta.set_language('fr-FR')\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_language(self, language: str) -&gt; None:\n    \"\"\"Set the default language of the document.\n\n    (Also available as \"self.language\" property.)\n\n    Arguments:\n\n        language -- str\n\n    Example::\n\n        &gt;&gt;&gt; document.meta.set_language('fr-FR')\n    \"\"\"\n    language = str(language)\n    if not self._is_RFC3066(language):\n        raise TypeError(\n            'Language must be \"xx\" lang or \"xx-YY\" lang-COUNTRY code (RFC3066)'\n        )\n    element = self.get_element(\"//dc:language\")\n    if element is None:\n        element = Element.from_tag(\"dc:language\")\n        self.get_meta_body().append(element)\n    element.text = language\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_statistic","title":"<code>set_statistic(statistic)</code>","text":"<p>Set the statistics about a document.</p> <p>(Also available as \u201cself.statistic\u201d property.)</p> <p>Arguments:</p> <pre><code>statistic -- dict\n</code></pre> <p>Example::</p> <pre><code>&gt;&gt;&gt; statistic = {'meta:table-count': 1,\n                 'meta:image-count': 2,\n                 'meta:object-count': 3,\n                 'meta:page-count': 4,\n                 'meta:paragraph-count': 5,\n                 'meta:word-count': 6,\n                 'meta:character-count': 7}\n&gt;&gt;&gt; document.meta.set_statistic(statistic)\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_statistic(self, statistic: dict[str, int]) -&gt; None:\n    \"\"\"Set the statistics about a document.\n\n    (Also available as \"self.statistic\" property.)\n\n    Arguments:\n\n        statistic -- dict\n\n    Example::\n\n        &gt;&gt;&gt; statistic = {'meta:table-count': 1,\n                         'meta:image-count': 2,\n                         'meta:object-count': 3,\n                         'meta:page-count': 4,\n                         'meta:paragraph-count': 5,\n                         'meta:word-count': 6,\n                         'meta:character-count': 7}\n        &gt;&gt;&gt; document.meta.set_statistic(statistic)\n    \"\"\"\n    if not isinstance(statistic, dict):\n        raise TypeError(\"Statistic must be a dict\")\n    element = self.get_element(\"//meta:document-statistic\")\n    for key, value in statistic.items():\n        try:\n            ivalue = int(value)\n        except ValueError as e:\n            raise TypeError(\"Statistic value must be a int\") from e\n        element.set_attribute(to_str(key), str(ivalue))\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_subject","title":"<code>set_subject(subject)</code>","text":"<p>Set the subject of the document.</p> <p>(Also available as \u201cself.subject\u201d property.)</p> <p>Arguments:</p> <pre><code>subject -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_subject(self, subject: str) -&gt; None:\n    \"\"\"Set the subject of the document.\n\n    (Also available as \"self.subject\" property.)\n\n    Arguments:\n\n        subject -- str\n    \"\"\"\n    element = self.get_element(\"//dc:subject\")\n    if element is None:\n        element = Element.from_tag(\"dc:subject\")\n        self.get_meta_body().append(element)\n    element.text = subject\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_template","title":"<code>set_template(date=None, href='', title='')</code>","text":"<p>Set the MetaTemplate  element. Source code in <code>odfdo/meta.py</code> <pre><code>def set_template(\n    self,\n    date: datetime | None = None,\n    href: str = \"\",\n    title: str = \"\",\n) -&gt; None:\n    \"\"\"Set the MetaTemplate &lt;meta:template&gt; element.\"\"\"\n    template = MetaTemplate(date=date, href=href, title=title)\n    current = self.template\n    if isinstance(current, MetaTemplate):\n        current.delete()\n    self.get_meta_body().append(template)\n</code></pre>"},{"location":"reference.html#odfdo.Meta.set_title","title":"<code>set_title(title)</code>","text":"<p>Set the title of the document.</p> <p>This is not the first heading but the title metadata.</p> <p>(Also available as \u201cself.title\u201d property.)</p> <p>Arguments:</p> <pre><code>title -- str\n</code></pre> Source code in <code>odfdo/meta.py</code> <pre><code>def set_title(self, title: str) -&gt; None:\n    \"\"\"Set the title of the document.\n\n    This is not the first heading but the title metadata.\n\n    (Also available as \"self.title\" property.)\n\n    Arguments:\n\n        title -- str\n    \"\"\"\n    element = self.get_element(\"//dc:title\")\n    if element is None:\n        element = Element.from_tag(\"dc:title\")\n        self.get_meta_body().append(element)\n    element.text = title\n</code></pre>"},{"location":"reference.html#odfdo.MetaAutoReload","title":"<code>MetaAutoReload</code>","text":"<p>               Bases: <code>Element</code></p> Source code in <code>odfdo/meta_auto_reload.py</code> <pre><code>class MetaAutoReload(Element):\n    _tag = \"meta:auto-reload\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"delay\", \"meta:delay\"),\n        PropDef(\"actuate\", \"xlink:actuate\"),\n        PropDef(\"href\", \"xlink:href\"),\n        PropDef(\"show\", \"xlink:show\"),\n        PropDef(\"type\", \"xlink:type\"),\n    )\n\n    def __init__(\n        self,\n        delay: timedelta | None = None,\n        href: str = \"\",\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        The &lt;meta:auto-reload&gt; element specifies whether a document is\n        reloaded or replaced by another document after a specified period\n        of time has elapsed.\n\n        Arguments:\n\n            delay -- timedelta\n\n            href -- str\n        \"\"\"\n        super().__init__(**kwargs)\n\n        self.actuate = \"onLoad\"\n        self.show = \"replace\"\n        self.type = \"simple\"\n        if self._do_init:\n            if not isinstance(delay, timedelta):\n                raise TypeError(\"delay must be a timedelta\")\n            self.delay = Duration.encode(delay)\n            self.href = href\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag} href={self.href} delay={Duration.decode(self.delay)}&gt;\"\n\n    def __str__(self) -&gt; str:\n        return f\"({self.href})\"\n</code></pre>"},{"location":"reference.html#odfdo.MetaAutoReload.__init__","title":"<code>__init__(delay=None, href='', **kwargs)</code>","text":"<p>The  element specifies whether a document is reloaded or replaced by another document after a specified period of time has elapsed. <p>Arguments:</p> <pre><code>delay -- timedelta\n\nhref -- str\n</code></pre> Source code in <code>odfdo/meta_auto_reload.py</code> <pre><code>def __init__(\n    self,\n    delay: timedelta | None = None,\n    href: str = \"\",\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    The &lt;meta:auto-reload&gt; element specifies whether a document is\n    reloaded or replaced by another document after a specified period\n    of time has elapsed.\n\n    Arguments:\n\n        delay -- timedelta\n\n        href -- str\n    \"\"\"\n    super().__init__(**kwargs)\n\n    self.actuate = \"onLoad\"\n    self.show = \"replace\"\n    self.type = \"simple\"\n    if self._do_init:\n        if not isinstance(delay, timedelta):\n            raise TypeError(\"delay must be a timedelta\")\n        self.delay = Duration.encode(delay)\n        self.href = href\n</code></pre>"},{"location":"reference.html#odfdo.MetaHyperlinkBehaviour","title":"<code>MetaHyperlinkBehaviour</code>","text":"<p>               Bases: <code>Element</code></p> Source code in <code>odfdo/meta_hyperlink_behaviour.py</code> <pre><code>class MetaHyperlinkBehaviour(Element):\n    _tag = \"meta:hyperlink-behaviour\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"target_frame_name\", \"office:target-frame-name\"),\n        PropDef(\"show\", \"xlink:show\"),\n    )\n\n    def __init__(\n        self,\n        target_frame_name: str = \"_blank\",\n        show: str = \"replace\",\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        The &lt;meta:hyperlink-behaviour&gt; element specifies the default behavior\n        for hyperlinks in a document.\n\n        Arguments:\n\n            target_frame_name -- str\n\n            show -- str\n        \"\"\"\n        super().__init__(**kwargs)\n\n        if self._do_init:\n            self.target_frame_name = target_frame_name\n            self.show = show\n\n    def __repr__(self) -&gt; str:\n        return (\n            f\"&lt;{self.__class__.__name__} tag={self.tag} \"\n            f\"target={self.target_frame_name} show={self.show}&gt;\"\n        )\n\n    def __str__(self) -&gt; str:\n        return f\"({self.target_frame_name})\"\n</code></pre>"},{"location":"reference.html#odfdo.MetaHyperlinkBehaviour.__init__","title":"<code>__init__(target_frame_name='_blank', show='replace', **kwargs)</code>","text":"<p>The  element specifies the default behavior for hyperlinks in a document. <p>Arguments:</p> <pre><code>target_frame_name -- str\n\nshow -- str\n</code></pre> Source code in <code>odfdo/meta_hyperlink_behaviour.py</code> <pre><code>def __init__(\n    self,\n    target_frame_name: str = \"_blank\",\n    show: str = \"replace\",\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    The &lt;meta:hyperlink-behaviour&gt; element specifies the default behavior\n    for hyperlinks in a document.\n\n    Arguments:\n\n        target_frame_name -- str\n\n        show -- str\n    \"\"\"\n    super().__init__(**kwargs)\n\n    if self._do_init:\n        self.target_frame_name = target_frame_name\n        self.show = show\n</code></pre>"},{"location":"reference.html#odfdo.MetaTemplate","title":"<code>MetaTemplate</code>","text":"<p>               Bases: <code>Element</code></p> Source code in <code>odfdo/meta_template.py</code> <pre><code>class MetaTemplate(Element):\n    _tag = \"meta:template\"\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"date\", \"meta:date\"),\n        PropDef(\"actuate\", \"xlink:actuate\"),\n        PropDef(\"href\", \"xlink:href\"),\n        PropDef(\"title\", \"xlink:title\"),\n        PropDef(\"type\", \"xlink:type\"),\n    )\n\n    def __init__(\n        self,\n        date: datetime | None = None,\n        href: str = \"\",\n        title: str = \"\",\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        The &lt;meta:template&gt; element specifies a IRI for the document template\n        that was used to create a document. The IRI is specified as an\n        Xlink.\n\n        Arguments:\n\n            date -- datetime or None\n\n            href -- str\n\n            title -- str\n        \"\"\"\n        super().__init__(**kwargs)\n\n        self.actuate = \"onRequest\"\n        self.type = \"simple\"\n        if self._do_init:\n            if date is None:\n                date = datetime.now()\n            self.date = DateTime.encode(date)\n            self.href = href\n            self.title = title\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} tag={self.tag} href={self.href}&gt;\"\n\n    def __str__(self) -&gt; str:\n        if self.title:\n            return f\"[{self.title}]({self.href})\"\n        return f\"({self.href})\"\n</code></pre>"},{"location":"reference.html#odfdo.MetaTemplate.__init__","title":"<code>__init__(date=None, href='', title='', **kwargs)</code>","text":"<p>The  element specifies a IRI for the document template that was used to create a document. The IRI is specified as an Xlink. <p>Arguments:</p> <pre><code>date -- datetime or None\n\nhref -- str\n\ntitle -- str\n</code></pre> Source code in <code>odfdo/meta_template.py</code> <pre><code>def __init__(\n    self,\n    date: datetime | None = None,\n    href: str = \"\",\n    title: str = \"\",\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    The &lt;meta:template&gt; element specifies a IRI for the document template\n    that was used to create a document. The IRI is specified as an\n    Xlink.\n\n    Arguments:\n\n        date -- datetime or None\n\n        href -- str\n\n        title -- str\n    \"\"\"\n    super().__init__(**kwargs)\n\n    self.actuate = \"onRequest\"\n    self.type = \"simple\"\n    if self._do_init:\n        if date is None:\n            date = datetime.now()\n        self.date = DateTime.encode(date)\n        self.href = href\n        self.title = title\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange","title":"<code>NamedRange</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF Named Range \u201ctable:named-range\u201d. Identifies inside the spreadsheet a range of cells of a table by a name and the name of the table.</p> <p>Name Ranges have the following attributes:</p> <pre><code>name -- name of the named range\n\ntable_name -- name of the table\n\nstart -- first cell of the named range, tuple (x, y)\n\nend -- last cell of the named range, tuple (x, y)\n\ncrange -- range of the named range, tuple (x, y, z, t)\n\nusage -- None or str, usage of the named range.\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>class NamedRange(Element):\n    \"\"\"ODF Named Range \"table:named-range\". Identifies inside the spreadsheet\n    a range of cells of a table by a name and the name of the table.\n\n    Name Ranges have the following attributes:\n\n        name -- name of the named range\n\n        table_name -- name of the table\n\n        start -- first cell of the named range, tuple (x, y)\n\n        end -- last cell of the named range, tuple (x, y)\n\n        crange -- range of the named range, tuple (x, y, z, t)\n\n        usage -- None or str, usage of the named range.\n    \"\"\"\n\n    _tag = \"table:named-range\"\n\n    def __init__(\n        self,\n        name: str | None = None,\n        crange: str | tuple | list | None = None,\n        table_name: str | None = None,\n        usage: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a Named Range element. 'name' must contains only letters, digits\n           and '_', and must not be like a coordinate as 'A1'. 'table_name' must be\n           a correct table name (no \"'\" or \"/\" in it).\n\n        Arguments:\n\n             name -- str, name of the named range\n\n             crange -- str or tuple of int, cell or area coordinate\n\n             table_name -- str, name of the table\n\n             usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n        \"\"\"\n        super().__init__(**kwargs)\n        self.usage = None\n        if self._do_init:\n            self.name = name or \"\"\n            self.table_name = _table_name_check(table_name)\n            self.set_range(crange or \"\")\n            self.set_usage(usage)\n        cell_range_address = self.get_attribute_string(\"table:cell-range-address\") or \"\"\n        if not cell_range_address:\n            self.table_name = \"\"\n            self.start = None\n            self.end = None\n            self.crange = None\n            self.usage = None\n            return\n        self.usage = self.get_attribute(\"table:range-usable-as\")\n        name_range = cell_range_address.replace(\"$\", \"\")\n        name, crange = name_range.split(\".\", 1)\n        if name.startswith(\"'\") and name.endswith(\"'\"):\n            name = name[1:-1]\n        self.table_name = name\n        crange = crange.replace(\".\", \"\")\n        self._set_range(crange)\n\n    def set_usage(self, usage: str | None = None) -&gt; None:\n        \"\"\"Set the usage of the Named Range. Usage can be None (default) or one\n        of :\n            'print-range'\n            'filter'\n            'repeat-column'\n            'repeat-row'\n\n        Arguments:\n\n            usage -- None or str\n        \"\"\"\n        if usage is not None:\n            usage = usage.strip().lower()\n            if usage not in (\"print-range\", \"filter\", \"repeat-column\", \"repeat-row\"):\n                usage = None\n        if usage is None:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:range-usable-as\")\n            self.usage = None\n        else:\n            self.set_attribute(\"table:range-usable-as\", usage)\n            self.usage = usage\n\n    @property\n    def name(self) -&gt; str | None:\n        \"\"\"Get / set the name of the table.\"\"\"\n        return self.get_attribute_string(\"table:name\")\n\n    @name.setter\n    def name(self, name: str) -&gt; None:\n        \"\"\"Set the name of the Named Range. The name is mandatory, if a Named\n        Range of the same name exists, it will be replaced. Name must contains\n        only alphanumerics characters and '_', and can not be of a cell\n        coordinates form like 'AB12'.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        name = name.strip()\n        if not name:\n            raise ValueError(\"Name required.\")\n        for x in name:\n            if x in forbidden_in_named_range():\n                raise ValueError(f\"Character forbidden '{x}' \")\n        step = \"\"\n        for x in name:\n            if x in string.ascii_letters and step in (\"\", \"A\"):\n                step = \"A\"\n                continue\n            elif step in (\"A\", \"A1\") and x in string.digits:\n                step = \"A1\"\n                continue\n            else:\n                step = \"\"\n                break\n        if step == \"A1\":\n            raise ValueError(\"Name of the type 'ABC123' is not allowed.\")\n        with contextlib.suppress(Exception):\n            # we are not on an inserted in a document.\n            body = self.document_body\n            named_range = body.get_named_range(name)  # type: ignore\n            if named_range:\n                named_range.delete()\n        self.set_attribute(\"table:name\", name)\n\n    def set_table_name(self, name: str) -&gt; None:\n        \"\"\"Set the name of the table of the Named Range. The name is mandatory.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        self.table_name = _table_name_check(name)\n        self._update_attributes()\n\n    def _set_range(self, coord: tuple | list | str) -&gt; None:\n        digits = convert_coordinates(coord)\n        if len(digits) == 4:\n            x, y, z, t = digits\n        else:\n            x, y = digits\n            z, t = digits\n        self.start = x, y  # type: ignore\n        self.end = z, t  # type: ignore\n        self.crange = x, y, z, t  # type: ignore\n\n    def set_range(self, crange: str | tuple | list) -&gt; None:\n        \"\"\"Set the range of the named range. Range can be either one cell\n        (like 'A1') or an area ('A1:B2'). It can be provided as an alpha numeric\n        value like \"A1:B2' or a tuple like (0, 0, 1, 1) or (0, 0).\n\n        Arguments:\n\n            crange -- str or tuple of int, cell or area coordinate\n        \"\"\"\n        self._set_range(crange)\n        self._update_attributes()\n\n    def _update_attributes(self) -&gt; None:\n        self.set_attribute(\"table:base-cell-address\", self._make_base_cell_address())\n        self.set_attribute(\"table:cell-range-address\", self._make_cell_range_address())\n\n    def _make_base_cell_address(self) -&gt; str:\n        # assuming we got table_name and range\n        if \" \" in self.table_name:\n            name = f\"'{self.table_name}'\"\n        else:\n            name = self.table_name\n        return f\"${name}.${digit_to_alpha(self.start[0])}${self.start[1] + 1}\"  # type: ignore\n\n    def _make_cell_range_address(self) -&gt; str:\n        # assuming we got table_name and range\n        if \" \" in self.table_name:\n            name = f\"'{self.table_name}'\"\n        else:\n            name = self.table_name\n        if self.start == self.end:\n            return self._make_base_cell_address()\n        return (\n            f\"${name}.${digit_to_alpha(self.start[0])}${self.start[1] + 1}:\"  # type: ignore\n            f\".${digit_to_alpha(self.end[0])}${self.end[1] + 1}\"  # type: ignore\n        )\n\n    def get_values(\n        self,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n        flat: bool = False,\n    ) -&gt; list:\n        \"\"\"Shortcut to retrieve the values of the cells of the named range. See\n        table.get_values() for the arguments description and return format.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        return table.get_values(self.crange, cell_type, complete, get_type, flat)  # type: ignore\n\n    def get_value(self, get_type: bool = False) -&gt; Any:\n        \"\"\"Shortcut to retrieve the value of the first cell of the named range.\n        See table.get_value() for the arguments description and return format.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        return table.get_value(self.start, get_type)  # type: ignore\n\n    def set_values(\n        self,\n        values: list,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the values of the cells of the named range.\n        See table.set_values() for the arguments description.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        table.set_values(  # type: ignore\n            values,\n            coord=self.crange,\n            style=style,\n            cell_type=cell_type,\n            currency=currency,\n        )\n\n    def set_value(\n        self,\n        value: Any,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the value of the first cell of the named range.\n        See table.set_value() for the arguments description.\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        table = body.get_table(name=self.table_name)\n        if table is None:\n            raise ValueError\n        table.set_value(  # type: ignore\n            coord=self.start,\n            value=value,\n            cell_type=cell_type,\n            currency=currency,\n            style=style,\n        )\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.name","title":"<code>name: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the name of the table.</p>"},{"location":"reference.html#odfdo.NamedRange.__init__","title":"<code>__init__(name=None, crange=None, table_name=None, usage=None, **kwargs)</code>","text":"<p>Create a Named Range element. \u2018name\u2019 must contains only letters, digits    and \u2018_\u2019, and must not be like a coordinate as \u2018A1\u2019. \u2018table_name\u2019 must be    a correct table name (no \u201c\u2019\u201d or \u201c/\u201d in it).</p> <p>Arguments:</p> <pre><code> name -- str, name of the named range\n\n crange -- str or tuple of int, cell or area coordinate\n\n table_name -- str, name of the table\n\n usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    name: str | None = None,\n    crange: str | tuple | list | None = None,\n    table_name: str | None = None,\n    usage: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a Named Range element. 'name' must contains only letters, digits\n       and '_', and must not be like a coordinate as 'A1'. 'table_name' must be\n       a correct table name (no \"'\" or \"/\" in it).\n\n    Arguments:\n\n         name -- str, name of the named range\n\n         crange -- str or tuple of int, cell or area coordinate\n\n         table_name -- str, name of the table\n\n         usage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n    \"\"\"\n    super().__init__(**kwargs)\n    self.usage = None\n    if self._do_init:\n        self.name = name or \"\"\n        self.table_name = _table_name_check(table_name)\n        self.set_range(crange or \"\")\n        self.set_usage(usage)\n    cell_range_address = self.get_attribute_string(\"table:cell-range-address\") or \"\"\n    if not cell_range_address:\n        self.table_name = \"\"\n        self.start = None\n        self.end = None\n        self.crange = None\n        self.usage = None\n        return\n    self.usage = self.get_attribute(\"table:range-usable-as\")\n    name_range = cell_range_address.replace(\"$\", \"\")\n    name, crange = name_range.split(\".\", 1)\n    if name.startswith(\"'\") and name.endswith(\"'\"):\n        name = name[1:-1]\n    self.table_name = name\n    crange = crange.replace(\".\", \"\")\n    self._set_range(crange)\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.get_value","title":"<code>get_value(get_type=False)</code>","text":"<p>Shortcut to retrieve the value of the first cell of the named range. See table.get_value() for the arguments description and return format.</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_value(self, get_type: bool = False) -&gt; Any:\n    \"\"\"Shortcut to retrieve the value of the first cell of the named range.\n    See table.get_value() for the arguments description and return format.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    return table.get_value(self.start, get_type)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.get_values","title":"<code>get_values(cell_type=None, complete=True, get_type=False, flat=False)</code>","text":"<p>Shortcut to retrieve the values of the cells of the named range. See table.get_values() for the arguments description and return format.</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_values(\n    self,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n    flat: bool = False,\n) -&gt; list:\n    \"\"\"Shortcut to retrieve the values of the cells of the named range. See\n    table.get_values() for the arguments description and return format.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    return table.get_values(self.crange, cell_type, complete, get_type, flat)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_range","title":"<code>set_range(crange)</code>","text":"<p>Set the range of the named range. Range can be either one cell (like \u2018A1\u2019) or an area (\u2018A1:B2\u2019). It can be provided as an alpha numeric value like \u201cA1:B2\u2019 or a tuple like (0, 0, 1, 1) or (0, 0).</p> <p>Arguments:</p> <pre><code>crange -- str or tuple of int, cell or area coordinate\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_range(self, crange: str | tuple | list) -&gt; None:\n    \"\"\"Set the range of the named range. Range can be either one cell\n    (like 'A1') or an area ('A1:B2'). It can be provided as an alpha numeric\n    value like \"A1:B2' or a tuple like (0, 0, 1, 1) or (0, 0).\n\n    Arguments:\n\n        crange -- str or tuple of int, cell or area coordinate\n    \"\"\"\n    self._set_range(crange)\n    self._update_attributes()\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_table_name","title":"<code>set_table_name(name)</code>","text":"<p>Set the name of the table of the Named Range. The name is mandatory.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_table_name(self, name: str) -&gt; None:\n    \"\"\"Set the name of the table of the Named Range. The name is mandatory.\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    self.table_name = _table_name_check(name)\n    self._update_attributes()\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_usage","title":"<code>set_usage(usage=None)</code>","text":"<p>Set the usage of the Named Range. Usage can be None (default) or one of :     \u2018print-range\u2019     \u2018filter\u2019     \u2018repeat-column\u2019     \u2018repeat-row\u2019</p> <p>Arguments:</p> <pre><code>usage -- None or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_usage(self, usage: str | None = None) -&gt; None:\n    \"\"\"Set the usage of the Named Range. Usage can be None (default) or one\n    of :\n        'print-range'\n        'filter'\n        'repeat-column'\n        'repeat-row'\n\n    Arguments:\n\n        usage -- None or str\n    \"\"\"\n    if usage is not None:\n        usage = usage.strip().lower()\n        if usage not in (\"print-range\", \"filter\", \"repeat-column\", \"repeat-row\"):\n            usage = None\n    if usage is None:\n        with contextlib.suppress(KeyError):\n            self.del_attribute(\"table:range-usable-as\")\n        self.usage = None\n    else:\n        self.set_attribute(\"table:range-usable-as\", usage)\n        self.usage = usage\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_value","title":"<code>set_value(value, cell_type=None, currency=None, style=None)</code>","text":"<p>Shortcut to set the value of the first cell of the named range. See table.set_value() for the arguments description.</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_value(\n    self,\n    value: Any,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the value of the first cell of the named range.\n    See table.set_value() for the arguments description.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    table.set_value(  # type: ignore\n        coord=self.start,\n        value=value,\n        cell_type=cell_type,\n        currency=currency,\n        style=style,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.NamedRange.set_values","title":"<code>set_values(values, style=None, cell_type=None, currency=None)</code>","text":"<p>Shortcut to set the values of the cells of the named range. See table.set_values() for the arguments description.</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_values(\n    self,\n    values: list,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the values of the cells of the named range.\n    See table.set_values() for the arguments description.\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    table = body.get_table(name=self.table_name)\n    if table is None:\n        raise ValueError\n    table.set_values(  # type: ignore\n        values,\n        coord=self.crange,\n        style=style,\n        cell_type=cell_type,\n        currency=currency,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Note","title":"<code>Note</code>","text":"<p>               Bases: <code>Element</code></p> <p>Either a footnote or a endnote element with the given text, optionally referencing it using the given note_id.</p> <p>Arguments:</p> <pre><code>note_class -- 'footnote' or 'endnote'\n\nnote_id -- str\n\ncitation -- str\n\nbody -- str or Element\n</code></pre> Source code in <code>odfdo/note.py</code> <pre><code>class Note(Element):\n    \"\"\"Either a footnote or a endnote element with the given text,\n    optionally referencing it using the given note_id.\n\n    Arguments:\n\n        note_class -- 'footnote' or 'endnote'\n\n        note_id -- str\n\n        citation -- str\n\n        body -- str or Element\n    \"\"\"\n\n    _tag = \"text:note\"\n    _properties = (\n        PropDef(\"note_class\", \"text:note-class\"),\n        PropDef(\"note_id\", \"text:id\"),\n    )\n\n    def __init__(\n        self,\n        note_class: str = \"footnote\",\n        note_id: str | None = None,\n        citation: str | None = None,\n        body: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.insert(Element.from_tag(\"text:note-body\"), position=0)\n            self.insert(Element.from_tag(\"text:note-citation\"), position=0)\n            self.note_class = note_class\n            if note_id is not None:\n                self.note_id = note_id\n            if citation is not None:\n                self.citation = citation\n            if body is not None:\n                self.note_body = body\n\n    @property\n    def citation(self) -&gt; str:\n        note_citation = self.get_element(\"text:note-citation\")\n        if note_citation:\n            return note_citation.text\n        return \"\"\n\n    @citation.setter\n    def citation(self, text: str | None) -&gt; None:\n        note_citation = self.get_element(\"text:note-citation\")\n        if note_citation:\n            note_citation.text = text  # type:ignore\n\n    @property\n    def note_body(self) -&gt; str:\n        note_body = self.get_element(\"text:note-body\")\n        if note_body:\n            return note_body.text_content\n        return \"\"\n\n    @note_body.setter\n    def note_body(self, text_or_element: Element | str | None) -&gt; None:\n        note_body = self.get_element(\"text:note-body\")\n        if not note_body:\n            return None\n        if text_or_element is None:\n            note_body.text_content = \"\"\n        elif isinstance(text_or_element, str):\n            note_body.text_content = text_or_element\n        elif isinstance(text_or_element, Element):\n            note_body.clear()\n            note_body.append(text_or_element)\n        else:\n            raise TypeError(f'Unexpected type for body: \"{type(text_or_element)}\"')\n\n    def check_validity(self) -&gt; None:\n        if not self.note_class:\n            raise ValueError('Note class must be \"footnote\" or \"endnote\"')\n        if not self.note_id:\n            raise ValueError(\"Note must have an id\")\n        if not self.citation:\n            raise ValueError(\"Note must have a citation\")\n        if not self.note_body:\n            pass\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph","title":"<code>Paragraph</code>","text":"<p>               Bases: <code>ParagraphBase</code></p> <p>Specialised element for paragraphs \u201ctext:p\u201d. The \u201ctext:p\u201d element represents a paragraph, which is the basic unit of text in an OpenDocument file.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>class Paragraph(ParagraphBase):\n    \"\"\"Specialised element for paragraphs \"text:p\". The \"text:p\" element\n    represents a paragraph, which is the basic unit of text in an OpenDocument\n    file.\n    \"\"\"\n\n    _tag = \"text:p\"\n\n    def __init__(\n        self,\n        text_or_element: str | Element | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ):\n        \"\"\"Create a paragraph element of the given style containing the optional\n        given text.\n\n        Arguments:\n\n            text -- str or Element\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if isinstance(text_or_element, Element):\n                self.append(text_or_element)\n            else:\n                self.text = text_or_element  # type:ignore\n            if style is not None:\n                self.style = style\n\n    def insert_note(\n        self,\n        note_element: Note | None = None,\n        after: str | Element | None = None,\n        note_class: str = \"footnote\",\n        note_id: str | None = None,\n        citation: str | None = None,\n        body: str | None = None,\n    ) -&gt; None:\n        if note_element is None:\n            note_element = Note(\n                note_class=note_class, note_id=note_id, citation=citation, body=body\n            )\n        else:\n            # XXX clone or modify the argument?\n            if note_class:\n                note_element.note_class = note_class\n            if note_id:\n                note_element.note_id = note_id\n            if citation:\n                note_element.citation = citation\n            if body:\n                note_element.note_body = body\n        note_element.check_validity()\n        if isinstance(after, str):\n            self._insert(note_element, after=after, main_text=True)\n        elif isinstance(after, Element):\n            after.insert(note_element, FIRST_CHILD)\n        else:\n            self.insert(note_element, FIRST_CHILD)\n\n    def insert_annotation(  # noqa: C901\n        self,\n        annotation_element: Annotation | None = None,\n        before: str | None = None,\n        after: str | Element | None = None,\n        position: int | tuple = 0,\n        content: str | Element | None = None,\n        body: str | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n    ) -&gt; Annotation:\n        \"\"\"Insert an annotation, at the position defined by the regex (before,\n        after, content) or by positionnal argument (position). If content is\n        provided, the annotation covers the full content regex. Else, the\n        annotation is positionned either 'before' or 'after' provided regex.\n\n        If content is an odf element (ie: paragraph, span, ...), the full inner\n        content is covered by the annotation (of the position just after if\n        content is a single empty tag).\n\n        If content/before or after exists (regex) and return a group of matching\n        positions, the position value is the index of matching place to use.\n\n        annotation_element can contain a previously created annotation, else\n        the annotation is created from the body, creator and optional date\n        (current date by default).\n\n        Arguments:\n\n            annotation_element -- Annotation or None\n\n            before -- str regular expression or None\n\n            after -- str regular expression or Element or None\n\n            content -- str regular expression or None, or Element\n\n            position -- int or tuple of int\n\n            body -- str or Element\n\n            creator -- str\n\n            date -- datetime\n        \"\"\"\n\n        if annotation_element is None:\n            annotation_element = Annotation(\n                text_or_element=body, creator=creator, date=date, parent=self\n            )\n        else:\n            # XXX clone or modify the argument?\n            if body:\n                annotation_element.note_body = body\n            if creator:\n                annotation_element.creator = creator\n            if date:\n                annotation_element.date = date\n        annotation_element.check_validity()\n\n        # special case: content is an odf element (ie: a paragraph)\n        if isinstance(content, Element):\n            if content.is_empty():\n                content.insert(annotation_element, xmlposition=NEXT_SIBLING)\n                return annotation_element\n            content.insert(annotation_element, start=True)\n            annotation_end = AnnotationEnd(annotation_element)\n            content.append(annotation_end)\n            return annotation_element\n\n        # special case\n        if isinstance(after, Element):\n            after.insert(annotation_element, FIRST_CHILD)\n            return annotation_element\n\n        # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and content is not None\n            and isinstance(position, int)\n        ):\n            # Start tag\n            self._insert(\n                annotation_element, before=content, position=position, main_text=True\n            )\n            # End tag\n            annotation_end = AnnotationEnd(annotation_element)\n            self._insert(\n                annotation_end, after=content, position=position, main_text=True\n            )\n            return annotation_element\n\n        # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and content is None\n            and isinstance(position, tuple)\n        ):\n            # Start\n            self._insert(annotation_element, position=position[0], main_text=True)\n            # End\n            annotation_end = AnnotationEnd(annotation_element)\n            self._insert(annotation_end, position=position[1], main_text=True)\n            return annotation_element\n\n        # Without \"content\" nor \"position\"\n        if content is not None or not isinstance(position, int):\n            raise ValueError(\"Bad arguments\")\n\n        # Insert\n        self._insert(\n            annotation_element,\n            before=before,\n            after=after,\n            position=position,\n            main_text=True,\n        )\n        return annotation_element\n\n    def insert_annotation_end(\n        self,\n        annotation_element: Annotation,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n    ) -&gt; AnnotationEnd:\n        \"\"\"Insert an annotation end tag for an existing annotation. If some end\n        tag already exists, replace it. Annotation end tag is set at the\n        position defined by the regex (before or after).\n\n        If content/before or after (regex) returns a group of matching\n        positions, the position value is the index of matching place to use.\n\n        Arguments:\n\n            annotation_element -- Annotation (mandatory)\n\n            before -- str regular expression or None\n\n            after -- str regular expression or None\n\n            position -- int\n        \"\"\"\n\n        if annotation_element is None:\n            raise ValueError\n        if not isinstance(annotation_element, Annotation):\n            raise TypeError(\"Not a &lt;office:annotation&gt; Annotation\")\n\n        # remove existing end tag\n        name = annotation_element.name\n        existing_end_tag = self.get_annotation_end(name=name)\n        if existing_end_tag:\n            existing_end_tag.delete()\n\n        # create the end tag\n        end_tag = AnnotationEnd(annotation_element)\n\n        # Insert\n        self._insert(\n            end_tag, before=before, after=after, position=position, main_text=True\n        )\n        return end_tag\n\n    def set_reference_mark(\n        self,\n        name: str,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n        content: str | Element | None = None,\n    ) -&gt; Element:\n        \"\"\"Insert a reference mark, at the position defined by the regex\n        (before, after, content) or by positionnal argument (position). If\n        content is provided, the annotation covers the full range content regex\n        (instances of ReferenceMarkStart and ReferenceMarkEnd are\n        created). Else, an instance of ReferenceMark is positionned either\n        'before' or 'after' provided regex.\n\n        If content is an ODF Element (ie: Paragraph, Span, ...), the full inner\n        content is referenced (of the position just after if content is a single\n        empty tag).\n\n        If content/before or after exists (regex) and return a group of matching\n        positions, the position value is the index of matching place to use.\n\n        Name is mandatory and shall be unique in the document for the preference\n        mark range.\n\n        Arguments:\n\n            name -- str\n\n            before -- str regular expression or None\n\n            after -- str regular expression or None,\n\n            content -- str regular expression or None, or Element\n\n            position -- int or tuple of int\n\n        Return: the created ReferenceMark or ReferenceMarkStart\n        \"\"\"\n        # special case: content is an odf element (ie: a paragraph)\n        if isinstance(content, Element):\n            if content.is_empty():\n                reference = ReferenceMark(name)\n                content.insert(reference, xmlposition=NEXT_SIBLING)\n                return reference\n            reference_start = ReferenceMarkStart(name)\n            content.insert(reference_start, start=True)\n            reference_end = ReferenceMarkEnd(name)\n            content.append(reference_end)\n            return reference_start\n\n        # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n        # reference\n        if (\n            before is None\n            and after is None\n            and content is not None\n            and isinstance(position, int)\n        ):\n            # Start tag\n            reference_start = ReferenceMarkStart(name)\n            self._insert(\n                reference_start, before=content, position=position, main_text=True\n            )\n            # End tag\n            reference_end = ReferenceMarkEnd(name)\n            self._insert(\n                reference_end, after=content, position=position, main_text=True\n            )\n            return reference_start\n\n        # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n        if (\n            before is None\n            and after is None\n            and content is None\n            and isinstance(position, tuple)\n        ):\n            # Start\n            reference_start = ReferenceMarkStart(name)\n            self._insert(reference_start, position=position[0], main_text=True)\n            # End\n            reference_end = ReferenceMarkEnd(name)\n            self._insert(reference_end, position=position[1], main_text=True)\n            return reference_start\n\n        # Without \"content\" nor \"position\"\n        if content is not None or not isinstance(position, int):\n            raise ValueError(\"bad arguments\")\n\n        # Insert a positional reference mark\n        reference = ReferenceMark(name)\n        self._insert(\n            reference,\n            before=before,\n            after=after,\n            position=position,\n            main_text=True,\n        )\n        return reference\n\n    def set_reference_mark_end(\n        self,\n        reference_mark: Element,\n        before: str | None = None,\n        after: str | None = None,\n        position: int = 0,\n    ) -&gt; ReferenceMarkEnd:\n        \"\"\"Insert/move a ReferenceMarkEnd for an existing reference mark. If\n        some end tag already exists, replace it. Reference tag is set at the\n        position defined by the regex (before or after).\n\n        If content/before or after (regex) returns a group of matching\n        positions, the position value is the index of matching place to use.\n\n        Arguments:\n\n            reference_mark -- ReferenceMark or ReferenceMarkStart (mandatory)\n\n            before -- str regular expression or None\n\n            after -- str regular expression or None\n\n            position -- int\n        \"\"\"\n        if not isinstance(reference_mark, (ReferenceMark, ReferenceMarkStart)):\n            raise TypeError(\"Not a ReferenceMark or ReferenceMarkStart\")\n        name = reference_mark.name\n        if isinstance(reference_mark, ReferenceMark):\n            # change it to a range reference:\n            reference_mark.tag = ReferenceMarkStart._tag\n\n        existing_end_tag = self.get_reference_mark_end(name=name)\n        if existing_end_tag:\n            existing_end_tag.delete()\n\n        # create the end tag\n        end_tag = ReferenceMarkEnd(name)\n\n        # Insert\n        self._insert(\n            end_tag, before=before, after=after, position=position, main_text=True\n        )\n        return end_tag\n\n    def insert_variable(self, variable_element: Element, after: str | None) -&gt; None:\n        self._insert(variable_element, after=after, main_text=True)\n\n    @_by_regex_offset\n    def set_span(\n        self,\n        match: str,\n        tail: str,\n        style: str,\n        regex: str | None = None,\n        offset: int | None = None,\n        length: int = 0,\n    ) -&gt; Span:\n        \"\"\"\n        set_span(style, regex=None, offset=None, length=0)\n        Apply the given style to text content matching the regex OR the\n        positional arguments offset and length.\n\n        (match, tail: provided by regex decorator)\n\n        Arguments:\n\n            style -- str\n\n            regex -- str regular expression\n\n            offset -- int\n\n            length -- int\n        \"\"\"\n        span = Span(match, style=style)\n        span.tail = tail\n        return span\n\n    def remove_spans(self, keep_heading: bool = True) -&gt; Element | list:\n        \"\"\"Send back a copy of the element, without span styles.\n        If keep_heading is True (default), the first level heading style is left\n        unchanged.\n        \"\"\"\n        strip = (Span._tag,)\n        if keep_heading:\n            protect = (\"text:h\",)\n        else:\n            protect = None\n        return self.strip_tags(strip=strip, protect=protect)\n\n    def remove_span(self, spans: Element | list[Element]) -&gt; Element | list:\n        \"\"\"Send back a copy of the element, the spans (not a clone) removed.\n\n        Arguments:\n\n            spans -- Element or list of Element\n        \"\"\"\n        return self.strip_elements(spans)\n\n    @_by_regex_offset\n    def set_link(\n        self,\n        match: str,\n        tail: str,\n        url: str,\n        regex: str | None = None,\n        offset: int | None = None,\n        length: int = 0,\n    ) -&gt; Element:\n        \"\"\"\n        set_link(url, regex=None, offset=None, length=0)\n        Make a link to the provided url from text content matching the regex\n        OR the positional arguments offset and length.\n\n        (match, tail: provided by regex decorator)\n\n        Arguments:\n\n            url -- str\n\n            regex -- str regular expression\n\n            offset -- int\n\n            length -- int\n        \"\"\"\n        link = Link(url, text=match)\n        link.tail = tail\n        return link\n\n    def remove_links(self) -&gt; Element | list:\n        \"\"\"Send back a copy of the element, without links tags.\"\"\"\n        strip = (Link._tag,)\n        return self.strip_tags(strip=strip)\n\n    def remove_link(self, links: Link | list[Link]) -&gt; Element | list:\n        \"\"\"Send back a copy of the element (not a clone), with the sub links\n           removed.\n\n        Arguments:\n\n            links -- Link or list of Link\n        \"\"\"\n        return self.strip_elements(links)\n\n    def insert_reference(\n        self,\n        name: str,\n        ref_format: str = \"\",\n        before: str | None = None,\n        after: str | Element | None = None,\n        position: int = 0,\n        display: str | None = None,\n    ) -&gt; None:\n        \"\"\"Create and insert a reference to a content marked by a reference\n        mark. The Reference element (\"text:reference-ref\") represents a\n        field that references a \"text:reference-mark-start\" or\n        \"text:reference-mark\" element. Its \"text:reference-format\" attribute\n        specifies what is displayed from the referenced element. Default is\n        'page'. Actual content is not automatically updated except for the 'text'\n        format.\n\n        name is mandatory and should represent an existing reference mark of the\n        document.\n\n        ref_format is the argument for format reference (default is 'page').\n\n        The reference is inserted the position defined by the regex (before /\n        after), or by positionnal argument (position). If 'display' is provided,\n        it will be used as the text value for the reference.\n\n        If after is an ODF Element, the reference is inserted as first child of\n        this element.\n\n        Arguments:\n\n            name -- str\n\n            ref_format -- one of : 'chapter', 'direction', 'page', 'text',\n                                    'caption', 'category-and-value', 'value',\n                                    'number', 'number-all-superior',\n                                    'number-no-superior'\n\n            before -- str regular expression or None\n\n            after -- str regular expression or odf element or None\n\n            position -- int\n\n            display -- str or None\n        \"\"\"\n        reference = Reference(name, ref_format)\n        if display is None and ref_format == \"text\":\n            # get reference content\n            body = self.document_body\n            if not body:\n                body = self.root\n            mark = body.get_reference_mark(name=name)\n            if mark:\n                display = mark.referenced_text  # type: ignore\n        if not display:\n            display = \" \"\n        reference.text = display\n        if isinstance(after, Element):\n            after.insert(reference, FIRST_CHILD)\n        else:\n            self._insert(\n                reference, before=before, after=after, position=position, main_text=True\n            )\n\n    def set_bookmark(\n        self,\n        name: str,\n        before: str | None = None,\n        after: str | None = None,\n        position: int | tuple = 0,\n        role: str | None = None,\n        content: str | None = None,\n    ) -&gt; Element | tuple[Element, Element]:\n        \"\"\"Insert a bookmark before or after the characters in the text which\n        match the regex before/after. When the regex matches more of one part\n        of the text, position can be set to choose which part must be used.\n        If before and after are None, we use only position that is the number\n        of characters.\n\n        So, by default, this function inserts a bookmark before the first\n        character of the content. Role can be None, \"start\" or \"end\", we\n        insert respectively a position bookmark a bookmark-start or a\n        bookmark-end.\n\n        If content is not None these 2 calls are equivalent:\n\n          paragraph.set_bookmark(\"bookmark\", content=\"xyz\")\n\n        and:\n\n          paragraph.set_bookmark(\"bookmark\", before=\"xyz\", role=\"start\")\n          paragraph.set_bookmark(\"bookmark\", after=\"xyz\", role=\"end\")\n\n\n        If position is a 2-tuple, these 2 calls are equivalent:\n\n          paragraph.set_bookmark(\"bookmark\", position=(10, 20))\n\n        and:\n\n          paragraph.set_bookmark(\"bookmark\", position=10, role=\"start\")\n          paragraph.set_bookmark(\"bookmark\", position=20, role=\"end\")\n\n\n        Arguments:\n\n            name -- str\n\n            before -- str regex\n\n            after -- str regex\n\n            position -- int or (int, int)\n\n            role -- None, \"start\" or \"end\"\n\n            content -- str regex\n        \"\"\"\n        # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and role is None\n            and content is not None\n            and isinstance(position, int)\n        ):\n            # Start\n            start = BookmarkStart(name)\n            self._insert(start, before=content, position=position, main_text=True)\n            # End\n            end = BookmarkEnd(name)\n            self._insert(end, after=content, position=position, main_text=True)\n            return start, end\n\n        # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n        # bookmark\n        if (\n            before is None\n            and after is None\n            and role is None\n            and content is None\n            and isinstance(position, tuple)\n        ):\n            # Start\n            start = BookmarkStart(name)\n            self._insert(start, position=position[0], main_text=True)\n            # End\n            end = BookmarkEnd(name)\n            self._insert(end, position=position[1], main_text=True)\n            return start, end\n\n        # Without \"content\" nor \"position\"\n        if content is not None or not isinstance(position, int):\n            raise ValueError(\"bad arguments\")\n\n        # Role\n        if role is None:\n            bookmark: Element = Bookmark(name)\n        elif role == \"start\":\n            bookmark = BookmarkStart(name)\n        elif role == \"end\":\n            bookmark = BookmarkEnd(name)\n        else:\n            raise ValueError(\"bad arguments\")\n\n        # Insert\n        self._insert(\n            bookmark, before=before, after=after, position=position, main_text=True\n        )\n\n        return bookmark\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.__init__","title":"<code>__init__(text_or_element=None, style=None, **kwargs)</code>","text":"<p>Create a paragraph element of the given style containing the optional given text.</p> <p>Arguments:</p> <pre><code>text -- str or Element\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def __init__(\n    self,\n    text_or_element: str | Element | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n):\n    \"\"\"Create a paragraph element of the given style containing the optional\n    given text.\n\n    Arguments:\n\n        text -- str or Element\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if isinstance(text_or_element, Element):\n            self.append(text_or_element)\n        else:\n            self.text = text_or_element  # type:ignore\n        if style is not None:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.insert_annotation","title":"<code>insert_annotation(annotation_element=None, before=None, after=None, position=0, content=None, body=None, creator=None, date=None)</code>","text":"<p>Insert an annotation, at the position defined by the regex (before, after, content) or by positionnal argument (position). If content is provided, the annotation covers the full content regex. Else, the annotation is positionned either \u2018before\u2019 or \u2018after\u2019 provided regex.</p> <p>If content is an odf element (ie: paragraph, span, \u2026), the full inner content is covered by the annotation (of the position just after if content is a single empty tag).</p> <p>If content/before or after exists (regex) and return a group of matching positions, the position value is the index of matching place to use.</p> <p>annotation_element can contain a previously created annotation, else the annotation is created from the body, creator and optional date (current date by default).</p> <p>Arguments:</p> <pre><code>annotation_element -- Annotation or None\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or Element or None\n\ncontent -- str regular expression or None, or Element\n\nposition -- int or tuple of int\n\nbody -- str or Element\n\ncreator -- str\n\ndate -- datetime\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def insert_annotation(  # noqa: C901\n    self,\n    annotation_element: Annotation | None = None,\n    before: str | None = None,\n    after: str | Element | None = None,\n    position: int | tuple = 0,\n    content: str | Element | None = None,\n    body: str | None = None,\n    creator: str | None = None,\n    date: datetime | None = None,\n) -&gt; Annotation:\n    \"\"\"Insert an annotation, at the position defined by the regex (before,\n    after, content) or by positionnal argument (position). If content is\n    provided, the annotation covers the full content regex. Else, the\n    annotation is positionned either 'before' or 'after' provided regex.\n\n    If content is an odf element (ie: paragraph, span, ...), the full inner\n    content is covered by the annotation (of the position just after if\n    content is a single empty tag).\n\n    If content/before or after exists (regex) and return a group of matching\n    positions, the position value is the index of matching place to use.\n\n    annotation_element can contain a previously created annotation, else\n    the annotation is created from the body, creator and optional date\n    (current date by default).\n\n    Arguments:\n\n        annotation_element -- Annotation or None\n\n        before -- str regular expression or None\n\n        after -- str regular expression or Element or None\n\n        content -- str regular expression or None, or Element\n\n        position -- int or tuple of int\n\n        body -- str or Element\n\n        creator -- str\n\n        date -- datetime\n    \"\"\"\n\n    if annotation_element is None:\n        annotation_element = Annotation(\n            text_or_element=body, creator=creator, date=date, parent=self\n        )\n    else:\n        # XXX clone or modify the argument?\n        if body:\n            annotation_element.note_body = body\n        if creator:\n            annotation_element.creator = creator\n        if date:\n            annotation_element.date = date\n    annotation_element.check_validity()\n\n    # special case: content is an odf element (ie: a paragraph)\n    if isinstance(content, Element):\n        if content.is_empty():\n            content.insert(annotation_element, xmlposition=NEXT_SIBLING)\n            return annotation_element\n        content.insert(annotation_element, start=True)\n        annotation_end = AnnotationEnd(annotation_element)\n        content.append(annotation_end)\n        return annotation_element\n\n    # special case\n    if isinstance(after, Element):\n        after.insert(annotation_element, FIRST_CHILD)\n        return annotation_element\n\n    # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and content is not None\n        and isinstance(position, int)\n    ):\n        # Start tag\n        self._insert(\n            annotation_element, before=content, position=position, main_text=True\n        )\n        # End tag\n        annotation_end = AnnotationEnd(annotation_element)\n        self._insert(\n            annotation_end, after=content, position=position, main_text=True\n        )\n        return annotation_element\n\n    # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and content is None\n        and isinstance(position, tuple)\n    ):\n        # Start\n        self._insert(annotation_element, position=position[0], main_text=True)\n        # End\n        annotation_end = AnnotationEnd(annotation_element)\n        self._insert(annotation_end, position=position[1], main_text=True)\n        return annotation_element\n\n    # Without \"content\" nor \"position\"\n    if content is not None or not isinstance(position, int):\n        raise ValueError(\"Bad arguments\")\n\n    # Insert\n    self._insert(\n        annotation_element,\n        before=before,\n        after=after,\n        position=position,\n        main_text=True,\n    )\n    return annotation_element\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.insert_annotation_end","title":"<code>insert_annotation_end(annotation_element, before=None, after=None, position=0)</code>","text":"<p>Insert an annotation end tag for an existing annotation. If some end tag already exists, replace it. Annotation end tag is set at the position defined by the regex (before or after).</p> <p>If content/before or after (regex) returns a group of matching positions, the position value is the index of matching place to use.</p> <p>Arguments:</p> <pre><code>annotation_element -- Annotation (mandatory)\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or None\n\nposition -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def insert_annotation_end(\n    self,\n    annotation_element: Annotation,\n    before: str | None = None,\n    after: str | None = None,\n    position: int = 0,\n) -&gt; AnnotationEnd:\n    \"\"\"Insert an annotation end tag for an existing annotation. If some end\n    tag already exists, replace it. Annotation end tag is set at the\n    position defined by the regex (before or after).\n\n    If content/before or after (regex) returns a group of matching\n    positions, the position value is the index of matching place to use.\n\n    Arguments:\n\n        annotation_element -- Annotation (mandatory)\n\n        before -- str regular expression or None\n\n        after -- str regular expression or None\n\n        position -- int\n    \"\"\"\n\n    if annotation_element is None:\n        raise ValueError\n    if not isinstance(annotation_element, Annotation):\n        raise TypeError(\"Not a &lt;office:annotation&gt; Annotation\")\n\n    # remove existing end tag\n    name = annotation_element.name\n    existing_end_tag = self.get_annotation_end(name=name)\n    if existing_end_tag:\n        existing_end_tag.delete()\n\n    # create the end tag\n    end_tag = AnnotationEnd(annotation_element)\n\n    # Insert\n    self._insert(\n        end_tag, before=before, after=after, position=position, main_text=True\n    )\n    return end_tag\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.insert_reference","title":"<code>insert_reference(name, ref_format='', before=None, after=None, position=0, display=None)</code>","text":"<p>Create and insert a reference to a content marked by a reference mark. The Reference element (\u201ctext:reference-ref\u201d) represents a field that references a \u201ctext:reference-mark-start\u201d or \u201ctext:reference-mark\u201d element. Its \u201ctext:reference-format\u201d attribute specifies what is displayed from the referenced element. Default is \u2018page\u2019. Actual content is not automatically updated except for the \u2018text\u2019 format.</p> <p>name is mandatory and should represent an existing reference mark of the document.</p> <p>ref_format is the argument for format reference (default is \u2018page\u2019).</p> <p>The reference is inserted the position defined by the regex (before / after), or by positionnal argument (position). If \u2018display\u2019 is provided, it will be used as the text value for the reference.</p> <p>If after is an ODF Element, the reference is inserted as first child of this element.</p> <p>Arguments:</p> <pre><code>name -- str\n\nref_format -- one of : 'chapter', 'direction', 'page', 'text',\n                        'caption', 'category-and-value', 'value',\n                        'number', 'number-all-superior',\n                        'number-no-superior'\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or odf element or None\n\nposition -- int\n\ndisplay -- str or None\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def insert_reference(\n    self,\n    name: str,\n    ref_format: str = \"\",\n    before: str | None = None,\n    after: str | Element | None = None,\n    position: int = 0,\n    display: str | None = None,\n) -&gt; None:\n    \"\"\"Create and insert a reference to a content marked by a reference\n    mark. The Reference element (\"text:reference-ref\") represents a\n    field that references a \"text:reference-mark-start\" or\n    \"text:reference-mark\" element. Its \"text:reference-format\" attribute\n    specifies what is displayed from the referenced element. Default is\n    'page'. Actual content is not automatically updated except for the 'text'\n    format.\n\n    name is mandatory and should represent an existing reference mark of the\n    document.\n\n    ref_format is the argument for format reference (default is 'page').\n\n    The reference is inserted the position defined by the regex (before /\n    after), or by positionnal argument (position). If 'display' is provided,\n    it will be used as the text value for the reference.\n\n    If after is an ODF Element, the reference is inserted as first child of\n    this element.\n\n    Arguments:\n\n        name -- str\n\n        ref_format -- one of : 'chapter', 'direction', 'page', 'text',\n                                'caption', 'category-and-value', 'value',\n                                'number', 'number-all-superior',\n                                'number-no-superior'\n\n        before -- str regular expression or None\n\n        after -- str regular expression or odf element or None\n\n        position -- int\n\n        display -- str or None\n    \"\"\"\n    reference = Reference(name, ref_format)\n    if display is None and ref_format == \"text\":\n        # get reference content\n        body = self.document_body\n        if not body:\n            body = self.root\n        mark = body.get_reference_mark(name=name)\n        if mark:\n            display = mark.referenced_text  # type: ignore\n    if not display:\n        display = \" \"\n    reference.text = display\n    if isinstance(after, Element):\n        after.insert(reference, FIRST_CHILD)\n    else:\n        self._insert(\n            reference, before=before, after=after, position=position, main_text=True\n        )\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_link","title":"<code>remove_link(links)</code>","text":"<p>Send back a copy of the element (not a clone), with the sub links    removed.</p> <p>Arguments:</p> <pre><code>links -- Link or list of Link\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_link(self, links: Link | list[Link]) -&gt; Element | list:\n    \"\"\"Send back a copy of the element (not a clone), with the sub links\n       removed.\n\n    Arguments:\n\n        links -- Link or list of Link\n    \"\"\"\n    return self.strip_elements(links)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_links","title":"<code>remove_links()</code>","text":"<p>Send back a copy of the element, without links tags.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_links(self) -&gt; Element | list:\n    \"\"\"Send back a copy of the element, without links tags.\"\"\"\n    strip = (Link._tag,)\n    return self.strip_tags(strip=strip)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_span","title":"<code>remove_span(spans)</code>","text":"<p>Send back a copy of the element, the spans (not a clone) removed.</p> <p>Arguments:</p> <pre><code>spans -- Element or list of Element\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_span(self, spans: Element | list[Element]) -&gt; Element | list:\n    \"\"\"Send back a copy of the element, the spans (not a clone) removed.\n\n    Arguments:\n\n        spans -- Element or list of Element\n    \"\"\"\n    return self.strip_elements(spans)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.remove_spans","title":"<code>remove_spans(keep_heading=True)</code>","text":"<p>Send back a copy of the element, without span styles. If keep_heading is True (default), the first level heading style is left unchanged.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def remove_spans(self, keep_heading: bool = True) -&gt; Element | list:\n    \"\"\"Send back a copy of the element, without span styles.\n    If keep_heading is True (default), the first level heading style is left\n    unchanged.\n    \"\"\"\n    strip = (Span._tag,)\n    if keep_heading:\n        protect = (\"text:h\",)\n    else:\n        protect = None\n    return self.strip_tags(strip=strip, protect=protect)\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_bookmark","title":"<code>set_bookmark(name, before=None, after=None, position=0, role=None, content=None)</code>","text":"<p>Insert a bookmark before or after the characters in the text which match the regex before/after. When the regex matches more of one part of the text, position can be set to choose which part must be used. If before and after are None, we use only position that is the number of characters.</p> <p>So, by default, this function inserts a bookmark before the first character of the content. Role can be None, \u201cstart\u201d or \u201cend\u201d, we insert respectively a position bookmark a bookmark-start or a bookmark-end.</p> <p>If content is not None these 2 calls are equivalent:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, content=\u201dxyz\u201d)</p> <p>and:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, before=\u201dxyz\u201d, role=\u201dstart\u201d)   paragraph.set_bookmark(\u201cbookmark\u201d, after=\u201dxyz\u201d, role=\u201dend\u201d)</p> <p>If position is a 2-tuple, these 2 calls are equivalent:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, position=(10, 20))</p> <p>and:</p> <p>paragraph.set_bookmark(\u201cbookmark\u201d, position=10, role=\u201dstart\u201d)   paragraph.set_bookmark(\u201cbookmark\u201d, position=20, role=\u201dend\u201d)</p> <p>Arguments:</p> <pre><code>name -- str\n\nbefore -- str regex\n\nafter -- str regex\n\nposition -- int or (int, int)\n\nrole -- None, \"start\" or \"end\"\n\ncontent -- str regex\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def set_bookmark(\n    self,\n    name: str,\n    before: str | None = None,\n    after: str | None = None,\n    position: int | tuple = 0,\n    role: str | None = None,\n    content: str | None = None,\n) -&gt; Element | tuple[Element, Element]:\n    \"\"\"Insert a bookmark before or after the characters in the text which\n    match the regex before/after. When the regex matches more of one part\n    of the text, position can be set to choose which part must be used.\n    If before and after are None, we use only position that is the number\n    of characters.\n\n    So, by default, this function inserts a bookmark before the first\n    character of the content. Role can be None, \"start\" or \"end\", we\n    insert respectively a position bookmark a bookmark-start or a\n    bookmark-end.\n\n    If content is not None these 2 calls are equivalent:\n\n      paragraph.set_bookmark(\"bookmark\", content=\"xyz\")\n\n    and:\n\n      paragraph.set_bookmark(\"bookmark\", before=\"xyz\", role=\"start\")\n      paragraph.set_bookmark(\"bookmark\", after=\"xyz\", role=\"end\")\n\n\n    If position is a 2-tuple, these 2 calls are equivalent:\n\n      paragraph.set_bookmark(\"bookmark\", position=(10, 20))\n\n    and:\n\n      paragraph.set_bookmark(\"bookmark\", position=10, role=\"start\")\n      paragraph.set_bookmark(\"bookmark\", position=20, role=\"end\")\n\n\n    Arguments:\n\n        name -- str\n\n        before -- str regex\n\n        after -- str regex\n\n        position -- int or (int, int)\n\n        role -- None, \"start\" or \"end\"\n\n        content -- str regex\n    \"\"\"\n    # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and role is None\n        and content is not None\n        and isinstance(position, int)\n    ):\n        # Start\n        start = BookmarkStart(name)\n        self._insert(start, before=content, position=position, main_text=True)\n        # End\n        end = BookmarkEnd(name)\n        self._insert(end, after=content, position=position, main_text=True)\n        return start, end\n\n    # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n    # bookmark\n    if (\n        before is None\n        and after is None\n        and role is None\n        and content is None\n        and isinstance(position, tuple)\n    ):\n        # Start\n        start = BookmarkStart(name)\n        self._insert(start, position=position[0], main_text=True)\n        # End\n        end = BookmarkEnd(name)\n        self._insert(end, position=position[1], main_text=True)\n        return start, end\n\n    # Without \"content\" nor \"position\"\n    if content is not None or not isinstance(position, int):\n        raise ValueError(\"bad arguments\")\n\n    # Role\n    if role is None:\n        bookmark: Element = Bookmark(name)\n    elif role == \"start\":\n        bookmark = BookmarkStart(name)\n    elif role == \"end\":\n        bookmark = BookmarkEnd(name)\n    else:\n        raise ValueError(\"bad arguments\")\n\n    # Insert\n    self._insert(\n        bookmark, before=before, after=after, position=position, main_text=True\n    )\n\n    return bookmark\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_link","title":"<code>set_link(match, tail, url, regex=None, offset=None, length=0)</code>","text":"<p>set_link(url, regex=None, offset=None, length=0) Make a link to the provided url from text content matching the regex OR the positional arguments offset and length.</p> <p>(match, tail: provided by regex decorator)</p> <p>Arguments:</p> <pre><code>url -- str\n\nregex -- str regular expression\n\noffset -- int\n\nlength -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>@_by_regex_offset\ndef set_link(\n    self,\n    match: str,\n    tail: str,\n    url: str,\n    regex: str | None = None,\n    offset: int | None = None,\n    length: int = 0,\n) -&gt; Element:\n    \"\"\"\n    set_link(url, regex=None, offset=None, length=0)\n    Make a link to the provided url from text content matching the regex\n    OR the positional arguments offset and length.\n\n    (match, tail: provided by regex decorator)\n\n    Arguments:\n\n        url -- str\n\n        regex -- str regular expression\n\n        offset -- int\n\n        length -- int\n    \"\"\"\n    link = Link(url, text=match)\n    link.tail = tail\n    return link\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_reference_mark","title":"<code>set_reference_mark(name, before=None, after=None, position=0, content=None)</code>","text":"<p>Insert a reference mark, at the position defined by the regex (before, after, content) or by positionnal argument (position). If content is provided, the annotation covers the full range content regex (instances of ReferenceMarkStart and ReferenceMarkEnd are created). Else, an instance of ReferenceMark is positionned either \u2018before\u2019 or \u2018after\u2019 provided regex.</p> <p>If content is an ODF Element (ie: Paragraph, Span, \u2026), the full inner content is referenced (of the position just after if content is a single empty tag).</p> <p>If content/before or after exists (regex) and return a group of matching positions, the position value is the index of matching place to use.</p> <p>Name is mandatory and shall be unique in the document for the preference mark range.</p> <p>Arguments:</p> <pre><code>name -- str\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or None,\n\ncontent -- str regular expression or None, or Element\n\nposition -- int or tuple of int\n</code></pre> <p>Return: the created ReferenceMark or ReferenceMarkStart</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def set_reference_mark(\n    self,\n    name: str,\n    before: str | None = None,\n    after: str | None = None,\n    position: int = 0,\n    content: str | Element | None = None,\n) -&gt; Element:\n    \"\"\"Insert a reference mark, at the position defined by the regex\n    (before, after, content) or by positionnal argument (position). If\n    content is provided, the annotation covers the full range content regex\n    (instances of ReferenceMarkStart and ReferenceMarkEnd are\n    created). Else, an instance of ReferenceMark is positionned either\n    'before' or 'after' provided regex.\n\n    If content is an ODF Element (ie: Paragraph, Span, ...), the full inner\n    content is referenced (of the position just after if content is a single\n    empty tag).\n\n    If content/before or after exists (regex) and return a group of matching\n    positions, the position value is the index of matching place to use.\n\n    Name is mandatory and shall be unique in the document for the preference\n    mark range.\n\n    Arguments:\n\n        name -- str\n\n        before -- str regular expression or None\n\n        after -- str regular expression or None,\n\n        content -- str regular expression or None, or Element\n\n        position -- int or tuple of int\n\n    Return: the created ReferenceMark or ReferenceMarkStart\n    \"\"\"\n    # special case: content is an odf element (ie: a paragraph)\n    if isinstance(content, Element):\n        if content.is_empty():\n            reference = ReferenceMark(name)\n            content.insert(reference, xmlposition=NEXT_SIBLING)\n            return reference\n        reference_start = ReferenceMarkStart(name)\n        content.insert(reference_start, start=True)\n        reference_end = ReferenceMarkEnd(name)\n        content.append(reference_end)\n        return reference_start\n\n    # With \"content\" =&gt; automatically insert a \"start\" and an \"end\"\n    # reference\n    if (\n        before is None\n        and after is None\n        and content is not None\n        and isinstance(position, int)\n    ):\n        # Start tag\n        reference_start = ReferenceMarkStart(name)\n        self._insert(\n            reference_start, before=content, position=position, main_text=True\n        )\n        # End tag\n        reference_end = ReferenceMarkEnd(name)\n        self._insert(\n            reference_end, after=content, position=position, main_text=True\n        )\n        return reference_start\n\n    # With \"(int, int)\" =&gt;  automatically insert a \"start\" and an \"end\"\n    if (\n        before is None\n        and after is None\n        and content is None\n        and isinstance(position, tuple)\n    ):\n        # Start\n        reference_start = ReferenceMarkStart(name)\n        self._insert(reference_start, position=position[0], main_text=True)\n        # End\n        reference_end = ReferenceMarkEnd(name)\n        self._insert(reference_end, position=position[1], main_text=True)\n        return reference_start\n\n    # Without \"content\" nor \"position\"\n    if content is not None or not isinstance(position, int):\n        raise ValueError(\"bad arguments\")\n\n    # Insert a positional reference mark\n    reference = ReferenceMark(name)\n    self._insert(\n        reference,\n        before=before,\n        after=after,\n        position=position,\n        main_text=True,\n    )\n    return reference\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_reference_mark_end","title":"<code>set_reference_mark_end(reference_mark, before=None, after=None, position=0)</code>","text":"<p>Insert/move a ReferenceMarkEnd for an existing reference mark. If some end tag already exists, replace it. Reference tag is set at the position defined by the regex (before or after).</p> <p>If content/before or after (regex) returns a group of matching positions, the position value is the index of matching place to use.</p> <p>Arguments:</p> <pre><code>reference_mark -- ReferenceMark or ReferenceMarkStart (mandatory)\n\nbefore -- str regular expression or None\n\nafter -- str regular expression or None\n\nposition -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def set_reference_mark_end(\n    self,\n    reference_mark: Element,\n    before: str | None = None,\n    after: str | None = None,\n    position: int = 0,\n) -&gt; ReferenceMarkEnd:\n    \"\"\"Insert/move a ReferenceMarkEnd for an existing reference mark. If\n    some end tag already exists, replace it. Reference tag is set at the\n    position defined by the regex (before or after).\n\n    If content/before or after (regex) returns a group of matching\n    positions, the position value is the index of matching place to use.\n\n    Arguments:\n\n        reference_mark -- ReferenceMark or ReferenceMarkStart (mandatory)\n\n        before -- str regular expression or None\n\n        after -- str regular expression or None\n\n        position -- int\n    \"\"\"\n    if not isinstance(reference_mark, (ReferenceMark, ReferenceMarkStart)):\n        raise TypeError(\"Not a ReferenceMark or ReferenceMarkStart\")\n    name = reference_mark.name\n    if isinstance(reference_mark, ReferenceMark):\n        # change it to a range reference:\n        reference_mark.tag = ReferenceMarkStart._tag\n\n    existing_end_tag = self.get_reference_mark_end(name=name)\n    if existing_end_tag:\n        existing_end_tag.delete()\n\n    # create the end tag\n    end_tag = ReferenceMarkEnd(name)\n\n    # Insert\n    self._insert(\n        end_tag, before=before, after=after, position=position, main_text=True\n    )\n    return end_tag\n</code></pre>"},{"location":"reference.html#odfdo.Paragraph.set_span","title":"<code>set_span(match, tail, style, regex=None, offset=None, length=0)</code>","text":"<p>set_span(style, regex=None, offset=None, length=0) Apply the given style to text content matching the regex OR the positional arguments offset and length.</p> <p>(match, tail: provided by regex decorator)</p> <p>Arguments:</p> <pre><code>style -- str\n\nregex -- str regular expression\n\noffset -- int\n\nlength -- int\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>@_by_regex_offset\ndef set_span(\n    self,\n    match: str,\n    tail: str,\n    style: str,\n    regex: str | None = None,\n    offset: int | None = None,\n    length: int = 0,\n) -&gt; Span:\n    \"\"\"\n    set_span(style, regex=None, offset=None, length=0)\n    Apply the given style to text content matching the regex OR the\n    positional arguments offset and length.\n\n    (match, tail: provided by regex decorator)\n\n    Arguments:\n\n        style -- str\n\n        regex -- str regular expression\n\n        offset -- int\n\n        length -- int\n    \"\"\"\n    span = Span(match, style=style)\n    span.tail = tail\n    return span\n</code></pre>"},{"location":"reference.html#odfdo.Presentation","title":"<code>Presentation</code>","text":"<p>               Bases: <code>Body</code></p> <p>Presentation, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Presentation(Body):\n    \"\"\"Presentation, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:presentation\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.RectangleShape","title":"<code>RectangleShape</code>","text":"<p>               Bases: <code>ShapeBase</code></p> <p>Create a rectangle shape.</p> <p>Arguments:</p> <pre><code>style -- str\n\ntext_style -- str\n\ndraw_id -- str\n\nlayer -- str\n\nposition -- (str, str)\n\nsize -- (str, str)\n</code></pre> Source code in <code>odfdo/shapes.py</code> <pre><code>class RectangleShape(ShapeBase):\n    \"\"\"Create a rectangle shape.\n\n    Arguments:\n\n        style -- str\n\n        text_style -- str\n\n        draw_id -- str\n\n        layer -- str\n\n        position -- (str, str)\n\n        size -- (str, str)\n\n    \"\"\"\n\n    _tag = \"draw:rect\"\n    _properties: tuple[PropDef, ...] = ()\n\n    def __init__(\n        self,\n        style: str | None = None,\n        text_style: str | None = None,\n        draw_id: str | None = None,\n        layer: str | None = None,\n        position: tuple | None = None,\n        size: tuple | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        kwargs.update(\n            {\n                \"style\": style,\n                \"text_style\": text_style,\n                \"draw_id\": draw_id,\n                \"layer\": layer,\n                \"size\": size,\n                \"position\": position,\n            }\n        )\n        super().__init__(**kwargs)\n</code></pre>"},{"location":"reference.html#odfdo.Reference","title":"<code>Reference</code>","text":"<p>               Bases: <code>Element</code></p> <p>A reference to a content marked by a reference mark. The odf_reference element (\u201ctext:reference-ref\u201d) represents a field that references a \u201ctext:reference-mark-start\u201d or \u201ctext:reference-mark\u201d element. Its text:reference-format attribute specifies what is displayed from the referenced element. Default is \u2018page\u2019 Actual content is not updated except for the \u2018text\u2019 format by the update() method.</p> <p>Creation of references can be tricky, consider using this method:     odfdo.paragraph.insert_reference()</p> <p>Values for text:reference-format :     The defined values for the text:reference-format attribute supported by     all reference fields are:       - \u2018chapter\u2019: displays the number of the chapter in which the         referenced item appears.       - \u2018direction\u2019: displays whether the referenced item is above or         below the reference field.       - \u2018page\u2019: displays the number of the page on which the referenced         item appears.       - \u2018text\u2019: displays the text of the referenced item.     Additional defined values for the text:reference-format attribute     supported by references to sequence fields are:       - \u2018caption\u2019: displays the caption in which the sequence is used.       - \u2018category-and-value\u2019: displays the name and value of the sequence.       - \u2018value\u2019: displays the value of the sequence.</p> <pre><code>References to bookmarks and other references support additional values,\nwhich display the list label of the referenced item. If the referenced\nitem is contained in a list or a numbered paragraph, the list label is\nthe formatted number of the paragraph which contains the referenced\nitem. If the referenced item is not contained in a list or numbered\nparagraph, the list label is empty, and the referenced field therefore\ndisplays nothing. If the referenced bookmark or reference contains more\nthan one paragraph, the list label of the paragraph at which the\nbookmark or reference starts is taken.\n\nAdditional defined values for the text:reference-format attribute\nsupported by all references to bookmark's or other reference fields\nare:\n  - 'number': displays the list label of the referenced item. [...]\n  - 'number-all-superior': displays the list label of the referenced\n    item and adds the contents of all list labels of superior levels\n    in front of it. [...]\n  - 'number-no-superior': displays the contents of the list label of\n    the referenced item.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>class Reference(Element):\n    \"\"\"A reference to a content marked by a reference mark.\n    The odf_reference element (\"text:reference-ref\") represents a field that\n    references a \"text:reference-mark-start\" or \"text:reference-mark\" element.\n    Its text:reference-format attribute specifies what is displayed from the\n    referenced element. Default is 'page'\n    Actual content is not updated except for the 'text' format by the\n    update() method.\n\n\n    Creation of references can be tricky, consider using this method:\n        odfdo.paragraph.insert_reference()\n\n    Values for text:reference-format :\n        The defined values for the text:reference-format attribute supported by\n        all reference fields are:\n          - 'chapter': displays the number of the chapter in which the\n            referenced item appears.\n          - 'direction': displays whether the referenced item is above or\n            below the reference field.\n          - 'page': displays the number of the page on which the referenced\n            item appears.\n          - 'text': displays the text of the referenced item.\n        Additional defined values for the text:reference-format attribute\n        supported by references to sequence fields are:\n          - 'caption': displays the caption in which the sequence is used.\n          - 'category-and-value': displays the name and value of the sequence.\n          - 'value': displays the value of the sequence.\n\n        References to bookmarks and other references support additional values,\n        which display the list label of the referenced item. If the referenced\n        item is contained in a list or a numbered paragraph, the list label is\n        the formatted number of the paragraph which contains the referenced\n        item. If the referenced item is not contained in a list or numbered\n        paragraph, the list label is empty, and the referenced field therefore\n        displays nothing. If the referenced bookmark or reference contains more\n        than one paragraph, the list label of the paragraph at which the\n        bookmark or reference starts is taken.\n\n        Additional defined values for the text:reference-format attribute\n        supported by all references to bookmark's or other reference fields\n        are:\n          - 'number': displays the list label of the referenced item. [...]\n          - 'number-all-superior': displays the list label of the referenced\n            item and adds the contents of all list labels of superior levels\n            in front of it. [...]\n          - 'number-no-superior': displays the contents of the list label of\n            the referenced item.\n    \"\"\"\n\n    _tag = \"text:reference-ref\"\n    _properties = (PropDef(\"name\", \"text:ref-name\"),)\n    format_allowed = (\n        \"chapter\",\n        \"direction\",\n        \"page\",\n        \"text\",\n        \"caption\",\n        \"category-and-value\",\n        \"value\",\n        \"number\",\n        \"number-all-superior\",\n        \"number-no-superior\",\n    )\n\n    def __init__(self, name: str = \"\", ref_format: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"Create a reference to a content marked by a reference mark. An\n        actual reference mark with the provided name should exist.\n\n        Consider using: odfdo.paragraph.insert_reference()\n\n        The text:ref-name attribute identifies a \"text:reference-mark\" or\n        \"text:referencemark-start\" element by the value of that element's\n        text:name attribute.\n        If ref_format is 'text', the current text content of the reference_mark\n        is retrieved.\n\n        Arguments:\n\n            name -- str : name of the reference mark\n\n            ref_format -- str : format of the field. Default is 'page', allowed\n                            values are 'chapter', 'direction', 'page', 'text',\n                            'caption', 'category-and-value', 'value', 'number',\n                            'number-all-superior', 'number-no-superior'.\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n            self.ref_format = ref_format\n\n    @property\n    def ref_format(self) -&gt; str | None:\n        reference = self.get_attribute(\"text:reference-format\")\n        if isinstance(reference, str):\n            return reference\n        return None\n\n    @ref_format.setter\n    def ref_format(self, ref_format: str) -&gt; None:\n        \"\"\"Set the text:reference-format attribute.\n\n        Arguments:\n\n            ref_format -- str\n        \"\"\"\n        if not ref_format or ref_format not in self.format_allowed:\n            ref_format = \"page\"\n        self.set_attribute(\"text:reference-format\", ref_format)\n\n    def update(self) -&gt; None:\n        \"\"\"Update the content of the reference text field. Currently only\n        'text' format is implemented. Other values, for example the 'page' text\n        field, may need to be refreshed through a visual ODF parser.\n        \"\"\"\n        ref_format = self.ref_format\n        if ref_format != \"text\":\n            # only 'text' is implemented\n            return None\n        body = self.document_body\n        if not body:\n            body = self.root\n        name = self.name\n        reference = body.get_reference_mark(name=name)\n        if not reference:\n            return None\n        # we know it is a ReferenceMarkStart:\n        self.text = reference.referenced_text()  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Reference.__init__","title":"<code>__init__(name='', ref_format='', **kwargs)</code>","text":"<p>Create a reference to a content marked by a reference mark. An actual reference mark with the provided name should exist.</p> <p>Consider using: odfdo.paragraph.insert_reference()</p> <p>The text:ref-name attribute identifies a \u201ctext:reference-mark\u201d or \u201ctext:referencemark-start\u201d element by the value of that element\u2019s text:name attribute. If ref_format is \u2018text\u2019, the current text content of the reference_mark is retrieved.</p> <p>Arguments:</p> <pre><code>name -- str : name of the reference mark\n\nref_format -- str : format of the field. Default is 'page', allowed\n                values are 'chapter', 'direction', 'page', 'text',\n                'caption', 'category-and-value', 'value', 'number',\n                'number-all-superior', 'number-no-superior'.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", ref_format: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"Create a reference to a content marked by a reference mark. An\n    actual reference mark with the provided name should exist.\n\n    Consider using: odfdo.paragraph.insert_reference()\n\n    The text:ref-name attribute identifies a \"text:reference-mark\" or\n    \"text:referencemark-start\" element by the value of that element's\n    text:name attribute.\n    If ref_format is 'text', the current text content of the reference_mark\n    is retrieved.\n\n    Arguments:\n\n        name -- str : name of the reference mark\n\n        ref_format -- str : format of the field. Default is 'page', allowed\n                        values are 'chapter', 'direction', 'page', 'text',\n                        'caption', 'category-and-value', 'value', 'number',\n                        'number-all-superior', 'number-no-superior'.\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n        self.ref_format = ref_format\n</code></pre>"},{"location":"reference.html#odfdo.Reference.update","title":"<code>update()</code>","text":"<p>Update the content of the reference text field. Currently only \u2018text\u2019 format is implemented. Other values, for example the \u2018page\u2019 text field, may need to be refreshed through a visual ODF parser.</p> Source code in <code>odfdo/reference.py</code> <pre><code>def update(self) -&gt; None:\n    \"\"\"Update the content of the reference text field. Currently only\n    'text' format is implemented. Other values, for example the 'page' text\n    field, may need to be refreshed through a visual ODF parser.\n    \"\"\"\n    ref_format = self.ref_format\n    if ref_format != \"text\":\n        # only 'text' is implemented\n        return None\n    body = self.document_body\n    if not body:\n        body = self.root\n    name = self.name\n    reference = body.get_reference_mark(name=name)\n    if not reference:\n        return None\n    # we know it is a ReferenceMarkStart:\n    self.text = reference.referenced_text()  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMark","title":"<code>ReferenceMark</code>","text":"<p>               Bases: <code>Element</code></p> <p>A point reference. A point reference marks a position in text and is represented by a single \u201ctext:reference-mark\u201d element.</p> Source code in <code>odfdo/reference.py</code> <pre><code>class ReferenceMark(Element):\n    \"\"\"A point reference.\n    A point reference marks a position in text and is represented by a single\n    \"text:reference-mark\" element.\n    \"\"\"\n\n    _tag = \"text:reference-mark\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"A point reference. A point reference marks a position in text and is\n        represented by a single \"text:reference-mark\" element.\n        Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMark.__init__","title":"<code>__init__(name='', **kwargs)</code>","text":"<p>A point reference. A point reference marks a position in text and is represented by a single \u201ctext:reference-mark\u201d element. Consider using the wrapper: odfdo.paragraph.set_reference_mark()</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"A point reference. A point reference marks a position in text and is\n    represented by a single \"text:reference-mark\" element.\n    Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkEnd","title":"<code>ReferenceMarkEnd</code>","text":"<p>               Bases: <code>Element</code></p> <p>The \u201ctext:reference-mark-end\u201d element represents the end of a range reference.</p> Source code in <code>odfdo/reference.py</code> <pre><code>class ReferenceMarkEnd(Element):\n    \"\"\"The \"text:reference-mark-end\" element represents the end of a range\n    reference.\n    \"\"\"\n\n    _tag = \"text:reference-mark-end\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"The \"text:reference-mark-end\" element represent the end of a range\n        reference.\n        Consider using the wrappers: odfdo.paragraph.set_reference_mark() and\n        odfdo.paragraph.set_reference_mark_end()\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n\n    def referenced_text(self) -&gt; str:\n        \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n        name = self.name\n        request = (\n            f\"//text()\"\n            f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n            f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n        )\n        result = \" \".join(str(x) for x in self.xpath(request))\n        return result\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkEnd.__init__","title":"<code>__init__(name='', **kwargs)</code>","text":"<p>The \u201ctext:reference-mark-end\u201d element represent the end of a range reference. Consider using the wrappers: odfdo.paragraph.set_reference_mark() and odfdo.paragraph.set_reference_mark_end()</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"The \"text:reference-mark-end\" element represent the end of a range\n    reference.\n    Consider using the wrappers: odfdo.paragraph.set_reference_mark() and\n    odfdo.paragraph.set_reference_mark_end()\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkEnd.referenced_text","title":"<code>referenced_text()</code>","text":"<p>Return the text between reference-mark-start and reference-mark-end.</p> Source code in <code>odfdo/reference.py</code> <pre><code>def referenced_text(self) -&gt; str:\n    \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n    name = self.name\n    request = (\n        f\"//text()\"\n        f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n        f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n    )\n    result = \" \".join(str(x) for x in self.xpath(request))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart","title":"<code>ReferenceMarkStart</code>","text":"<p>               Bases: <code>Element</code></p> <p>The \u201ctext:reference-mark-start\u201d element represents the start of a range reference.</p> Source code in <code>odfdo/reference.py</code> <pre><code>class ReferenceMarkStart(Element):\n    \"\"\"The \"text:reference-mark-start\" element represents the start of a\n    range reference.\n    \"\"\"\n\n    _tag = \"text:reference-mark-start\"\n    _properties = (PropDef(\"name\", \"text:name\"),)\n\n    def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n        \"\"\"The \"text:reference-mark-start\" element represent the start of a range\n        reference.\n        Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.name = name\n\n    def referenced_text(self) -&gt; str:\n        \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n        name = self.name\n        request = (\n            f\"//text()\"\n            f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n            f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n        )\n        result = \" \".join(str(x) for x in self.xpath(request))\n        return result\n\n    def get_referenced(\n        self,\n        no_header: bool = False,\n        clean: bool = True,\n        as_xml: bool = False,\n        as_list: bool = False,\n    ) -&gt; Element | list | str | None:\n        \"\"\"Return the document content between the start and end tags of the\n        reference. The content returned by this method can spread over several\n        headers and paragraphs.\n        By default, the content is returned as an \"office:text\" odf element.\n\n\n        Arguments:\n\n            no_header -- boolean (default to False), translate existing headers\n                         tags \"text:h\" into paragraphs \"text:p\".\n\n            clean -- boolean (default to True), suppress unwanted tags. Striped\n                     tags are : 'text:change', 'text:change-start',\n                     'text:change-end', 'text:reference-mark',\n                     'text:reference-mark-start', 'text:reference-mark-end'.\n\n            as_xml -- boolean (default to False), format the returned content as\n                      a XML string (serialization).\n\n            as_list -- boolean (default to False), do not embed the returned\n                       content in a \"office:text'\" element, instead simply\n                       return a raw list of odf elements.\n        \"\"\"\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Reference need some upper document part\")\n        body = self.document_body\n        if not body:\n            body = parent\n        end = body.get_reference_mark_end(name=name)\n        if end is None:\n            raise ValueError(\"No reference-end found\")\n        start = self\n        return _get_referenced(body, start, end, no_header, clean, as_xml, as_list)\n\n    def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        For odf_reference_mark_start : delete the reference-end tag if exists.\n\n        Arguments:\n\n            child -- Element\n\n            keep_tail -- boolean (default to True), True for most usages.\n        \"\"\"\n        if child is not None:  # act like normal delete\n            return super().delete(child, keep_tail)\n        name = self.name\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can't delete the root element\")\n        body = self.document_body\n        if not body:\n            body = parent\n        end = body.get_reference_mark_end(name=name)\n        if end:\n            end.delete()\n        # act like normal delete\n        return super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.__init__","title":"<code>__init__(name='', **kwargs)</code>","text":"<p>The \u201ctext:reference-mark-start\u201d element represent the start of a range reference. Consider using the wrapper: odfdo.paragraph.set_reference_mark()</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def __init__(self, name: str = \"\", **kwargs: Any) -&gt; None:\n    \"\"\"The \"text:reference-mark-start\" element represent the start of a range\n    reference.\n    Consider using the wrapper: odfdo.paragraph.set_reference_mark()\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.name = name\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>For odf_reference_mark_start : delete the reference-end tag if exists.</p> <p>Arguments:</p> <pre><code>child -- Element\n\nkeep_tail -- boolean (default to True), True for most usages.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def delete(self, child: Element | None = None, keep_tail: bool = True) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    For odf_reference_mark_start : delete the reference-end tag if exists.\n\n    Arguments:\n\n        child -- Element\n\n        keep_tail -- boolean (default to True), True for most usages.\n    \"\"\"\n    if child is not None:  # act like normal delete\n        return super().delete(child, keep_tail)\n    name = self.name\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Can't delete the root element\")\n    body = self.document_body\n    if not body:\n        body = parent\n    end = body.get_reference_mark_end(name=name)\n    if end:\n        end.delete()\n    # act like normal delete\n    return super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.get_referenced","title":"<code>get_referenced(no_header=False, clean=True, as_xml=False, as_list=False)</code>","text":"<p>Return the document content between the start and end tags of the reference. The content returned by this method can spread over several headers and paragraphs. By default, the content is returned as an \u201coffice:text\u201d odf element.</p> <p>Arguments:</p> <pre><code>no_header -- boolean (default to False), translate existing headers\n             tags \"text:h\" into paragraphs \"text:p\".\n\nclean -- boolean (default to True), suppress unwanted tags. Striped\n         tags are : 'text:change', 'text:change-start',\n         'text:change-end', 'text:reference-mark',\n         'text:reference-mark-start', 'text:reference-mark-end'.\n\nas_xml -- boolean (default to False), format the returned content as\n          a XML string (serialization).\n\nas_list -- boolean (default to False), do not embed the returned\n           content in a \"office:text'\" element, instead simply\n           return a raw list of odf elements.\n</code></pre> Source code in <code>odfdo/reference.py</code> <pre><code>def get_referenced(\n    self,\n    no_header: bool = False,\n    clean: bool = True,\n    as_xml: bool = False,\n    as_list: bool = False,\n) -&gt; Element | list | str | None:\n    \"\"\"Return the document content between the start and end tags of the\n    reference. The content returned by this method can spread over several\n    headers and paragraphs.\n    By default, the content is returned as an \"office:text\" odf element.\n\n\n    Arguments:\n\n        no_header -- boolean (default to False), translate existing headers\n                     tags \"text:h\" into paragraphs \"text:p\".\n\n        clean -- boolean (default to True), suppress unwanted tags. Striped\n                 tags are : 'text:change', 'text:change-start',\n                 'text:change-end', 'text:reference-mark',\n                 'text:reference-mark-start', 'text:reference-mark-end'.\n\n        as_xml -- boolean (default to False), format the returned content as\n                  a XML string (serialization).\n\n        as_list -- boolean (default to False), do not embed the returned\n                   content in a \"office:text'\" element, instead simply\n                   return a raw list of odf elements.\n    \"\"\"\n    name = self.name\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Reference need some upper document part\")\n    body = self.document_body\n    if not body:\n        body = parent\n    end = body.get_reference_mark_end(name=name)\n    if end is None:\n        raise ValueError(\"No reference-end found\")\n    start = self\n    return _get_referenced(body, start, end, no_header, clean, as_xml, as_list)\n</code></pre>"},{"location":"reference.html#odfdo.ReferenceMarkStart.referenced_text","title":"<code>referenced_text()</code>","text":"<p>Return the text between reference-mark-start and reference-mark-end.</p> Source code in <code>odfdo/reference.py</code> <pre><code>def referenced_text(self) -&gt; str:\n    \"\"\"Return the text between reference-mark-start and reference-mark-end.\"\"\"\n    name = self.name\n    request = (\n        f\"//text()\"\n        f\"[preceding::text:reference-mark-start[@text:name='{name}'] \"\n        f\"and following::text:reference-mark-end[@text:name='{name}']]\"\n    )\n    result = \" \".join(str(x) for x in self.xpath(request))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.Row","title":"<code>Row</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF table row \u201ctable:table-row\u201d</p> Source code in <code>odfdo/row.py</code> <pre><code>class Row(Element):\n    \"\"\"ODF table row \"table:table-row\" \"\"\"\n\n    _tag = \"table:table-row\"\n    _caching = True\n    _append = Element.append\n\n    def __init__(\n        self,\n        width: int | None = None,\n        repeated: int | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"create a Row, optionally filled with \"width\" number of cells.\n\n        Rows contain cells, their number determine the number of columns.\n\n        You don't generally have to create rows by hand, use the Table API.\n\n        Arguments:\n\n            width -- int\n\n            repeated -- int\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self.y = None\n        if not hasattr(self, \"_indexes\"):\n            self._indexes = {}\n            self._indexes[\"_rmap\"] = {}\n        if not hasattr(self, \"_rmap\"):\n            self._compute_row_cache()\n            if not hasattr(self, \"_tmap\"):\n                self._tmap = []\n                self._cmap = []\n        if self._do_init:\n            if width is not None:\n                for _i in range(width):\n                    self.append(Cell())  # type:ignore\n            if repeated:\n                self.repeated = repeated\n            if style is not None:\n                self.style = style\n            self._compute_row_cache()\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} y={self.y}&gt;\"\n\n    def _get_cells(self) -&gt; list[Element]:\n        return self.get_elements(_xpath_cell)\n\n    def _translate_row_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, int | None]:\n        xyzt = convert_coordinates(coord)\n        if len(xyzt) == 2:\n            x, z = xyzt\n        else:\n            x, _, z, __ = xyzt\n        if x and x &lt; 0:\n            x = increment(x, self.width)\n        if z and z &lt; 0:\n            z = increment(z, self.width)\n        return (x, z)\n\n    def _compute_row_cache(self) -&gt; None:\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_cell, \"table:number-columns-repeated\"\n        )\n        self._rmap = make_cache_map(idx_repeated_seq)\n\n    # Public API\n\n    @property\n    def clone(self) -&gt; Row:\n        clone = Element.clone.fget(self)  # type: ignore\n        clone.y = self.y\n        if hasattr(self, \"_tmap\"):\n            if hasattr(self, \"_rmap\"):\n                clone._rmap = self._rmap[:]\n            clone._tmap = self._tmap[:]\n            clone._cmap = self._cmap[:]\n        return clone\n\n    def _set_repeated(self, repeated: int | None) -&gt; None:\n        \"\"\"Method Internal only. Set the numnber of times the row is\n        repeated, or None to delete it. Without changing cache.\n\n        Arguments:\n\n            repeated -- int\n        \"\"\"\n        if repeated is None or repeated &lt; 2:\n            with contextlib.suppress(KeyError):\n                self.del_attribute(\"table:number-rows-repeated\")\n            return\n        self.set_attribute(\"table:number-rows-repeated\", str(repeated))\n\n    @property\n    def repeated(self) -&gt; int | None:\n        \"\"\"Get / set the number of times the row is repeated.\n\n        Always None when using the table API.\n\n        Return: int or None\n        \"\"\"\n        repeated = self.get_attribute(\"table:number-rows-repeated\")\n        if repeated is None:\n            return None\n        return int(repeated)\n\n    @repeated.setter\n    def repeated(self, repeated: int | None) -&gt; None:\n        self._set_repeated(repeated)\n        # update cache\n        current: Element = self\n        while True:\n            # look for Table, parent may be group of rows\n            upper = current.parent\n            if not upper:\n                # lonely row\n                return\n            # parent may be group of rows, not table\n            if isinstance(upper, Element) and upper._tag == \"table:table\":\n                break\n            current = upper\n        # fixme : need to optimize this\n        if isinstance(upper, Element) and upper._tag == \"table:table\":\n            upper._compute_table_cache()\n            if hasattr(self, \"_tmap\"):\n                del self._tmap[:]\n                self._tmap.extend(upper._tmap)\n            else:\n                self._tmap = upper._tmap\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get /set the style of the row itself.\n\n        Return: str\n        \"\"\"\n        return self.get_attribute(\"table:style-name\")  # type: ignore\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n\n    @property\n    def width(self) -&gt; int:\n        \"\"\"Get the number of expected cells in the row, i.e. addition\n        repetitions.\n\n        Return: int\n        \"\"\"\n        try:\n            value = self._rmap[-1] + 1\n        except Exception:\n            value = 0\n        return value\n\n    def _translate_x_from_any(self, x: str | int) -&gt; int:\n        return translate_from_any(x, self.width, 0)\n\n    def traverse(  # noqa: C901\n        self,\n        start: int | None = None,\n        end: int | None = None,\n    ) -&gt; Iterator[Cell]:\n        \"\"\"Yield as many cell elements as expected cells in the row, i.e.\n        expand repetitions by returning the same cell as many times as\n        necessary.\n\n            Arguments:\n\n                start -- int\n\n                end -- int\n\n        Copies are returned, use set_cell() to push them back.\n        \"\"\"\n        idx = -1\n        before = -1\n        x = 0\n        cell: Cell\n        if start is None and end is None:\n            for juska in self._rmap:\n                idx += 1\n                if idx in self._indexes[\"_rmap\"]:\n                    cell = self._indexes[\"_rmap\"][idx]\n                else:\n                    cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                    if not isinstance(cell, Cell):\n                        raise TypeError(f\"Not a cell: {cell!r}\")\n                    self._indexes[\"_rmap\"][idx] = cell\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    # Return a copy without the now obsolete repetition\n                    if cell is None:\n                        cell = Cell()\n                    else:\n                        cell = cell.clone\n                        if repeated &gt; 1:\n                            cell.repeated = None\n                    cell.y = self.y\n                    cell.x = x\n                    x += 1\n                    yield cell\n        else:\n            if start is None:\n                start = 0\n            start = max(0, start)\n            if end is None:\n                try:\n                    end = self._rmap[-1]\n                except Exception:\n                    end = -1\n            start_map = find_odf_idx(self._rmap, start)\n            if start_map is None:\n                return\n            if start_map &gt; 0:\n                before = self._rmap[start_map - 1]\n            idx = start_map - 1\n            before = start - 1\n            x = start\n            for juska in self._rmap[start_map:]:\n                idx += 1\n                if idx in self._indexes[\"_rmap\"]:\n                    cell = self._indexes[\"_rmap\"][idx]\n                else:\n                    cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                    if not isinstance(cell, Cell):\n                        raise TypeError(f\"Not a cell: {cell!r}\")\n                    self._indexes[\"_rmap\"][idx] = cell\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    if x &lt;= end:\n                        if cell is None:\n                            cell = Cell()\n                        else:\n                            cell = cell.clone\n                            if repeated &gt; 1 or (x == start and start &gt; 0):\n                                cell.repeated = None\n                        cell.y = self.y\n                        cell.x = x\n                        x += 1\n                        yield cell\n\n    def get_cells(\n        self,\n        coord: str | tuple | None = None,\n        style: str | None = None,\n        content: str | None = None,\n        cell_type: str | None = None,\n    ) -&gt; list[Cell]:\n        \"\"\"Get the list of cells matching the criteria.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n\n        Filter by coordinates will retrieve the amount of cells defined by\n        'coord', minus the other filters.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            content -- str regex\n\n            style -- str\n\n        Return: list of Cell\n        \"\"\"\n        # fixme : not clones ?\n        if coord:\n            x, z = self._translate_row_coordinates(coord)\n        else:\n            x = None\n            z = None\n        if cell_type:\n            cell_type = cell_type.lower().strip()\n        cells: list[Cell] = []\n        for cell in self.traverse(start=x, end=z):\n            # Filter the cells by cell_type\n            if cell_type:\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    continue\n            # Filter the cells with the regex\n            if content and not cell.match(content):\n                continue\n            # Filter the cells with the style\n            if style and style != cell.style:\n                continue\n            cells.append(cell)\n        return cells\n\n    @property\n    def cells(self) -&gt; list[Cell]:\n        \"\"\"Get the list of all cells.\n\n        Return: list of Cell\n        \"\"\"\n        # fixme : not clones ?\n        return list(self.traverse())\n\n    def _get_cell2(self, x: int, clone: bool = True) -&gt; Cell | None:\n        if x &gt;= self.width:\n            return Cell()\n        if clone:\n            return self._get_cell2_base(x).clone  # type: ignore\n        else:\n            return self._get_cell2_base(x)\n\n    def _get_cell2_base(self, x: int) -&gt; Cell | None:\n        idx = find_odf_idx(self._rmap, x)\n        cell: Cell\n        if idx is not None:\n            if idx in self._indexes[\"_rmap\"]:\n                cell = self._indexes[\"_rmap\"][idx]\n            else:\n                cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                self._indexes[\"_rmap\"][idx] = cell\n            return cell\n        return None\n\n    def get_cell(self, x: int, clone: bool = True) -&gt; Cell | None:\n        \"\"\"Get the cell at position \"x\" starting from 0. Alphabetical\n        positions like \"D\" are accepted.\n\n        A  copy is returned, use set_cell() to push it back.\n\n        Arguments:\n\n            x -- int or str\n\n        Return: Cell | None\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        cell = self._get_cell2(x, clone=clone)\n        if not cell:\n            return None\n        cell.y = self.y\n        cell.x = x\n        return cell\n\n    def get_value(\n        self,\n        x: int | str,\n        get_type: bool = False,\n    ) -&gt; Any | tuple[Any, str]:\n        \"\"\"Shortcut to get the value of the cell at position \"x\".\n        If get_type is True, returns the tuples (value, ODF type).\n\n        If the cell is empty, returns None or (None, None)\n\n        See get_cell() and Cell.get_value().\n        \"\"\"\n        if get_type:\n            x = self._translate_x_from_any(x)\n            cell = self._get_cell2_base(x)\n            if cell is None:\n                return (None, None)\n            return cell.get_value(get_type=get_type)\n        x = self._translate_x_from_any(x)\n        cell = self._get_cell2_base(x)\n        if cell is None:\n            return None\n        return cell.get_value()\n\n    def set_cell(\n        self,\n        x: int | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Push the cell back in the row at position \"x\" starting from 0.\n        Alphabetical positions like \"D\" are accepted.\n\n        Arguments:\n\n            x -- int or str\n\n        returns the cell with x and y updated\n        \"\"\"\n        cell_back: Cell\n        if cell is None:\n            cell = Cell()\n            repeated = 1\n            clone = False\n        else:\n            repeated = cell.repeated or 1\n        x = self._translate_x_from_any(x)\n        # Outside the defined row\n        diff = x - self.width\n        if diff == 0:\n            cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n        elif diff &gt; 0:\n            self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n            cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n        else:\n            # Inside the defined row\n            set_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\", clone=clone)\n            cell.x = x\n            cell.y = self.y\n            cell_back = cell\n        return cell_back\n\n    def set_value(\n        self,\n        x: int | str,\n        value: Any,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the value of the cell at position \"x\".\n\n        Arguments:\n\n            x -- int or str\n\n            value -- Python type\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n\n        See get_cell() and Cell.get_value().\n        \"\"\"\n        self.set_cell(\n            x,\n            Cell(value, style=style, cell_type=cell_type, currency=currency),\n            clone=False,\n        )\n\n    def insert_cell(\n        self,\n        x: int | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Insert the given cell at position \"x\" starting from 0. If no cell\n        is given, an empty one is created.\n\n        Alphabetical positions like \"D\" are accepted.\n\n        Do not use when working on a table, use Table.insert_cell().\n\n        Arguments:\n\n            x -- int or str\n\n            cell -- Cell\n\n        returns the cell with x and y updated\n        \"\"\"\n        cell_back: Cell\n        if cell is None:\n            cell = Cell()\n        x = self._translate_x_from_any(x)\n        # Outside the defined row\n        diff = x - self.width\n        if diff &lt; 0:\n            insert_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\")\n            cell.x = x\n            cell.y = self.y\n            cell_back = cell\n        elif diff == 0:\n            cell_back = self.append_cell(cell, clone=clone)\n        else:\n            self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n            cell_back = self.append_cell(cell, clone=clone)\n        return cell_back\n\n    def extend_cells(self, cells: Iterable[Cell] | None = None) -&gt; None:\n        if cells is None:\n            cells = []\n        self.extend(cells)\n        self._compute_row_cache()\n\n    def append_cell(\n        self,\n        cell: Cell | None = None,\n        clone: bool = True,\n        _repeated: int | None = None,\n    ) -&gt; Cell:\n        \"\"\"Append the given cell at the end of the row. Repeated cells are\n        accepted. If no cell is given, an empty one is created.\n\n        Do not use when working on a table, use Table.append_cell().\n\n        Arguments:\n\n            cell -- Cell\n\n            _repeated -- (optional), repeated value of the row\n\n        returns the cell with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        if clone:\n            cell = cell.clone\n        self._append(cell)\n        if _repeated is None:\n            _repeated = cell.repeated or 1\n        self._rmap = insert_map_once(self._rmap, len(self._rmap), _repeated)\n        cell.x = self.width - 1\n        cell.y = self.y\n        return cell\n\n    # fix for unit test and typos\n    append = append_cell  # type: ignore\n\n    def delete_cell(self, x: int | str) -&gt; None:\n        \"\"\"Delete the cell at the given position \"x\" starting from 0.\n        Alphabetical positions like \"D\" are accepted.\n\n        Cells on the right will be shifted to the left. In a table, other\n        rows remain unaffected.\n\n        Arguments:\n\n            x -- int or str\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        if x &gt;= self.width:\n            return\n        delete_item_in_vault(x, self, _xpath_cell_idx, \"_rmap\")\n\n    def get_values(\n        self,\n        coord: str | tuple | None = None,\n        cell_type: str | None = None,\n        complete: bool = False,\n        get_type: bool = False,\n    ) -&gt; list[Any | tuple[Any, Any]]:\n        \"\"\"Shortcut to get the cell values in this row.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n        If cell_type is used and complete is True, missing values are\n        replaced by None.\n        If cell_type is None, complete is always True : with no cell type\n        queried, get_values() returns None for each empty cell, the length\n        of the list is equal to the length of the row (depending on\n        coordinates use).\n\n        If get_type is True, returns a tuple (value, ODF type of value), or\n        (None, None) for empty cells if complete is True.\n\n        Filter by coordinates will retrieve the amount of cells defined by\n        coordinates with None for empty cells, except when using cell_type.\n\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates in row\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of Python types, or list of tuples.\n        \"\"\"\n        if coord:\n            x, z = self._translate_row_coordinates(coord)\n        else:\n            x = None\n            z = None\n        if cell_type:\n            cell_type = cell_type.lower().strip()\n            values: list[Any | tuple[Any, Any]] = []\n            for cell in self.traverse(start=x, end=z):\n                # Filter the cells by cell_type\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    if complete:\n                        if get_type:\n                            values.append((None, None))\n                        else:\n                            values.append(None)\n                    continue\n                values.append(cell.get_value(get_type=get_type))\n            return values\n        else:\n            return [\n                cell.get_value(get_type=get_type)\n                for cell in self.traverse(start=x, end=z)\n            ]\n\n    def set_cells(\n        self,\n        cells: list[Cell] | tuple[Cell] | None = None,\n        start: int | str = 0,\n        clone: bool = True,\n    ) -&gt; None:\n        \"\"\"Set the cells in the row, from the 'start' column.\n        This method does not clear the row, use row.clear() before to start\n        with an empty row.\n\n        Arguments:\n\n            cells -- list of cells\n\n            start -- int or str\n        \"\"\"\n        if cells is None:\n            cells = []\n        if start is None:\n            start = 0\n        else:\n            start = self._translate_x_from_any(start)\n        if start == 0 and clone is False and (len(cells) &gt;= self.width):\n            self.clear()\n            self.extend_cells(cells)\n        else:\n            x = start\n            for cell in cells:\n                self.set_cell(x, cell, clone=clone)\n                if cell:\n                    x += cell.repeated or 1\n                else:\n                    x += 1\n\n    def set_values(\n        self,\n        values: list[Any],\n        start: int | str = 0,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the value of cells in the row, from the 'start'\n        column vith values.\n        This method does not clear the row, use row.clear() before to start\n        with an empty row.\n\n        Arguments:\n\n            values -- list of Python types\n\n            start -- int or str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency' or 'percentage'\n\n            currency -- three-letter str\n\n            style -- cell style\n        \"\"\"\n        # fixme : if values n, n+ are same, use repeat\n        if start is None:\n            start = 0\n        else:\n            start = self._translate_x_from_any(start)\n        if start == 0 and (len(values) &gt;= self.width):\n            self.clear()\n            cells = [\n                Cell(value, style=style, cell_type=cell_type, currency=currency)\n                for value in values\n            ]\n            self.extend_cells(cells)\n        else:\n            x = start\n            for value in values:\n                self.set_cell(\n                    x,\n                    Cell(value, style=style, cell_type=cell_type, currency=currency),\n                    clone=False,\n                )\n                x += 1\n\n    def rstrip(self, aggressive: bool = False) -&gt; None:\n        \"\"\"Remove *in-place* empty cells at the right of the row. An empty\n        cell has no value but can have style. If \"aggressive\" is True, style\n        is ignored.\n\n        Arguments:\n\n            aggressive -- bool\n        \"\"\"\n        for cell in reversed(self._get_cells()):\n            if not cell.is_empty(aggressive=aggressive):  # type: ignore\n                break\n            self.delete(cell)\n        self._compute_row_cache()\n        self._indexes[\"_rmap\"] = {}\n\n    def _current_length(self) -&gt; int:\n        \"\"\"Return the current estimated length of the row.\n\n        Return: int\n        \"\"\"\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_cell, \"table:number-columns-repeated\"\n        )\n        repeated = [item[1] for item in idx_repeated_seq]\n        if repeated:\n            return sum(repeated)\n        return 1\n\n    def minimized_width(self) -&gt; int:\n        \"\"\"Return the length of the row if the last repeated sequence is\n        reduced to one.\n\n        Return: int\n        \"\"\"\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_cell, \"table:number-columns-repeated\"\n        )\n        repeated = [item[1] for item in idx_repeated_seq]\n        if repeated:\n            cell = self.last_cell()\n            if cell is not None and cell.is_empty(aggressive=True):\n                repeated[-1] = 1\n            min_width = sum(repeated)\n        else:\n            min_width = 1\n        self._compute_row_cache()\n        self._indexes[\"_rmap\"] = {}\n        return min_width\n\n    def last_cell(self) -&gt; Cell | None:\n        \"\"\"Return the las cell of the row.\n\n        Return Cell | None\n        \"\"\"\n        try:\n            return self._get_cells()[-1]  # type: ignore\n        except IndexError:\n            return None\n\n    def force_width(self, width: int) -&gt; None:\n        \"\"\"Change the repeated property of the last cell of the row\n        to comply with the required max width.\n\n        Arguments:\n\n            width -- int\n        \"\"\"\n        cell = self.last_cell()\n        if cell is None or not cell.is_empty(aggressive=True):\n            return\n        repeated = cell.repeated\n        if repeated is None:\n            return\n        # empty repeated cell\n        delta = self._current_length() - width\n        if delta &gt; 0:\n            cell._set_repeated(repeated - delta)\n            self._compute_row_cache()\n\n    def is_empty(self, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return whether every cell in the row has no value or the value\n        evaluates to False (empty string), and no style.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            aggressive -- bool\n\n        Return: bool\n        \"\"\"\n        return all(cell.is_empty(aggressive=aggressive) for cell in self._get_cells())  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Row.cells","title":"<code>cells: list[Cell]</code>  <code>property</code>","text":"<p>Get the list of all cells.</p> <p>Return: list of Cell</p>"},{"location":"reference.html#odfdo.Row.repeated","title":"<code>repeated: int | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the number of times the row is repeated.</p> <p>Always None when using the table API.</p> <p>Return: int or None</p>"},{"location":"reference.html#odfdo.Row.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get /set the style of the row itself.</p> <p>Return: str</p>"},{"location":"reference.html#odfdo.Row.width","title":"<code>width: int</code>  <code>property</code>","text":"<p>Get the number of expected cells in the row, i.e. addition repetitions.</p> <p>Return: int</p>"},{"location":"reference.html#odfdo.Row.__init__","title":"<code>__init__(width=None, repeated=None, style=None, **kwargs)</code>","text":"<p>create a Row, optionally filled with \u201cwidth\u201d number of cells.</p> <p>Rows contain cells, their number determine the number of columns.</p> <p>You don\u2019t generally have to create rows by hand, use the Table API.</p> <p>Arguments:</p> <pre><code>width -- int\n\nrepeated -- int\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def __init__(\n    self,\n    width: int | None = None,\n    repeated: int | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"create a Row, optionally filled with \"width\" number of cells.\n\n    Rows contain cells, their number determine the number of columns.\n\n    You don't generally have to create rows by hand, use the Table API.\n\n    Arguments:\n\n        width -- int\n\n        repeated -- int\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self.y = None\n    if not hasattr(self, \"_indexes\"):\n        self._indexes = {}\n        self._indexes[\"_rmap\"] = {}\n    if not hasattr(self, \"_rmap\"):\n        self._compute_row_cache()\n        if not hasattr(self, \"_tmap\"):\n            self._tmap = []\n            self._cmap = []\n    if self._do_init:\n        if width is not None:\n            for _i in range(width):\n                self.append(Cell())  # type:ignore\n        if repeated:\n            self.repeated = repeated\n        if style is not None:\n            self.style = style\n        self._compute_row_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Row.append_cell","title":"<code>append_cell(cell=None, clone=True, _repeated=None)</code>","text":"<p>Append the given cell at the end of the row. Repeated cells are accepted. If no cell is given, an empty one is created.</p> <p>Do not use when working on a table, use Table.append_cell().</p> <p>Arguments:</p> <pre><code>cell -- Cell\n\n_repeated -- (optional), repeated value of the row\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/row.py</code> <pre><code>def append_cell(\n    self,\n    cell: Cell | None = None,\n    clone: bool = True,\n    _repeated: int | None = None,\n) -&gt; Cell:\n    \"\"\"Append the given cell at the end of the row. Repeated cells are\n    accepted. If no cell is given, an empty one is created.\n\n    Do not use when working on a table, use Table.append_cell().\n\n    Arguments:\n\n        cell -- Cell\n\n        _repeated -- (optional), repeated value of the row\n\n    returns the cell with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    if clone:\n        cell = cell.clone\n    self._append(cell)\n    if _repeated is None:\n        _repeated = cell.repeated or 1\n    self._rmap = insert_map_once(self._rmap, len(self._rmap), _repeated)\n    cell.x = self.width - 1\n    cell.y = self.y\n    return cell\n</code></pre>"},{"location":"reference.html#odfdo.Row.delete_cell","title":"<code>delete_cell(x)</code>","text":"<p>Delete the cell at the given position \u201cx\u201d starting from 0. Alphabetical positions like \u201cD\u201d are accepted.</p> <p>Cells on the right will be shifted to the left. In a table, other rows remain unaffected.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def delete_cell(self, x: int | str) -&gt; None:\n    \"\"\"Delete the cell at the given position \"x\" starting from 0.\n    Alphabetical positions like \"D\" are accepted.\n\n    Cells on the right will be shifted to the left. In a table, other\n    rows remain unaffected.\n\n    Arguments:\n\n        x -- int or str\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    if x &gt;= self.width:\n        return\n    delete_item_in_vault(x, self, _xpath_cell_idx, \"_rmap\")\n</code></pre>"},{"location":"reference.html#odfdo.Row.force_width","title":"<code>force_width(width)</code>","text":"<p>Change the repeated property of the last cell of the row to comply with the required max width.</p> <p>Arguments:</p> <pre><code>width -- int\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def force_width(self, width: int) -&gt; None:\n    \"\"\"Change the repeated property of the last cell of the row\n    to comply with the required max width.\n\n    Arguments:\n\n        width -- int\n    \"\"\"\n    cell = self.last_cell()\n    if cell is None or not cell.is_empty(aggressive=True):\n        return\n    repeated = cell.repeated\n    if repeated is None:\n        return\n    # empty repeated cell\n    delta = self._current_length() - width\n    if delta &gt; 0:\n        cell._set_repeated(repeated - delta)\n        self._compute_row_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_cell","title":"<code>get_cell(x, clone=True)</code>","text":"<p>Get the cell at position \u201cx\u201d starting from 0. Alphabetical positions like \u201cD\u201d are accepted.</p> <p>A  copy is returned, use set_cell() to push it back.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> <p>Return: Cell | None</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_cell(self, x: int, clone: bool = True) -&gt; Cell | None:\n    \"\"\"Get the cell at position \"x\" starting from 0. Alphabetical\n    positions like \"D\" are accepted.\n\n    A  copy is returned, use set_cell() to push it back.\n\n    Arguments:\n\n        x -- int or str\n\n    Return: Cell | None\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    cell = self._get_cell2(x, clone=clone)\n    if not cell:\n        return None\n    cell.y = self.y\n    cell.x = x\n    return cell\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_cells","title":"<code>get_cells(coord=None, style=None, content=None, cell_type=None)</code>","text":"<p>Get the list of cells matching the criteria.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells.</p> <p>Filter by coordinates will retrieve the amount of cells defined by \u2018coord\u2019, minus the other filters.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncontent -- str regex\n\nstyle -- str\n</code></pre> <p>Return: list of Cell</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_cells(\n    self,\n    coord: str | tuple | None = None,\n    style: str | None = None,\n    content: str | None = None,\n    cell_type: str | None = None,\n) -&gt; list[Cell]:\n    \"\"\"Get the list of cells matching the criteria.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n\n    Filter by coordinates will retrieve the amount of cells defined by\n    'coord', minus the other filters.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        content -- str regex\n\n        style -- str\n\n    Return: list of Cell\n    \"\"\"\n    # fixme : not clones ?\n    if coord:\n        x, z = self._translate_row_coordinates(coord)\n    else:\n        x = None\n        z = None\n    if cell_type:\n        cell_type = cell_type.lower().strip()\n    cells: list[Cell] = []\n    for cell in self.traverse(start=x, end=z):\n        # Filter the cells by cell_type\n        if cell_type:\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                continue\n        # Filter the cells with the regex\n        if content and not cell.match(content):\n            continue\n        # Filter the cells with the style\n        if style and style != cell.style:\n            continue\n        cells.append(cell)\n    return cells\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_value","title":"<code>get_value(x, get_type=False)</code>","text":"<p>Shortcut to get the value of the cell at position \u201cx\u201d. If get_type is True, returns the tuples (value, ODF type).</p> <p>If the cell is empty, returns None or (None, None)</p> <p>See get_cell() and Cell.get_value().</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_value(\n    self,\n    x: int | str,\n    get_type: bool = False,\n) -&gt; Any | tuple[Any, str]:\n    \"\"\"Shortcut to get the value of the cell at position \"x\".\n    If get_type is True, returns the tuples (value, ODF type).\n\n    If the cell is empty, returns None or (None, None)\n\n    See get_cell() and Cell.get_value().\n    \"\"\"\n    if get_type:\n        x = self._translate_x_from_any(x)\n        cell = self._get_cell2_base(x)\n        if cell is None:\n            return (None, None)\n        return cell.get_value(get_type=get_type)\n    x = self._translate_x_from_any(x)\n    cell = self._get_cell2_base(x)\n    if cell is None:\n        return None\n    return cell.get_value()\n</code></pre>"},{"location":"reference.html#odfdo.Row.get_values","title":"<code>get_values(coord=None, cell_type=None, complete=False, get_type=False)</code>","text":"<p>Shortcut to get the cell values in this row.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells. If cell_type is used and complete is True, missing values are replaced by None. If cell_type is None, complete is always True : with no cell type queried, get_values() returns None for each empty cell, the length of the list is equal to the length of the row (depending on coordinates use).</p> <p>If get_type is True, returns a tuple (value, ODF type of value), or (None, None) for empty cells if complete is True.</p> <p>Filter by coordinates will retrieve the amount of cells defined by coordinates with None for empty cells, except when using cell_type.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates in row\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of Python types, or list of tuples.</p> Source code in <code>odfdo/row.py</code> <pre><code>def get_values(\n    self,\n    coord: str | tuple | None = None,\n    cell_type: str | None = None,\n    complete: bool = False,\n    get_type: bool = False,\n) -&gt; list[Any | tuple[Any, Any]]:\n    \"\"\"Shortcut to get the cell values in this row.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n    If cell_type is used and complete is True, missing values are\n    replaced by None.\n    If cell_type is None, complete is always True : with no cell type\n    queried, get_values() returns None for each empty cell, the length\n    of the list is equal to the length of the row (depending on\n    coordinates use).\n\n    If get_type is True, returns a tuple (value, ODF type of value), or\n    (None, None) for empty cells if complete is True.\n\n    Filter by coordinates will retrieve the amount of cells defined by\n    coordinates with None for empty cells, except when using cell_type.\n\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates in row\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of Python types, or list of tuples.\n    \"\"\"\n    if coord:\n        x, z = self._translate_row_coordinates(coord)\n    else:\n        x = None\n        z = None\n    if cell_type:\n        cell_type = cell_type.lower().strip()\n        values: list[Any | tuple[Any, Any]] = []\n        for cell in self.traverse(start=x, end=z):\n            # Filter the cells by cell_type\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                if complete:\n                    if get_type:\n                        values.append((None, None))\n                    else:\n                        values.append(None)\n                continue\n            values.append(cell.get_value(get_type=get_type))\n        return values\n    else:\n        return [\n            cell.get_value(get_type=get_type)\n            for cell in self.traverse(start=x, end=z)\n        ]\n</code></pre>"},{"location":"reference.html#odfdo.Row.insert_cell","title":"<code>insert_cell(x, cell=None, clone=True)</code>","text":"<p>Insert the given cell at position \u201cx\u201d starting from 0. If no cell is given, an empty one is created.</p> <p>Alphabetical positions like \u201cD\u201d are accepted.</p> <p>Do not use when working on a table, use Table.insert_cell().</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncell -- Cell\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/row.py</code> <pre><code>def insert_cell(\n    self,\n    x: int | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Insert the given cell at position \"x\" starting from 0. If no cell\n    is given, an empty one is created.\n\n    Alphabetical positions like \"D\" are accepted.\n\n    Do not use when working on a table, use Table.insert_cell().\n\n    Arguments:\n\n        x -- int or str\n\n        cell -- Cell\n\n    returns the cell with x and y updated\n    \"\"\"\n    cell_back: Cell\n    if cell is None:\n        cell = Cell()\n    x = self._translate_x_from_any(x)\n    # Outside the defined row\n    diff = x - self.width\n    if diff &lt; 0:\n        insert_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\")\n        cell.x = x\n        cell.y = self.y\n        cell_back = cell\n    elif diff == 0:\n        cell_back = self.append_cell(cell, clone=clone)\n    else:\n        self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n        cell_back = self.append_cell(cell, clone=clone)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Row.is_empty","title":"<code>is_empty(aggressive=False)</code>","text":"<p>Return whether every cell in the row has no value or the value evaluates to False (empty string), and no style.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> <p>Return: bool</p> Source code in <code>odfdo/row.py</code> <pre><code>def is_empty(self, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return whether every cell in the row has no value or the value\n    evaluates to False (empty string), and no style.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        aggressive -- bool\n\n    Return: bool\n    \"\"\"\n    return all(cell.is_empty(aggressive=aggressive) for cell in self._get_cells())  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Row.last_cell","title":"<code>last_cell()</code>","text":"<p>Return the las cell of the row.</p> <p>Return Cell | None</p> Source code in <code>odfdo/row.py</code> <pre><code>def last_cell(self) -&gt; Cell | None:\n    \"\"\"Return the las cell of the row.\n\n    Return Cell | None\n    \"\"\"\n    try:\n        return self._get_cells()[-1]  # type: ignore\n    except IndexError:\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Row.minimized_width","title":"<code>minimized_width()</code>","text":"<p>Return the length of the row if the last repeated sequence is reduced to one.</p> <p>Return: int</p> Source code in <code>odfdo/row.py</code> <pre><code>def minimized_width(self) -&gt; int:\n    \"\"\"Return the length of the row if the last repeated sequence is\n    reduced to one.\n\n    Return: int\n    \"\"\"\n    idx_repeated_seq = self.elements_repeated_sequence(\n        _xpath_cell, \"table:number-columns-repeated\"\n    )\n    repeated = [item[1] for item in idx_repeated_seq]\n    if repeated:\n        cell = self.last_cell()\n        if cell is not None and cell.is_empty(aggressive=True):\n            repeated[-1] = 1\n        min_width = sum(repeated)\n    else:\n        min_width = 1\n    self._compute_row_cache()\n    self._indexes[\"_rmap\"] = {}\n    return min_width\n</code></pre>"},{"location":"reference.html#odfdo.Row.rstrip","title":"<code>rstrip(aggressive=False)</code>","text":"<p>Remove in-place empty cells at the right of the row. An empty cell has no value but can have style. If \u201caggressive\u201d is True, style is ignored.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def rstrip(self, aggressive: bool = False) -&gt; None:\n    \"\"\"Remove *in-place* empty cells at the right of the row. An empty\n    cell has no value but can have style. If \"aggressive\" is True, style\n    is ignored.\n\n    Arguments:\n\n        aggressive -- bool\n    \"\"\"\n    for cell in reversed(self._get_cells()):\n        if not cell.is_empty(aggressive=aggressive):  # type: ignore\n            break\n        self.delete(cell)\n    self._compute_row_cache()\n    self._indexes[\"_rmap\"] = {}\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_cell","title":"<code>set_cell(x, cell=None, clone=True)</code>","text":"<p>Push the cell back in the row at position \u201cx\u201d starting from 0. Alphabetical positions like \u201cD\u201d are accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/row.py</code> <pre><code>def set_cell(\n    self,\n    x: int | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Push the cell back in the row at position \"x\" starting from 0.\n    Alphabetical positions like \"D\" are accepted.\n\n    Arguments:\n\n        x -- int or str\n\n    returns the cell with x and y updated\n    \"\"\"\n    cell_back: Cell\n    if cell is None:\n        cell = Cell()\n        repeated = 1\n        clone = False\n    else:\n        repeated = cell.repeated or 1\n    x = self._translate_x_from_any(x)\n    # Outside the defined row\n    diff = x - self.width\n    if diff == 0:\n        cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n    elif diff &gt; 0:\n        self.append_cell(Cell(repeated=diff), _repeated=diff, clone=False)\n        cell_back = self.append_cell(cell, _repeated=repeated, clone=clone)\n    else:\n        # Inside the defined row\n        set_item_in_vault(x, cell, self, _xpath_cell_idx, \"_rmap\", clone=clone)\n        cell.x = x\n        cell.y = self.y\n        cell_back = cell\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_cells","title":"<code>set_cells(cells=None, start=0, clone=True)</code>","text":"<p>Set the cells in the row, from the \u2018start\u2019 column. This method does not clear the row, use row.clear() before to start with an empty row.</p> <p>Arguments:</p> <pre><code>cells -- list of cells\n\nstart -- int or str\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def set_cells(\n    self,\n    cells: list[Cell] | tuple[Cell] | None = None,\n    start: int | str = 0,\n    clone: bool = True,\n) -&gt; None:\n    \"\"\"Set the cells in the row, from the 'start' column.\n    This method does not clear the row, use row.clear() before to start\n    with an empty row.\n\n    Arguments:\n\n        cells -- list of cells\n\n        start -- int or str\n    \"\"\"\n    if cells is None:\n        cells = []\n    if start is None:\n        start = 0\n    else:\n        start = self._translate_x_from_any(start)\n    if start == 0 and clone is False and (len(cells) &gt;= self.width):\n        self.clear()\n        self.extend_cells(cells)\n    else:\n        x = start\n        for cell in cells:\n            self.set_cell(x, cell, clone=clone)\n            if cell:\n                x += cell.repeated or 1\n            else:\n                x += 1\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_value","title":"<code>set_value(x, value, style=None, cell_type=None, currency=None)</code>","text":"<p>Shortcut to set the value of the cell at position \u201cx\u201d.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\nvalue -- Python type\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n         'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> <p>See get_cell() and Cell.get_value().</p> Source code in <code>odfdo/row.py</code> <pre><code>def set_value(\n    self,\n    x: int | str,\n    value: Any,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the value of the cell at position \"x\".\n\n    Arguments:\n\n        x -- int or str\n\n        value -- Python type\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                 'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n\n    See get_cell() and Cell.get_value().\n    \"\"\"\n    self.set_cell(\n        x,\n        Cell(value, style=style, cell_type=cell_type, currency=currency),\n        clone=False,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Row.set_values","title":"<code>set_values(values, start=0, style=None, cell_type=None, currency=None)</code>","text":"<p>Shortcut to set the value of cells in the row, from the \u2018start\u2019 column vith values. This method does not clear the row, use row.clear() before to start with an empty row.</p> <p>Arguments:</p> <pre><code>values -- list of Python types\n\nstart -- int or str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency' or 'percentage'\n\ncurrency -- three-letter str\n\nstyle -- cell style\n</code></pre> Source code in <code>odfdo/row.py</code> <pre><code>def set_values(\n    self,\n    values: list[Any],\n    start: int | str = 0,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the value of cells in the row, from the 'start'\n    column vith values.\n    This method does not clear the row, use row.clear() before to start\n    with an empty row.\n\n    Arguments:\n\n        values -- list of Python types\n\n        start -- int or str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency' or 'percentage'\n\n        currency -- three-letter str\n\n        style -- cell style\n    \"\"\"\n    # fixme : if values n, n+ are same, use repeat\n    if start is None:\n        start = 0\n    else:\n        start = self._translate_x_from_any(start)\n    if start == 0 and (len(values) &gt;= self.width):\n        self.clear()\n        cells = [\n            Cell(value, style=style, cell_type=cell_type, currency=currency)\n            for value in values\n        ]\n        self.extend_cells(cells)\n    else:\n        x = start\n        for value in values:\n            self.set_cell(\n                x,\n                Cell(value, style=style, cell_type=cell_type, currency=currency),\n                clone=False,\n            )\n            x += 1\n</code></pre>"},{"location":"reference.html#odfdo.Row.traverse","title":"<code>traverse(start=None, end=None)</code>","text":"<p>Yield as many cell elements as expected cells in the row, i.e. expand repetitions by returning the same cell as many times as necessary.</p> <pre><code>Arguments:\n\n    start -- int\n\n    end -- int\n</code></pre> <p>Copies are returned, use set_cell() to push them back.</p> Source code in <code>odfdo/row.py</code> <pre><code>def traverse(  # noqa: C901\n    self,\n    start: int | None = None,\n    end: int | None = None,\n) -&gt; Iterator[Cell]:\n    \"\"\"Yield as many cell elements as expected cells in the row, i.e.\n    expand repetitions by returning the same cell as many times as\n    necessary.\n\n        Arguments:\n\n            start -- int\n\n            end -- int\n\n    Copies are returned, use set_cell() to push them back.\n    \"\"\"\n    idx = -1\n    before = -1\n    x = 0\n    cell: Cell\n    if start is None and end is None:\n        for juska in self._rmap:\n            idx += 1\n            if idx in self._indexes[\"_rmap\"]:\n                cell = self._indexes[\"_rmap\"][idx]\n            else:\n                cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                if not isinstance(cell, Cell):\n                    raise TypeError(f\"Not a cell: {cell!r}\")\n                self._indexes[\"_rmap\"][idx] = cell\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                # Return a copy without the now obsolete repetition\n                if cell is None:\n                    cell = Cell()\n                else:\n                    cell = cell.clone\n                    if repeated &gt; 1:\n                        cell.repeated = None\n                cell.y = self.y\n                cell.x = x\n                x += 1\n                yield cell\n    else:\n        if start is None:\n            start = 0\n        start = max(0, start)\n        if end is None:\n            try:\n                end = self._rmap[-1]\n            except Exception:\n                end = -1\n        start_map = find_odf_idx(self._rmap, start)\n        if start_map is None:\n            return\n        if start_map &gt; 0:\n            before = self._rmap[start_map - 1]\n        idx = start_map - 1\n        before = start - 1\n        x = start\n        for juska in self._rmap[start_map:]:\n            idx += 1\n            if idx in self._indexes[\"_rmap\"]:\n                cell = self._indexes[\"_rmap\"][idx]\n            else:\n                cell = self._get_element_idx2(_xpath_cell_idx, idx)  # type: ignore\n                if not isinstance(cell, Cell):\n                    raise TypeError(f\"Not a cell: {cell!r}\")\n                self._indexes[\"_rmap\"][idx] = cell\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                if x &lt;= end:\n                    if cell is None:\n                        cell = Cell()\n                    else:\n                        cell = cell.clone\n                        if repeated &gt; 1 or (x == start and start &gt; 0):\n                            cell.repeated = None\n                    cell.y = self.y\n                    cell.x = x\n                    x += 1\n                    yield cell\n</code></pre>"},{"location":"reference.html#odfdo.RowGroup","title":"<code>RowGroup</code>","text":"<p>               Bases: <code>Element</code></p> <p>\u201ctable:table-row-group\u201d group rows with common properties.</p> Source code in <code>odfdo/table.py</code> <pre><code>class RowGroup(Element):\n    \"\"\" \"table:table-row-group\" group rows with common properties.\"\"\"\n\n    # TODO\n    _tag = \"table:table-row-group\"\n    _caching = True\n\n    def __init__(\n        self,\n        height: int | None = None,\n        width: int | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a group of rows, optionnaly filled with \"height\" number of\n        rows, of \"width\" cells each.\n\n        Row group bear style information applied to a series of rows.\n\n        Arguments:\n\n            height -- int\n\n            width -- int\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init and height is not None:\n            for _i in range(height):\n                row = Row(width=width)\n                self.append(row)\n</code></pre>"},{"location":"reference.html#odfdo.RowGroup.__init__","title":"<code>__init__(height=None, width=None, **kwargs)</code>","text":"<p>Create a group of rows, optionnaly filled with \u201cheight\u201d number of rows, of \u201cwidth\u201d cells each.</p> <p>Row group bear style information applied to a series of rows.</p> <p>Arguments:</p> <pre><code>height -- int\n\nwidth -- int\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    height: int | None = None,\n    width: int | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a group of rows, optionnaly filled with \"height\" number of\n    rows, of \"width\" cells each.\n\n    Row group bear style information applied to a series of rows.\n\n    Arguments:\n\n        height -- int\n\n        width -- int\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init and height is not None:\n        for _i in range(height):\n            row = Row(width=width)\n            self.append(row)\n</code></pre>"},{"location":"reference.html#odfdo.Section","title":"<code>Section</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF section \u201ctext:section\u201d</p> <p>Arguments:</p> <pre><code>style -- str\n\nname -- str\n</code></pre> Source code in <code>odfdo/section.py</code> <pre><code>class Section(Element):\n    \"\"\"ODF section \"text:section\"\n\n    Arguments:\n\n        style -- str\n\n        name -- str\n    \"\"\"\n\n    _tag = \"text:section\"\n    _properties = (\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"name\", \"text:name\"),\n    )\n\n    def __init__(\n        self,\n        style: str | None = None,\n        name: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style:\n                self.style = style\n            if name:\n                self.name = name\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        result = [element.get_formatted_text(context) for element in self.children]\n        result.append(\"\\n\")\n        return \"\".join(result)\n</code></pre>"},{"location":"reference.html#odfdo.Spacer","title":"<code>Spacer</code>","text":"<p>               Bases: <code>Element</code></p> <p>This element shall be used to represent the second and all following \u201c \u201c (U+0020, SPACE) characters in a sequence of \u201c \u201c (U+0020, SPACE) characters. Note: It is not an error if the character preceding the element is not a white space character, but it is good practice to use this element only for the second and all following SPACE characters in a sequence.</p> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>class Spacer(Element):\n    \"\"\"This element shall be used to represent the second and all following \u201c \u201c\n    (U+0020, SPACE) characters in a sequence of \u201c \u201c (U+0020, SPACE) characters.\n    Note: It is not an error if the character preceding the element is not a\n    white space character, but it is good practice to use this element only for\n    the second and all following SPACE characters in a sequence.\n    \"\"\"\n\n    _tag = \"text:s\"\n    _properties: tuple[PropDef, ...] = (PropDef(\"number\", \"text:c\"),)\n\n    def __init__(self, number: int = 1, **kwargs: Any):\n        \"\"\"\n        Arguments:\n\n            number -- int\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            self.number = str(number)\n</code></pre>"},{"location":"reference.html#odfdo.Spacer.__init__","title":"<code>__init__(number=1, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>number -- int\n</code></pre> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>def __init__(self, number: int = 1, **kwargs: Any):\n    \"\"\"\n    Arguments:\n\n        number -- int\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        self.number = str(number)\n</code></pre>"},{"location":"reference.html#odfdo.Span","title":"<code>Span</code>","text":"<p>               Bases: <code>Paragraph</code></p> <p>Create a span element \u201ctext:span\u201d of the given style containing the optional given text.</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>class Span(Paragraph):\n    \"\"\"Create a span element \"text:span\" of the given style containing the optional\n    given text.\n    \"\"\"\n\n    _tag = \"text:span\"\n    _properties = (\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"class_names\", \"text:class-names\"),\n    )\n\n    def __init__(\n        self,\n        text: str | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            text -- str\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if text:\n                self.text = text\n            if style:\n                self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Span.__init__","title":"<code>__init__(text=None, style=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>text -- str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/paragraph.py</code> <pre><code>def __init__(\n    self,\n    text: str | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        text -- str\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if text:\n            self.text = text\n        if style:\n            self.style = style\n</code></pre>"},{"location":"reference.html#odfdo.Spreadsheet","title":"<code>Spreadsheet</code>","text":"<p>               Bases: <code>Body</code></p> <p>Spreadsheet, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Spreadsheet(Body):\n    \"\"\"Spreadsheet, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:spreadsheet\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.Style","title":"<code>Style</code>","text":"<p>               Bases: <code>Element</code></p> <p>Style class for all these tags:</p> <p>\u2018style:style\u2019 \u2018number:date-style\u2019, \u2018number:number-style\u2019, \u2018number:percentage-style\u2019, \u2018number:time-style\u2019 \u2018style:font-face\u2019, \u2018style:master-page\u2019, \u2018style:page-layout\u2019, \u2018style:presentation-page-layout\u2019, \u2018text:list-style\u2019, \u2018text:outline-style\u2019, \u2018style:tab-stops\u2019, \u2026</p> Source code in <code>odfdo/style.py</code> <pre><code>class Style(Element):\n    \"\"\"Style class for all these tags:\n\n    'style:style'\n    'number:date-style',\n    'number:number-style',\n    'number:percentage-style',\n    'number:time-style'\n    'style:font-face',\n    'style:master-page',\n    'style:page-layout',\n    'style:presentation-page-layout',\n    'text:list-style',\n    'text:outline-style',\n    'style:tab-stops',\n    ...\n    \"\"\"\n\n    _properties: tuple[PropDef, ...] = (\n        PropDef(\"page_layout\", \"style:page-layout-name\", \"master-page\"),\n        PropDef(\"next_style\", \"style:next-style-name\", \"master-page\"),\n        PropDef(\"name\", \"style:name\"),\n        PropDef(\"parent_style\", \"style:parent-style-name\"),\n        PropDef(\"display_name\", \"style:display-name\"),\n        PropDef(\"svg_font_family\", \"svg:font-family\"),\n        PropDef(\"font_family_generic\", \"style:font-family-generic\"),\n        PropDef(\"font_pitch\", \"style:font-pitch\"),\n        PropDef(\"text_style\", \"text:style-name\"),\n        PropDef(\"master_page\", \"style:master-page-name\", \"paragraph\"),\n        PropDef(\"master_page\", \"style:master-page-name\", \"paragraph\"),\n        PropDef(\"master_page\", \"style:master-page-name\", \"paragraph\"),\n        # style:tab-stop\n        PropDef(\"style_type\", \"style:type\"),\n        PropDef(\"leader_style\", \"style:leader-style\"),\n        PropDef(\"leader_text\", \"style:leader-text\"),\n        PropDef(\"style_position\", \"style:position\"),\n        PropDef(\"leader_text\", \"style:position\"),\n    )\n\n    def __init__(  # noqa: C901\n        self,\n        family: str | None = None,\n        name: str | None = None,\n        display_name: str | None = None,\n        parent_style: str | None = None,\n        # Where properties apply\n        area: str | None = None,\n        # For family 'text':\n        color: str | tuple | None = None,\n        background_color: str | tuple | None = None,\n        italic: bool = False,\n        bold: bool = False,\n        # For family 'paragraph'\n        master_page: str | None = None,\n        # For family 'master-page'\n        page_layout: str | None = None,\n        next_style: str | None = None,\n        # For family 'table-cell'\n        data_style: str | None = None,  # unused\n        border: str | None = None,\n        border_top: str | None = None,\n        border_right: str | None = None,\n        border_bottom: str | None = None,\n        border_left: str | None = None,\n        padding: str | None = None,\n        padding_top: str | None = None,\n        padding_bottom: str | None = None,\n        padding_left: str | None = None,\n        padding_right: str | None = None,\n        shadow: str | None = None,\n        # For family 'table-row'\n        height: str | None = None,\n        use_optimal_height: bool = False,\n        # For family 'table-column'\n        width: str | None = None,\n        break_before: str | None = None,\n        break_after: str | None = None,\n        # For family 'graphic'\n        min_height: str | None = None,\n        # For family 'font-face'\n        font_name: str | None = None,\n        font_family: str | None = None,\n        font_family_generic: str | None = None,\n        font_pitch: str = \"variable\",\n        # Every other property\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a style of the given family. The name is not mandatory at this\n        point but will become required when inserting in a document as a common\n        style.\n\n        The display name is the name the user sees in an office application.\n\n        The parent_style is the name of the style this style will inherit from.\n\n        To set properties, pass them as keyword arguments. The area properties\n        apply to is optional and defaults to the family.\n\n        Arguments:\n\n            family -- 'paragraph', 'text', 'section', 'table', 'table-column',\n                      'table-row', 'table-cell', 'table-page', 'chart',\n                      'drawing-page', 'graphic', 'presentation',\n                      'control', 'ruby', 'list', 'number', 'page-layout'\n                      'font-face', or 'master-page'\n\n            name -- str\n\n            display_name -- str\n\n            parent_style -- str\n\n            area -- str\n\n        'text' Properties:\n\n            italic -- bool\n\n            bold -- bool\n\n        'paragraph' Properties:\n\n            master_page -- str\n\n        'master-page' Properties:\n\n            page_layout -- str\n\n            next_style -- str\n\n        'table-cell' Properties:\n\n            border, border_top, border_right, border_bottom, border_left -- str,\n            e.g. \"0.002cm solid #000000\" or 'none'\n\n            padding, padding_top, padding_right, padding_bottom, padding_left -- str,\n            e.g. \"0.002cm\" or 'none'\n\n            shadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\n        'table-row' Properties:\n\n            height -- str, e.g. '5cm'\n\n            use_optimal_height -- bool\n\n        'table-column' Properties:\n\n            width -- str, e.g. '5cm'\n\n            break_before -- 'page', 'column' or 'auto'\n\n            break_after -- 'page', 'column' or 'auto'\n        \"\"\"\n        self._family: str | None = None\n        tag_or_elem = kwargs.get(\"tag_or_elem\", None)\n        if tag_or_elem is None:\n            family = to_str(family)\n            if family not in FAMILY_MAPPING:\n                raise ValueError(f\"Unknown family value: '{family}'\")\n            kwargs[\"tag\"] = FAMILY_MAPPING[family]\n        super().__init__(**kwargs)\n        if self._do_init and family not in SUBCLASSED_STYLES:\n            kwargs.pop(\"tag\", None)\n            kwargs.pop(\"tag_or_elem\", None)\n            self.family = family  # relevant test made by property\n            # Common attributes\n            if name:\n                self.name = name\n            if display_name:\n                self.display_name = display_name\n            if parent_style:\n                self.parent_style = parent_style\n            # Paragraph\n            if family == \"paragraph\":\n                if master_page:\n                    self.master_page = master_page\n            # Master Page\n            elif family == \"master-page\":\n                if page_layout:\n                    self.page_layout = page_layout\n                if next_style:\n                    self.next_style = next_style\n            # Font face\n            elif family == \"font-face\":\n                if not font_name:\n                    raise ValueError(\"A font_name is required for 'font-face' style\")\n                self.set_font(\n                    font_name,\n                    family=font_family,\n                    family_generic=font_family_generic,\n                    pitch=font_pitch,\n                )\n            # Properties\n            if area is None:\n                area = family\n            area = to_str(area)\n            # Text\n            if area == \"text\":\n                if color:\n                    kwargs[\"fo:color\"] = color\n                if background_color:\n                    kwargs[\"fo:background-color\"] = background_color\n                if italic:\n                    kwargs[\"fo:font-style\"] = \"italic\"\n                    kwargs[\"style:font-style-asian\"] = \"italic\"\n                    kwargs[\"style:font-style-complex\"] = \"italic\"\n                if bold:\n                    kwargs[\"fo:font-weight\"] = \"bold\"\n                    kwargs[\"style:font-weight-asian\"] = \"bold\"\n                    kwargs[\"style:font-weight-complex\"] = \"bold\"\n            # Table cell\n            elif area == \"table-cell\":\n                if border:\n                    kwargs[\"fo:border\"] = border\n                elif border_top or border_right or border_bottom or border_left:\n                    kwargs[\"fo:border-top\"] = border_top or \"none\"\n                    kwargs[\"fo:border-right\"] = border_right or \"none\"\n                    kwargs[\"fo:border-bottom\"] = border_bottom or \"none\"\n                    kwargs[\"fo:border-left\"] = border_left or \"none\"\n                else:  # no border_top, ... neither border are defined\n                    pass  # left untouched\n                if padding:\n                    kwargs[\"fo:padding\"] = padding\n                elif padding_top or padding_right or padding_bottom or padding_left:\n                    kwargs[\"fo:padding-top\"] = padding_top or \"none\"\n                    kwargs[\"fo:padding-right\"] = padding_right or \"none\"\n                    kwargs[\"fo:padding-bottom\"] = padding_bottom or \"none\"\n                    kwargs[\"fo:padding-left\"] = padding_left or \"none\"\n                else:  # no border_top, ... neither border are defined\n                    pass  # left untouched\n                if shadow:\n                    kwargs[\"style:shadow\"] = shadow\n                if background_color:\n                    kwargs[\"fo:background-color\"] = background_color\n            # Table row\n            elif area == \"table-row\":\n                if height:\n                    kwargs[\"style:row-height\"] = height\n                if use_optimal_height:\n                    kwargs[\"style:use-optimal-row-height\"] = Boolean.encode(\n                        use_optimal_height\n                    )\n                if background_color:\n                    kwargs[\"fo:background-color\"] = background_color\n            # Table column\n            elif area == \"table-column\":\n                if width:\n                    kwargs[\"style:column-width\"] = width\n                if break_before:\n                    kwargs[\"fo:break-before\"] = break_before\n                if break_after:\n                    kwargs[\"fo:break-after\"] = break_after\n            # Graphic\n            elif area == \"graphic\":\n                if min_height:\n                    kwargs[\"fo:min-height\"] = min_height\n            # Every other properties\n            if kwargs:\n                self.set_properties(kwargs, area=area)\n\n    @property\n    def family(self) -&gt; str | None:\n        if self._family is None:\n            self._family = FALSE_FAMILY_MAP_REVERSE.get(\n                self.tag, self.get_attribute_string(\"style:family\")\n            )\n        return self._family\n\n    @family.setter\n    def family(self, family: str | None) -&gt; None:\n        self._family = family\n        if family in FAMILY_ODF_STD and self.tag == \"style:style\":\n            self.set_attribute(\"style:family\", family)\n\n    def get_properties(self, area: str | None = None) -&gt; dict[str, str | dict] | None:\n        \"\"\"Get the mapping of all properties of this style. By default the\n        properties of the same family, e.g. a paragraph style and its\n        paragraph properties. Specify the area to get the text properties of\n        a paragraph style for example.\n\n        Arguments:\n\n            area -- str\n\n        Return: dict\n        \"\"\"\n        if area is None:\n            area = self.family\n        element = self.get_element(f\"style:{area}-properties\")\n        if element is None:\n            return None\n        properties: dict[str, str | dict] = element.attributes  # type: ignore\n        # Nested properties are nested dictionaries\n        for child in element.children:\n            properties[child.tag] = child.attributes\n        return properties\n\n    def set_properties(  # noqa: C901\n        self,\n        properties: dict[str, str | dict] | None = None,\n        style: Style | None = None,\n        area: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Set the properties of the \"area\" type of this style. Properties\n        are given either as a dict or as named arguments (or both). The area\n        is identical to the style family by default. If the properties\n        element is missing, it is created.\n\n        Instead of properties, you can pass a style with properties of the\n        same area. These will be copied.\n\n        Arguments:\n\n            properties -- dict\n\n            style -- Style\n\n            area -- 'paragraph', 'text'...\n        \"\"\"\n        if properties is None:\n            properties = {}\n        if area is None:\n            if isinstance(self.family, bool):\n                area = None\n            else:\n                area = self.family\n        element = self.get_element(f\"style:{area}-properties\")\n        if element is None:\n            element = Element.from_tag(f\"style:{area}-properties\")\n            self.append(element)\n        if properties or kwargs:\n            properties = _expand_properties_dict(_merge_dicts(properties, kwargs))\n        elif style is not None:\n            properties = style.get_properties(area=area)\n            if properties is None:\n                return\n        if properties is None:\n            return\n        for key, value in properties.items():\n            if value is None:\n                element.del_attribute(key)\n            elif isinstance(value, (str, bool, tuple)):\n                element.set_attribute(key, value)\n            else:\n                pass\n\n    def del_properties(\n        self,\n        properties: list[str] | None = None,\n        area: str | None = None,\n    ) -&gt; None:\n        \"\"\"Delete the given properties, either by list argument or\n        positional argument (or both). Remove only from the given area,\n        identical to the style family by default.\n\n        Arguments:\n\n            properties -- list\n\n            area -- str\n        \"\"\"\n        if properties is None:\n            properties = []\n        if area is None:\n            area = self.family\n        element = self.get_element(f\"style:{area}-properties\")\n        if element is None:\n            raise ValueError(\n                f\"properties element is inexistent for: style:{area}-properties\"\n            )\n        for key in _expand_properties_list(properties):\n            element.del_attribute(key)\n\n    def set_background(  # noqa: C901\n        self,\n        color: str | None = None,\n        url: str | None = None,\n        position: str | None = \"center\",\n        repeat: str | None = None,\n        opacity: str | None = None,\n        filter: str | None = None,  # noqa: A002\n    ) -&gt; None:\n        \"\"\"Set the background color of a text style, or the background color\n        or image of a paragraph style or page layout.\n\n        With no argument, remove any existing background.\n\n        The position is one or two of 'center', 'left', 'right', 'top' or\n        'bottom'.\n\n        The repeat is 'no-repeat', 'repeat' or 'stretch'.\n\n        The opacity is a percentage integer (not a string with the '%s' sign)\n\n        The filter is an application-specific filter name defined elsewhere.\n\n        Though this method is defined on the base style class, it will raise\n        an error if the style type is not compatible.\n\n        Arguments:\n\n            color -- '#rrggbb'\n\n            url -- str\n\n            position -- str\n\n            repeat -- str\n\n            opacity -- int\n\n            filter -- str\n        \"\"\"\n        family = self.family\n        if family not in {\n            \"text\",\n            \"paragraph\",\n            \"page-layout\",\n            \"section\",\n            \"table\",\n            \"table-row\",\n            \"table-cell\",\n            \"graphic\",\n        }:\n            raise TypeError(\"No background support for this family\")\n        if url is not None and family == \"text\":\n            raise TypeError(\"No background image for text styles\")\n        properties = self.get_element(f\"style:{family}-properties\")\n        bg_image: BackgroundImage | None = None\n        if properties is not None:\n            bg_image = properties.get_element(\"style:background-image\")  # type:ignore\n        # Erasing\n        if color is None and url is None:\n            if properties is None:\n                return\n            properties.del_attribute(\"fo:background-color\")\n            if bg_image is not None:\n                properties.delete(bg_image)\n            return\n        # Add the properties if necessary\n        if properties is None:\n            properties = Element.from_tag(f\"style:{family}-properties\")\n            self.append(properties)\n        # Add the color...\n        if color:\n            properties.set_attribute(\"fo:background-color\", color)\n            if bg_image is not None:\n                properties.delete(bg_image)\n        # ... or the background\n        elif url:\n            properties.set_attribute(\"fo:background-color\", \"transparent\")\n            if bg_image is None:\n                bg_image = Element.from_tag(\"style:background-image\")  # type:ignore\n                properties.append(bg_image)  # type:ignore\n            bg_image.url = url  # type:ignore\n            if position:\n                bg_image.position = position  # type:ignore\n            if repeat:\n                bg_image.repeat = repeat  # type:ignore\n            if opacity:\n                bg_image.opacity = opacity  # type:ignore\n            if filter:\n                bg_image.filter = filter  # type:ignore\n\n    # list-style only:\n\n    def get_level_style(self, level: int) -&gt; Style | None:\n        if self.family != \"list\":\n            return None\n        level_styles = (\n            \"(text:list-level-style-number\"\n            \"|text:list-level-style-bullet\"\n            \"|text:list-level-style-image)\"\n        )\n        return self._filtered_element(level_styles, 0, level=level)  # type: ignore\n\n    def set_level_style(  # noqa: C901\n        self,\n        level: int,\n        num_format: str | None = None,\n        bullet_char: str | None = None,\n        url: str | None = None,\n        display_levels: int | None = None,\n        prefix: str | None = None,\n        suffix: str | None = None,\n        start_value: int | None = None,\n        style: str | None = None,\n        clone: Style | None = None,\n    ) -&gt; Style | None:\n        \"\"\"\n        Arguments:\n\n            level -- int\n\n            num_format (for number) -- int\n\n            bullet_char (for bullet) -- str\n\n            url (for image) -- str\n\n            display_levels -- int\n\n            prefix -- str\n\n            suffix -- str\n\n            start_value -- int\n\n            style -- str\n\n            clone -- List Style\n\n        Return:\n            level_style created\n        \"\"\"\n        if self.family != \"list\":\n            return None\n        # Expected name\n        if num_format is not None:\n            level_style_name = \"text:list-level-style-number\"\n        elif bullet_char is not None:\n            level_style_name = \"text:list-level-style-bullet\"\n        elif url is not None:\n            level_style_name = \"text:list-level-style-image\"\n        elif clone is not None:\n            level_style_name = clone.tag\n        else:\n            raise ValueError(\"unknown level style type\")\n        was_created = False\n        # Cloning or reusing an existing element\n        level_style: Style | None = None\n        if clone is not None:\n            level_style = clone.clone  # type: ignore\n            was_created = True\n        else:\n            level_style = self.get_level_style(level)\n            if level_style is None:\n                level_style = Element.from_tag(level_style_name)  # type: ignore\n                was_created = True\n        if level_style is None:\n            return None\n        # Transmute if the type changed\n        if level_style.tag != level_style_name:\n            print(\"Warn: different style\", level_style_name, level_style.tag)\n            level_style.tag = level_style_name\n        # Set the level\n        level_style.set_attribute(\"text:level\", str(level))\n        # Set the main attribute\n        if num_format is not None:\n            level_style.set_attribute(\"fo:num-format\", num_format)\n        elif bullet_char is not None:\n            level_style.set_attribute(\"text:bullet-char\", bullet_char)\n        elif url is not None:\n            level_style.set_attribute(\"xlink:href\", url)\n        # Set attributes\n        if prefix:\n            level_style.set_attribute(\"style:num-prefix\", prefix)\n        if suffix:\n            level_style.set_attribute(\"style:num-suffix\", suffix)\n        if display_levels:\n            level_style.set_attribute(\"text:display-levels\", str(display_levels))\n        if start_value:\n            level_style.set_attribute(\"text:start-value\", str(start_value))\n        if style:\n            level_style.text_style = style  # type: ignore\n        # Commit the creation\n        if was_created:\n            self.append(level_style)\n        return level_style\n\n    # page-layout only:\n\n    def get_header_style(self) -&gt; Element | None:\n        if self.family != \"page-layout\":\n            return None\n        return self.get_element(\"style:header-style\")\n\n    def set_header_style(self, new_style: Style) -&gt; None:\n        if self.family != \"page-layout\":\n            return\n        header_style = self.get_header_style()\n        if header_style is not None:\n            self.delete(header_style)\n        self.append(new_style)\n\n    def get_footer_style(self) -&gt; Style | None:\n        if self.family != \"page-layout\":\n            return None\n        return self.get_element(\"style:footer-style\")  # type: ignore\n\n    def set_footer_style(self, new_style: Style) -&gt; None:\n        if self.family != \"page-layout\":\n            return\n        footer_style = self.get_footer_style()\n        if footer_style is not None:\n            self.delete(footer_style)\n        self.append(new_style)\n\n    # master-page only:\n\n    def _set_header_or_footer(\n        self,\n        text_or_element: str | Element | list[Element | str],\n        name: str = \"header\",\n        style: str = \"Header\",\n    ) -&gt; None:\n        if name == \"header\":\n            header_or_footer = self.get_page_header()\n        else:\n            header_or_footer = self.get_page_footer()\n        if header_or_footer is None:\n            header_or_footer = Element.from_tag(\"style:\" + name)\n            self.append(header_or_footer)\n        else:\n            header_or_footer.clear()\n        if (\n            isinstance(text_or_element, Element)\n            and text_or_element.tag == f\"style:{name}\"\n        ):\n            # Already a header or footer?\n            self.delete(header_or_footer)\n            self.append(text_or_element)\n            return\n        if isinstance(text_or_element, (Element, str)):\n            elem_list: list[Element | str] = [text_or_element]\n        else:\n            elem_list = text_or_element\n        for item in elem_list:\n            if isinstance(item, str):\n                paragraph = Element.from_tag(\"text:p\")\n                paragraph.style = style  # type: ignore\n                header_or_footer.append(paragraph)\n            elif isinstance(item, Element):\n                header_or_footer.append(item)\n\n    def get_page_header(self) -&gt; Element | None:\n        \"\"\"Get the element that contains the header contents.\n\n        If None, no header was set.\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        return self.get_element(\"style:header\")\n\n    def set_page_header(\n        self,\n        text_or_element: str | Element | list[Element | str],\n    ) -&gt; None:\n        \"\"\"Create or replace the header by the given content. It can already\n        be a complete header.\n\n        If you only want to update the existing header, get it and use the\n        API.\n\n        Arguments:\n\n            text_or_element -- str or Element or a list of them\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        self._set_header_or_footer(text_or_element)\n\n    def get_page_footer(self) -&gt; Element | None:\n        \"\"\"Get the element that contains the footer contents.\n\n        If None, no footer was set.\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        return self.get_element(\"style:footer\")\n\n    def set_page_footer(\n        self,\n        text_or_element: str | Element | list[Element | str],\n    ) -&gt; None:\n        \"\"\"Create or replace the footer by the given content. It can already\n        be a complete footer.\n\n        If you only want to update the existing footer, get it and use the\n        API.\n\n        Arguments:\n\n            text_or_element -- str or Element or a list of them\n        \"\"\"\n        if self.family != \"master-page\":\n            return None\n        self._set_header_or_footer(text_or_element, name=\"footer\", style=\"Footer\")\n\n    # font-face only:\n\n    def set_font(\n        self,\n        name: str,\n        family: str | None = None,\n        family_generic: str | None = None,\n        pitch: str = \"variable\",\n    ) -&gt; None:\n        if self.family != \"font-face\":\n            return\n        self.name = name\n        if family is None:\n            family = name\n        self.svg_font_family = f'\"{family}\"'\n        if family_generic is not None:\n            self.font_family_generic = family_generic\n        self.font_pitch = pitch\n</code></pre>"},{"location":"reference.html#odfdo.Style.__init__","title":"<code>__init__(family=None, name=None, display_name=None, parent_style=None, area=None, color=None, background_color=None, italic=False, bold=False, master_page=None, page_layout=None, next_style=None, data_style=None, border=None, border_top=None, border_right=None, border_bottom=None, border_left=None, padding=None, padding_top=None, padding_bottom=None, padding_left=None, padding_right=None, shadow=None, height=None, use_optimal_height=False, width=None, break_before=None, break_after=None, min_height=None, font_name=None, font_family=None, font_family_generic=None, font_pitch='variable', **kwargs)</code>","text":"<p>Create a style of the given family. The name is not mandatory at this point but will become required when inserting in a document as a common style.</p> <p>The display name is the name the user sees in an office application.</p> <p>The parent_style is the name of the style this style will inherit from.</p> <p>To set properties, pass them as keyword arguments. The area properties apply to is optional and defaults to the family.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text', 'section', 'table', 'table-column',\n          'table-row', 'table-cell', 'table-page', 'chart',\n          'drawing-page', 'graphic', 'presentation',\n          'control', 'ruby', 'list', 'number', 'page-layout'\n          'font-face', or 'master-page'\n\nname -- str\n\ndisplay_name -- str\n\nparent_style -- str\n\narea -- str\n</code></pre> <p>\u2018text\u2019 Properties:</p> <pre><code>italic -- bool\n\nbold -- bool\n</code></pre> <p>\u2018paragraph\u2019 Properties:</p> <pre><code>master_page -- str\n</code></pre> <p>\u2018master-page\u2019 Properties:</p> <pre><code>page_layout -- str\n\nnext_style -- str\n</code></pre> <p>\u2018table-cell\u2019 Properties:</p> <pre><code>border, border_top, border_right, border_bottom, border_left -- str,\ne.g. \"0.002cm solid #000000\" or 'none'\n\npadding, padding_top, padding_right, padding_bottom, padding_left -- str,\ne.g. \"0.002cm\" or 'none'\n\nshadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n</code></pre> <p>\u2018table-row\u2019 Properties:</p> <pre><code>height -- str, e.g. '5cm'\n\nuse_optimal_height -- bool\n</code></pre> <p>\u2018table-column\u2019 Properties:</p> <pre><code>width -- str, e.g. '5cm'\n\nbreak_before -- 'page', 'column' or 'auto'\n\nbreak_after -- 'page', 'column' or 'auto'\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def __init__(  # noqa: C901\n    self,\n    family: str | None = None,\n    name: str | None = None,\n    display_name: str | None = None,\n    parent_style: str | None = None,\n    # Where properties apply\n    area: str | None = None,\n    # For family 'text':\n    color: str | tuple | None = None,\n    background_color: str | tuple | None = None,\n    italic: bool = False,\n    bold: bool = False,\n    # For family 'paragraph'\n    master_page: str | None = None,\n    # For family 'master-page'\n    page_layout: str | None = None,\n    next_style: str | None = None,\n    # For family 'table-cell'\n    data_style: str | None = None,  # unused\n    border: str | None = None,\n    border_top: str | None = None,\n    border_right: str | None = None,\n    border_bottom: str | None = None,\n    border_left: str | None = None,\n    padding: str | None = None,\n    padding_top: str | None = None,\n    padding_bottom: str | None = None,\n    padding_left: str | None = None,\n    padding_right: str | None = None,\n    shadow: str | None = None,\n    # For family 'table-row'\n    height: str | None = None,\n    use_optimal_height: bool = False,\n    # For family 'table-column'\n    width: str | None = None,\n    break_before: str | None = None,\n    break_after: str | None = None,\n    # For family 'graphic'\n    min_height: str | None = None,\n    # For family 'font-face'\n    font_name: str | None = None,\n    font_family: str | None = None,\n    font_family_generic: str | None = None,\n    font_pitch: str = \"variable\",\n    # Every other property\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a style of the given family. The name is not mandatory at this\n    point but will become required when inserting in a document as a common\n    style.\n\n    The display name is the name the user sees in an office application.\n\n    The parent_style is the name of the style this style will inherit from.\n\n    To set properties, pass them as keyword arguments. The area properties\n    apply to is optional and defaults to the family.\n\n    Arguments:\n\n        family -- 'paragraph', 'text', 'section', 'table', 'table-column',\n                  'table-row', 'table-cell', 'table-page', 'chart',\n                  'drawing-page', 'graphic', 'presentation',\n                  'control', 'ruby', 'list', 'number', 'page-layout'\n                  'font-face', or 'master-page'\n\n        name -- str\n\n        display_name -- str\n\n        parent_style -- str\n\n        area -- str\n\n    'text' Properties:\n\n        italic -- bool\n\n        bold -- bool\n\n    'paragraph' Properties:\n\n        master_page -- str\n\n    'master-page' Properties:\n\n        page_layout -- str\n\n        next_style -- str\n\n    'table-cell' Properties:\n\n        border, border_top, border_right, border_bottom, border_left -- str,\n        e.g. \"0.002cm solid #000000\" or 'none'\n\n        padding, padding_top, padding_right, padding_bottom, padding_left -- str,\n        e.g. \"0.002cm\" or 'none'\n\n        shadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\n    'table-row' Properties:\n\n        height -- str, e.g. '5cm'\n\n        use_optimal_height -- bool\n\n    'table-column' Properties:\n\n        width -- str, e.g. '5cm'\n\n        break_before -- 'page', 'column' or 'auto'\n\n        break_after -- 'page', 'column' or 'auto'\n    \"\"\"\n    self._family: str | None = None\n    tag_or_elem = kwargs.get(\"tag_or_elem\", None)\n    if tag_or_elem is None:\n        family = to_str(family)\n        if family not in FAMILY_MAPPING:\n            raise ValueError(f\"Unknown family value: '{family}'\")\n        kwargs[\"tag\"] = FAMILY_MAPPING[family]\n    super().__init__(**kwargs)\n    if self._do_init and family not in SUBCLASSED_STYLES:\n        kwargs.pop(\"tag\", None)\n        kwargs.pop(\"tag_or_elem\", None)\n        self.family = family  # relevant test made by property\n        # Common attributes\n        if name:\n            self.name = name\n        if display_name:\n            self.display_name = display_name\n        if parent_style:\n            self.parent_style = parent_style\n        # Paragraph\n        if family == \"paragraph\":\n            if master_page:\n                self.master_page = master_page\n        # Master Page\n        elif family == \"master-page\":\n            if page_layout:\n                self.page_layout = page_layout\n            if next_style:\n                self.next_style = next_style\n        # Font face\n        elif family == \"font-face\":\n            if not font_name:\n                raise ValueError(\"A font_name is required for 'font-face' style\")\n            self.set_font(\n                font_name,\n                family=font_family,\n                family_generic=font_family_generic,\n                pitch=font_pitch,\n            )\n        # Properties\n        if area is None:\n            area = family\n        area = to_str(area)\n        # Text\n        if area == \"text\":\n            if color:\n                kwargs[\"fo:color\"] = color\n            if background_color:\n                kwargs[\"fo:background-color\"] = background_color\n            if italic:\n                kwargs[\"fo:font-style\"] = \"italic\"\n                kwargs[\"style:font-style-asian\"] = \"italic\"\n                kwargs[\"style:font-style-complex\"] = \"italic\"\n            if bold:\n                kwargs[\"fo:font-weight\"] = \"bold\"\n                kwargs[\"style:font-weight-asian\"] = \"bold\"\n                kwargs[\"style:font-weight-complex\"] = \"bold\"\n        # Table cell\n        elif area == \"table-cell\":\n            if border:\n                kwargs[\"fo:border\"] = border\n            elif border_top or border_right or border_bottom or border_left:\n                kwargs[\"fo:border-top\"] = border_top or \"none\"\n                kwargs[\"fo:border-right\"] = border_right or \"none\"\n                kwargs[\"fo:border-bottom\"] = border_bottom or \"none\"\n                kwargs[\"fo:border-left\"] = border_left or \"none\"\n            else:  # no border_top, ... neither border are defined\n                pass  # left untouched\n            if padding:\n                kwargs[\"fo:padding\"] = padding\n            elif padding_top or padding_right or padding_bottom or padding_left:\n                kwargs[\"fo:padding-top\"] = padding_top or \"none\"\n                kwargs[\"fo:padding-right\"] = padding_right or \"none\"\n                kwargs[\"fo:padding-bottom\"] = padding_bottom or \"none\"\n                kwargs[\"fo:padding-left\"] = padding_left or \"none\"\n            else:  # no border_top, ... neither border are defined\n                pass  # left untouched\n            if shadow:\n                kwargs[\"style:shadow\"] = shadow\n            if background_color:\n                kwargs[\"fo:background-color\"] = background_color\n        # Table row\n        elif area == \"table-row\":\n            if height:\n                kwargs[\"style:row-height\"] = height\n            if use_optimal_height:\n                kwargs[\"style:use-optimal-row-height\"] = Boolean.encode(\n                    use_optimal_height\n                )\n            if background_color:\n                kwargs[\"fo:background-color\"] = background_color\n        # Table column\n        elif area == \"table-column\":\n            if width:\n                kwargs[\"style:column-width\"] = width\n            if break_before:\n                kwargs[\"fo:break-before\"] = break_before\n            if break_after:\n                kwargs[\"fo:break-after\"] = break_after\n        # Graphic\n        elif area == \"graphic\":\n            if min_height:\n                kwargs[\"fo:min-height\"] = min_height\n        # Every other properties\n        if kwargs:\n            self.set_properties(kwargs, area=area)\n</code></pre>"},{"location":"reference.html#odfdo.Style.del_properties","title":"<code>del_properties(properties=None, area=None)</code>","text":"<p>Delete the given properties, either by list argument or positional argument (or both). Remove only from the given area, identical to the style family by default.</p> <p>Arguments:</p> <pre><code>properties -- list\n\narea -- str\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def del_properties(\n    self,\n    properties: list[str] | None = None,\n    area: str | None = None,\n) -&gt; None:\n    \"\"\"Delete the given properties, either by list argument or\n    positional argument (or both). Remove only from the given area,\n    identical to the style family by default.\n\n    Arguments:\n\n        properties -- list\n\n        area -- str\n    \"\"\"\n    if properties is None:\n        properties = []\n    if area is None:\n        area = self.family\n    element = self.get_element(f\"style:{area}-properties\")\n    if element is None:\n        raise ValueError(\n            f\"properties element is inexistent for: style:{area}-properties\"\n        )\n    for key in _expand_properties_list(properties):\n        element.del_attribute(key)\n</code></pre>"},{"location":"reference.html#odfdo.Style.get_page_footer","title":"<code>get_page_footer()</code>","text":"<p>Get the element that contains the footer contents.</p> <p>If None, no footer was set.</p> Source code in <code>odfdo/style.py</code> <pre><code>def get_page_footer(self) -&gt; Element | None:\n    \"\"\"Get the element that contains the footer contents.\n\n    If None, no footer was set.\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    return self.get_element(\"style:footer\")\n</code></pre>"},{"location":"reference.html#odfdo.Style.get_page_header","title":"<code>get_page_header()</code>","text":"<p>Get the element that contains the header contents.</p> <p>If None, no header was set.</p> Source code in <code>odfdo/style.py</code> <pre><code>def get_page_header(self) -&gt; Element | None:\n    \"\"\"Get the element that contains the header contents.\n\n    If None, no header was set.\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    return self.get_element(\"style:header\")\n</code></pre>"},{"location":"reference.html#odfdo.Style.get_properties","title":"<code>get_properties(area=None)</code>","text":"<p>Get the mapping of all properties of this style. By default the properties of the same family, e.g. a paragraph style and its paragraph properties. Specify the area to get the text properties of a paragraph style for example.</p> <p>Arguments:</p> <pre><code>area -- str\n</code></pre> <p>Return: dict</p> Source code in <code>odfdo/style.py</code> <pre><code>def get_properties(self, area: str | None = None) -&gt; dict[str, str | dict] | None:\n    \"\"\"Get the mapping of all properties of this style. By default the\n    properties of the same family, e.g. a paragraph style and its\n    paragraph properties. Specify the area to get the text properties of\n    a paragraph style for example.\n\n    Arguments:\n\n        area -- str\n\n    Return: dict\n    \"\"\"\n    if area is None:\n        area = self.family\n    element = self.get_element(f\"style:{area}-properties\")\n    if element is None:\n        return None\n    properties: dict[str, str | dict] = element.attributes  # type: ignore\n    # Nested properties are nested dictionaries\n    for child in element.children:\n        properties[child.tag] = child.attributes\n    return properties\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_background","title":"<code>set_background(color=None, url=None, position='center', repeat=None, opacity=None, filter=None)</code>","text":"<p>Set the background color of a text style, or the background color or image of a paragraph style or page layout.</p> <p>With no argument, remove any existing background.</p> <p>The position is one or two of \u2018center\u2019, \u2018left\u2019, \u2018right\u2019, \u2018top\u2019 or \u2018bottom\u2019.</p> <p>The repeat is \u2018no-repeat\u2019, \u2018repeat\u2019 or \u2018stretch\u2019.</p> <p>The opacity is a percentage integer (not a string with the \u2018%s\u2019 sign)</p> <p>The filter is an application-specific filter name defined elsewhere.</p> <p>Though this method is defined on the base style class, it will raise an error if the style type is not compatible.</p> <p>Arguments:</p> <pre><code>color -- '#rrggbb'\n\nurl -- str\n\nposition -- str\n\nrepeat -- str\n\nopacity -- int\n\nfilter -- str\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_background(  # noqa: C901\n    self,\n    color: str | None = None,\n    url: str | None = None,\n    position: str | None = \"center\",\n    repeat: str | None = None,\n    opacity: str | None = None,\n    filter: str | None = None,  # noqa: A002\n) -&gt; None:\n    \"\"\"Set the background color of a text style, or the background color\n    or image of a paragraph style or page layout.\n\n    With no argument, remove any existing background.\n\n    The position is one or two of 'center', 'left', 'right', 'top' or\n    'bottom'.\n\n    The repeat is 'no-repeat', 'repeat' or 'stretch'.\n\n    The opacity is a percentage integer (not a string with the '%s' sign)\n\n    The filter is an application-specific filter name defined elsewhere.\n\n    Though this method is defined on the base style class, it will raise\n    an error if the style type is not compatible.\n\n    Arguments:\n\n        color -- '#rrggbb'\n\n        url -- str\n\n        position -- str\n\n        repeat -- str\n\n        opacity -- int\n\n        filter -- str\n    \"\"\"\n    family = self.family\n    if family not in {\n        \"text\",\n        \"paragraph\",\n        \"page-layout\",\n        \"section\",\n        \"table\",\n        \"table-row\",\n        \"table-cell\",\n        \"graphic\",\n    }:\n        raise TypeError(\"No background support for this family\")\n    if url is not None and family == \"text\":\n        raise TypeError(\"No background image for text styles\")\n    properties = self.get_element(f\"style:{family}-properties\")\n    bg_image: BackgroundImage | None = None\n    if properties is not None:\n        bg_image = properties.get_element(\"style:background-image\")  # type:ignore\n    # Erasing\n    if color is None and url is None:\n        if properties is None:\n            return\n        properties.del_attribute(\"fo:background-color\")\n        if bg_image is not None:\n            properties.delete(bg_image)\n        return\n    # Add the properties if necessary\n    if properties is None:\n        properties = Element.from_tag(f\"style:{family}-properties\")\n        self.append(properties)\n    # Add the color...\n    if color:\n        properties.set_attribute(\"fo:background-color\", color)\n        if bg_image is not None:\n            properties.delete(bg_image)\n    # ... or the background\n    elif url:\n        properties.set_attribute(\"fo:background-color\", \"transparent\")\n        if bg_image is None:\n            bg_image = Element.from_tag(\"style:background-image\")  # type:ignore\n            properties.append(bg_image)  # type:ignore\n        bg_image.url = url  # type:ignore\n        if position:\n            bg_image.position = position  # type:ignore\n        if repeat:\n            bg_image.repeat = repeat  # type:ignore\n        if opacity:\n            bg_image.opacity = opacity  # type:ignore\n        if filter:\n            bg_image.filter = filter  # type:ignore\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_level_style","title":"<code>set_level_style(level, num_format=None, bullet_char=None, url=None, display_levels=None, prefix=None, suffix=None, start_value=None, style=None, clone=None)</code>","text":"<p>Arguments:</p> <pre><code>level -- int\n\nnum_format (for number) -- int\n\nbullet_char (for bullet) -- str\n\nurl (for image) -- str\n\ndisplay_levels -- int\n\nprefix -- str\n\nsuffix -- str\n\nstart_value -- int\n\nstyle -- str\n\nclone -- List Style\n</code></pre> Return <p>level_style created</p> Source code in <code>odfdo/style.py</code> <pre><code>def set_level_style(  # noqa: C901\n    self,\n    level: int,\n    num_format: str | None = None,\n    bullet_char: str | None = None,\n    url: str | None = None,\n    display_levels: int | None = None,\n    prefix: str | None = None,\n    suffix: str | None = None,\n    start_value: int | None = None,\n    style: str | None = None,\n    clone: Style | None = None,\n) -&gt; Style | None:\n    \"\"\"\n    Arguments:\n\n        level -- int\n\n        num_format (for number) -- int\n\n        bullet_char (for bullet) -- str\n\n        url (for image) -- str\n\n        display_levels -- int\n\n        prefix -- str\n\n        suffix -- str\n\n        start_value -- int\n\n        style -- str\n\n        clone -- List Style\n\n    Return:\n        level_style created\n    \"\"\"\n    if self.family != \"list\":\n        return None\n    # Expected name\n    if num_format is not None:\n        level_style_name = \"text:list-level-style-number\"\n    elif bullet_char is not None:\n        level_style_name = \"text:list-level-style-bullet\"\n    elif url is not None:\n        level_style_name = \"text:list-level-style-image\"\n    elif clone is not None:\n        level_style_name = clone.tag\n    else:\n        raise ValueError(\"unknown level style type\")\n    was_created = False\n    # Cloning or reusing an existing element\n    level_style: Style | None = None\n    if clone is not None:\n        level_style = clone.clone  # type: ignore\n        was_created = True\n    else:\n        level_style = self.get_level_style(level)\n        if level_style is None:\n            level_style = Element.from_tag(level_style_name)  # type: ignore\n            was_created = True\n    if level_style is None:\n        return None\n    # Transmute if the type changed\n    if level_style.tag != level_style_name:\n        print(\"Warn: different style\", level_style_name, level_style.tag)\n        level_style.tag = level_style_name\n    # Set the level\n    level_style.set_attribute(\"text:level\", str(level))\n    # Set the main attribute\n    if num_format is not None:\n        level_style.set_attribute(\"fo:num-format\", num_format)\n    elif bullet_char is not None:\n        level_style.set_attribute(\"text:bullet-char\", bullet_char)\n    elif url is not None:\n        level_style.set_attribute(\"xlink:href\", url)\n    # Set attributes\n    if prefix:\n        level_style.set_attribute(\"style:num-prefix\", prefix)\n    if suffix:\n        level_style.set_attribute(\"style:num-suffix\", suffix)\n    if display_levels:\n        level_style.set_attribute(\"text:display-levels\", str(display_levels))\n    if start_value:\n        level_style.set_attribute(\"text:start-value\", str(start_value))\n    if style:\n        level_style.text_style = style  # type: ignore\n    # Commit the creation\n    if was_created:\n        self.append(level_style)\n    return level_style\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_page_footer","title":"<code>set_page_footer(text_or_element)</code>","text":"<p>Create or replace the footer by the given content. It can already be a complete footer.</p> <p>If you only want to update the existing footer, get it and use the API.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or Element or a list of them\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_page_footer(\n    self,\n    text_or_element: str | Element | list[Element | str],\n) -&gt; None:\n    \"\"\"Create or replace the footer by the given content. It can already\n    be a complete footer.\n\n    If you only want to update the existing footer, get it and use the\n    API.\n\n    Arguments:\n\n        text_or_element -- str or Element or a list of them\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    self._set_header_or_footer(text_or_element, name=\"footer\", style=\"Footer\")\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_page_header","title":"<code>set_page_header(text_or_element)</code>","text":"<p>Create or replace the header by the given content. It can already be a complete header.</p> <p>If you only want to update the existing header, get it and use the API.</p> <p>Arguments:</p> <pre><code>text_or_element -- str or Element or a list of them\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_page_header(\n    self,\n    text_or_element: str | Element | list[Element | str],\n) -&gt; None:\n    \"\"\"Create or replace the header by the given content. It can already\n    be a complete header.\n\n    If you only want to update the existing header, get it and use the\n    API.\n\n    Arguments:\n\n        text_or_element -- str or Element or a list of them\n    \"\"\"\n    if self.family != \"master-page\":\n        return None\n    self._set_header_or_footer(text_or_element)\n</code></pre>"},{"location":"reference.html#odfdo.Style.set_properties","title":"<code>set_properties(properties=None, style=None, area=None, **kwargs)</code>","text":"<p>Set the properties of the \u201carea\u201d type of this style. Properties are given either as a dict or as named arguments (or both). The area is identical to the style family by default. If the properties element is missing, it is created.</p> <p>Instead of properties, you can pass a style with properties of the same area. These will be copied.</p> <p>Arguments:</p> <pre><code>properties -- dict\n\nstyle -- Style\n\narea -- 'paragraph', 'text'...\n</code></pre> Source code in <code>odfdo/style.py</code> <pre><code>def set_properties(  # noqa: C901\n    self,\n    properties: dict[str, str | dict] | None = None,\n    style: Style | None = None,\n    area: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Set the properties of the \"area\" type of this style. Properties\n    are given either as a dict or as named arguments (or both). The area\n    is identical to the style family by default. If the properties\n    element is missing, it is created.\n\n    Instead of properties, you can pass a style with properties of the\n    same area. These will be copied.\n\n    Arguments:\n\n        properties -- dict\n\n        style -- Style\n\n        area -- 'paragraph', 'text'...\n    \"\"\"\n    if properties is None:\n        properties = {}\n    if area is None:\n        if isinstance(self.family, bool):\n            area = None\n        else:\n            area = self.family\n    element = self.get_element(f\"style:{area}-properties\")\n    if element is None:\n        element = Element.from_tag(f\"style:{area}-properties\")\n        self.append(element)\n    if properties or kwargs:\n        properties = _expand_properties_dict(_merge_dicts(properties, kwargs))\n    elif style is not None:\n        properties = style.get_properties(area=area)\n        if properties is None:\n            return\n    if properties is None:\n        return\n    for key, value in properties.items():\n        if value is None:\n            element.del_attribute(key)\n        elif isinstance(value, (str, bool, tuple)):\n            element.set_attribute(key, value)\n        else:\n            pass\n</code></pre>"},{"location":"reference.html#odfdo.Styles","title":"<code>Styles</code>","text":"<p>               Bases: <code>XmlPart</code></p> Source code in <code>odfdo/styles.py</code> <pre><code>class Styles(XmlPart):\n    def _get_style_contexts(\n        self, family: str, automatic: bool = False\n    ) -&gt; list[Element]:\n        if automatic:\n            return [self.get_element(\"//office:automatic-styles\")]\n        if not family:\n            # All possibilities\n            return [\n                self.get_element(\"//office:automatic-styles\"),\n                self.get_element(\"//office:styles\"),\n                self.get_element(\"//office:master-styles\"),\n                self.get_element(\"//office:font-face-decls\"),\n            ]\n        queries = CONTEXT_MAPPING.get(family)\n        if queries is None:\n            raise ValueError(f\"unknown family: {family}\")\n        # print('q:', queries)\n        return [self.get_element(query) for query in queries]\n\n    def get_styles(self, family: str = \"\", automatic: bool = False) -&gt; list[Element]:\n        \"\"\"Return the list of styles in the Content part, optionally limited\n        to the given family, optionaly limited to automatic styles.\n\n        Arguments:\n\n            family -- str\n\n            automatic -- bool\n\n        Return: list of Style\n        \"\"\"\n        result = []\n        for context in self._get_style_contexts(family, automatic=automatic):\n            if context is None:\n                continue\n            # print('-ctx----', automatic)\n            # print(context.tag)\n            # print(context.__class__)\n            # print(context.serialize())\n            result.extend(context.get_styles(family=family))\n        return result\n\n    def get_style(\n        self,\n        family: str,\n        name_or_element: str | Style | None = None,\n        display_name: str | None = None,\n    ) -&gt; Style | None:\n        \"\"\"Return the style uniquely identified by the name/family pair. If\n        the argument is already a style object, it will return it.\n\n        If the name is None, the default style is fetched.\n\n        If the name is not the internal name but the name you gave in the\n        desktop application, use display_name instead.\n\n        Arguments:\n\n            family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                      'number', 'page-layout', 'master-page'\n\n            name_or_element -- str, odf_style or None\n\n            display_name -- str or None\n\n        Return: odf_style or None if not found\n        \"\"\"\n        for context in self._get_style_contexts(family):\n            if context is None:\n                continue\n            style = context.get_style(\n                family,\n                name_or_element=name_or_element,\n                display_name=display_name,\n            )\n            if style is not None:\n                return style  # type: ignore\n        return None\n\n    def get_master_pages(self) -&gt; list[Element]:\n        query = make_xpath_query(\"descendant::style:master-page\")\n        return self.get_elements(query)  # type:ignore\n\n    def get_master_page(self, position: int = 0) -&gt; Element | None:\n        results = self.get_master_pages()\n        try:\n            return results[position]\n        except IndexError:\n            return None\n</code></pre>"},{"location":"reference.html#odfdo.Styles.get_style","title":"<code>get_style(family, name_or_element=None, display_name=None)</code>","text":"<p>Return the style uniquely identified by the name/family pair. If the argument is already a style object, it will return it.</p> <p>If the name is None, the default style is fetched.</p> <p>If the name is not the internal name but the name you gave in the desktop application, use display_name instead.</p> <p>Arguments:</p> <pre><code>family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n          'number', 'page-layout', 'master-page'\n\nname_or_element -- str, odf_style or None\n\ndisplay_name -- str or None\n</code></pre> <p>Return: odf_style or None if not found</p> Source code in <code>odfdo/styles.py</code> <pre><code>def get_style(\n    self,\n    family: str,\n    name_or_element: str | Style | None = None,\n    display_name: str | None = None,\n) -&gt; Style | None:\n    \"\"\"Return the style uniquely identified by the name/family pair. If\n    the argument is already a style object, it will return it.\n\n    If the name is None, the default style is fetched.\n\n    If the name is not the internal name but the name you gave in the\n    desktop application, use display_name instead.\n\n    Arguments:\n\n        family -- 'paragraph', 'text',  'graphic', 'table', 'list',\n                  'number', 'page-layout', 'master-page'\n\n        name_or_element -- str, odf_style or None\n\n        display_name -- str or None\n\n    Return: odf_style or None if not found\n    \"\"\"\n    for context in self._get_style_contexts(family):\n        if context is None:\n            continue\n        style = context.get_style(\n            family,\n            name_or_element=name_or_element,\n            display_name=display_name,\n        )\n        if style is not None:\n            return style  # type: ignore\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Styles.get_styles","title":"<code>get_styles(family='', automatic=False)</code>","text":"<p>Return the list of styles in the Content part, optionally limited to the given family, optionaly limited to automatic styles.</p> <p>Arguments:</p> <pre><code>family -- str\n\nautomatic -- bool\n</code></pre> <p>Return: list of Style</p> Source code in <code>odfdo/styles.py</code> <pre><code>def get_styles(self, family: str = \"\", automatic: bool = False) -&gt; list[Element]:\n    \"\"\"Return the list of styles in the Content part, optionally limited\n    to the given family, optionaly limited to automatic styles.\n\n    Arguments:\n\n        family -- str\n\n        automatic -- bool\n\n    Return: list of Style\n    \"\"\"\n    result = []\n    for context in self._get_style_contexts(family, automatic=automatic):\n        if context is None:\n            continue\n        # print('-ctx----', automatic)\n        # print(context.tag)\n        # print(context.__class__)\n        # print(context.serialize())\n        result.extend(context.get_styles(family=family))\n    return result\n</code></pre>"},{"location":"reference.html#odfdo.TOC","title":"<code>TOC</code>","text":"<p>               Bases: <code>Element</code></p> <p>Table of content. The \u201ctext:table-of-content\u201d element represents a table of contents for a document. The items that can be listed in a table of contents are:   - Headings (as defined by the outline structure of the document), up to     a selected level.   - Table of contents index marks.   - Paragraphs formatted with specified paragraph styles.</p> <p>Implementation: Default parameters are what most people use: protected from manual modifications and not limited in title levels.</p> <p>The name is mandatory and derived automatically from the title if not given. Provide one in case of a conflict with other TOCs in the same document.</p> <p>The \u201ctext:table-of-content\u201d element has the following attributes: text:name, text:protected, text:protection-key, text:protection-key-digest-algorithm, text:style-name and xml:id.</p> <p>Arguments:</p> <pre><code>title -- str\n\nname -- str\n\nprotected -- bool\n\noutline_level -- int\n\nstyle -- str\n\ntitle_style -- str\n\nentry_style -- str\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>class TOC(Element):\n    \"\"\"Table of content.\n    The \"text:table-of-content\" element represents a table of contents for a\n    document. The items that can be listed in a table of contents are:\n      - Headings (as defined by the outline structure of the document), up to\n        a selected level.\n      - Table of contents index marks.\n      - Paragraphs formatted with specified paragraph styles.\n\n\n    Implementation:\n    Default parameters are what most people use: protected from manual\n    modifications and not limited in title levels.\n\n    The name is mandatory and derived automatically from the title if not\n    given. Provide one in case of a conflict with other TOCs in the same\n    document.\n\n    The \"text:table-of-content\" element has the following attributes:\n    text:name, text:protected, text:protection-key,\n    text:protection-key-digest-algorithm, text:style-name and xml:id.\n\n    Arguments:\n\n        title -- str\n\n        name -- str\n\n        protected -- bool\n\n        outline_level -- int\n\n        style -- str\n\n        title_style -- str\n\n        entry_style -- str\n    \"\"\"\n\n    _tag = \"text:table-of-content\"\n    _properties = (\n        PropDef(\"name\", \"text:name\"),\n        PropDef(\"style\", \"text:style-name\"),\n        PropDef(\"xml_id\", \"xml:id\"),\n        PropDef(\"protected\", \"text:protected\"),\n        PropDef(\"protection_key\", \"text:protection-key\"),\n        PropDef(\n            \"protection_key_digest_algorithm\", \"text:protection-key-digest-algorithm\"\n        ),\n    )\n\n    def __init__(\n        self,\n        title: str = \"Table of Contents\",\n        name: str | None = None,\n        protected: bool = True,\n        outline_level: int = 0,\n        style: str | None = None,\n        title_style: str = \"Contents_20_Heading\",\n        entry_style: str = \"Contents_20_%d\",\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style:\n                self.style = style\n            if protected:\n                self.protected = protected\n            if name is None:\n                self.name = f\"{title}1\"\n            # Create the source template\n            toc_source = self.create_toc_source(\n                title, outline_level, title_style, entry_style\n            )\n            self.append(toc_source)\n            # Create the index body automatically with the index title\n            if title:\n                # This style is in the template document\n                self.set_toc_title(title, text_style=title_style)\n\n    @staticmethod\n    def create_toc_source(\n        title: str,\n        outline_level: int,\n        title_style: str,\n        entry_style: str,\n    ) -&gt; Element:\n        toc_source = Element.from_tag(\"text:table-of-content-source\")\n        toc_source.set_attribute(\"text:outline-level\", str(outline_level))\n        if title:\n            title_template = IndexTitleTemplate()\n            if title_style:\n                # This style is in the template document\n                title_template.style = title_style\n            title_template.text = title\n            toc_source.append(title_template)\n        for level in range(1, 11):\n            template = TocEntryTemplate(outline_level=level)\n            if entry_style:\n                template.style = entry_style % level\n            toc_source.append(template)\n        return toc_source\n\n    def __str__(self) -&gt; str:\n        return self.get_formatted_text()\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        index_body = self.get_element(\"text:index-body\")\n\n        if index_body is None:\n            return \"\"\n        if context is None:\n            context = {}\n        if context.get(\"rst_mode\"):\n            return \"\\n.. contents::\\n\\n\"\n\n        result = []\n        for element in index_body.children:\n            if element.tag == \"text:index-title\":\n                for child_element in element.children:\n                    result.append(child_element.get_formatted_text(context).strip())\n            else:\n                result.append(element.get_formatted_text(context).strip())\n        return \"\\n\".join(result)\n\n    @property\n    def outline_level(self) -&gt; int | None:\n        source = self.get_element(\"text:table-of-content-source\")\n        if source is None:\n            return None\n        return source.get_attribute_integer(\"text:outline-level\")\n\n    @outline_level.setter\n    def outline_level(self, level: int) -&gt; None:\n        source = self.get_element(\"text:table-of-content-source\")\n        if source is None:\n            source = Element.from_tag(\"text:table-of-content-source\")\n            self.insert(source, FIRST_CHILD)\n        source.set_attribute(\"text:outline-level\", str(level))\n\n    @property\n    def body(self) -&gt; Element | None:\n        return self.get_element(\"text:index-body\")\n\n    @body.setter\n    def body(self, body: Element | None = None) -&gt; Element | None:\n        old_body = self.body\n        if old_body is not None:\n            self.delete(old_body)\n        if body is None:\n            body = Element.from_tag(\"text:index-body\")\n        self.append(body)\n        return body\n\n    def get_title(self) -&gt; str:\n        index_body = self.body\n        if index_body is None:\n            return \"\"\n        index_title = index_body.get_element(IndexTitle._tag)\n        if index_title is None:\n            return \"\"\n        return index_title.text_content\n\n    def set_toc_title(\n        self,\n        title: str,\n        style: str | None = None,\n        text_style: str | None = None,\n    ) -&gt; None:\n        index_body = self.body\n        if index_body is None:\n            self.body = None\n            index_body = self.body\n        index_title = index_body.get_element(IndexTitle._tag)  # type: ignore\n        if index_title is None:\n            name = f\"{self.name}_Head\"\n            index_title = IndexTitle(\n                name=name, style=style, title_text=title, text_style=text_style\n            )\n            index_body.append(index_title)  # type: ignore\n        else:\n            if style:\n                index_title.style = style  # type: ignore\n            paragraph = index_title.get_paragraph()\n            if paragraph is None:\n                paragraph = Paragraph()\n                index_title.append(paragraph)\n            if text_style:\n                paragraph.style = text_style  # type: ignore\n            paragraph.text = title\n\n    @staticmethod\n    def _header_numbering(level_indexes: dict[int, int], level: int) -&gt; str:\n        \"\"\"Return the header hierarchical number (like \"1.2.3.\").\"\"\"\n        numbers: list[int] = []\n        # before header level\n        for idx in range(1, level):\n            numbers.append(level_indexes.setdefault(idx, 1))\n        # header level\n        index = level_indexes.get(level, 0) + 1\n        level_indexes[level] = index\n        numbers.append(index)\n        # after header level\n        idx = level + 1\n        while idx in level_indexes:\n            del level_indexes[idx]\n            idx += 1\n        return \".\".join(str(x) for x in numbers) + \".\"\n\n    def fill(  # noqa: C901\n        self,\n        document: Document | None = None,\n        use_default_styles: bool = True,\n    ) -&gt; None:\n        \"\"\"Fill the TOC with the titles found in the document. A TOC is not\n        contextual so it will catch all titles before and after its insertion.\n        If the TOC is not attached to a document, attach it beforehand or\n        provide one as argument.\n\n        For having a pretty TOC, let use_default_styles by default.\n\n        Arguments:\n\n            document -- Document\n\n            use_default_styles -- bool\n        \"\"\"\n        # Find the body\n        if document is not None:\n            body: Element | None = document.body\n        else:\n            body = self.document_body\n        if body is None:\n            raise ValueError(\"The TOC must be related to a document somehow\")\n\n        # Save the title\n        index_body = self.body\n        title = index_body.get_element(\"text:index-title\")  # type: ignore\n\n        # Clean the old index-body\n        self.body = None\n        index_body = self.body\n\n        # Restore the title\n        if title and str(title):\n            index_body.insert(title, position=0)  # type: ignore\n\n        # Insert default TOC style\n        if use_default_styles:\n            automatic_styles = body.get_element(\"//office:automatic-styles\")\n            if isinstance(automatic_styles, Element):\n                for level in range(1, 11):\n                    if (\n                        automatic_styles.get_style(\n                            \"paragraph\", _toc_entry_style_name(level)\n                        )\n                        is None\n                    ):\n                        level_style = default_toc_level_style(level)\n                        automatic_styles.append(level_style)\n\n        # Auto-fill the index\n        outline_level = self.outline_level or 10\n        level_indexes: dict[int, int] = {}\n        for header in body.headers:\n            level = header.get_attribute_integer(\"text:outline-level\") or 0\n            if level is None or level &gt; outline_level:\n                continue\n            number_str = self._header_numbering(level_indexes, level)\n            # Make the title with \"1.2.3. Title\" format\n            paragraph = Paragraph(f\"{number_str} {header}\")\n            if use_default_styles:\n                paragraph.style = _toc_entry_style_name(level)\n            index_body.append(paragraph)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.TOC.fill","title":"<code>fill(document=None, use_default_styles=True)</code>","text":"<p>Fill the TOC with the titles found in the document. A TOC is not contextual so it will catch all titles before and after its insertion. If the TOC is not attached to a document, attach it beforehand or provide one as argument.</p> <p>For having a pretty TOC, let use_default_styles by default.</p> <p>Arguments:</p> <pre><code>document -- Document\n\nuse_default_styles -- bool\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>def fill(  # noqa: C901\n    self,\n    document: Document | None = None,\n    use_default_styles: bool = True,\n) -&gt; None:\n    \"\"\"Fill the TOC with the titles found in the document. A TOC is not\n    contextual so it will catch all titles before and after its insertion.\n    If the TOC is not attached to a document, attach it beforehand or\n    provide one as argument.\n\n    For having a pretty TOC, let use_default_styles by default.\n\n    Arguments:\n\n        document -- Document\n\n        use_default_styles -- bool\n    \"\"\"\n    # Find the body\n    if document is not None:\n        body: Element | None = document.body\n    else:\n        body = self.document_body\n    if body is None:\n        raise ValueError(\"The TOC must be related to a document somehow\")\n\n    # Save the title\n    index_body = self.body\n    title = index_body.get_element(\"text:index-title\")  # type: ignore\n\n    # Clean the old index-body\n    self.body = None\n    index_body = self.body\n\n    # Restore the title\n    if title and str(title):\n        index_body.insert(title, position=0)  # type: ignore\n\n    # Insert default TOC style\n    if use_default_styles:\n        automatic_styles = body.get_element(\"//office:automatic-styles\")\n        if isinstance(automatic_styles, Element):\n            for level in range(1, 11):\n                if (\n                    automatic_styles.get_style(\n                        \"paragraph\", _toc_entry_style_name(level)\n                    )\n                    is None\n                ):\n                    level_style = default_toc_level_style(level)\n                    automatic_styles.append(level_style)\n\n    # Auto-fill the index\n    outline_level = self.outline_level or 10\n    level_indexes: dict[int, int] = {}\n    for header in body.headers:\n        level = header.get_attribute_integer(\"text:outline-level\") or 0\n        if level is None or level &gt; outline_level:\n            continue\n        number_str = self._header_numbering(level_indexes, level)\n        # Make the title with \"1.2.3. Title\" format\n        paragraph = Paragraph(f\"{number_str} {header}\")\n        if use_default_styles:\n            paragraph.style = _toc_entry_style_name(level)\n        index_body.append(paragraph)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Tab","title":"<code>Tab</code>","text":"<p>               Bases: <code>Element</code></p> <p>This element represents the [UNICODE] tab character (HORIZONTAL TABULATION, U+0009).</p> <p>The position attribute contains the number of the tab-stop to which a tab character refers. The position 0 marks the start margin of a paragraph. Note: The position attribute is only a hint to help non-layout oriented consumers to determine the tab/tab-stop association. Layout oriented consumers should determine the tab positions based on the style information</p> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>class Tab(Element):\n    \"\"\"This element represents the [UNICODE] tab character (HORIZONTAL\n    TABULATION, U+0009).\n\n    The position attribute contains the number of the tab-stop to which\n    a tab character refers. The position 0 marks the start margin of a\n    paragraph. Note: The position attribute is only a hint to help non-layout\n    oriented consumers to determine the tab/tab-stop association. Layout\n    oriented consumers should determine the tab positions based on the style\n    information\n    \"\"\"\n\n    _tag = \"text:tab\"\n    _properties: tuple[PropDef, ...] = (PropDef(\"position\", \"text:tab-ref\"),)\n\n    def __init__(self, position: int | None = None, **kwargs: Any) -&gt; None:\n        \"\"\"\n        Arguments:\n\n            position -- int\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init and position is not None and position &gt;= 0:\n            self.position = str(position)\n</code></pre>"},{"location":"reference.html#odfdo.Tab.__init__","title":"<code>__init__(position=None, **kwargs)</code>","text":"<p>Arguments:</p> <pre><code>position -- int\n</code></pre> Source code in <code>odfdo/paragraph_base.py</code> <pre><code>def __init__(self, position: int | None = None, **kwargs: Any) -&gt; None:\n    \"\"\"\n    Arguments:\n\n        position -- int\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init and position is not None and position &gt;= 0:\n        self.position = str(position)\n</code></pre>"},{"location":"reference.html#odfdo.TabStopStyle","title":"<code>TabStopStyle</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF \u201cstyle:tab-stop\u201d Base style for a TOC entryBase style for a TOC entry</p> Source code in <code>odfdo/toc.py</code> <pre><code>class TabStopStyle(Element):\n    \"\"\"ODF \"style:tab-stop\"\n    Base style for a TOC entryBase style for a TOC entry\n    \"\"\"\n\n    _tag = \"style:tab-stop\"\n    _properties = (\n        PropDef(\"style_char\", \"style:char\"),\n        PropDef(\"leader_color\", \"style:leader-color\"),\n        PropDef(\"leader_style\", \"style:leader-style\"),\n        PropDef(\"leader_text\", \"style:leader-text\"),\n        PropDef(\"leader_text_style\", \"style:leader-text-style\"),\n        PropDef(\"leader_type\", \"style:leader-type\"),\n        PropDef(\"leader_width\", \"style:leader-width\"),\n        PropDef(\"style_position\", \"style:position\"),\n        PropDef(\"style_type\", \"style:type\"),\n    )\n\n    def __init__(  # noqa: C901\n        self,\n        style_char: str | None = None,\n        leader_color: str | None = None,\n        leader_style: str | None = None,\n        leader_text: str | None = None,\n        leader_text_style: str | None = None,\n        leader_type: str | None = None,\n        leader_width: str | None = None,\n        style_position: str | None = None,\n        style_type: str | None = None,\n        **kwargs: Any,\n    ):\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style_char:\n                self.style_char = style_char\n            if leader_color:\n                self.leader_color = leader_color\n            if leader_style:\n                self.leader_style = leader_style\n            if leader_text:\n                self.leader_text = leader_text\n            if leader_text_style:\n                self.leader_text_style = leader_text_style\n            if leader_type:\n                self.leader_type = leader_type\n            if leader_width:\n                self.leader_width = leader_width\n            if style_position:\n                self.style_position = style_position\n            if style_type:\n                self.style_type = style_type\n</code></pre>"},{"location":"reference.html#odfdo.Table","title":"<code>Table</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF table \u201ctable:table\u201d</p> Source code in <code>odfdo/table.py</code> <pre><code>class Table(Element):\n    \"\"\"ODF table \"table:table\" \"\"\"\n\n    _tag = \"table:table\"\n    _caching = True\n    _append = Element.append\n\n    def __init__(\n        self,\n        name: str | None = None,\n        width: int | None = None,\n        height: int | None = None,\n        protected: bool = False,\n        protection_key: str | None = None,\n        display: bool = True,\n        printable: bool = True,\n        print_ranges: list[str] | None = None,\n        style: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"Create a table element, optionally prefilled with \"height\" rows of\n        \"width\" cells each.\n\n        If the table is to be protected, a protection key must be provided,\n        i.e. a hash value of the password.\n\n        If the table must not be displayed, set \"display\" to False.\n\n        If the table must not be printed, set \"printable\" to False. The table\n        will not be printed when it is not displayed, whatever the value of\n        this argument.\n\n        Ranges of cells to print can be provided as a list of cell ranges,\n        e.g. ['E6:K12', 'P6:R12'] or directly as a raw string, e.g.\n        \"E6:K12 P6:R12\".\n\n        You can access and modify the XML tree manually, but you probably want\n        to use the API to access and alter cells. It will save you from\n        handling repetitions and the same number of cells for each row.\n\n        If you use both the table API and the XML API, you are on your own for\n        ensuiring model integrity.\n\n        Arguments:\n\n            name -- str\n\n            width -- int\n\n            height -- int\n\n            protected -- bool\n\n            protection_key -- str\n\n            display -- bool\n\n            printable -- bool\n\n            print_ranges -- list\n\n            style -- str\n        \"\"\"\n        super().__init__(**kwargs)\n        self._indexes = {}\n        self._indexes[\"_cmap\"] = {}\n        self._indexes[\"_tmap\"] = {}\n        if self._do_init:\n            self.name = name\n            if protected:\n                self.protected = protected\n                self.set_protection_key = protection_key\n            if not display:\n                self.displayed = display\n            if not printable:\n                self.printable = printable\n            if print_ranges:\n                self.print_ranges = print_ranges\n            if style:\n                self.style = style\n            # Prefill the table\n            if width is not None or height is not None:\n                width = width or 1\n                height = height or 1\n                # Column groups for style information\n                columns = Column(repeated=width)\n                self._append(columns)\n                for _i in range(height):\n                    row = Row(width)\n                    self._append(row)\n        self._compute_table_cache()\n\n    def __str__(self) -&gt; str:\n        def write_content(csv_writer: object) -&gt; None:\n            for values in self.iter_values():\n                line = []\n                for value in values:\n                    if value is None:\n                        value = \"\"\n                    if isinstance(value, str):\n                        value = value.strip()\n                    line.append(value)\n                csv_writer.writerow(line)  # type: ignore\n\n        out = StringIO(newline=os.linesep)\n        csv_writer = csv.writer(\n            out,\n            delimiter=\" \",\n            doublequote=False,\n            escapechar=\"\\\\\",\n            lineterminator=os.linesep,\n            quotechar='\"',\n            quoting=csv.QUOTE_NONNUMERIC,\n        )\n        write_content(csv_writer)\n        return out.getvalue()\n\n    def _translate_y_from_any(self, y: str | int) -&gt; int:\n        # \"3\" (couting from 1) -&gt; 2 (couting from 0)\n        return translate_from_any(y, self.height, 1)\n\n    def _translate_table_coordinates_list(\n        self,\n        coord: tuple | list,\n    ) -&gt; tuple[int | None, ...]:\n        height = self.height\n        width = self.width\n        # assuming we got int values\n        if len(coord) == 1:\n            # It is a row\n            y = coord[0]\n            if y and y &lt; 0:\n                y = increment(y, height)\n            return (None, y, None, y)\n        if len(coord) == 2:\n            # It is a row range, not a cell, because context is table\n            y = coord[0]\n            if y and y &lt; 0:\n                y = increment(y, height)\n            t = coord[1]\n            if t and t &lt; 0:\n                t = increment(t, height)\n            return (None, y, None, t)\n        # should be 4 int\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_table_coordinates_str(\n        self,\n        coord_str: str,\n    ) -&gt; tuple[int | None, ...]:\n        height = self.height\n        width = self.width\n        coord = convert_coordinates(coord_str)\n        if len(coord) == 2:\n            x, y = coord\n            if x and x &lt; 0:\n                x = increment(x, width)\n            if y and y &lt; 0:\n                y = increment(y, height)\n            # extent to an area :\n            return (x, y, x, y)\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_table_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, ...]:\n        if isinstance(coord, str):\n            return self._translate_table_coordinates_str(coord)\n        return self._translate_table_coordinates_list(coord)\n\n    def _translate_column_coordinates_str(\n        self,\n        coord_str: str,\n    ) -&gt; tuple[int | None, ...]:\n        width = self.width\n        height = self.height\n        coord = convert_coordinates(coord_str)\n        if len(coord) == 2:\n            x, y = coord\n            if x and x &lt; 0:\n                x = increment(x, width)\n            if y and y &lt; 0:\n                y = increment(y, height)\n            # extent to an area :\n            return (x, y, x, y)\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_column_coordinates_list(\n        self,\n        coord: tuple | list,\n    ) -&gt; tuple[int | None, ...]:\n        width = self.width\n        height = self.height\n        # assuming we got int values\n        if len(coord) == 1:\n            # It is a column\n            x = coord[0]\n            if x and x &lt; 0:\n                x = increment(x, width)\n            return (x, None, x, None)\n        if len(coord) == 2:\n            # It is a column range, not a cell, because context is table\n            x = coord[0]\n            if x and x &lt; 0:\n                x = increment(x, width)\n            z = coord[1]\n            if z and z &lt; 0:\n                z = increment(z, width)\n            return (x, None, z, None)\n        # should be 4 int\n        x, y, z, t = coord\n        if x and x &lt; 0:\n            x = increment(x, width)\n        if y and y &lt; 0:\n            y = increment(y, height)\n        if z and z &lt; 0:\n            z = increment(z, width)\n        if t and t &lt; 0:\n            t = increment(t, height)\n        return (x, y, z, t)\n\n    def _translate_column_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, ...]:\n        if isinstance(coord, str):\n            return self._translate_column_coordinates_str(coord)\n        return self._translate_column_coordinates_list(coord)\n\n    def _translate_cell_coordinates(\n        self,\n        coord: tuple | list | str,\n    ) -&gt; tuple[int | None, int | None]:\n        # we want an x,y result\n        coord = convert_coordinates(coord)\n        if len(coord) == 2:\n            x, y = coord\n        # If we got an area, take the first cell\n        elif len(coord) == 4:\n            x, y, z, t = coord\n        else:\n            raise ValueError(str(coord))\n        if x and x &lt; 0:\n            x = increment(x, self.width)\n        if y and y &lt; 0:\n            y = increment(y, self.height)\n        return (x, y)\n\n    def _compute_table_cache(self) -&gt; None:\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_row, \"table:number-rows-repeated\"\n        )\n        self._tmap = make_cache_map(idx_repeated_seq)\n        idx_repeated_seq = self.elements_repeated_sequence(\n            _xpath_column, \"table:number-columns-repeated\"\n        )\n        self._cmap = make_cache_map(idx_repeated_seq)\n\n    def _update_width(self, row: Row) -&gt; None:\n        \"\"\"Synchronize the number of columns if the row is bigger.\n\n        Append, don't insert, not to disturb the current layout.\n        \"\"\"\n        diff = row.width - self.width\n        if diff &gt; 0:\n            self.append_column(Column(repeated=diff))\n\n    def _get_formatted_text_normal(self, context: dict | None) -&gt; str:\n        result = []\n        for row in self.traverse():\n            for cell in row.traverse():\n                value = cell.get_value(try_get_text=False)\n                # None ?\n                if value is None:\n                    # Try with get_formatted_text on the elements\n                    value = []\n                    for element in cell.children:\n                        value.append(element.get_formatted_text(context))\n                    value = \"\".join(value)\n                else:\n                    value = str(value)\n                result.append(value)\n                result.append(\"\\n\")\n            result.append(\"\\n\")\n        return \"\".join(result)\n\n    def _get_formatted_text_rst(self, context: dict) -&gt; str:  # noqa: C901\n        context[\"no_img_level\"] += 1\n        # Strip the table =&gt; We must clone\n        table = self.clone\n        table.rstrip(aggressive=True)  # type: ignore\n\n        # Fill the rows\n        rows = []\n        cols_nb = 0\n        cols_size: dict[int, int] = {}\n        for odf_row in table.traverse():  # type: ignore\n            row = []\n            for i, cell in enumerate(odf_row.traverse()):\n                value = cell.get_value(try_get_text=False)\n                # None ?\n                if value is None:\n                    # Try with get_formatted_text on the elements\n                    value = []\n                    for element in cell.children:\n                        value.append(element.get_formatted_text(context))\n                    value = \"\".join(value)\n                else:\n                    value = str(value)\n                value = value.strip()\n                # Strip the empty columns\n                if value:\n                    cols_nb = max(cols_nb, i + 1)\n                # Compute the size of each columns (at least 2)\n                cols_size[i] = max(cols_size.get(i, 2), len(value))\n                # Append\n                row.append(value)\n            rows.append(row)\n\n        # Nothing ?\n        if cols_nb == 0:\n            return \"\"\n\n        # Prevent a crash with empty columns (by example with images)\n        for col, size in cols_size.items():\n            if size == 0:\n                cols_size[col] = 1\n\n        # Update cols_size\n        LINE_MAX = 100\n        COL_MIN = 16\n\n        free_size = LINE_MAX - (cols_nb - 1) * 3 - 4\n        real_size = sum([cols_size[i] for i in range(cols_nb)])\n        if real_size &gt; free_size:\n            factor = float(free_size) / real_size\n\n            for i in range(cols_nb):\n                old_size = cols_size[i]\n\n                # The cell is already small\n                if old_size &lt;= COL_MIN:\n                    continue\n\n                new_size = int(factor * old_size)\n\n                if new_size &lt; COL_MIN:\n                    new_size = COL_MIN\n                cols_size[i] = new_size\n\n        # Convert !\n        result: list[str] = [\"\"]\n        # Construct the first/last line\n        line: list[str] = []\n        for i in range(cols_nb):\n            line.append(\"=\" * cols_size[i])\n            line.append(\" \")\n        line_str = \"\".join(line)\n\n        # Add the lines\n        result.append(line_str)\n        for row in rows:\n            # Wrap the row\n            wrapped_row = []\n            for i, value in enumerate(row[:cols_nb]):\n                wrapped_value = []\n                for part in value.split(\"\\n\"):\n                    # Hack to handle correctly the lists or the directives\n                    subsequent_indent = \"\"\n                    part_lstripped = part.lstrip()\n                    if part_lstripped.startswith(\"-\") or part_lstripped.startswith(\n                        \"..\"\n                    ):\n                        subsequent_indent = \" \" * (len(part) - len(part.lstrip()) + 2)\n                    wrapped_part = wrap(\n                        part, width=cols_size[i], subsequent_indent=subsequent_indent\n                    )\n                    if wrapped_part:\n                        wrapped_value.extend(wrapped_part)\n                    else:\n                        wrapped_value.append(\"\")\n                wrapped_row.append(wrapped_value)\n\n            # Append!\n            for j in range(max([1] + [len(values) for values in wrapped_row])):\n                txt_row: list[str] = []\n                for i in range(cols_nb):\n                    values = wrapped_row[i] if i &lt; len(wrapped_row) else []\n\n                    # An empty cell ?\n                    if len(values) - 1 &lt; j or not values[j]:\n                        if i == 0 and j == 0:\n                            txt_row.append(\"..\")\n                            txt_row.append(\" \" * (cols_size[i] - 1))\n                        else:\n                            txt_row.append(\" \" * (cols_size[i] + 1))\n                        continue\n\n                    # Not empty\n                    value = values[j]\n                    txt_row.append(value)\n                    txt_row.append(\" \" * (cols_size[i] - len(value) + 1))\n                result.append(\"\".join(txt_row))\n\n        result.append(line_str)\n        result.append(\"\")\n        result.append(\"\")\n        result_str = \"\\n\".join(result)\n\n        context[\"no_img_level\"] -= 1\n        return result_str\n\n    def _translate_x_from_any(self, x: str | int) -&gt; int:\n        return translate_from_any(x, self.width, 0)\n\n    #\n    # Public API\n    #\n\n    def append(self, something: Element | str) -&gt; None:\n        \"\"\"Dispatch .append() call to append_row() or append_column().\"\"\"\n        if isinstance(something, Row):\n            self.append_row(something)\n        elif isinstance(something, Column):\n            self.append_column(something)\n        else:\n            # probably still an error\n            self._append(something)\n\n    @property\n    def height(self) -&gt; int:\n        \"\"\"Get the current height of the table.\n\n        Return: int\n        \"\"\"\n        try:\n            height = self._tmap[-1] + 1\n        except Exception:\n            height = 0\n        return height\n\n    @property\n    def width(self) -&gt; int:\n        \"\"\"Get the current width of the table, measured on columns.\n\n        Rows may have different widths, use the Table API to ensure width\n        consistency.\n\n        Return: int\n        \"\"\"\n        # Columns are our reference for user expected width\n\n        try:\n            width = self._cmap[-1] + 1\n        except Exception:\n            width = 0\n\n        # columns = self._get_columns()\n        # repeated = self.xpath(\n        #        'table:table-column/@table:number-columns-repeated')\n        # unrepeated = len(columns) - len(repeated)\n        # ws = sum(int(r) for r in repeated) + unrepeated\n        # if w != ws:\n        #    print \"WARNING   ws\", ws, \"w\", w\n\n        return width\n\n    @property\n    def size(self) -&gt; tuple[int, int]:\n        \"\"\"Shortcut to get the current width and height of the table.\n\n        Return: (int, int)\n        \"\"\"\n        return self.width, self.height\n\n    @property\n    def name(self) -&gt; str | None:\n        \"\"\"Get / set the name of the table.\"\"\"\n        return self.get_attribute_string(\"table:name\")\n\n    @name.setter\n    def name(self, name: str) -&gt; None:\n        name = _table_name_check(name)\n        # first, update named ranges\n        # fixme : delete name ranges when deleting table, too.\n        for named_range in self.get_named_ranges(table_name=self.name):\n            named_range.set_table_name(name)\n        self.set_attribute(\"table:name\", name)\n\n    @property\n    def protected(self) -&gt; bool:\n        return bool(self.get_attribute(\"table:protected\"))\n\n    @protected.setter\n    def protected(self, protect: bool) -&gt; None:\n        self.set_attribute(\"table:protected\", protect)\n\n    @property\n    def protection_key(self) -&gt; str | None:\n        return self.get_attribute_string(\"table:protection-key\")\n\n    @protection_key.setter\n    def protection_key(self, key: str) -&gt; None:\n        self.set_attribute(\"table:protection-key\", key)\n\n    @property\n    def displayed(self) -&gt; bool:\n        return bool(self.get_attribute(\"table:display\"))\n\n    @displayed.setter\n    def displayed(self, display: bool) -&gt; None:\n        self.set_attribute(\"table:display\", display)\n\n    @property\n    def printable(self) -&gt; bool:\n        printable = self.get_attribute(\"table:print\")\n        # Default value\n        if printable is None:\n            return True\n        return bool(printable)\n\n    @printable.setter\n    def printable(self, printable: bool) -&gt; None:\n        self.set_attribute(\"table:print\", printable)\n\n    @property\n    def print_ranges(self) -&gt; list[str]:\n        ranges = self.get_attribute_string(\"table:print-ranges\")\n        if isinstance(ranges, str):\n            return ranges.split()\n        return []\n\n    @print_ranges.setter\n    def print_ranges(self, ranges: list[str] | None) -&gt; None:\n        if isinstance(ranges, (list, tuple)):\n            self.set_attribute(\"table:print-ranges\", \" \".join(ranges))\n        else:\n            self.set_attribute(\"table:print-ranges\", ranges)\n\n    @property\n    def style(self) -&gt; str | None:\n        \"\"\"Get / set the style of the table\n\n        Return: str\n        \"\"\"\n        return self.get_attribute_string(\"table:style-name\")\n\n    @style.setter\n    def style(self, style: str | Element) -&gt; None:\n        self.set_style_attribute(\"table:style-name\", style)\n\n    def get_formatted_text(self, context: dict | None = None) -&gt; str:\n        if context and context[\"rst_mode\"]:\n            return self._get_formatted_text_rst(context)\n        return self._get_formatted_text_normal(context)\n\n    def get_values(\n        self,\n        coord: tuple | list | str | None = None,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n        flat: bool = False,\n    ) -&gt; list:\n        \"\"\"Get a matrix of values of the table.\n\n        Filter by coordinates will parse the area defined by the coordinates.\n\n        If 'cell_type' is used and 'complete' is True (default), missing values\n        are replaced by None.\n        Filter by ' cell_type = \"all\" ' will retrieve cells of any\n        type, aka non empty cells.\n\n        If 'cell_type' is None, complete is always True : with no cell type\n        queried, get_values() returns None for each empty cell, the length\n        each lists is equal to the width of the table.\n\n        If get_type is True, returns tuples (value, ODF type of value), or\n        (None, None) for empty cells with complete True.\n\n        If flat is True, the methods return a single list of all the values.\n        By default, flat is False.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of area\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of lists of Python types\n        \"\"\"\n        if coord:\n            x, y, z, t = self._translate_table_coordinates(coord)\n        else:\n            x = y = z = t = None\n        data = []\n        for row in self.traverse(start=y, end=t):\n            if z is None:\n                width = self.width\n            else:\n                width = min(z + 1, self.width)\n            if x is not None:\n                width -= x\n            values = row.get_values(\n                (x, z),\n                cell_type=cell_type,\n                complete=complete,\n                get_type=get_type,\n            )\n            # complete row to match request width\n            if complete:\n                if get_type:\n                    values.extend([(None, None)] * (width - len(values)))\n                else:\n                    values.extend([None] * (width - len(values)))\n            if flat:\n                data.extend(values)\n            else:\n                data.append(values)\n        return data\n\n    def iter_values(\n        self,\n        coord: tuple | list | str | None = None,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n    ) -&gt; Iterator[list]:\n        \"\"\"Iterate through lines of Python values of the table.\n\n        Filter by coordinates will parse the area defined by the coordinates.\n\n        cell_type, complete, grt_type : see get_values()\n\n\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of area\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: iterator of lists\n        \"\"\"\n        if coord:\n            x, y, z, t = self._translate_table_coordinates(coord)\n        else:\n            x = y = z = t = None\n        for row in self.traverse(start=y, end=t):\n            if z is None:\n                width = self.width\n            else:\n                width = min(z + 1, self.width)\n            if x is not None:\n                width -= x\n            values = row.get_values(\n                (x, z),\n                cell_type=cell_type,\n                complete=complete,\n                get_type=get_type,\n            )\n            # complete row to match column width\n            if complete:\n                if get_type:\n                    values.extend([(None, None)] * (width - len(values)))\n                else:\n                    values.extend([None] * (width - len(values)))\n            yield values\n\n    def set_values(\n        self,\n        values: list,\n        coord: tuple | list | str | None = None,\n        style: str | None = None,\n        cell_type: str | None = None,\n        currency: str | None = None,\n    ) -&gt; None:\n        \"\"\"Set the value of cells in the table, from the 'coord' position\n        with values.\n\n        'coord' is the coordinate of the upper left cell to be modified by\n        values. If 'coord' is None, default to the position (0,0) (\"A1\").\n        If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n        area is used as coordinate.\n\n        The table is *not* cleared before the operation, to reset the table\n        before setting values, use table.clear().\n\n        A list of lists is expected, with as many lists as rows, and as many\n        items in each sublist as cells to be setted. None values in the list\n        will create empty cells with no cell type (but eventually a style).\n\n        Arguments:\n\n            coord -- tuple or str\n\n            values -- list of lists of python types\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n        \"\"\"\n        if coord:\n            x, y = self._translate_cell_coordinates(coord)\n        else:\n            x = y = 0\n        if y is None:\n            y = 0\n        if x is None:\n            x = 0\n        y -= 1\n        for row_values in values:\n            y += 1\n            if not row_values:\n                continue\n            row = self.get_row(y, clone=True)\n            repeated = row.repeated or 1\n            if repeated &gt;= 2:\n                row.repeated = None\n            row.set_values(\n                row_values,\n                start=x,\n                cell_type=cell_type,\n                currency=currency,\n                style=style,\n            )\n            self.set_row(y, row, clone=False)\n            self._update_width(row)\n\n    def rstrip(self, aggressive: bool = False) -&gt; None:\n        \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n        the table. Cells are empty if they contain no value or it evaluates\n        to False, and no style.\n\n        If aggressive is True, empty cells with style are removed too.\n\n        Argument:\n\n            aggressive -- bool\n        \"\"\"\n        # Step 1: remove empty rows below the table\n        for row in reversed(self._get_rows()):\n            if row.is_empty(aggressive=aggressive):\n                row.parent.delete(row)  # type: ignore\n            else:\n                break\n        # Step 2: rstrip remaining rows\n        max_width = 0\n        for row in self._get_rows():\n            row.rstrip(aggressive=aggressive)\n            # keep count of the biggest row\n            max_width = max(max_width, row.width)\n        # raz cache of rows\n        self._indexes[\"_tmap\"] = {}\n        # Step 3: trim columns to match max_width\n        columns = self._get_columns()\n        repeated_cols = self.xpath(\"table:table-column/@table:number-columns-repeated\")\n        if not isinstance(repeated_cols, list):\n            raise TypeError\n        unrepeated = len(columns) - len(repeated_cols)\n        column_width = sum(int(r) for r in repeated_cols) + unrepeated  # type: ignore\n        diff = column_width - max_width\n        if diff &gt; 0:\n            for column in reversed(columns):\n                repeated = column.repeated or 1\n                repeated = repeated - diff\n                if repeated &gt; 0:\n                    column.repeated = repeated\n                    break\n                else:\n                    column.parent.delete(column)\n                    diff = -repeated\n                    if diff == 0:\n                        break\n        # raz cache of columns\n        self._indexes[\"_cmap\"] = {}\n        self._compute_table_cache()\n\n    def optimize_width(self) -&gt; None:\n        \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n        the table. Keep repeated styles of empty cells but minimize row width.\n        \"\"\"\n        self._optimize_width_trim_rows()\n        width = self._optimize_width_length()\n        self._optimize_width_rstrip_rows(width)\n        self._optimize_width_adapt_columns(width)\n\n    def _optimize_width_trim_rows(self) -&gt; None:\n        count = -1  # to keep one empty row\n        for row in reversed(self._get_rows()):\n            if row.is_empty(aggressive=False):\n                count += 1\n            else:\n                break\n        if count &gt; 0:\n            for row in reversed(self._get_rows()):\n                row.parent.delete(row)  # type: ignore\n                count -= 1\n                if count &lt;= 0:\n                    break\n        try:\n            last_row = self._get_rows()[-1]\n            last_row._set_repeated(None)\n        except IndexError:\n            pass\n        # raz cache of rows\n        self._indexes[\"_tmap\"] = {}\n\n    def _optimize_width_length(self) -&gt; int:\n        return max(row.minimized_width() for row in self._get_rows())\n\n    def _optimize_width_rstrip_rows(self, width: int) -&gt; None:\n        for row in self._get_rows():\n            row.force_width(width)\n\n    def _optimize_width_adapt_columns(self, width: int) -&gt; None:\n        # trim columns to match minimal_width\n        columns = self._get_columns()\n        repeated_cols = self.xpath(\"table:table-column/@table:number-columns-repeated\")\n        if not isinstance(repeated_cols, list):\n            raise TypeError\n        unrepeated = len(columns) - len(repeated_cols)\n        column_width = sum(int(r) for r in repeated_cols) + unrepeated  # type: ignore\n        diff = column_width - width\n        if diff &gt; 0:\n            for column in reversed(columns):\n                repeated = column.repeated or 1\n                repeated = repeated - diff\n                if repeated &gt; 0:\n                    column.repeated = repeated\n                    break\n                else:\n                    column.parent.delete(column)\n                    diff = -repeated\n                    if diff == 0:\n                        break\n        # raz cache of columns\n        self._indexes[\"_cmap\"] = {}\n        self._compute_table_cache()\n\n    def transpose(self, coord: tuple | list | str | None = None) -&gt; None:  # noqa: C901\n        \"\"\"Swap *in-place* rows and columns of the table.\n\n        If 'coord' is not None, apply transpose only to the area defined by the\n        coordinates. Beware, if area is not square, some cells mays be over\n        written during the process.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of area\n\n            start -- int or str\n        \"\"\"\n        data = []\n        if coord is None:\n            for row in self.traverse():\n                data.append(list(row.traverse()))\n            transposed_data = zip_longest(*data)\n            self.clear()\n            # new_rows = []\n            for row_cells in transposed_data:\n                if not isiterable(row_cells):\n                    row_cells = (row_cells,)\n                row = Row()\n                row.extend_cells(row_cells)\n                self.append_row(row, clone=False)\n            self._compute_table_cache()\n        else:\n            x, y, z, t = self._translate_table_coordinates(coord)\n            if x is None:\n                x = 0\n            else:\n                x = min(x, self.width - 1)\n            if z is None:\n                z = self.width - 1\n            else:\n                z = min(z, self.width - 1)\n            if y is None:\n                y = 0\n            else:\n                y = min(y, self.height - 1)\n            if t is None:\n                t = self.height - 1\n            else:\n                t = min(t, self.height - 1)\n            for row in self.traverse(start=y, end=t):\n                data.append(list(row.traverse(start=x, end=z)))\n            transposed_data = zip_longest(*data)\n            # clear locally\n            w = z - x + 1\n            h = t - y + 1\n            if w != h:\n                nones = [[None] * w for i in range(h)]\n                self.set_values(nones, coord=(x, y, z, t))\n            # put transposed\n            filtered_data: list[tuple[Cell]] = []\n            for row_cells in transposed_data:\n                if isinstance(row_cells, (list, tuple)):\n                    filtered_data.append(row_cells)\n                else:\n                    filtered_data.append((row_cells,))\n            self.set_cells(filtered_data, (x, y, x + h - 1, y + w - 1))\n            self._compute_table_cache()\n\n    def is_empty(self, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return whether every cell in the table has no value or the value\n        evaluates to False (empty string), and no style.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            aggressive -- bool\n        \"\"\"\n        return all(row.is_empty(aggressive=aggressive) for row in self._get_rows())\n\n    #\n    # Rows\n    #\n\n    def _get_rows(self) -&gt; list[Row]:\n        return self.get_elements(_xpath_row)  # type: ignore\n\n    def traverse(  # noqa: C901\n        self,\n        start: int | None = None,\n        end: int | None = None,\n    ) -&gt; Iterator[Row]:\n        \"\"\"Yield as many row elements as expected rows in the table, i.e.\n        expand repetitions by returning the same row as many times as\n        necessary.\n\n            Arguments:\n\n                start -- int\n\n                end -- int\n\n        Copies are returned, use set_row() to push them back.\n        \"\"\"\n        idx = -1\n        before = -1\n        y = 0\n        if start is None and end is None:\n            for juska in self._tmap:\n                idx += 1\n                if idx in self._indexes[\"_tmap\"]:\n                    row = self._indexes[\"_tmap\"][idx]\n                else:\n                    row = self._get_element_idx2(_xpath_row_idx, idx)\n                    self._indexes[\"_tmap\"][idx] = row\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    # Return a copy without the now obsolete repetition\n                    row = row.clone\n                    row.y = y\n                    y += 1\n                    if repeated &gt; 1:\n                        row.repeated = None\n                    yield row\n        else:\n            if start is None:\n                start = 0\n            start = max(0, start)\n            if end is None:\n                try:\n                    end = self._tmap[-1]\n                except Exception:\n                    end = -1\n            start_map = find_odf_idx(self._tmap, start)\n            if start_map is None:\n                return\n            if start_map &gt; 0:\n                before = self._tmap[start_map - 1]\n            idx = start_map - 1\n            before = start - 1\n            y = start\n            for juska in self._tmap[start_map:]:\n                idx += 1\n                if idx in self._indexes[\"_tmap\"]:\n                    row = self._indexes[\"_tmap\"][idx]\n                else:\n                    row = self._get_element_idx2(_xpath_row_idx, idx)\n                    self._indexes[\"_tmap\"][idx] = row\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    if y &lt;= end:\n                        row = row.clone\n                        row.y = y\n                        y += 1\n                        if repeated &gt; 1 or (y == start and start &gt; 0):\n                            row.repeated = None\n                        yield row\n\n    def get_rows(\n        self,\n        coord: tuple | list | str | None = None,\n        style: str | None = None,\n        content: str | None = None,\n    ) -&gt; list[Row]:\n        \"\"\"Get the list of rows matching the criteria.\n\n        Filter by coordinates will parse the area defined by the coordinates.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of rows\n\n            content -- str regex\n\n            style -- str\n\n        Return: list of rows\n        \"\"\"\n        if coord:\n            _x, y, _z, t = self._translate_table_coordinates(coord)\n        else:\n            y = t = None\n        # fixme : not clones ?\n        if not content and not style:\n            return list(self.traverse(start=y, end=t))\n        rows = []\n        for row in self.traverse(start=y, end=t):\n            if content and not row.match(content):\n                continue\n            if style and style != row.style:\n                continue\n            rows.append(row)\n        return rows\n\n    @property\n    def rows(self) -&gt; list[Row]:\n        \"\"\"Get the list of all rows.\n\n        Return: list of rows\n        \"\"\"\n        # fixme : not clones ?\n        return list(self.traverse())\n\n    def _get_row2(self, y: int, clone: bool = True, create: bool = True) -&gt; Row:\n        if y &gt;= self.height:\n            if create:\n                return Row()\n            raise ValueError(\"Row not found\")\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError(\"Row not found\")\n        if clone:\n            return row.clone\n        return row\n\n    def _get_row2_base(self, y: int) -&gt; Row | None:\n        idx = find_odf_idx(self._tmap, y)\n        if idx is not None:\n            if idx in self._indexes[\"_tmap\"]:\n                row = self._indexes[\"_tmap\"][idx]\n            else:\n                row = self._get_element_idx2(_xpath_row_idx, idx)\n                self._indexes[\"_tmap\"][idx] = row\n            return row\n        return None\n\n    def get_row(self, y: int | str, clone: bool = True, create: bool = True) -&gt; Row:\n        \"\"\"Get the row at the given \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        A copy is returned, use set_cell() to push it back.\n\n        Arguments:\n\n            y -- int or str\n\n        Return: Row\n        \"\"\"\n        # fixme : keep repeat ? maybe an option to functions : \"raw=False\"\n        y = self._translate_y_from_any(y)\n        row = self._get_row2(y, clone=clone, create=create)\n        if row is None:\n            raise ValueError(\"Row not found\")\n        row.y = y\n        return row\n\n    def set_row(self, y: int | str, row: Row | None = None, clone: bool = True) -&gt; Row:\n        \"\"\"Replace the row at the given position with the new one. Repetions of\n        the old row will be adjusted.\n\n        If row is None, a new empty row is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n\n            row -- Row\n\n        returns the row, with updated row.y\n        \"\"\"\n        if row is None:\n            row = Row()\n            repeated = 1\n            clone = False\n        else:\n            repeated = row.repeated or 1\n        y = self._translate_y_from_any(y)\n        row.y = y\n        # Outside the defined table ?\n        diff = y - self.height\n        if diff == 0:\n            row_back = self.append_row(row, _repeated=repeated, clone=clone)\n        elif diff &gt; 0:\n            self.append_row(Row(repeated=diff), _repeated=diff, clone=clone)\n            row_back = self.append_row(row, _repeated=repeated, clone=clone)\n        else:\n            # Inside the defined table\n            row_back = set_item_in_vault(  # type: ignore\n                y, row, self, _xpath_row_idx, \"_tmap\", clone=clone\n            )\n        # print self.serialize(True)\n        # Update width if necessary\n        self._update_width(row_back)\n        return row_back\n\n    def insert_row(\n        self, y: str | int, row: Row | None = None, clone: bool = True\n    ) -&gt; Row:\n        \"\"\"Insert the row before the given \"y\" position. If no row is given,\n        an empty one is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        If row is None, a new empty row is created.\n\n        Arguments:\n\n            y -- int or str\n\n            row -- Row\n\n        returns the row, with updated row.y\n        \"\"\"\n        if row is None:\n            row = Row()\n            clone = False\n        y = self._translate_y_from_any(y)\n        diff = y - self.height\n        if diff &lt; 0:\n            row_back = insert_item_in_vault(y, row, self, _xpath_row_idx, \"_tmap\")\n        elif diff == 0:\n            row_back = self.append_row(row, clone=clone)\n        else:\n            self.append_row(Row(repeated=diff), _repeated=diff, clone=False)\n            row_back = self.append_row(row, clone=clone)\n        row_back.y = y  # type: ignore\n        # Update width if necessary\n        self._update_width(row_back)  # type: ignore\n        return row_back  # type: ignore\n\n    def extend_rows(self, rows: list[Row] | None = None) -&gt; None:\n        \"\"\"Append a list of rows at the end of the table.\n\n        Arguments:\n\n            rows -- list of Row\n        \"\"\"\n        if rows is None:\n            rows = []\n        self.extend(rows)\n        self._compute_table_cache()\n        # Update width if necessary\n        width = self.width\n        for row in self.traverse():\n            if row.width &gt; width:\n                width = row.width\n        diff = width - self.width\n        if diff &gt; 0:\n            self.append_column(Column(repeated=diff))\n\n    def append_row(\n        self,\n        row: Row | None = None,\n        clone: bool = True,\n        _repeated: int | None = None,\n    ) -&gt; Row:\n        \"\"\"Append the row at the end of the table. If no row is given, an\n        empty one is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Note the columns are automatically created when the first row is\n        inserted in an empty table. So better insert a filled row.\n\n        Arguments:\n\n            row -- Row\n\n            _repeated -- (optional), repeated value of the row\n\n        returns the row, with updated row.y\n        \"\"\"\n        if row is None:\n            row = Row()\n            _repeated = 1\n        elif clone:\n            row = row.clone\n        # Appending a repeated row accepted\n        # Do not insert next to the last row because it could be in a group\n        self._append(row)\n        if _repeated is None:\n            _repeated = row.repeated or 1\n        self._tmap = insert_map_once(self._tmap, len(self._tmap), _repeated)\n        row.y = self.height - 1\n        # Initialize columns\n        if not self._get_columns():\n            repeated = row.width\n            self.insert(Column(repeated=repeated), position=0)\n            self._compute_table_cache()\n        # Update width if necessary\n        self._update_width(row)\n        return row\n\n    def delete_row(self, y: int | str) -&gt; None:\n        \"\"\"Delete the row at the given \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n        \"\"\"\n        y = self._translate_y_from_any(y)\n        # Outside the defined table\n        if y &gt;= self.height:\n            return\n        # Inside the defined table\n        delete_item_in_vault(y, self, _xpath_row_idx, \"_tmap\")\n\n    def get_row_values(\n        self,\n        y: int | str,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n    ) -&gt; list:\n        \"\"\"Shortcut to get the list of Python values for the cells of the row\n        at the given \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n        If cell_type and complete is True, replace missing values by None.\n\n        If get_type is True, returns a tuple (value, ODF type of value)\n\n        Arguments:\n\n            y -- int, str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of lists of Python types\n        \"\"\"\n        values = self.get_row(y, clone=False).get_values(\n            cell_type=cell_type, complete=complete, get_type=get_type\n        )\n        # complete row to match column width\n        if complete:\n            if get_type:\n                values.extend([(None, None)] * (self.width - len(values)))\n            else:\n                values.extend([None] * (self.width - len(values)))\n        return values\n\n    def set_row_values(\n        self,\n        y: int | str,\n        values: list,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; Row:\n        \"\"\"Shortcut to set the values of *all* cells of the row at the given\n        \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n\n            values -- list of Python types\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n\n        returns the row, with updated row.y\n        \"\"\"\n        row = Row()  # needed if clones rows\n        row.set_values(values, style=style, cell_type=cell_type, currency=currency)\n        return self.set_row(y, row)  # needed if clones rows\n\n    def set_row_cells(self, y: int | str, cells: list | None = None) -&gt; Row:\n        \"\"\"Shortcut to set *all* the cells of the row at the given\n        \"y\" position.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Arguments:\n\n            y -- int or str\n\n            cells -- list of Python types\n\n            style -- str\n\n        returns the row, with updated row.y\n        \"\"\"\n        if cells is None:\n            cells = []\n        row = Row()  # needed if clones rows\n        row.extend_cells(cells)\n        return self.set_row(y, row)  # needed if clones rows\n\n    def is_row_empty(self, y: int | str, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return wether every cell in the row at the given \"y\" position has\n        no value or the value evaluates to False (empty string), and no style.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Arguments:\n\n            y -- int or str\n\n            aggressive -- bool\n        \"\"\"\n        return self.get_row(y, clone=False).is_empty(aggressive=aggressive)\n\n    #\n    # Cells\n    #\n\n    def get_cells(\n        self,\n        coord: tuple | list | str | None = None,\n        cell_type: str | None = None,\n        style: str | None = None,\n        content: str | None = None,\n        flat: bool = False,\n    ) -&gt; list:\n        \"\"\"Get the cells matching the criteria. If 'coord' is None,\n        parse the whole table, else parse the area defined by 'coord'.\n\n        Filter by  cell_type = \"all\"  will retrieve cells of any\n        type, aka non empty cells.\n\n        If flat is True (default is False), the method return a single list\n        of all the values, else a list of lists of cells.\n\n        if cell_type, style and content are None, get_cells() will return\n        the exact number of cells of the area, including empty cells.\n\n        Arguments:\n\n            coordinates -- str or tuple of int : coordinates of area\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            content -- str regex\n\n            style -- str\n\n            flat -- boolean\n\n        Return: list of list of Cell\n        \"\"\"\n        if coord:\n            x, y, z, t = self._translate_table_coordinates(coord)\n        else:\n            x = y = z = t = None\n        if flat:\n            cells: list[Cell] = []\n            for row in self.traverse(start=y, end=t):\n                row_cells = row.get_cells(\n                    coord=(x, z),\n                    cell_type=cell_type,\n                    style=style,\n                    content=content,\n                )\n                cells.extend(row_cells)\n            return cells\n        else:\n            lcells: list[list[Cell]] = []\n            for row in self.traverse(start=y, end=t):\n                row_cells = row.get_cells(\n                    coord=(x, z),\n                    cell_type=cell_type,\n                    style=style,\n                    content=content,\n                )\n                lcells.append(row_cells)\n            return lcells\n\n    @property\n    def cells(self) -&gt; list:\n        \"\"\"Get all cells of the table.\n\n        Return: list of list of Cell\n        \"\"\"\n        lcells: list[list[Cell]] = []\n        for row in self.traverse():\n            lcells.append(row.cells)\n        return lcells\n\n    def get_cell(\n        self,\n        coord: tuple | list | str,\n        clone: bool = True,\n        keep_repeated: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Get the cell at the given coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        A copy is returned, use ``set_cell`` to push it back.\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n        Return: Cell\n        \"\"\"\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        # Outside the defined table\n        if y &gt;= self.height:\n            cell = Cell()\n        else:\n            # Inside the defined table\n            row = self._get_row2_base(y)\n            if row is None:\n                raise ValueError\n            read_cell = row.get_cell(x, clone=clone)\n            if read_cell is None:\n                raise ValueError\n            cell = read_cell\n            if not keep_repeated:\n                repeated = cell.repeated or 1\n                if repeated &gt;= 2:\n                    cell.repeated = None\n        cell.x = x\n        cell.y = y\n        return cell\n\n    def get_value(\n        self,\n        coord: tuple | list | str,\n        get_type: bool = False,\n    ) -&gt; Any:\n        \"\"\"Shortcut to get the Python value of the cell at the given\n        coordinates.\n\n        If get_type is True, returns the tuples (value, ODF type)\n\n        coord is either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\". If an Area is given, the upper\n        left position is used as coord.\n\n        Arguments:\n\n            coord -- (int, int) or str : coordinate\n\n        Return: Python type\n        \"\"\"\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        # Outside the defined table\n        if y &gt;= self.height:\n            if get_type:\n                return (None, None)\n            return None\n        else:\n            # Inside the defined table\n            row = self._get_row2_base(y)\n            if row is None:\n                raise ValueError\n            cell = row._get_cell2_base(x)\n            if cell is None:\n                if get_type:\n                    return (None, None)\n                return None\n            return cell.get_value(get_type=get_type)\n\n    def set_cell(\n        self,\n        coord: tuple | list | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Replace a cell of the table at the given coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Arguments:\n\n            coord -- (int, int) or str : coordinate\n\n            cell -- Cell\n\n        return the cell, with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        cell.x = x\n        cell.y = y\n        if y &gt;= self.height:\n            row = Row()\n            cell_back = row.set_cell(x, cell, clone=clone)\n            self.set_row(y, row, clone=False)\n        else:\n            row_read = self._get_row2_base(y)\n            if row_read is None:\n                raise ValueError\n            row = row_read\n            row.y = y\n            repeated = row.repeated or 1\n            if repeated &gt; 1:\n                row = row.clone\n                row.repeated = None\n                cell_back = row.set_cell(x, cell, clone=clone)\n                self.set_row(y, row, clone=False)\n            else:\n                cell_back = row.set_cell(x, cell, clone=clone)\n                # Update width if necessary, since we don't use set_row\n                self._update_width(row)\n        return cell_back\n\n    def set_cells(\n        self,\n        cells: list[list[Cell]] | list[tuple[Cell]],\n        coord: tuple | list | str | None = None,\n        clone: bool = True,\n    ) -&gt; None:\n        \"\"\"Set the cells in the table, from the 'coord' position.\n\n        'coord' is the coordinate of the upper left cell to be modified by\n        values. If 'coord' is None, default to the position (0,0) (\"A1\").\n        If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n        area is used as coordinate.\n\n        The table is *not* cleared before the operation, to reset the table\n        before setting cells, use table.clear().\n\n        A list of lists is expected, with as many lists as rows to be set, and\n        as many cell in each sublist as cells to be setted in the row.\n\n        Arguments:\n\n            cells -- list of list of cells\n\n            coord -- tuple or str\n\n            values -- list of lists of python types\n        \"\"\"\n        if coord:\n            x, y = self._translate_cell_coordinates(coord)\n        else:\n            x = y = 0\n        if y is None:\n            y = 0\n        if x is None:\n            x = 0\n        y -= 1\n        for row_cells in cells:\n            y += 1\n            if not row_cells:\n                continue\n            row = self.get_row(y, clone=True)\n            repeated = row.repeated or 1\n            if repeated &gt;= 2:\n                row.repeated = None\n            row.set_cells(row_cells, start=x, clone=clone)\n            self.set_row(y, row, clone=False)\n            self._update_width(row)\n\n    def set_value(\n        self,\n        coord: tuple | list | str,\n        value: Any,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; None:\n        \"\"\"Set the Python value of the cell at the given coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n            value -- Python type\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n\n        \"\"\"\n        self.set_cell(\n            coord,\n            Cell(value, cell_type=cell_type, currency=currency, style=style),\n            clone=False,\n        )\n\n    def set_cell_image(\n        self,\n        coord: tuple | list | str,\n        image_frame: Frame,\n        doc_type: str | None = None,\n    ) -&gt; None:\n        \"\"\"Do all the magic to display an image in the cell at the given\n        coordinates.\n\n        They are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        The frame element must contain the expected image position and\n        dimensions.\n\n        DrawImage insertion depends on the document type, so the type must be\n        provided or the table element must be already attached to a document.\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n            image_frame -- Frame including an image\n\n            doc_type -- 'spreadsheet' or 'text'\n        \"\"\"\n        # Test document type\n        if doc_type is None:\n            body = self.document_body\n            if body is None:\n                raise ValueError(\"document type not found\")\n            doc_type = {\"office:spreadsheet\": \"spreadsheet\", \"office:text\": \"text\"}.get(\n                body.tag\n            )\n            if doc_type is None:\n                raise ValueError(\"document type not supported for images\")\n        # We need the end address of the image\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        cell = self.get_cell((x, y))\n        image_frame = image_frame.clone  # type: ignore\n        # Remove any previous paragraph, frame, etc.\n        for child in cell.children:\n            cell.delete(child)\n        # Now it all depends on the document type\n        if doc_type == \"spreadsheet\":\n            image_frame.anchor_type = \"char\"\n            # The frame needs end coordinates\n            width, height = image_frame.size\n            image_frame.set_attribute(\"table:end-x\", width)\n            image_frame.set_attribute(\"table:end-y\", height)\n            # FIXME what happens when the address changes?\n            address = f\"{self.name}.{digit_to_alpha(x)}{y + 1}\"\n            image_frame.set_attribute(\"table:end-cell-address\", address)\n            # The frame is directly in the cell\n            cell.append(image_frame)\n        elif doc_type == \"text\":\n            # The frame must be in a paragraph\n            cell.set_value(\"\")\n            paragraph = cell.get_element(\"text:p\")\n            if paragraph is None:\n                raise ValueError\n            paragraph.append(image_frame)\n        self.set_cell(coord, cell)\n\n    def insert_cell(\n        self,\n        coord: tuple | list | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Insert the given cell at the given coordinates. If no cell is\n        given, an empty one is created.\n\n        Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Cells on the right are shifted. Other rows remain untouched.\n\n        Arguments:\n\n            coord -- (int, int) or str\n\n            cell -- Cell\n\n        returns the cell with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        if clone:\n            cell = cell.clone\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        row = self._get_row2(y, clone=True)\n        row.y = y\n        row.repeated = None\n        cell_back = row.insert_cell(x, cell, clone=False)\n        self.set_row(y, row, clone=False)\n        # Update width if necessary\n        self._update_width(row)\n        return cell_back\n\n    def append_cell(\n        self,\n        y: int | str,\n        cell: Cell | None = None,\n        clone: bool = True,\n    ) -&gt; Cell:\n        \"\"\"Append the given cell at the \"y\" coordinate. Repeated cells are\n        accepted. If no cell is given, an empty one is created.\n\n        Position start at 0. So cell A4 is on row 3.\n\n        Other rows remain untouched.\n\n        Arguments:\n\n            y -- int or str\n\n            cell -- Cell\n\n        returns the cell with x and y updated\n        \"\"\"\n        if cell is None:\n            cell = Cell()\n            clone = False\n        if clone:\n            cell = cell.clone\n        y = self._translate_y_from_any(y)\n        row = self._get_row2(y)\n        row.y = y\n        cell_back = row.append_cell(cell, clone=False)\n        self.set_row(y, row)\n        # Update width if necessary\n        self._update_width(row)\n        return cell_back\n\n    def delete_cell(self, coord: tuple | list | str) -&gt; None:\n        \"\"\"Delete the cell at the given coordinates, so that next cells are\n        shifted to the left.\n\n        Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n        human-readable position like \"C4\".\n\n        Use set_value() for erasing value.\n\n        Arguments:\n\n            coord -- (int, int) or str\n        \"\"\"\n        x, y = self._translate_cell_coordinates(coord)\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        # Outside the defined table\n        if y &gt;= self.height:\n            return\n        # Inside the defined table\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError\n        row.delete_cell(x)\n        # self.set_row(y, row)\n\n    # Columns\n\n    def _get_columns(self) -&gt; list:\n        return self.get_elements(_xpath_column)\n\n    def traverse_columns(  # noqa: C901\n        self,\n        start: int | None = None,\n        end: int | None = None,\n    ) -&gt; Iterator[Column]:\n        \"\"\"Yield as many column elements as expected columns in the table,\n        i.e. expand repetitions by returning the same column as many times as\n        necessary.\n\n            Arguments:\n\n                start -- int\n\n                end -- int\n\n        Copies are returned, use set_column() to push them back.\n        \"\"\"\n        idx = -1\n        before = -1\n        x = 0\n        if start is None and end is None:\n            for juska in self._cmap:\n                idx += 1\n                if idx in self._indexes[\"_cmap\"]:\n                    column = self._indexes[\"_cmap\"][idx]\n                else:\n                    column = self._get_element_idx2(_xpath_column_idx, idx)\n                    self._indexes[\"_cmap\"][idx] = column\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    # Return a copy without the now obsolete repetition\n                    column = column.clone\n                    column.x = x\n                    x += 1\n                    if repeated &gt; 1:\n                        column.repeated = None\n                    yield column\n        else:\n            if start is None:\n                start = 0\n            start = max(0, start)\n            if end is None:\n                try:\n                    end = self._cmap[-1]\n                except Exception:\n                    end = -1\n            start_map = find_odf_idx(self._cmap, start)\n            if start_map is None:\n                return\n            if start_map &gt; 0:\n                before = self._cmap[start_map - 1]\n            idx = start_map - 1\n            before = start - 1\n            x = start\n            for juska in self._cmap[start_map:]:\n                idx += 1\n                if idx in self._indexes[\"_cmap\"]:\n                    column = self._indexes[\"_cmap\"][idx]\n                else:\n                    column = self._get_element_idx2(_xpath_column_idx, idx)\n                    self._indexes[\"_cmap\"][idx] = column\n                repeated = juska - before\n                before = juska\n                for _i in range(repeated or 1):\n                    if x &lt;= end:\n                        column = column.clone\n                        column.x = x\n                        x += 1\n                        if repeated &gt; 1 or (x == start and start &gt; 0):\n                            column.repeated = None\n                        yield column\n\n    def get_columns(\n        self,\n        coord: tuple | list | str | None = None,\n        style: str | None = None,\n    ) -&gt; list[Column]:\n        \"\"\"Get the list of columns matching the criteria.\n\n        Copies are returned, use set_column() to push them back.\n\n        Arguments:\n\n            coord -- str or tuple of int : coordinates of columns\n\n            style -- str\n\n        Return: list of columns\n        \"\"\"\n        if coord:\n            x, _y, _z, t = self._translate_column_coordinates(coord)\n        else:\n            x = t = None\n        if not style:\n            return list(self.traverse_columns(start=x, end=t))\n        columns = []\n        for column in self.traverse_columns(start=x, end=t):\n            if style != column.style:\n                continue\n            columns.append(column)\n        return columns\n\n    def _get_column2(self, x: int) -&gt; Column | None:\n        # Outside the defined table\n        if x &gt;= self.width:\n            return Column()\n        # Inside the defined table\n        odf_idx = find_odf_idx(self._cmap, x)\n        if odf_idx is not None:\n            column = self._get_element_idx2(_xpath_column_idx, odf_idx)\n            if column is None:\n                return None\n            # fixme : no clone here =&gt; change doc and unit tests\n            return column.clone  # type: ignore\n            # return row\n        return None\n\n    @property\n    def columns(self) -&gt; list[Column]:\n        \"\"\"Get the list of all columns matching the criteria.\n\n        Copies are returned, use set_column() to push them back.\n\n        Return: list of columns\n        \"\"\"\n        return list(self.traverse_columns())\n\n    def get_column(self, x: int | str) -&gt; Column:\n        \"\"\"Get the column at the given \"x\" position.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        A copy is returned, use set_column() to push it back.\n\n        Arguments:\n\n            x -- int or str\n\n        Return: Column\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        column = self._get_column2(x)\n        if column is None:\n            raise ValueError\n        column.x = x\n        return column\n\n    def set_column(\n        self,\n        x: int | str,\n        column: Column | None = None,\n    ) -&gt; Column:\n        \"\"\"Replace the column at the given \"x\" position.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            x -- int or str\n\n            column -- Column\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        if column is None:\n            column = Column()\n            repeated = 1\n        else:\n            repeated = column.repeated or 1\n        column.x = x\n        # Outside the defined table ?\n        diff = x - self.width\n        if diff == 0:\n            column_back = self.append_column(column, _repeated=repeated)\n        elif diff &gt; 0:\n            self.append_column(Column(repeated=diff), _repeated=diff)\n            column_back = self.append_column(column, _repeated=repeated)\n        else:\n            # Inside the defined table\n            column_back = set_item_in_vault(  # type: ignore\n                x, column, self, _xpath_column_idx, \"_cmap\"\n            )\n        return column_back\n\n    def insert_column(\n        self,\n        x: int | str,\n        column: Column | None = None,\n    ) -&gt; Column:\n        \"\"\"Insert the column before the given \"x\" position. If no column is\n        given, an empty one is created.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            x -- int or str\n\n            column -- Column\n        \"\"\"\n        if column is None:\n            column = Column()\n        x = self._translate_x_from_any(x)\n        diff = x - self.width\n        if diff &lt; 0:\n            column_back = insert_item_in_vault(\n                x, column, self, _xpath_column_idx, \"_cmap\"\n            )\n        elif diff == 0:\n            column_back = self.append_column(column.clone)\n        else:\n            self.append_column(Column(repeated=diff), _repeated=diff)\n            column_back = self.append_column(column.clone)\n        column_back.x = x  # type: ignore\n        # Repetitions are accepted\n        repeated = column.repeated or 1\n        # Update width on every row\n        for row in self._get_rows():\n            if row.width &gt; x:\n                row.insert_cell(x, Cell(repeated=repeated))\n            # Shorter rows don't need insert\n            # Longer rows shouldn't exist!\n        return column_back  # type: ignore\n\n    def append_column(\n        self,\n        column: Column | None = None,\n        _repeated: int | None = None,\n    ) -&gt; Column:\n        \"\"\"Append the column at the end of the table. If no column is given,\n        an empty one is created.\n\n        ODF columns don't contain cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            column -- Column\n        \"\"\"\n        if column is None:\n            column = Column()\n        else:\n            column = column.clone\n        if not self._cmap:\n            position = 0\n        else:\n            odf_idx = len(self._cmap) - 1\n            last_column = self._get_element_idx2(_xpath_column_idx, odf_idx)\n            if last_column is None:\n                raise ValueError\n            position = self.index(last_column) + 1\n        column.x = self.width\n        self.insert(column, position=position)\n        # Repetitions are accepted\n        if _repeated is None:\n            _repeated = column.repeated or 1\n        self._cmap = insert_map_once(self._cmap, len(self._cmap), _repeated)\n        # No need to update row widths\n        return column\n\n    def delete_column(self, x: int | str) -&gt; None:\n        \"\"\"Delete the column at the given position. ODF columns don't contain\n        cells, only style information.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Arguments:\n\n            x -- int or str\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        # Outside the defined table\n        if x &gt;= self.width:\n            return\n        # Inside the defined table\n        delete_item_in_vault(x, self, _xpath_column_idx, \"_cmap\")\n        # Update width\n        width = self.width\n        for row in self._get_rows():\n            if row.width &gt;= width:\n                row.delete_cell(x)\n\n    def get_column_cells(  # noqa: C901\n        self,\n        x: int | str,\n        style: str | None = None,\n        content: str | None = None,\n        cell_type: str | None = None,\n        complete: bool = False,\n    ) -&gt; list[Cell | None]:\n        \"\"\"Get the list of cells at the given position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n\n        If complete is True, replace missing values by None.\n\n        Arguments:\n\n            x -- int or str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            content -- str regex\n\n            style -- str\n\n            complete -- boolean\n\n        Return: list of Cell\n        \"\"\"\n        x = self._translate_x_from_any(x)\n        if cell_type:\n            cell_type = cell_type.lower().strip()\n        cells: list[Cell | None] = []\n        if not style and not content and not cell_type:\n            for row in self.traverse():\n                cells.append(row.get_cell(x, clone=True))\n            return cells\n        for row in self.traverse():\n            cell = row.get_cell(x, clone=True)\n            if cell is None:\n                raise ValueError\n            # Filter the cells by cell_type\n            if cell_type:\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    if complete:\n                        cells.append(None)\n                    continue\n            # Filter the cells with the regex\n            if content and not cell.match(content):\n                if complete:\n                    cells.append(None)\n                continue\n            # Filter the cells with the style\n            if style and style != cell.style:\n                if complete:\n                    cells.append(None)\n                continue\n            cells.append(cell)\n        return cells\n\n    def get_column_values(\n        self,\n        x: int | str,\n        cell_type: str | None = None,\n        complete: bool = True,\n        get_type: bool = False,\n    ) -&gt; list[Any]:\n        \"\"\"Shortcut to get the list of Python values for the cells at the\n        given position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        Filter by cell_type, with cell_type 'all' will retrieve cells of any\n        type, aka non empty cells.\n        If cell_type and complete is True, replace missing values by None.\n\n        If get_type is True, returns a tuple (value, ODF type of value)\n\n        Arguments:\n\n            x -- int or str\n\n            cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                         'currency', 'percentage' or 'all'\n\n            complete -- boolean\n\n            get_type -- boolean\n\n        Return: list of Python types\n        \"\"\"\n        cells = self.get_column_cells(\n            x, style=None, content=None, cell_type=cell_type, complete=complete\n        )\n        values: list[Any] = []\n        for cell in cells:\n            if cell is None:\n                if complete:\n                    if get_type:\n                        values.append((None, None))\n                    else:\n                        values.append(None)\n                continue\n            if cell_type:\n                ctype = cell.type\n                if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                    if complete:\n                        if get_type:\n                            values.append((None, None))\n                        else:\n                            values.append(None)\n                    continue\n            values.append(cell.get_value(get_type=get_type))\n        return values\n\n    def set_column_cells(self, x: int | str, cells: list[Cell]) -&gt; None:\n        \"\"\"Shortcut to set the list of cells at the given position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        The list must have the same length than the table height.\n\n        Arguments:\n\n            x -- int or str\n\n            cells -- list of Cell\n        \"\"\"\n        height = self.height\n        if len(cells) != height:\n            raise ValueError(f\"col mismatch: {height} cells expected\")\n        cells_iterator = iter(cells)\n        for y, row in enumerate(self.traverse()):\n            row.set_cell(x, next(cells_iterator))\n            self.set_row(y, row)\n\n    def set_column_values(\n        self,\n        x: int | str,\n        values: list,\n        cell_type: str | None = None,\n        currency: str | None = None,\n        style: str | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the list of Python values of cells at the given\n        position.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        The list must have the same length than the table height.\n\n        Arguments:\n\n            x -- int or str\n\n            values -- list of Python types\n\n            cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                         'string' or 'time'\n\n            currency -- three-letter str\n\n            style -- str\n        \"\"\"\n        cells = [\n            Cell(value, cell_type=cell_type, currency=currency, style=style)\n            for value in values\n        ]\n        self.set_column_cells(x, cells)\n\n    def is_column_empty(self, x: int | str, aggressive: bool = False) -&gt; bool:\n        \"\"\"Return wether every cell in the column at \"x\" position has no value\n        or the value evaluates to False (empty string), and no style.\n\n        Position start at 0. So cell C4 is on column 2. Alphabetical position\n        like \"C\" is accepted.\n\n        If aggressive is True, empty cells with style are considered empty.\n\n        Return: bool\n        \"\"\"\n        for cell in self.get_column_cells(x):\n            if cell is None:\n                continue\n            if not cell.is_empty(aggressive=aggressive):\n                return False\n        return True\n\n    # Named Range\n\n    def get_named_ranges(  # type: ignore\n        self,\n        table_name: str | list[str] | None = None,\n    ) -&gt; list[NamedRange]:\n        \"\"\"Returns the list of available Name Ranges of the spreadsheet. If\n        table_name is provided, limits the search to these tables.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            table_names -- str or list of str, names of tables\n\n        Return : list of table_range\n        \"\"\"\n        body = self.document_body\n        if not body:\n            return []\n        all_named_ranges = body.get_named_ranges()\n        if not table_name:\n            return all_named_ranges  # type:ignore\n        filter_ = []\n        if isinstance(table_name, str):\n            filter_.append(table_name)\n        elif isiterable(table_name):\n            filter_.extend(table_name)\n        else:\n            raise ValueError(\n                f\"table_name must be string or Iterable, not {type(table_name)}\"\n            )\n        return [\n            nr for nr in all_named_ranges if nr.table_name in filter_  # type:ignore\n        ]\n\n    def get_named_range(self, name: str) -&gt; NamedRange:\n        \"\"\"Returns the Name Ranges of the specified name. If\n        table_name is provided, limits the search to these tables.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            name -- str, name of the named range object\n\n        Return : NamedRange\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document\")\n        return body.get_named_range(name)  # type: ignore\n\n    def set_named_range(\n        self,\n        name: str,\n        crange: str | tuple | list,\n        table_name: str | None = None,\n        usage: str | None = None,\n    ) -&gt; None:\n        \"\"\"Create a Named Range element and insert it in the document.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            name -- str, name of the named range\n\n            crange -- str or tuple of int, cell or area coordinate\n\n            table_name -- str, name of the table\n\n            uage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n        \"\"\"\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document\")\n        if not name:\n            raise ValueError(\"Name required.\")\n        if table_name is None:\n            table_name = self.name\n        named_range = NamedRange(name, crange, table_name, usage)\n        body.append_named_range(named_range)\n\n    def delete_named_range(self, name: str) -&gt; None:\n        \"\"\"Delete the Named Range of specified name from the spreadsheet.\n        Beware : named ranges are stored at the body level, thus do not call\n        this method on a cloned table.\n\n        Arguments:\n\n            name -- str\n        \"\"\"\n        name = name.strip()\n        if not name:\n            raise ValueError(\"Name required.\")\n        body = self.document_body\n        if not body:\n            raise ValueError(\"Table is not inside a document.\")\n        body.delete_named_range(name)\n\n    #\n    # Cell span\n    #\n\n    def set_span(  # noqa: C901\n        self,\n        area: str | tuple | list,\n        merge: bool = False,\n    ) -&gt; bool:\n        \"\"\"Create a Cell Span : span the first cell of the area on several\n        columns and/or rows.\n        If merge is True, replace text of the cell by the concatenation of\n        existing text in covered cells.\n        Beware : if merge is True, old text is changed, if merge is False\n        (the default), old text in coverd cells is still present but not\n        displayed by most GUI.\n\n        If the area defines only one cell, the set span will do nothing.\n        It is not allowed to apply set span to an area whose one cell already\n        belongs to previous cell span.\n\n        Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n        be provided as an alpha numeric value like \"A1:B2' or a tuple like\n        (0, 0, 1, 1) or (0, 0).\n\n        Arguments:\n\n            area -- str or tuple of int, cell or area coordinate\n\n            merge -- boolean\n        \"\"\"\n        # get area\n        digits = convert_coordinates(area)\n        if len(digits) == 4:\n            x, y, z, t = digits\n        else:\n            x, y = digits\n            z, t = digits\n        start = x, y\n        end = z, t\n        if start == end:\n            # one cell : do nothing\n            return False\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        if z is None:\n            raise ValueError\n        if t is None:\n            raise ValueError\n        # check for previous span\n        good = True\n        # Check boundaries and empty cells : need to crate non existent cells\n        # so don't use get_cells directly, but get_cell\n        cells = []\n        for yy in range(y, t + 1):\n            row_cells = []\n            for xx in range(x, z + 1):\n                row_cells.append(\n                    self.get_cell((xx, yy), clone=True, keep_repeated=False)\n                )\n            cells.append(row_cells)\n        for row in cells:\n            for cell in row:\n                if cell.is_spanned():\n                    good = False\n                    break\n            if not good:\n                break\n        if not good:\n            return False\n        # Check boundaries\n        # if z &gt;= self.width or t &gt;= self.height:\n        #    self.set_cell(coord = end)\n        #    print area, z, t\n        #    cells = self.get_cells((x, y, z, t))\n        #    print cells\n        # do it:\n        if merge:\n            val_list = []\n            for row in cells:\n                for cell in row:\n                    if cell.is_empty(aggressive=True):\n                        continue\n                    val = cell.get_value()\n                    if val is not None:\n                        if isinstance(val, str):\n                            val.strip()\n                        if val != \"\":\n                            val_list.append(val)\n                        cell.clear()\n            if val_list:\n                if len(val_list) == 1:\n                    cells[0][0].set_value(val_list[0])\n                else:\n                    value = \" \".join([str(v) for v in val_list if v])\n                    cells[0][0].set_value(value)\n        cols = z - x + 1\n        cells[0][0].set_attribute(\"table:number-columns-spanned\", str(cols))\n        rows = t - y + 1\n        cells[0][0].set_attribute(\"table:number-rows-spanned\", str(rows))\n        for cell in cells[0][1:]:\n            cell.tag = \"table:covered-table-cell\"\n        for row in cells[1:]:\n            for cell in row:\n                cell.tag = \"table:covered-table-cell\"\n        # replace cells in table\n        self.set_cells(cells, coord=start, clone=False)\n        return True\n\n    def del_span(self, area: str | tuple | list) -&gt; bool:\n        \"\"\"Delete a Cell Span. 'area' is the cell coordiante of the upper left\n        cell of the spanned area.\n\n        Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n        be provided as an alpha numeric value like \"A1:B2' or a tuple like\n        (0, 0, 1, 1) or (0, 0). If an area is provided, the upper left cell\n        is used.\n\n        Arguments:\n\n            area -- str or tuple of int, cell or area coordinate\n        \"\"\"\n        # get area\n        digits = convert_coordinates(area)\n        if len(digits) == 4:\n            x, y, _z, _t = digits\n        else:\n            x, y = digits\n        if x is None:\n            raise ValueError\n        if y is None:\n            raise ValueError\n        start = x, y\n        # check for previous span\n        cell0 = self.get_cell(start)\n        nb_cols = cell0.get_attribute_integer(\"table:number-columns-spanned\")\n        if nb_cols is None:\n            return False\n        nb_rows = cell0.get_attribute_integer(\"table:number-rows-spanned\")\n        if nb_rows is None:\n            return False\n        z = x + nb_cols - 1\n        t = y + nb_rows - 1\n        cells = self.get_cells((x, y, z, t))\n        cells[0][0].del_attribute(\"table:number-columns-spanned\")\n        cells[0][0].del_attribute(\"table:number-rows-spanned\")\n        for cell in cells[0][1:]:\n            cell.tag = \"table:table-cell\"\n        for row in cells[1:]:\n            for cell in row:\n                cell.tag = \"table:table-cell\"\n        # replace cells in table\n        self.set_cells(cells, coord=start, clone=False)\n        return True\n\n    # Utilities\n\n    def to_csv(\n        self,\n        path_or_file: str | Path | None = None,\n        dialect: str = \"excel\",\n    ) -&gt; Any:\n        \"\"\"Write the table as CSV in the file.\n\n        If the file is a string, it is opened as a local path. Else an\n        opened file-like is expected.\n\n        Arguments:\n\n            path_or_file -- str or file-like\n\n            dialect -- str, python csv.dialect, can be 'excel', 'unix'...\n        \"\"\"\n\n        def write_content(csv_writer: object) -&gt; None:\n            for values in self.iter_values():\n                line = []\n                for value in values:\n                    if value is None:\n                        value = \"\"\n                    if isinstance(value, str):\n                        value = value.strip()\n                    line.append(value)\n                csv_writer.writerow(line)  # type: ignore\n\n        out = StringIO(newline=\"\")\n        csv_writer = csv.writer(out, dialect=dialect)\n        write_content(csv_writer)\n        if path_or_file is None:\n            return out.getvalue()\n        path = Path(path_or_file)\n        path.write_text(out.getvalue())\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.Table.cells","title":"<code>cells: list</code>  <code>property</code>","text":"<p>Get all cells of the table.</p> <p>Return: list of list of Cell</p>"},{"location":"reference.html#odfdo.Table.columns","title":"<code>columns: list[Column]</code>  <code>property</code>","text":"<p>Get the list of all columns matching the criteria.</p> <p>Copies are returned, use set_column() to push them back.</p> <p>Return: list of columns</p>"},{"location":"reference.html#odfdo.Table.height","title":"<code>height: int</code>  <code>property</code>","text":"<p>Get the current height of the table.</p> <p>Return: int</p>"},{"location":"reference.html#odfdo.Table.name","title":"<code>name: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the name of the table.</p>"},{"location":"reference.html#odfdo.Table.rows","title":"<code>rows: list[Row]</code>  <code>property</code>","text":"<p>Get the list of all rows.</p> <p>Return: list of rows</p>"},{"location":"reference.html#odfdo.Table.size","title":"<code>size: tuple[int, int]</code>  <code>property</code>","text":"<p>Shortcut to get the current width and height of the table.</p> <p>Return: (int, int)</p>"},{"location":"reference.html#odfdo.Table.style","title":"<code>style: str | None</code>  <code>property</code> <code>writable</code>","text":"<p>Get / set the style of the table</p> <p>Return: str</p>"},{"location":"reference.html#odfdo.Table.width","title":"<code>width: int</code>  <code>property</code>","text":"<p>Get the current width of the table, measured on columns.</p> <p>Rows may have different widths, use the Table API to ensure width consistency.</p> <p>Return: int</p>"},{"location":"reference.html#odfdo.Table.__init__","title":"<code>__init__(name=None, width=None, height=None, protected=False, protection_key=None, display=True, printable=True, print_ranges=None, style=None, **kwargs)</code>","text":"<p>Create a table element, optionally prefilled with \u201cheight\u201d rows of \u201cwidth\u201d cells each.</p> <p>If the table is to be protected, a protection key must be provided, i.e. a hash value of the password.</p> <p>If the table must not be displayed, set \u201cdisplay\u201d to False.</p> <p>If the table must not be printed, set \u201cprintable\u201d to False. The table will not be printed when it is not displayed, whatever the value of this argument.</p> <p>Ranges of cells to print can be provided as a list of cell ranges, e.g. [\u2018E6:K12\u2019, \u2018P6:R12\u2019] or directly as a raw string, e.g. \u201cE6:K12 P6:R12\u201d.</p> <p>You can access and modify the XML tree manually, but you probably want to use the API to access and alter cells. It will save you from handling repetitions and the same number of cells for each row.</p> <p>If you use both the table API and the XML API, you are on your own for ensuiring model integrity.</p> <p>Arguments:</p> <pre><code>name -- str\n\nwidth -- int\n\nheight -- int\n\nprotected -- bool\n\nprotection_key -- str\n\ndisplay -- bool\n\nprintable -- bool\n\nprint_ranges -- list\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def __init__(\n    self,\n    name: str | None = None,\n    width: int | None = None,\n    height: int | None = None,\n    protected: bool = False,\n    protection_key: str | None = None,\n    display: bool = True,\n    printable: bool = True,\n    print_ranges: list[str] | None = None,\n    style: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"Create a table element, optionally prefilled with \"height\" rows of\n    \"width\" cells each.\n\n    If the table is to be protected, a protection key must be provided,\n    i.e. a hash value of the password.\n\n    If the table must not be displayed, set \"display\" to False.\n\n    If the table must not be printed, set \"printable\" to False. The table\n    will not be printed when it is not displayed, whatever the value of\n    this argument.\n\n    Ranges of cells to print can be provided as a list of cell ranges,\n    e.g. ['E6:K12', 'P6:R12'] or directly as a raw string, e.g.\n    \"E6:K12 P6:R12\".\n\n    You can access and modify the XML tree manually, but you probably want\n    to use the API to access and alter cells. It will save you from\n    handling repetitions and the same number of cells for each row.\n\n    If you use both the table API and the XML API, you are on your own for\n    ensuiring model integrity.\n\n    Arguments:\n\n        name -- str\n\n        width -- int\n\n        height -- int\n\n        protected -- bool\n\n        protection_key -- str\n\n        display -- bool\n\n        printable -- bool\n\n        print_ranges -- list\n\n        style -- str\n    \"\"\"\n    super().__init__(**kwargs)\n    self._indexes = {}\n    self._indexes[\"_cmap\"] = {}\n    self._indexes[\"_tmap\"] = {}\n    if self._do_init:\n        self.name = name\n        if protected:\n            self.protected = protected\n            self.set_protection_key = protection_key\n        if not display:\n            self.displayed = display\n        if not printable:\n            self.printable = printable\n        if print_ranges:\n            self.print_ranges = print_ranges\n        if style:\n            self.style = style\n        # Prefill the table\n        if width is not None or height is not None:\n            width = width or 1\n            height = height or 1\n            # Column groups for style information\n            columns = Column(repeated=width)\n            self._append(columns)\n            for _i in range(height):\n                row = Row(width)\n                self._append(row)\n    self._compute_table_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Table.append","title":"<code>append(something)</code>","text":"<p>Dispatch .append() call to append_row() or append_column().</p> Source code in <code>odfdo/table.py</code> <pre><code>def append(self, something: Element | str) -&gt; None:\n    \"\"\"Dispatch .append() call to append_row() or append_column().\"\"\"\n    if isinstance(something, Row):\n        self.append_row(something)\n    elif isinstance(something, Column):\n        self.append_column(something)\n    else:\n        # probably still an error\n        self._append(something)\n</code></pre>"},{"location":"reference.html#odfdo.Table.append_cell","title":"<code>append_cell(y, cell=None, clone=True)</code>","text":"<p>Append the given cell at the \u201cy\u201d coordinate. Repeated cells are accepted. If no cell is given, an empty one is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Other rows remain untouched.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\ncell -- Cell\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/table.py</code> <pre><code>def append_cell(\n    self,\n    y: int | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Append the given cell at the \"y\" coordinate. Repeated cells are\n    accepted. If no cell is given, an empty one is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Other rows remain untouched.\n\n    Arguments:\n\n        y -- int or str\n\n        cell -- Cell\n\n    returns the cell with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    if clone:\n        cell = cell.clone\n    y = self._translate_y_from_any(y)\n    row = self._get_row2(y)\n    row.y = y\n    cell_back = row.append_cell(cell, clone=False)\n    self.set_row(y, row)\n    # Update width if necessary\n    self._update_width(row)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.append_column","title":"<code>append_column(column=None, _repeated=None)</code>","text":"<p>Append the column at the end of the table. If no column is given, an empty one is created.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>column -- Column\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def append_column(\n    self,\n    column: Column | None = None,\n    _repeated: int | None = None,\n) -&gt; Column:\n    \"\"\"Append the column at the end of the table. If no column is given,\n    an empty one is created.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        column -- Column\n    \"\"\"\n    if column is None:\n        column = Column()\n    else:\n        column = column.clone\n    if not self._cmap:\n        position = 0\n    else:\n        odf_idx = len(self._cmap) - 1\n        last_column = self._get_element_idx2(_xpath_column_idx, odf_idx)\n        if last_column is None:\n            raise ValueError\n        position = self.index(last_column) + 1\n    column.x = self.width\n    self.insert(column, position=position)\n    # Repetitions are accepted\n    if _repeated is None:\n        _repeated = column.repeated or 1\n    self._cmap = insert_map_once(self._cmap, len(self._cmap), _repeated)\n    # No need to update row widths\n    return column\n</code></pre>"},{"location":"reference.html#odfdo.Table.append_row","title":"<code>append_row(row=None, clone=True, _repeated=None)</code>","text":"<p>Append the row at the end of the table. If no row is given, an empty one is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Note the columns are automatically created when the first row is inserted in an empty table. So better insert a filled row.</p> <p>Arguments:</p> <pre><code>row -- Row\n\n_repeated -- (optional), repeated value of the row\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def append_row(\n    self,\n    row: Row | None = None,\n    clone: bool = True,\n    _repeated: int | None = None,\n) -&gt; Row:\n    \"\"\"Append the row at the end of the table. If no row is given, an\n    empty one is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Note the columns are automatically created when the first row is\n    inserted in an empty table. So better insert a filled row.\n\n    Arguments:\n\n        row -- Row\n\n        _repeated -- (optional), repeated value of the row\n\n    returns the row, with updated row.y\n    \"\"\"\n    if row is None:\n        row = Row()\n        _repeated = 1\n    elif clone:\n        row = row.clone\n    # Appending a repeated row accepted\n    # Do not insert next to the last row because it could be in a group\n    self._append(row)\n    if _repeated is None:\n        _repeated = row.repeated or 1\n    self._tmap = insert_map_once(self._tmap, len(self._tmap), _repeated)\n    row.y = self.height - 1\n    # Initialize columns\n    if not self._get_columns():\n        repeated = row.width\n        self.insert(Column(repeated=repeated), position=0)\n        self._compute_table_cache()\n    # Update width if necessary\n    self._update_width(row)\n    return row\n</code></pre>"},{"location":"reference.html#odfdo.Table.del_span","title":"<code>del_span(area)</code>","text":"<p>Delete a Cell Span. \u2018area\u2019 is the cell coordiante of the upper left cell of the spanned area.</p> <p>Area can be either one cell (like \u2018A1\u2019) or an area (\u2018A1:B2\u2019). It can be provided as an alpha numeric value like \u201cA1:B2\u2019 or a tuple like (0, 0, 1, 1) or (0, 0). If an area is provided, the upper left cell is used.</p> <p>Arguments:</p> <pre><code>area -- str or tuple of int, cell or area coordinate\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def del_span(self, area: str | tuple | list) -&gt; bool:\n    \"\"\"Delete a Cell Span. 'area' is the cell coordiante of the upper left\n    cell of the spanned area.\n\n    Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n    be provided as an alpha numeric value like \"A1:B2' or a tuple like\n    (0, 0, 1, 1) or (0, 0). If an area is provided, the upper left cell\n    is used.\n\n    Arguments:\n\n        area -- str or tuple of int, cell or area coordinate\n    \"\"\"\n    # get area\n    digits = convert_coordinates(area)\n    if len(digits) == 4:\n        x, y, _z, _t = digits\n    else:\n        x, y = digits\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    start = x, y\n    # check for previous span\n    cell0 = self.get_cell(start)\n    nb_cols = cell0.get_attribute_integer(\"table:number-columns-spanned\")\n    if nb_cols is None:\n        return False\n    nb_rows = cell0.get_attribute_integer(\"table:number-rows-spanned\")\n    if nb_rows is None:\n        return False\n    z = x + nb_cols - 1\n    t = y + nb_rows - 1\n    cells = self.get_cells((x, y, z, t))\n    cells[0][0].del_attribute(\"table:number-columns-spanned\")\n    cells[0][0].del_attribute(\"table:number-rows-spanned\")\n    for cell in cells[0][1:]:\n        cell.tag = \"table:table-cell\"\n    for row in cells[1:]:\n        for cell in row:\n            cell.tag = \"table:table-cell\"\n    # replace cells in table\n    self.set_cells(cells, coord=start, clone=False)\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_cell","title":"<code>delete_cell(coord)</code>","text":"<p>Delete the cell at the given coordinates, so that next cells are shifted to the left.</p> <p>Coordinates are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Use set_value() for erasing value.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_cell(self, coord: tuple | list | str) -&gt; None:\n    \"\"\"Delete the cell at the given coordinates, so that next cells are\n    shifted to the left.\n\n    Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Use set_value() for erasing value.\n\n    Arguments:\n\n        coord -- (int, int) or str\n    \"\"\"\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    # Outside the defined table\n    if y &gt;= self.height:\n        return\n    # Inside the defined table\n    row = self._get_row2_base(y)\n    if row is None:\n        raise ValueError\n    row.delete_cell(x)\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_column","title":"<code>delete_column(x)</code>","text":"<p>Delete the column at the given position. ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_column(self, x: int | str) -&gt; None:\n    \"\"\"Delete the column at the given position. ODF columns don't contain\n    cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        x -- int or str\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    # Outside the defined table\n    if x &gt;= self.width:\n        return\n    # Inside the defined table\n    delete_item_in_vault(x, self, _xpath_column_idx, \"_cmap\")\n    # Update width\n    width = self.width\n    for row in self._get_rows():\n        if row.width &gt;= width:\n            row.delete_cell(x)\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_named_range","title":"<code>delete_named_range(name)</code>","text":"<p>Delete the Named Range of specified name from the spreadsheet. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>name -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_named_range(self, name: str) -&gt; None:\n    \"\"\"Delete the Named Range of specified name from the spreadsheet.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        name -- str\n    \"\"\"\n    name = name.strip()\n    if not name:\n        raise ValueError(\"Name required.\")\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document.\")\n    body.delete_named_range(name)\n</code></pre>"},{"location":"reference.html#odfdo.Table.delete_row","title":"<code>delete_row(y)</code>","text":"<p>Delete the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def delete_row(self, y: int | str) -&gt; None:\n    \"\"\"Delete the row at the given \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n    \"\"\"\n    y = self._translate_y_from_any(y)\n    # Outside the defined table\n    if y &gt;= self.height:\n        return\n    # Inside the defined table\n    delete_item_in_vault(y, self, _xpath_row_idx, \"_tmap\")\n</code></pre>"},{"location":"reference.html#odfdo.Table.extend_rows","title":"<code>extend_rows(rows=None)</code>","text":"<p>Append a list of rows at the end of the table.</p> <p>Arguments:</p> <pre><code>rows -- list of Row\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def extend_rows(self, rows: list[Row] | None = None) -&gt; None:\n    \"\"\"Append a list of rows at the end of the table.\n\n    Arguments:\n\n        rows -- list of Row\n    \"\"\"\n    if rows is None:\n        rows = []\n    self.extend(rows)\n    self._compute_table_cache()\n    # Update width if necessary\n    width = self.width\n    for row in self.traverse():\n        if row.width &gt; width:\n            width = row.width\n    diff = width - self.width\n    if diff &gt; 0:\n        self.append_column(Column(repeated=diff))\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_cell","title":"<code>get_cell(coord, clone=True, keep_repeated=True)</code>","text":"<p>Get the cell at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>A copy is returned, use <code>set_cell</code> to push it back.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n</code></pre> <p>Return: Cell</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_cell(\n    self,\n    coord: tuple | list | str,\n    clone: bool = True,\n    keep_repeated: bool = True,\n) -&gt; Cell:\n    \"\"\"Get the cell at the given coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    A copy is returned, use ``set_cell`` to push it back.\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n    Return: Cell\n    \"\"\"\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    # Outside the defined table\n    if y &gt;= self.height:\n        cell = Cell()\n    else:\n        # Inside the defined table\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError\n        read_cell = row.get_cell(x, clone=clone)\n        if read_cell is None:\n            raise ValueError\n        cell = read_cell\n        if not keep_repeated:\n            repeated = cell.repeated or 1\n            if repeated &gt;= 2:\n                cell.repeated = None\n    cell.x = x\n    cell.y = y\n    return cell\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_cells","title":"<code>get_cells(coord=None, cell_type=None, style=None, content=None, flat=False)</code>","text":"<p>Get the cells matching the criteria. If \u2018coord\u2019 is None, parse the whole table, else parse the area defined by \u2018coord\u2019.</p> <p>Filter by  cell_type = \u201call\u201d  will retrieve cells of any type, aka non empty cells.</p> <p>If flat is True (default is False), the method return a single list of all the values, else a list of lists of cells.</p> <p>if cell_type, style and content are None, get_cells() will return the exact number of cells of the area, including empty cells.</p> <p>Arguments:</p> <pre><code>coordinates -- str or tuple of int : coordinates of area\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncontent -- str regex\n\nstyle -- str\n\nflat -- boolean\n</code></pre> <p>Return: list of list of Cell</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_cells(\n    self,\n    coord: tuple | list | str | None = None,\n    cell_type: str | None = None,\n    style: str | None = None,\n    content: str | None = None,\n    flat: bool = False,\n) -&gt; list:\n    \"\"\"Get the cells matching the criteria. If 'coord' is None,\n    parse the whole table, else parse the area defined by 'coord'.\n\n    Filter by  cell_type = \"all\"  will retrieve cells of any\n    type, aka non empty cells.\n\n    If flat is True (default is False), the method return a single list\n    of all the values, else a list of lists of cells.\n\n    if cell_type, style and content are None, get_cells() will return\n    the exact number of cells of the area, including empty cells.\n\n    Arguments:\n\n        coordinates -- str or tuple of int : coordinates of area\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        content -- str regex\n\n        style -- str\n\n        flat -- boolean\n\n    Return: list of list of Cell\n    \"\"\"\n    if coord:\n        x, y, z, t = self._translate_table_coordinates(coord)\n    else:\n        x = y = z = t = None\n    if flat:\n        cells: list[Cell] = []\n        for row in self.traverse(start=y, end=t):\n            row_cells = row.get_cells(\n                coord=(x, z),\n                cell_type=cell_type,\n                style=style,\n                content=content,\n            )\n            cells.extend(row_cells)\n        return cells\n    else:\n        lcells: list[list[Cell]] = []\n        for row in self.traverse(start=y, end=t):\n            row_cells = row.get_cells(\n                coord=(x, z),\n                cell_type=cell_type,\n                style=style,\n                content=content,\n            )\n            lcells.append(row_cells)\n        return lcells\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_column","title":"<code>get_column(x)</code>","text":"<p>Get the column at the given \u201cx\u201d position.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>A copy is returned, use set_column() to push it back.</p> <p>Arguments:</p> <pre><code>x -- int or str\n</code></pre> <p>Return: Column</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_column(self, x: int | str) -&gt; Column:\n    \"\"\"Get the column at the given \"x\" position.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    A copy is returned, use set_column() to push it back.\n\n    Arguments:\n\n        x -- int or str\n\n    Return: Column\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    column = self._get_column2(x)\n    if column is None:\n        raise ValueError\n    column.x = x\n    return column\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_column_cells","title":"<code>get_column_cells(x, style=None, content=None, cell_type=None, complete=False)</code>","text":"<p>Get the list of cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells.</p> <p>If complete is True, replace missing values by None.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncontent -- str regex\n\nstyle -- str\n\ncomplete -- boolean\n</code></pre> <p>Return: list of Cell</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_column_cells(  # noqa: C901\n    self,\n    x: int | str,\n    style: str | None = None,\n    content: str | None = None,\n    cell_type: str | None = None,\n    complete: bool = False,\n) -&gt; list[Cell | None]:\n    \"\"\"Get the list of cells at the given position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n\n    If complete is True, replace missing values by None.\n\n    Arguments:\n\n        x -- int or str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        content -- str regex\n\n        style -- str\n\n        complete -- boolean\n\n    Return: list of Cell\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    if cell_type:\n        cell_type = cell_type.lower().strip()\n    cells: list[Cell | None] = []\n    if not style and not content and not cell_type:\n        for row in self.traverse():\n            cells.append(row.get_cell(x, clone=True))\n        return cells\n    for row in self.traverse():\n        cell = row.get_cell(x, clone=True)\n        if cell is None:\n            raise ValueError\n        # Filter the cells by cell_type\n        if cell_type:\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                if complete:\n                    cells.append(None)\n                continue\n        # Filter the cells with the regex\n        if content and not cell.match(content):\n            if complete:\n                cells.append(None)\n            continue\n        # Filter the cells with the style\n        if style and style != cell.style:\n            if complete:\n                cells.append(None)\n            continue\n        cells.append(cell)\n    return cells\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_column_values","title":"<code>get_column_values(x, cell_type=None, complete=True, get_type=False)</code>","text":"<p>Shortcut to get the list of Python values for the cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells. If cell_type and complete is True, replace missing values by None.</p> <p>If get_type is True, returns a tuple (value, ODF type of value)</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of Python types</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_column_values(\n    self,\n    x: int | str,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n) -&gt; list[Any]:\n    \"\"\"Shortcut to get the list of Python values for the cells at the\n    given position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n    If cell_type and complete is True, replace missing values by None.\n\n    If get_type is True, returns a tuple (value, ODF type of value)\n\n    Arguments:\n\n        x -- int or str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of Python types\n    \"\"\"\n    cells = self.get_column_cells(\n        x, style=None, content=None, cell_type=cell_type, complete=complete\n    )\n    values: list[Any] = []\n    for cell in cells:\n        if cell is None:\n            if complete:\n                if get_type:\n                    values.append((None, None))\n                else:\n                    values.append(None)\n            continue\n        if cell_type:\n            ctype = cell.type\n            if not ctype or not (ctype == cell_type or cell_type == \"all\"):\n                if complete:\n                    if get_type:\n                        values.append((None, None))\n                    else:\n                        values.append(None)\n                continue\n        values.append(cell.get_value(get_type=get_type))\n    return values\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_columns","title":"<code>get_columns(coord=None, style=None)</code>","text":"<p>Get the list of columns matching the criteria.</p> <p>Copies are returned, use set_column() to push them back.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of columns\n\nstyle -- str\n</code></pre> <p>Return: list of columns</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_columns(\n    self,\n    coord: tuple | list | str | None = None,\n    style: str | None = None,\n) -&gt; list[Column]:\n    \"\"\"Get the list of columns matching the criteria.\n\n    Copies are returned, use set_column() to push them back.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of columns\n\n        style -- str\n\n    Return: list of columns\n    \"\"\"\n    if coord:\n        x, _y, _z, t = self._translate_column_coordinates(coord)\n    else:\n        x = t = None\n    if not style:\n        return list(self.traverse_columns(start=x, end=t))\n    columns = []\n    for column in self.traverse_columns(start=x, end=t):\n        if style != column.style:\n            continue\n        columns.append(column)\n    return columns\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_named_range","title":"<code>get_named_range(name)</code>","text":"<p>Returns the Name Ranges of the specified name. If table_name is provided, limits the search to these tables. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>name -- str, name of the named range object\n</code></pre> <p>Return : NamedRange</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_named_range(self, name: str) -&gt; NamedRange:\n    \"\"\"Returns the Name Ranges of the specified name. If\n    table_name is provided, limits the search to these tables.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        name -- str, name of the named range object\n\n    Return : NamedRange\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document\")\n    return body.get_named_range(name)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_named_ranges","title":"<code>get_named_ranges(table_name=None)</code>","text":"<p>Returns the list of available Name Ranges of the spreadsheet. If table_name is provided, limits the search to these tables. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>table_names -- str or list of str, names of tables\n</code></pre> <p>Return : list of table_range</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_named_ranges(  # type: ignore\n    self,\n    table_name: str | list[str] | None = None,\n) -&gt; list[NamedRange]:\n    \"\"\"Returns the list of available Name Ranges of the spreadsheet. If\n    table_name is provided, limits the search to these tables.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        table_names -- str or list of str, names of tables\n\n    Return : list of table_range\n    \"\"\"\n    body = self.document_body\n    if not body:\n        return []\n    all_named_ranges = body.get_named_ranges()\n    if not table_name:\n        return all_named_ranges  # type:ignore\n    filter_ = []\n    if isinstance(table_name, str):\n        filter_.append(table_name)\n    elif isiterable(table_name):\n        filter_.extend(table_name)\n    else:\n        raise ValueError(\n            f\"table_name must be string or Iterable, not {type(table_name)}\"\n        )\n    return [\n        nr for nr in all_named_ranges if nr.table_name in filter_  # type:ignore\n    ]\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_row","title":"<code>get_row(y, clone=True, create=True)</code>","text":"<p>Get the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>A copy is returned, use set_cell() to push it back.</p> <p>Arguments:</p> <pre><code>y -- int or str\n</code></pre> <p>Return: Row</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_row(self, y: int | str, clone: bool = True, create: bool = True) -&gt; Row:\n    \"\"\"Get the row at the given \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    A copy is returned, use set_cell() to push it back.\n\n    Arguments:\n\n        y -- int or str\n\n    Return: Row\n    \"\"\"\n    # fixme : keep repeat ? maybe an option to functions : \"raw=False\"\n    y = self._translate_y_from_any(y)\n    row = self._get_row2(y, clone=clone, create=create)\n    if row is None:\n        raise ValueError(\"Row not found\")\n    row.y = y\n    return row\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_row_values","title":"<code>get_row_values(y, cell_type=None, complete=True, get_type=False)</code>","text":"<p>Shortcut to get the list of Python values for the cells of the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Filter by cell_type, with cell_type \u2018all\u2019 will retrieve cells of any type, aka non empty cells. If cell_type and complete is True, replace missing values by None.</p> <p>If get_type is True, returns a tuple (value, ODF type of value)</p> <p>Arguments:</p> <pre><code>y -- int, str\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of lists of Python types</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_row_values(\n    self,\n    y: int | str,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n) -&gt; list:\n    \"\"\"Shortcut to get the list of Python values for the cells of the row\n    at the given \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Filter by cell_type, with cell_type 'all' will retrieve cells of any\n    type, aka non empty cells.\n    If cell_type and complete is True, replace missing values by None.\n\n    If get_type is True, returns a tuple (value, ODF type of value)\n\n    Arguments:\n\n        y -- int, str\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of lists of Python types\n    \"\"\"\n    values = self.get_row(y, clone=False).get_values(\n        cell_type=cell_type, complete=complete, get_type=get_type\n    )\n    # complete row to match column width\n    if complete:\n        if get_type:\n            values.extend([(None, None)] * (self.width - len(values)))\n        else:\n            values.extend([None] * (self.width - len(values)))\n    return values\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_rows","title":"<code>get_rows(coord=None, style=None, content=None)</code>","text":"<p>Get the list of rows matching the criteria.</p> <p>Filter by coordinates will parse the area defined by the coordinates.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of rows\n\ncontent -- str regex\n\nstyle -- str\n</code></pre> <p>Return: list of rows</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_rows(\n    self,\n    coord: tuple | list | str | None = None,\n    style: str | None = None,\n    content: str | None = None,\n) -&gt; list[Row]:\n    \"\"\"Get the list of rows matching the criteria.\n\n    Filter by coordinates will parse the area defined by the coordinates.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of rows\n\n        content -- str regex\n\n        style -- str\n\n    Return: list of rows\n    \"\"\"\n    if coord:\n        _x, y, _z, t = self._translate_table_coordinates(coord)\n    else:\n        y = t = None\n    # fixme : not clones ?\n    if not content and not style:\n        return list(self.traverse(start=y, end=t))\n    rows = []\n    for row in self.traverse(start=y, end=t):\n        if content and not row.match(content):\n            continue\n        if style and style != row.style:\n            continue\n        rows.append(row)\n    return rows\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_value","title":"<code>get_value(coord, get_type=False)</code>","text":"<p>Shortcut to get the Python value of the cell at the given coordinates.</p> <p>If get_type is True, returns the tuples (value, ODF type)</p> <p>coord is either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d. If an Area is given, the upper left position is used as coord.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str : coordinate\n</code></pre> <p>Return: Python type</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_value(\n    self,\n    coord: tuple | list | str,\n    get_type: bool = False,\n) -&gt; Any:\n    \"\"\"Shortcut to get the Python value of the cell at the given\n    coordinates.\n\n    If get_type is True, returns the tuples (value, ODF type)\n\n    coord is either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\". If an Area is given, the upper\n    left position is used as coord.\n\n    Arguments:\n\n        coord -- (int, int) or str : coordinate\n\n    Return: Python type\n    \"\"\"\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    # Outside the defined table\n    if y &gt;= self.height:\n        if get_type:\n            return (None, None)\n        return None\n    else:\n        # Inside the defined table\n        row = self._get_row2_base(y)\n        if row is None:\n            raise ValueError\n        cell = row._get_cell2_base(x)\n        if cell is None:\n            if get_type:\n                return (None, None)\n            return None\n        return cell.get_value(get_type=get_type)\n</code></pre>"},{"location":"reference.html#odfdo.Table.get_values","title":"<code>get_values(coord=None, cell_type=None, complete=True, get_type=False, flat=False)</code>","text":"<p>Get a matrix of values of the table.</p> <p>Filter by coordinates will parse the area defined by the coordinates.</p> <p>If \u2018cell_type\u2019 is used and \u2018complete\u2019 is True (default), missing values are replaced by None. Filter by \u2019 cell_type = \u201call\u201d \u2019 will retrieve cells of any type, aka non empty cells.</p> <p>If \u2018cell_type\u2019 is None, complete is always True : with no cell type queried, get_values() returns None for each empty cell, the length each lists is equal to the width of the table.</p> <p>If get_type is True, returns tuples (value, ODF type of value), or (None, None) for empty cells with complete True.</p> <p>If flat is True, the methods return a single list of all the values. By default, flat is False.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of area\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: list of lists of Python types</p> Source code in <code>odfdo/table.py</code> <pre><code>def get_values(\n    self,\n    coord: tuple | list | str | None = None,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n    flat: bool = False,\n) -&gt; list:\n    \"\"\"Get a matrix of values of the table.\n\n    Filter by coordinates will parse the area defined by the coordinates.\n\n    If 'cell_type' is used and 'complete' is True (default), missing values\n    are replaced by None.\n    Filter by ' cell_type = \"all\" ' will retrieve cells of any\n    type, aka non empty cells.\n\n    If 'cell_type' is None, complete is always True : with no cell type\n    queried, get_values() returns None for each empty cell, the length\n    each lists is equal to the width of the table.\n\n    If get_type is True, returns tuples (value, ODF type of value), or\n    (None, None) for empty cells with complete True.\n\n    If flat is True, the methods return a single list of all the values.\n    By default, flat is False.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of area\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: list of lists of Python types\n    \"\"\"\n    if coord:\n        x, y, z, t = self._translate_table_coordinates(coord)\n    else:\n        x = y = z = t = None\n    data = []\n    for row in self.traverse(start=y, end=t):\n        if z is None:\n            width = self.width\n        else:\n            width = min(z + 1, self.width)\n        if x is not None:\n            width -= x\n        values = row.get_values(\n            (x, z),\n            cell_type=cell_type,\n            complete=complete,\n            get_type=get_type,\n        )\n        # complete row to match request width\n        if complete:\n            if get_type:\n                values.extend([(None, None)] * (width - len(values)))\n            else:\n                values.extend([None] * (width - len(values)))\n        if flat:\n            data.extend(values)\n        else:\n            data.append(values)\n    return data\n</code></pre>"},{"location":"reference.html#odfdo.Table.insert_cell","title":"<code>insert_cell(coord, cell=None, clone=True)</code>","text":"<p>Insert the given cell at the given coordinates. If no cell is given, an empty one is created.</p> <p>Coordinates are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Cells on the right are shifted. Other rows remain untouched.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n\ncell -- Cell\n</code></pre> <p>returns the cell with x and y updated</p> Source code in <code>odfdo/table.py</code> <pre><code>def insert_cell(\n    self,\n    coord: tuple | list | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Insert the given cell at the given coordinates. If no cell is\n    given, an empty one is created.\n\n    Coordinates are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Cells on the right are shifted. Other rows remain untouched.\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n        cell -- Cell\n\n    returns the cell with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    if clone:\n        cell = cell.clone\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    row = self._get_row2(y, clone=True)\n    row.y = y\n    row.repeated = None\n    cell_back = row.insert_cell(x, cell, clone=False)\n    self.set_row(y, row, clone=False)\n    # Update width if necessary\n    self._update_width(row)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.insert_column","title":"<code>insert_column(x, column=None)</code>","text":"<p>Insert the column before the given \u201cx\u201d position. If no column is given, an empty one is created.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncolumn -- Column\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def insert_column(\n    self,\n    x: int | str,\n    column: Column | None = None,\n) -&gt; Column:\n    \"\"\"Insert the column before the given \"x\" position. If no column is\n    given, an empty one is created.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        x -- int or str\n\n        column -- Column\n    \"\"\"\n    if column is None:\n        column = Column()\n    x = self._translate_x_from_any(x)\n    diff = x - self.width\n    if diff &lt; 0:\n        column_back = insert_item_in_vault(\n            x, column, self, _xpath_column_idx, \"_cmap\"\n        )\n    elif diff == 0:\n        column_back = self.append_column(column.clone)\n    else:\n        self.append_column(Column(repeated=diff), _repeated=diff)\n        column_back = self.append_column(column.clone)\n    column_back.x = x  # type: ignore\n    # Repetitions are accepted\n    repeated = column.repeated or 1\n    # Update width on every row\n    for row in self._get_rows():\n        if row.width &gt; x:\n            row.insert_cell(x, Cell(repeated=repeated))\n        # Shorter rows don't need insert\n        # Longer rows shouldn't exist!\n    return column_back  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Table.insert_row","title":"<code>insert_row(y, row=None, clone=True)</code>","text":"<p>Insert the row before the given \u201cy\u201d position. If no row is given, an empty one is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>If row is None, a new empty row is created.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\nrow -- Row\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def insert_row(\n    self, y: str | int, row: Row | None = None, clone: bool = True\n) -&gt; Row:\n    \"\"\"Insert the row before the given \"y\" position. If no row is given,\n    an empty one is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    If row is None, a new empty row is created.\n\n    Arguments:\n\n        y -- int or str\n\n        row -- Row\n\n    returns the row, with updated row.y\n    \"\"\"\n    if row is None:\n        row = Row()\n        clone = False\n    y = self._translate_y_from_any(y)\n    diff = y - self.height\n    if diff &lt; 0:\n        row_back = insert_item_in_vault(y, row, self, _xpath_row_idx, \"_tmap\")\n    elif diff == 0:\n        row_back = self.append_row(row, clone=clone)\n    else:\n        self.append_row(Row(repeated=diff), _repeated=diff, clone=False)\n        row_back = self.append_row(row, clone=clone)\n    row_back.y = y  # type: ignore\n    # Update width if necessary\n    self._update_width(row_back)  # type: ignore\n    return row_back  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.Table.is_column_empty","title":"<code>is_column_empty(x, aggressive=False)</code>","text":"<p>Return wether every cell in the column at \u201cx\u201d position has no value or the value evaluates to False (empty string), and no style.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Return: bool</p> Source code in <code>odfdo/table.py</code> <pre><code>def is_column_empty(self, x: int | str, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return wether every cell in the column at \"x\" position has no value\n    or the value evaluates to False (empty string), and no style.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Return: bool\n    \"\"\"\n    for cell in self.get_column_cells(x):\n        if cell is None:\n            continue\n        if not cell.is_empty(aggressive=aggressive):\n            return False\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Table.is_empty","title":"<code>is_empty(aggressive=False)</code>","text":"<p>Return whether every cell in the table has no value or the value evaluates to False (empty string), and no style.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>aggressive -- bool\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def is_empty(self, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return whether every cell in the table has no value or the value\n    evaluates to False (empty string), and no style.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        aggressive -- bool\n    \"\"\"\n    return all(row.is_empty(aggressive=aggressive) for row in self._get_rows())\n</code></pre>"},{"location":"reference.html#odfdo.Table.is_row_empty","title":"<code>is_row_empty(y, aggressive=False)</code>","text":"<p>Return wether every cell in the row at the given \u201cy\u201d position has no value or the value evaluates to False (empty string), and no style.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>If aggressive is True, empty cells with style are considered empty.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\naggressive -- bool\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def is_row_empty(self, y: int | str, aggressive: bool = False) -&gt; bool:\n    \"\"\"Return wether every cell in the row at the given \"y\" position has\n    no value or the value evaluates to False (empty string), and no style.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    If aggressive is True, empty cells with style are considered empty.\n\n    Arguments:\n\n        y -- int or str\n\n        aggressive -- bool\n    \"\"\"\n    return self.get_row(y, clone=False).is_empty(aggressive=aggressive)\n</code></pre>"},{"location":"reference.html#odfdo.Table.iter_values","title":"<code>iter_values(coord=None, cell_type=None, complete=True, get_type=False)</code>","text":"<p>Iterate through lines of Python values of the table.</p> <p>Filter by coordinates will parse the area defined by the coordinates.</p> <p>cell_type, complete, grt_type : see get_values()</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of area\n\ncell_type -- 'boolean', 'float', 'date', 'string', 'time',\n             'currency', 'percentage' or 'all'\n\ncomplete -- boolean\n\nget_type -- boolean\n</code></pre> <p>Return: iterator of lists</p> Source code in <code>odfdo/table.py</code> <pre><code>def iter_values(\n    self,\n    coord: tuple | list | str | None = None,\n    cell_type: str | None = None,\n    complete: bool = True,\n    get_type: bool = False,\n) -&gt; Iterator[list]:\n    \"\"\"Iterate through lines of Python values of the table.\n\n    Filter by coordinates will parse the area defined by the coordinates.\n\n    cell_type, complete, grt_type : see get_values()\n\n\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of area\n\n        cell_type -- 'boolean', 'float', 'date', 'string', 'time',\n                     'currency', 'percentage' or 'all'\n\n        complete -- boolean\n\n        get_type -- boolean\n\n    Return: iterator of lists\n    \"\"\"\n    if coord:\n        x, y, z, t = self._translate_table_coordinates(coord)\n    else:\n        x = y = z = t = None\n    for row in self.traverse(start=y, end=t):\n        if z is None:\n            width = self.width\n        else:\n            width = min(z + 1, self.width)\n        if x is not None:\n            width -= x\n        values = row.get_values(\n            (x, z),\n            cell_type=cell_type,\n            complete=complete,\n            get_type=get_type,\n        )\n        # complete row to match column width\n        if complete:\n            if get_type:\n                values.extend([(None, None)] * (width - len(values)))\n            else:\n                values.extend([None] * (width - len(values)))\n        yield values\n</code></pre>"},{"location":"reference.html#odfdo.Table.optimize_width","title":"<code>optimize_width()</code>","text":"<p>Remove in-place empty rows below and empty cells at the right of the table. Keep repeated styles of empty cells but minimize row width.</p> Source code in <code>odfdo/table.py</code> <pre><code>def optimize_width(self) -&gt; None:\n    \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n    the table. Keep repeated styles of empty cells but minimize row width.\n    \"\"\"\n    self._optimize_width_trim_rows()\n    width = self._optimize_width_length()\n    self._optimize_width_rstrip_rows(width)\n    self._optimize_width_adapt_columns(width)\n</code></pre>"},{"location":"reference.html#odfdo.Table.rstrip","title":"<code>rstrip(aggressive=False)</code>","text":"<p>Remove in-place empty rows below and empty cells at the right of the table. Cells are empty if they contain no value or it evaluates to False, and no style.</p> <p>If aggressive is True, empty cells with style are removed too.</p> <p>Argument:</p> <pre><code>aggressive -- bool\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def rstrip(self, aggressive: bool = False) -&gt; None:\n    \"\"\"Remove *in-place* empty rows below and empty cells at the right of\n    the table. Cells are empty if they contain no value or it evaluates\n    to False, and no style.\n\n    If aggressive is True, empty cells with style are removed too.\n\n    Argument:\n\n        aggressive -- bool\n    \"\"\"\n    # Step 1: remove empty rows below the table\n    for row in reversed(self._get_rows()):\n        if row.is_empty(aggressive=aggressive):\n            row.parent.delete(row)  # type: ignore\n        else:\n            break\n    # Step 2: rstrip remaining rows\n    max_width = 0\n    for row in self._get_rows():\n        row.rstrip(aggressive=aggressive)\n        # keep count of the biggest row\n        max_width = max(max_width, row.width)\n    # raz cache of rows\n    self._indexes[\"_tmap\"] = {}\n    # Step 3: trim columns to match max_width\n    columns = self._get_columns()\n    repeated_cols = self.xpath(\"table:table-column/@table:number-columns-repeated\")\n    if not isinstance(repeated_cols, list):\n        raise TypeError\n    unrepeated = len(columns) - len(repeated_cols)\n    column_width = sum(int(r) for r in repeated_cols) + unrepeated  # type: ignore\n    diff = column_width - max_width\n    if diff &gt; 0:\n        for column in reversed(columns):\n            repeated = column.repeated or 1\n            repeated = repeated - diff\n            if repeated &gt; 0:\n                column.repeated = repeated\n                break\n            else:\n                column.parent.delete(column)\n                diff = -repeated\n                if diff == 0:\n                    break\n    # raz cache of columns\n    self._indexes[\"_cmap\"] = {}\n    self._compute_table_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_cell","title":"<code>set_cell(coord, cell=None, clone=True)</code>","text":"<p>Replace a cell of the table at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str : coordinate\n\ncell -- Cell\n</code></pre> <p>return the cell, with x and y updated</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_cell(\n    self,\n    coord: tuple | list | str,\n    cell: Cell | None = None,\n    clone: bool = True,\n) -&gt; Cell:\n    \"\"\"Replace a cell of the table at the given coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Arguments:\n\n        coord -- (int, int) or str : coordinate\n\n        cell -- Cell\n\n    return the cell, with x and y updated\n    \"\"\"\n    if cell is None:\n        cell = Cell()\n        clone = False\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    cell.x = x\n    cell.y = y\n    if y &gt;= self.height:\n        row = Row()\n        cell_back = row.set_cell(x, cell, clone=clone)\n        self.set_row(y, row, clone=False)\n    else:\n        row_read = self._get_row2_base(y)\n        if row_read is None:\n            raise ValueError\n        row = row_read\n        row.y = y\n        repeated = row.repeated or 1\n        if repeated &gt; 1:\n            row = row.clone\n            row.repeated = None\n            cell_back = row.set_cell(x, cell, clone=clone)\n            self.set_row(y, row, clone=False)\n        else:\n            cell_back = row.set_cell(x, cell, clone=clone)\n            # Update width if necessary, since we don't use set_row\n            self._update_width(row)\n    return cell_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_cell_image","title":"<code>set_cell_image(coord, image_frame, doc_type=None)</code>","text":"<p>Do all the magic to display an image in the cell at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>The frame element must contain the expected image position and dimensions.</p> <p>DrawImage insertion depends on the document type, so the type must be provided or the table element must be already attached to a document.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n\nimage_frame -- Frame including an image\n\ndoc_type -- 'spreadsheet' or 'text'\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_cell_image(\n    self,\n    coord: tuple | list | str,\n    image_frame: Frame,\n    doc_type: str | None = None,\n) -&gt; None:\n    \"\"\"Do all the magic to display an image in the cell at the given\n    coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    The frame element must contain the expected image position and\n    dimensions.\n\n    DrawImage insertion depends on the document type, so the type must be\n    provided or the table element must be already attached to a document.\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n        image_frame -- Frame including an image\n\n        doc_type -- 'spreadsheet' or 'text'\n    \"\"\"\n    # Test document type\n    if doc_type is None:\n        body = self.document_body\n        if body is None:\n            raise ValueError(\"document type not found\")\n        doc_type = {\"office:spreadsheet\": \"spreadsheet\", \"office:text\": \"text\"}.get(\n            body.tag\n        )\n        if doc_type is None:\n            raise ValueError(\"document type not supported for images\")\n    # We need the end address of the image\n    x, y = self._translate_cell_coordinates(coord)\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    cell = self.get_cell((x, y))\n    image_frame = image_frame.clone  # type: ignore\n    # Remove any previous paragraph, frame, etc.\n    for child in cell.children:\n        cell.delete(child)\n    # Now it all depends on the document type\n    if doc_type == \"spreadsheet\":\n        image_frame.anchor_type = \"char\"\n        # The frame needs end coordinates\n        width, height = image_frame.size\n        image_frame.set_attribute(\"table:end-x\", width)\n        image_frame.set_attribute(\"table:end-y\", height)\n        # FIXME what happens when the address changes?\n        address = f\"{self.name}.{digit_to_alpha(x)}{y + 1}\"\n        image_frame.set_attribute(\"table:end-cell-address\", address)\n        # The frame is directly in the cell\n        cell.append(image_frame)\n    elif doc_type == \"text\":\n        # The frame must be in a paragraph\n        cell.set_value(\"\")\n        paragraph = cell.get_element(\"text:p\")\n        if paragraph is None:\n            raise ValueError\n        paragraph.append(image_frame)\n    self.set_cell(coord, cell)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_cells","title":"<code>set_cells(cells, coord=None, clone=True)</code>","text":"<p>Set the cells in the table, from the \u2018coord\u2019 position.</p> <p>\u2018coord\u2019 is the coordinate of the upper left cell to be modified by values. If \u2018coord\u2019 is None, default to the position (0,0) (\u201cA1\u201d). If \u2018coord\u2019 is an area (e.g. \u201cA2:B5\u201d), the upper left position of this area is used as coordinate.</p> <p>The table is not cleared before the operation, to reset the table before setting cells, use table.clear().</p> <p>A list of lists is expected, with as many lists as rows to be set, and as many cell in each sublist as cells to be setted in the row.</p> <p>Arguments:</p> <pre><code>cells -- list of list of cells\n\ncoord -- tuple or str\n\nvalues -- list of lists of python types\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_cells(\n    self,\n    cells: list[list[Cell]] | list[tuple[Cell]],\n    coord: tuple | list | str | None = None,\n    clone: bool = True,\n) -&gt; None:\n    \"\"\"Set the cells in the table, from the 'coord' position.\n\n    'coord' is the coordinate of the upper left cell to be modified by\n    values. If 'coord' is None, default to the position (0,0) (\"A1\").\n    If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n    area is used as coordinate.\n\n    The table is *not* cleared before the operation, to reset the table\n    before setting cells, use table.clear().\n\n    A list of lists is expected, with as many lists as rows to be set, and\n    as many cell in each sublist as cells to be setted in the row.\n\n    Arguments:\n\n        cells -- list of list of cells\n\n        coord -- tuple or str\n\n        values -- list of lists of python types\n    \"\"\"\n    if coord:\n        x, y = self._translate_cell_coordinates(coord)\n    else:\n        x = y = 0\n    if y is None:\n        y = 0\n    if x is None:\n        x = 0\n    y -= 1\n    for row_cells in cells:\n        y += 1\n        if not row_cells:\n            continue\n        row = self.get_row(y, clone=True)\n        repeated = row.repeated or 1\n        if repeated &gt;= 2:\n            row.repeated = None\n        row.set_cells(row_cells, start=x, clone=clone)\n        self.set_row(y, row, clone=False)\n        self._update_width(row)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_column","title":"<code>set_column(x, column=None)</code>","text":"<p>Replace the column at the given \u201cx\u201d position.</p> <p>ODF columns don\u2019t contain cells, only style information.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncolumn -- Column\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_column(\n    self,\n    x: int | str,\n    column: Column | None = None,\n) -&gt; Column:\n    \"\"\"Replace the column at the given \"x\" position.\n\n    ODF columns don't contain cells, only style information.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    Arguments:\n\n        x -- int or str\n\n        column -- Column\n    \"\"\"\n    x = self._translate_x_from_any(x)\n    if column is None:\n        column = Column()\n        repeated = 1\n    else:\n        repeated = column.repeated or 1\n    column.x = x\n    # Outside the defined table ?\n    diff = x - self.width\n    if diff == 0:\n        column_back = self.append_column(column, _repeated=repeated)\n    elif diff &gt; 0:\n        self.append_column(Column(repeated=diff), _repeated=diff)\n        column_back = self.append_column(column, _repeated=repeated)\n    else:\n        # Inside the defined table\n        column_back = set_item_in_vault(  # type: ignore\n            x, column, self, _xpath_column_idx, \"_cmap\"\n        )\n    return column_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_column_cells","title":"<code>set_column_cells(x, cells)</code>","text":"<p>Shortcut to set the list of cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>The list must have the same length than the table height.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\ncells -- list of Cell\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_column_cells(self, x: int | str, cells: list[Cell]) -&gt; None:\n    \"\"\"Shortcut to set the list of cells at the given position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    The list must have the same length than the table height.\n\n    Arguments:\n\n        x -- int or str\n\n        cells -- list of Cell\n    \"\"\"\n    height = self.height\n    if len(cells) != height:\n        raise ValueError(f\"col mismatch: {height} cells expected\")\n    cells_iterator = iter(cells)\n    for y, row in enumerate(self.traverse()):\n        row.set_cell(x, next(cells_iterator))\n        self.set_row(y, row)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_column_values","title":"<code>set_column_values(x, values, cell_type=None, currency=None, style=None)</code>","text":"<p>Shortcut to set the list of Python values of cells at the given position.</p> <p>Position start at 0. So cell C4 is on column 2. Alphabetical position like \u201cC\u201d is accepted.</p> <p>The list must have the same length than the table height.</p> <p>Arguments:</p> <pre><code>x -- int or str\n\nvalues -- list of Python types\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_column_values(\n    self,\n    x: int | str,\n    values: list,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the list of Python values of cells at the given\n    position.\n\n    Position start at 0. So cell C4 is on column 2. Alphabetical position\n    like \"C\" is accepted.\n\n    The list must have the same length than the table height.\n\n    Arguments:\n\n        x -- int or str\n\n        values -- list of Python types\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n    \"\"\"\n    cells = [\n        Cell(value, cell_type=cell_type, currency=currency, style=style)\n        for value in values\n    ]\n    self.set_column_cells(x, cells)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_named_range","title":"<code>set_named_range(name, crange, table_name=None, usage=None)</code>","text":"<p>Create a Named Range element and insert it in the document. Beware : named ranges are stored at the body level, thus do not call this method on a cloned table.</p> <p>Arguments:</p> <pre><code>name -- str, name of the named range\n\ncrange -- str or tuple of int, cell or area coordinate\n\ntable_name -- str, name of the table\n\nuage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_named_range(\n    self,\n    name: str,\n    crange: str | tuple | list,\n    table_name: str | None = None,\n    usage: str | None = None,\n) -&gt; None:\n    \"\"\"Create a Named Range element and insert it in the document.\n    Beware : named ranges are stored at the body level, thus do not call\n    this method on a cloned table.\n\n    Arguments:\n\n        name -- str, name of the named range\n\n        crange -- str or tuple of int, cell or area coordinate\n\n        table_name -- str, name of the table\n\n        uage -- None or 'print-range', 'filter', 'repeat-column', 'repeat-row'\n    \"\"\"\n    body = self.document_body\n    if not body:\n        raise ValueError(\"Table is not inside a document\")\n    if not name:\n        raise ValueError(\"Name required.\")\n    if table_name is None:\n        table_name = self.name\n    named_range = NamedRange(name, crange, table_name, usage)\n    body.append_named_range(named_range)\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_row","title":"<code>set_row(y, row=None, clone=True)</code>","text":"<p>Replace the row at the given position with the new one. Repetions of the old row will be adjusted.</p> <p>If row is None, a new empty row is created.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\nrow -- Row\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_row(self, y: int | str, row: Row | None = None, clone: bool = True) -&gt; Row:\n    \"\"\"Replace the row at the given position with the new one. Repetions of\n    the old row will be adjusted.\n\n    If row is None, a new empty row is created.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n\n        row -- Row\n\n    returns the row, with updated row.y\n    \"\"\"\n    if row is None:\n        row = Row()\n        repeated = 1\n        clone = False\n    else:\n        repeated = row.repeated or 1\n    y = self._translate_y_from_any(y)\n    row.y = y\n    # Outside the defined table ?\n    diff = y - self.height\n    if diff == 0:\n        row_back = self.append_row(row, _repeated=repeated, clone=clone)\n    elif diff &gt; 0:\n        self.append_row(Row(repeated=diff), _repeated=diff, clone=clone)\n        row_back = self.append_row(row, _repeated=repeated, clone=clone)\n    else:\n        # Inside the defined table\n        row_back = set_item_in_vault(  # type: ignore\n            y, row, self, _xpath_row_idx, \"_tmap\", clone=clone\n        )\n    # print self.serialize(True)\n    # Update width if necessary\n    self._update_width(row_back)\n    return row_back\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_row_cells","title":"<code>set_row_cells(y, cells=None)</code>","text":"<p>Shortcut to set all the cells of the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\ncells -- list of Python types\n\nstyle -- str\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_row_cells(self, y: int | str, cells: list | None = None) -&gt; Row:\n    \"\"\"Shortcut to set *all* the cells of the row at the given\n    \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n\n        cells -- list of Python types\n\n        style -- str\n\n    returns the row, with updated row.y\n    \"\"\"\n    if cells is None:\n        cells = []\n    row = Row()  # needed if clones rows\n    row.extend_cells(cells)\n    return self.set_row(y, row)  # needed if clones rows\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_row_values","title":"<code>set_row_values(y, values, cell_type=None, currency=None, style=None)</code>","text":"<p>Shortcut to set the values of all cells of the row at the given \u201cy\u201d position.</p> <p>Position start at 0. So cell A4 is on row 3.</p> <p>Arguments:</p> <pre><code>y -- int or str\n\nvalues -- list of Python types\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> <p>returns the row, with updated row.y</p> Source code in <code>odfdo/table.py</code> <pre><code>def set_row_values(\n    self,\n    y: int | str,\n    values: list,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; Row:\n    \"\"\"Shortcut to set the values of *all* cells of the row at the given\n    \"y\" position.\n\n    Position start at 0. So cell A4 is on row 3.\n\n    Arguments:\n\n        y -- int or str\n\n        values -- list of Python types\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n\n    returns the row, with updated row.y\n    \"\"\"\n    row = Row()  # needed if clones rows\n    row.set_values(values, style=style, cell_type=cell_type, currency=currency)\n    return self.set_row(y, row)  # needed if clones rows\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_span","title":"<code>set_span(area, merge=False)</code>","text":"<p>Create a Cell Span : span the first cell of the area on several columns and/or rows. If merge is True, replace text of the cell by the concatenation of existing text in covered cells. Beware : if merge is True, old text is changed, if merge is False (the default), old text in coverd cells is still present but not displayed by most GUI.</p> <p>If the area defines only one cell, the set span will do nothing. It is not allowed to apply set span to an area whose one cell already belongs to previous cell span.</p> <p>Area can be either one cell (like \u2018A1\u2019) or an area (\u2018A1:B2\u2019). It can be provided as an alpha numeric value like \u201cA1:B2\u2019 or a tuple like (0, 0, 1, 1) or (0, 0).</p> <p>Arguments:</p> <pre><code>area -- str or tuple of int, cell or area coordinate\n\nmerge -- boolean\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_span(  # noqa: C901\n    self,\n    area: str | tuple | list,\n    merge: bool = False,\n) -&gt; bool:\n    \"\"\"Create a Cell Span : span the first cell of the area on several\n    columns and/or rows.\n    If merge is True, replace text of the cell by the concatenation of\n    existing text in covered cells.\n    Beware : if merge is True, old text is changed, if merge is False\n    (the default), old text in coverd cells is still present but not\n    displayed by most GUI.\n\n    If the area defines only one cell, the set span will do nothing.\n    It is not allowed to apply set span to an area whose one cell already\n    belongs to previous cell span.\n\n    Area can be either one cell (like 'A1') or an area ('A1:B2'). It can\n    be provided as an alpha numeric value like \"A1:B2' or a tuple like\n    (0, 0, 1, 1) or (0, 0).\n\n    Arguments:\n\n        area -- str or tuple of int, cell or area coordinate\n\n        merge -- boolean\n    \"\"\"\n    # get area\n    digits = convert_coordinates(area)\n    if len(digits) == 4:\n        x, y, z, t = digits\n    else:\n        x, y = digits\n        z, t = digits\n    start = x, y\n    end = z, t\n    if start == end:\n        # one cell : do nothing\n        return False\n    if x is None:\n        raise ValueError\n    if y is None:\n        raise ValueError\n    if z is None:\n        raise ValueError\n    if t is None:\n        raise ValueError\n    # check for previous span\n    good = True\n    # Check boundaries and empty cells : need to crate non existent cells\n    # so don't use get_cells directly, but get_cell\n    cells = []\n    for yy in range(y, t + 1):\n        row_cells = []\n        for xx in range(x, z + 1):\n            row_cells.append(\n                self.get_cell((xx, yy), clone=True, keep_repeated=False)\n            )\n        cells.append(row_cells)\n    for row in cells:\n        for cell in row:\n            if cell.is_spanned():\n                good = False\n                break\n        if not good:\n            break\n    if not good:\n        return False\n    # Check boundaries\n    # if z &gt;= self.width or t &gt;= self.height:\n    #    self.set_cell(coord = end)\n    #    print area, z, t\n    #    cells = self.get_cells((x, y, z, t))\n    #    print cells\n    # do it:\n    if merge:\n        val_list = []\n        for row in cells:\n            for cell in row:\n                if cell.is_empty(aggressive=True):\n                    continue\n                val = cell.get_value()\n                if val is not None:\n                    if isinstance(val, str):\n                        val.strip()\n                    if val != \"\":\n                        val_list.append(val)\n                    cell.clear()\n        if val_list:\n            if len(val_list) == 1:\n                cells[0][0].set_value(val_list[0])\n            else:\n                value = \" \".join([str(v) for v in val_list if v])\n                cells[0][0].set_value(value)\n    cols = z - x + 1\n    cells[0][0].set_attribute(\"table:number-columns-spanned\", str(cols))\n    rows = t - y + 1\n    cells[0][0].set_attribute(\"table:number-rows-spanned\", str(rows))\n    for cell in cells[0][1:]:\n        cell.tag = \"table:covered-table-cell\"\n    for row in cells[1:]:\n        for cell in row:\n            cell.tag = \"table:covered-table-cell\"\n    # replace cells in table\n    self.set_cells(cells, coord=start, clone=False)\n    return True\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_value","title":"<code>set_value(coord, value, cell_type=None, currency=None, style=None)</code>","text":"<p>Set the Python value of the cell at the given coordinates.</p> <p>They are either a 2-uplet of (x, y) starting from 0, or a human-readable position like \u201cC4\u201d.</p> <p>Arguments:</p> <pre><code>coord -- (int, int) or str\n\nvalue -- Python type\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n         'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_value(\n    self,\n    coord: tuple | list | str,\n    value: Any,\n    cell_type: str | None = None,\n    currency: str | None = None,\n    style: str | None = None,\n) -&gt; None:\n    \"\"\"Set the Python value of the cell at the given coordinates.\n\n    They are either a 2-uplet of (x, y) starting from 0, or a\n    human-readable position like \"C4\".\n\n    Arguments:\n\n        coord -- (int, int) or str\n\n        value -- Python type\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                 'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n\n    \"\"\"\n    self.set_cell(\n        coord,\n        Cell(value, cell_type=cell_type, currency=currency, style=style),\n        clone=False,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.Table.set_values","title":"<code>set_values(values, coord=None, style=None, cell_type=None, currency=None)</code>","text":"<p>Set the value of cells in the table, from the \u2018coord\u2019 position with values.</p> <p>\u2018coord\u2019 is the coordinate of the upper left cell to be modified by values. If \u2018coord\u2019 is None, default to the position (0,0) (\u201cA1\u201d). If \u2018coord\u2019 is an area (e.g. \u201cA2:B5\u201d), the upper left position of this area is used as coordinate.</p> <p>The table is not cleared before the operation, to reset the table before setting values, use table.clear().</p> <p>A list of lists is expected, with as many lists as rows, and as many items in each sublist as cells to be setted. None values in the list will create empty cells with no cell type (but eventually a style).</p> <p>Arguments:</p> <pre><code>coord -- tuple or str\n\nvalues -- list of lists of python types\n\ncell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n             'string' or 'time'\n\ncurrency -- three-letter str\n\nstyle -- str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def set_values(\n    self,\n    values: list,\n    coord: tuple | list | str | None = None,\n    style: str | None = None,\n    cell_type: str | None = None,\n    currency: str | None = None,\n) -&gt; None:\n    \"\"\"Set the value of cells in the table, from the 'coord' position\n    with values.\n\n    'coord' is the coordinate of the upper left cell to be modified by\n    values. If 'coord' is None, default to the position (0,0) (\"A1\").\n    If 'coord' is an area (e.g. \"A2:B5\"), the upper left position of this\n    area is used as coordinate.\n\n    The table is *not* cleared before the operation, to reset the table\n    before setting values, use table.clear().\n\n    A list of lists is expected, with as many lists as rows, and as many\n    items in each sublist as cells to be setted. None values in the list\n    will create empty cells with no cell type (but eventually a style).\n\n    Arguments:\n\n        coord -- tuple or str\n\n        values -- list of lists of python types\n\n        cell_type -- 'boolean', 'currency', 'date', 'float', 'percentage',\n                     'string' or 'time'\n\n        currency -- three-letter str\n\n        style -- str\n    \"\"\"\n    if coord:\n        x, y = self._translate_cell_coordinates(coord)\n    else:\n        x = y = 0\n    if y is None:\n        y = 0\n    if x is None:\n        x = 0\n    y -= 1\n    for row_values in values:\n        y += 1\n        if not row_values:\n            continue\n        row = self.get_row(y, clone=True)\n        repeated = row.repeated or 1\n        if repeated &gt;= 2:\n            row.repeated = None\n        row.set_values(\n            row_values,\n            start=x,\n            cell_type=cell_type,\n            currency=currency,\n            style=style,\n        )\n        self.set_row(y, row, clone=False)\n        self._update_width(row)\n</code></pre>"},{"location":"reference.html#odfdo.Table.to_csv","title":"<code>to_csv(path_or_file=None, dialect='excel')</code>","text":"<p>Write the table as CSV in the file.</p> <p>If the file is a string, it is opened as a local path. Else an opened file-like is expected.</p> <p>Arguments:</p> <pre><code>path_or_file -- str or file-like\n\ndialect -- str, python csv.dialect, can be 'excel', 'unix'...\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def to_csv(\n    self,\n    path_or_file: str | Path | None = None,\n    dialect: str = \"excel\",\n) -&gt; Any:\n    \"\"\"Write the table as CSV in the file.\n\n    If the file is a string, it is opened as a local path. Else an\n    opened file-like is expected.\n\n    Arguments:\n\n        path_or_file -- str or file-like\n\n        dialect -- str, python csv.dialect, can be 'excel', 'unix'...\n    \"\"\"\n\n    def write_content(csv_writer: object) -&gt; None:\n        for values in self.iter_values():\n            line = []\n            for value in values:\n                if value is None:\n                    value = \"\"\n                if isinstance(value, str):\n                    value = value.strip()\n                line.append(value)\n            csv_writer.writerow(line)  # type: ignore\n\n    out = StringIO(newline=\"\")\n    csv_writer = csv.writer(out, dialect=dialect)\n    write_content(csv_writer)\n    if path_or_file is None:\n        return out.getvalue()\n    path = Path(path_or_file)\n    path.write_text(out.getvalue())\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.Table.transpose","title":"<code>transpose(coord=None)</code>","text":"<p>Swap in-place rows and columns of the table.</p> <p>If \u2018coord\u2019 is not None, apply transpose only to the area defined by the coordinates. Beware, if area is not square, some cells mays be over written during the process.</p> <p>Arguments:</p> <pre><code>coord -- str or tuple of int : coordinates of area\n\nstart -- int or str\n</code></pre> Source code in <code>odfdo/table.py</code> <pre><code>def transpose(self, coord: tuple | list | str | None = None) -&gt; None:  # noqa: C901\n    \"\"\"Swap *in-place* rows and columns of the table.\n\n    If 'coord' is not None, apply transpose only to the area defined by the\n    coordinates. Beware, if area is not square, some cells mays be over\n    written during the process.\n\n    Arguments:\n\n        coord -- str or tuple of int : coordinates of area\n\n        start -- int or str\n    \"\"\"\n    data = []\n    if coord is None:\n        for row in self.traverse():\n            data.append(list(row.traverse()))\n        transposed_data = zip_longest(*data)\n        self.clear()\n        # new_rows = []\n        for row_cells in transposed_data:\n            if not isiterable(row_cells):\n                row_cells = (row_cells,)\n            row = Row()\n            row.extend_cells(row_cells)\n            self.append_row(row, clone=False)\n        self._compute_table_cache()\n    else:\n        x, y, z, t = self._translate_table_coordinates(coord)\n        if x is None:\n            x = 0\n        else:\n            x = min(x, self.width - 1)\n        if z is None:\n            z = self.width - 1\n        else:\n            z = min(z, self.width - 1)\n        if y is None:\n            y = 0\n        else:\n            y = min(y, self.height - 1)\n        if t is None:\n            t = self.height - 1\n        else:\n            t = min(t, self.height - 1)\n        for row in self.traverse(start=y, end=t):\n            data.append(list(row.traverse(start=x, end=z)))\n        transposed_data = zip_longest(*data)\n        # clear locally\n        w = z - x + 1\n        h = t - y + 1\n        if w != h:\n            nones = [[None] * w for i in range(h)]\n            self.set_values(nones, coord=(x, y, z, t))\n        # put transposed\n        filtered_data: list[tuple[Cell]] = []\n        for row_cells in transposed_data:\n            if isinstance(row_cells, (list, tuple)):\n                filtered_data.append(row_cells)\n            else:\n                filtered_data.append((row_cells,))\n        self.set_cells(filtered_data, (x, y, x + h - 1, y + w - 1))\n        self._compute_table_cache()\n</code></pre>"},{"location":"reference.html#odfdo.Table.traverse","title":"<code>traverse(start=None, end=None)</code>","text":"<p>Yield as many row elements as expected rows in the table, i.e. expand repetitions by returning the same row as many times as necessary.</p> <pre><code>Arguments:\n\n    start -- int\n\n    end -- int\n</code></pre> <p>Copies are returned, use set_row() to push them back.</p> Source code in <code>odfdo/table.py</code> <pre><code>def traverse(  # noqa: C901\n    self,\n    start: int | None = None,\n    end: int | None = None,\n) -&gt; Iterator[Row]:\n    \"\"\"Yield as many row elements as expected rows in the table, i.e.\n    expand repetitions by returning the same row as many times as\n    necessary.\n\n        Arguments:\n\n            start -- int\n\n            end -- int\n\n    Copies are returned, use set_row() to push them back.\n    \"\"\"\n    idx = -1\n    before = -1\n    y = 0\n    if start is None and end is None:\n        for juska in self._tmap:\n            idx += 1\n            if idx in self._indexes[\"_tmap\"]:\n                row = self._indexes[\"_tmap\"][idx]\n            else:\n                row = self._get_element_idx2(_xpath_row_idx, idx)\n                self._indexes[\"_tmap\"][idx] = row\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                # Return a copy without the now obsolete repetition\n                row = row.clone\n                row.y = y\n                y += 1\n                if repeated &gt; 1:\n                    row.repeated = None\n                yield row\n    else:\n        if start is None:\n            start = 0\n        start = max(0, start)\n        if end is None:\n            try:\n                end = self._tmap[-1]\n            except Exception:\n                end = -1\n        start_map = find_odf_idx(self._tmap, start)\n        if start_map is None:\n            return\n        if start_map &gt; 0:\n            before = self._tmap[start_map - 1]\n        idx = start_map - 1\n        before = start - 1\n        y = start\n        for juska in self._tmap[start_map:]:\n            idx += 1\n            if idx in self._indexes[\"_tmap\"]:\n                row = self._indexes[\"_tmap\"][idx]\n            else:\n                row = self._get_element_idx2(_xpath_row_idx, idx)\n                self._indexes[\"_tmap\"][idx] = row\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                if y &lt;= end:\n                    row = row.clone\n                    row.y = y\n                    y += 1\n                    if repeated &gt; 1 or (y == start and start &gt; 0):\n                        row.repeated = None\n                    yield row\n</code></pre>"},{"location":"reference.html#odfdo.Table.traverse_columns","title":"<code>traverse_columns(start=None, end=None)</code>","text":"<p>Yield as many column elements as expected columns in the table, i.e. expand repetitions by returning the same column as many times as necessary.</p> <pre><code>Arguments:\n\n    start -- int\n\n    end -- int\n</code></pre> <p>Copies are returned, use set_column() to push them back.</p> Source code in <code>odfdo/table.py</code> <pre><code>def traverse_columns(  # noqa: C901\n    self,\n    start: int | None = None,\n    end: int | None = None,\n) -&gt; Iterator[Column]:\n    \"\"\"Yield as many column elements as expected columns in the table,\n    i.e. expand repetitions by returning the same column as many times as\n    necessary.\n\n        Arguments:\n\n            start -- int\n\n            end -- int\n\n    Copies are returned, use set_column() to push them back.\n    \"\"\"\n    idx = -1\n    before = -1\n    x = 0\n    if start is None and end is None:\n        for juska in self._cmap:\n            idx += 1\n            if idx in self._indexes[\"_cmap\"]:\n                column = self._indexes[\"_cmap\"][idx]\n            else:\n                column = self._get_element_idx2(_xpath_column_idx, idx)\n                self._indexes[\"_cmap\"][idx] = column\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                # Return a copy without the now obsolete repetition\n                column = column.clone\n                column.x = x\n                x += 1\n                if repeated &gt; 1:\n                    column.repeated = None\n                yield column\n    else:\n        if start is None:\n            start = 0\n        start = max(0, start)\n        if end is None:\n            try:\n                end = self._cmap[-1]\n            except Exception:\n                end = -1\n        start_map = find_odf_idx(self._cmap, start)\n        if start_map is None:\n            return\n        if start_map &gt; 0:\n            before = self._cmap[start_map - 1]\n        idx = start_map - 1\n        before = start - 1\n        x = start\n        for juska in self._cmap[start_map:]:\n            idx += 1\n            if idx in self._indexes[\"_cmap\"]:\n                column = self._indexes[\"_cmap\"][idx]\n            else:\n                column = self._get_element_idx2(_xpath_column_idx, idx)\n                self._indexes[\"_cmap\"][idx] = column\n            repeated = juska - before\n            before = juska\n            for _i in range(repeated or 1):\n                if x &lt;= end:\n                    column = column.clone\n                    column.x = x\n                    x += 1\n                    if repeated &gt; 1 or (x == start and start &gt; 0):\n                        column.repeated = None\n                    yield column\n</code></pre>"},{"location":"reference.html#odfdo.Text","title":"<code>Text</code>","text":"<p>               Bases: <code>Body</code></p> <p>Text, specialized class of Element in charge of actual content management.</p> Source code in <code>odfdo/body.py</code> <pre><code>class Text(Body):\n    \"\"\"Text, specialized class of Element in charge of actual content\n    management.\n    \"\"\"\n\n    _tag: str = \"office:text\"\n    _caching: bool = False\n    _properties: tuple[PropDef, ...] = ()\n</code></pre>"},{"location":"reference.html#odfdo.TextChange","title":"<code>TextChange</code>","text":"<p>               Bases: <code>Element</code></p> <p>The TextChange \u201ctext:change\u201d element marks a position in an empty region where text has been deleted.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChange(Element):\n    \"\"\"The TextChange \"text:change\" element marks a position in an empty\n    region where text has been deleted.\n    \"\"\"\n\n    _tag = \"text:change\"\n\n    def get_id(self) -&gt; str | None:\n        return self.get_attribute_string(\"text:change-id\")\n\n    def set_id(self, idx: str) -&gt; None:\n        self.set_attribute(\"text:change-id\", idx)\n\n    def _get_tracked_changes(self) -&gt; Element | None:\n        body = self.document_body\n        if not body:\n            raise ValueError\n        return body.get_tracked_changes()\n\n    def get_changed_region(\n        self,\n        tracked_changes: Element | None = None,\n    ) -&gt; Element | None:\n        if not tracked_changes:\n            tracked_changes = self._get_tracked_changes()\n        idx = self.get_id()\n        return tracked_changes.get_changed_region(text_id=idx)  # type: ignore\n\n    def get_change_info(\n        self,\n        tracked_changes: Element | None = None,\n    ) -&gt; Element | None:\n        changed_region = self.get_changed_region(tracked_changes=tracked_changes)\n        if not changed_region:\n            return None\n        return changed_region.get_change_info()  # type: ignore\n\n    def get_change_element(\n        self,\n        tracked_changes: Element | None = None,\n    ) -&gt; Element | None:\n        changed_region = self.get_changed_region(tracked_changes=tracked_changes)\n        if not changed_region:\n            return None\n        return changed_region.get_change_element()  # type: ignore\n\n    def get_deleted(\n        self,\n        tracked_changes: Element | None = None,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; Element | None:\n        \"\"\"Shortcut to get the deleted informations stored in the\n        TextDeletion stored in the tracked changes.\n\n        Return: Paragraph (or None).\"\n        \"\"\"\n        changed = self.get_change_element(tracked_changes=tracked_changes)\n        if not changed:\n            return None\n        return changed.get_deleted(  # type: ignore\n            as_text=as_text,\n            no_header=no_header,\n            clean=clean,\n        )\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Return None.\"\"\"\n        return None\n\n    def get_start(self) -&gt; TextChangeStart | None:\n        \"\"\"Return None.\"\"\"\n        return None\n\n    def get_end(self) -&gt; TextChangeEnd | None:\n        \"\"\"Return None.\"\"\"\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_deleted","title":"<code>get_deleted(tracked_changes=None, as_text=False, no_header=False, clean=True)</code>","text":"<p>Shortcut to get the deleted informations stored in the TextDeletion stored in the tracked changes.</p> <p>Return: Paragraph (or None).\u201d</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(\n    self,\n    tracked_changes: Element | None = None,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; Element | None:\n    \"\"\"Shortcut to get the deleted informations stored in the\n    TextDeletion stored in the tracked changes.\n\n    Return: Paragraph (or None).\"\n    \"\"\"\n    changed = self.get_change_element(tracked_changes=tracked_changes)\n    if not changed:\n        return None\n    return changed.get_deleted(  # type: ignore\n        as_text=as_text,\n        no_header=no_header,\n        clean=clean,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_end","title":"<code>get_end()</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_end(self) -&gt; TextChangeEnd | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChange.get_start","title":"<code>get_start()</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_start(self) -&gt; TextChangeStart | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd","title":"<code>TextChangeEnd</code>","text":"<p>               Bases: <code>TextChange</code></p> <p>The TextChangeEnd \u201ctext:change-end\u201d element marks the end of a region with content where text has been inserted or the format has been changed.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChangeEnd(TextChange):\n    \"\"\"The TextChangeEnd \"text:change-end\" element marks the end of a region\n    with content where text has been inserted or the format has been\n    changed.\n    \"\"\"\n\n    _tag = \"text:change-end\"\n\n    def get_start(self) -&gt; TextChangeStart | None:\n        \"\"\"Return the corresponding annotation starting tag or None.\"\"\"\n        idx = self.get_id()\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can not find end tag: no parent available.\")\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_text_change_start(idx=idx)  # type: ignore\n\n    def get_end(self) -&gt; TextChangeEnd | None:\n        \"\"\"Return self.\"\"\"\n        return self\n\n    def get_deleted(self, *args: Any, **kwargs: Any) -&gt; Element | None:\n        \"\"\"Return None.\"\"\"\n        return None\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Return the content between text:change-start and text:change-end.\n\n        If no content exists (deletion tag), returns None (or '' if text flag\n        is True).\n        If as_text is True: returns the text content.\n        If clean is True: suppress unwanted tags (deletions marks, ...)\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of Element, cleaned and with headers\n\n        Arguments:\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list or Element or text\n        \"\"\"\n\n        # idx = self.get_id()\n        start = self.get_start()\n        end = self.get_end()\n        if end is None or start is None:\n            if as_text:\n                return \"\"\n            return None\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_between(\n            start, end, as_text=as_text, no_header=no_header, clean=clean\n        )\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_deleted","title":"<code>get_deleted(*args, **kwargs)</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(self, *args: Any, **kwargs: Any) -&gt; Element | None:\n    \"\"\"Return None.\"\"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_end","title":"<code>get_end()</code>","text":"<p>Return self.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_end(self) -&gt; TextChangeEnd | None:\n    \"\"\"Return self.\"\"\"\n    return self\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Return the content between text:change-start and text:change-end.</p> <p>If no content exists (deletion tag), returns None (or \u2018\u2019 if text flag is True). If as_text is True: returns the text content. If clean is True: suppress unwanted tags (deletions marks, \u2026) If no_header is True: existing text:h are changed in text:p By default: returns a list of Element, cleaned and with headers</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list or Element or text</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Return the content between text:change-start and text:change-end.\n\n    If no content exists (deletion tag), returns None (or '' if text flag\n    is True).\n    If as_text is True: returns the text content.\n    If clean is True: suppress unwanted tags (deletions marks, ...)\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of Element, cleaned and with headers\n\n    Arguments:\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list or Element or text\n    \"\"\"\n\n    # idx = self.get_id()\n    start = self.get_start()\n    end = self.get_end()\n    if end is None or start is None:\n        if as_text:\n            return \"\"\n        return None\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_between(\n        start, end, as_text=as_text, no_header=no_header, clean=clean\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeEnd.get_start","title":"<code>get_start()</code>","text":"<p>Return the corresponding annotation starting tag or None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_start(self) -&gt; TextChangeStart | None:\n    \"\"\"Return the corresponding annotation starting tag or None.\"\"\"\n    idx = self.get_id()\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Can not find end tag: no parent available.\")\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_text_change_start(idx=idx)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart","title":"<code>TextChangeStart</code>","text":"<p>               Bases: <code>TextChangeEnd</code></p> <p>The TextChangeStart \u201ctext:change-start\u201d element marks the start of a region with content where text has been inserted or the format has been changed.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChangeStart(TextChangeEnd):\n    \"\"\"The TextChangeStart \"text:change-start\" element marks the start of a\n    region with content where text has been inserted or the format has\n    been changed.\n    \"\"\"\n\n    _tag = \"text:change-start\"\n\n    def get_start(self) -&gt; TextChangeStart:\n        \"\"\"Return self.\"\"\"\n        return self\n\n    def get_end(self) -&gt; TextChangeEnd:\n        \"\"\"Return the corresponding change-end tag or None.\"\"\"\n        idx = self.get_id()\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"Can not find end tag: no parent available.\")\n        body = self.document_body\n        if not body:\n            body = self.root\n        return body.get_text_change_end(idx=idx)  # type: ignore\n\n    def delete(\n        self,\n        child: Element | None = None,\n        keep_tail: bool = True,\n    ) -&gt; None:\n        \"\"\"Delete the given element from the XML tree. If no element is given,\n        \"self\" is deleted. The XML library may allow to continue to use an\n        element now \"orphan\" as long as you have a reference to it.\n\n        For TextChangeStart : delete also the end tag if exists.\n\n        Arguments:\n\n            child -- Element\n\n            keep_tail -- boolean (default to True), True for most usages.\n        \"\"\"\n        if child is not None:  # act like normal delete\n            return super().delete(child, keep_tail)\n        idx = self.get_id()\n        parent = self.parent\n        if parent is None:\n            raise ValueError(\"cannot delete the root element\")\n        body = self.document_body\n        if not body:\n            body = parent\n        end = body.get_text_change_end(idx=idx)\n        if end:\n            end.delete()\n        # act like normal delete\n        super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart.delete","title":"<code>delete(child=None, keep_tail=True)</code>","text":"<p>Delete the given element from the XML tree. If no element is given, \u201cself\u201d is deleted. The XML library may allow to continue to use an element now \u201corphan\u201d as long as you have a reference to it.</p> <p>For TextChangeStart : delete also the end tag if exists.</p> <p>Arguments:</p> <pre><code>child -- Element\n\nkeep_tail -- boolean (default to True), True for most usages.\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def delete(\n    self,\n    child: Element | None = None,\n    keep_tail: bool = True,\n) -&gt; None:\n    \"\"\"Delete the given element from the XML tree. If no element is given,\n    \"self\" is deleted. The XML library may allow to continue to use an\n    element now \"orphan\" as long as you have a reference to it.\n\n    For TextChangeStart : delete also the end tag if exists.\n\n    Arguments:\n\n        child -- Element\n\n        keep_tail -- boolean (default to True), True for most usages.\n    \"\"\"\n    if child is not None:  # act like normal delete\n        return super().delete(child, keep_tail)\n    idx = self.get_id()\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"cannot delete the root element\")\n    body = self.document_body\n    if not body:\n        body = parent\n    end = body.get_text_change_end(idx=idx)\n    if end:\n        end.delete()\n    # act like normal delete\n    super().delete()\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart.get_end","title":"<code>get_end()</code>","text":"<p>Return the corresponding change-end tag or None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_end(self) -&gt; TextChangeEnd:\n    \"\"\"Return the corresponding change-end tag or None.\"\"\"\n    idx = self.get_id()\n    parent = self.parent\n    if parent is None:\n        raise ValueError(\"Can not find end tag: no parent available.\")\n    body = self.document_body\n    if not body:\n        body = self.root\n    return body.get_text_change_end(idx=idx)  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.TextChangeStart.get_start","title":"<code>get_start()</code>","text":"<p>Return self.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_start(self) -&gt; TextChangeStart:\n    \"\"\"Return self.\"\"\"\n    return self\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion","title":"<code>TextChangedRegion</code>","text":"<p>               Bases: <code>Element</code></p> <p>Each TextChangedRegion \u201ctext:changed-region\u201d element contains a single element, one of TextInsertion, TextDeletion or TextFormatChange that corresponds to a change being tracked within the scope of the \u201ctext:tracked-changes\u201d element that contains the \u201ctext:changed-region\u201d instance. The xml:id attribute of the TextChangedRegion is referenced from the \u201ctext:change\u201d, \u201ctext:change-start\u201d and \u201ctext:change-end\u201d elements that identify where the change applies to markup in the scope of the \u201ctext:tracked-changes\u201d element.</p> for this implementation, text:change should be referenced only <p>once in the scope, which is different from ODF 1.2 requirement:</p> <pre><code>     \" A \"text:changed-region\" can be referenced by more than one\n     change, but the corresponding referencing change mark elements\n     shall be of the same change type - insertion, format change or\n     deletion. \"\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextChangedRegion(Element):\n    \"\"\"Each TextChangedRegion \"text:changed-region\" element contains a single\n    element, one of TextInsertion, TextDeletion or TextFormatChange that\n    corresponds to a change being tracked within the scope of the\n    \"text:tracked-changes\" element that contains the \"text:changed-region\"\n    instance.\n    The xml:id attribute of the TextChangedRegion is referenced\n    from the \"text:change\", \"text:change-start\" and \"text:change-end\"\n    elements that identify where the change applies to markup in the scope of\n    the \"text:tracked-changes\" element.\n\n    Warning : for this implementation, text:change should be referenced only\n              once in the scope, which is different from ODF 1.2 requirement:\n             \" A \"text:changed-region\" can be referenced by more than one\n             change, but the corresponding referencing change mark elements\n             shall be of the same change type - insertion, format change or\n             deletion. \"\n    \"\"\"\n\n    _tag = \"text:changed-region\"\n\n    def get_change_info(self) -&gt; Element | None:\n        \"\"\"Shortcut to get the ChangeInfo element of the change\n        element child.\n\n        Return: ChangeInfo element.\n        \"\"\"\n        return self.get_element(\"descendant::office:change-info\")\n\n    def set_change_info(\n        self,\n        change_info: Element | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        comments: Element | list[Element] | None = None,\n    ) -&gt; None:\n        \"\"\"Shortcut to set the ChangeInfo element of the sub change element.\n        See TextInsertion.set_change_info() for details.\n\n        Arguments:\n\n             change_info -- ChangeInfo element (or None)\n\n             cretor -- str (or None)\n\n             date -- datetime (or None)\n\n             comments -- Paragraph or list of Paragraph elements (or None)\n        \"\"\"\n        child = self.get_change_element()\n        if not child:\n            raise ValueError\n        child.set_change_info(  # type: ignore\n            change_info=change_info, creator=creator, date=date, comments=comments\n        )\n\n    def get_change_element(self) -&gt; Element | None:\n        \"\"\"Get the change element child. It can be either: TextInsertion,\n        TextDeletion, or TextFormatChange as an Element object.\n\n        Return: Element.\n        \"\"\"\n        request = (\n            \"descendant::text:insertion \"\n            \"| descendant::text:deletion\"\n            \"| descendant::text:format-change\"\n        )\n        return self._filtered_element(request, 0)\n\n    def _get_text_id(self) -&gt; str | None:\n        return self.get_attribute_string(\"text:id\")\n\n    def _set_text_id(self, text_id: str) -&gt; None:\n        self.set_attribute(\"text:id\", text_id)\n\n    def _get_xml_id(self) -&gt; str | None:\n        return self.get_attribute_string(\"xml:id\")\n\n    def _set_xml_id(self, xml_id: str) -&gt; None:\n        self.set_attribute(\"xml:id\", xml_id)\n\n    def get_id(self) -&gt; str | None:\n        \"\"\"Get the \"text:id\" attribute.\n\n        Return: str\n        \"\"\"\n        return self._get_text_id()\n\n    def set_id(self, idx: str) -&gt; None:\n        \"\"\"Set both the \"text:id\" and \"xml:id\" attributes with same value.\"\"\"\n        self._set_text_id(idx)\n        self._set_xml_id(idx)\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.get_change_element","title":"<code>get_change_element()</code>","text":"<p>Get the change element child. It can be either: TextInsertion, TextDeletion, or TextFormatChange as an Element object.</p> <p>Return: Element.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_change_element(self) -&gt; Element | None:\n    \"\"\"Get the change element child. It can be either: TextInsertion,\n    TextDeletion, or TextFormatChange as an Element object.\n\n    Return: Element.\n    \"\"\"\n    request = (\n        \"descendant::text:insertion \"\n        \"| descendant::text:deletion\"\n        \"| descendant::text:format-change\"\n    )\n    return self._filtered_element(request, 0)\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.get_change_info","title":"<code>get_change_info()</code>","text":"<p>Shortcut to get the ChangeInfo element of the change element child.</p> <p>Return: ChangeInfo element.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_change_info(self) -&gt; Element | None:\n    \"\"\"Shortcut to get the ChangeInfo element of the change\n    element child.\n\n    Return: ChangeInfo element.\n    \"\"\"\n    return self.get_element(\"descendant::office:change-info\")\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.get_id","title":"<code>get_id()</code>","text":"<p>Get the \u201ctext:id\u201d attribute.</p> <p>Return: str</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_id(self) -&gt; str | None:\n    \"\"\"Get the \"text:id\" attribute.\n\n    Return: str\n    \"\"\"\n    return self._get_text_id()\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.set_change_info","title":"<code>set_change_info(change_info=None, creator=None, date=None, comments=None)</code>","text":"<p>Shortcut to set the ChangeInfo element of the sub change element. See TextInsertion.set_change_info() for details.</p> <p>Arguments:</p> <pre><code> change_info -- ChangeInfo element (or None)\n\n cretor -- str (or None)\n\n date -- datetime (or None)\n\n comments -- Paragraph or list of Paragraph elements (or None)\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_change_info(\n    self,\n    change_info: Element | None = None,\n    creator: str | None = None,\n    date: datetime | None = None,\n    comments: Element | list[Element] | None = None,\n) -&gt; None:\n    \"\"\"Shortcut to set the ChangeInfo element of the sub change element.\n    See TextInsertion.set_change_info() for details.\n\n    Arguments:\n\n         change_info -- ChangeInfo element (or None)\n\n         cretor -- str (or None)\n\n         date -- datetime (or None)\n\n         comments -- Paragraph or list of Paragraph elements (or None)\n    \"\"\"\n    child = self.get_change_element()\n    if not child:\n        raise ValueError\n    child.set_change_info(  # type: ignore\n        change_info=change_info, creator=creator, date=date, comments=comments\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextChangedRegion.set_id","title":"<code>set_id(idx)</code>","text":"<p>Set both the \u201ctext:id\u201d and \u201cxml:id\u201d attributes with same value.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_id(self, idx: str) -&gt; None:\n    \"\"\"Set both the \"text:id\" and \"xml:id\" attributes with same value.\"\"\"\n    self._set_text_id(idx)\n    self._set_xml_id(idx)\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion","title":"<code>TextDeletion</code>","text":"<p>               Bases: <code>TextInsertion</code></p> <p>The TextDeletion \u201ctext:deletion\u201d contains information that identifies the person responsible for a deletion and the date of that deletion. This information may also contain one or more Paragraph which contains a comment on the deletion. The TextDeletion element may also contain content that was deleted while change tracking was enabled. The position where the text was deleted is marked by a \u201ctext:change\u201d element. Deleted text is contained in a paragraph element. To reconstruct the original text, the paragraph containing the deleted text is merged with its surrounding paragraph or heading element. To reconstruct the text before a deletion took place:   - If the change mark is inside a paragraph, insert the content that was   deleted, but remove all leading start tags up to and including the   first \u201ctext:p\u201d element and all trailing end tags up to and including   the last \u201c/text:p\u201d or \u201c/text:h\u201d element. If the last trailing element   is a \u201c/text:h\u201d, change the end tag \u201c/text:p\u201d following this insertion   to a \u201c/text:h\u201d element.   - If the change mark is inside a heading, insert the content that was   deleted, but remove all leading start tags up to and including the   first \u201ctext:h\u201d element and all trailing end tags up to and including   the last \u201c/text:h\u201d or \u201c/text:p\u201d element. If the last trailing element   is a \u201c/text:p\u201d, change the end tag \u201c/text:h\u201d following this insertion   to a \u201c/text:p\u201d element.   - Otherwise, copy the text content of the \u201ctext:deletion\u201d element in   place of the change mark.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextDeletion(TextInsertion):\n    \"\"\"The TextDeletion \"text:deletion\" contains information that identifies\n    the person responsible for a deletion and the date of that deletion.\n    This information may also contain one or more Paragraph which contains\n    a comment on the deletion. The TextDeletion element may also contain\n    content that was deleted while change tracking was enabled. The position\n    where the text was deleted is marked by a \"text:change\" element. Deleted\n    text is contained in a paragraph element. To reconstruct the original\n    text, the paragraph containing the deleted text is merged with its\n    surrounding paragraph or heading element. To reconstruct the text before\n    a deletion took place:\n      - If the change mark is inside a paragraph, insert the content that was\n      deleted, but remove all leading start tags up to and including the\n      first \"text:p\" element and all trailing end tags up to and including\n      the last \"/text:p\" or \"/text:h\" element. If the last trailing element\n      is a \"/text:h\", change the end tag \"/text:p\" following this insertion\n      to a \"/text:h\" element.\n      - If the change mark is inside a heading, insert the content that was\n      deleted, but remove all leading start tags up to and including the\n      first \"text:h\" element and all trailing end tags up to and including\n      the last \"/text:h\" or \"/text:p\" element. If the last trailing element\n      is a \"/text:p\", change the end tag \"/text:h\" following this insertion\n      to a \"/text:p\" element.\n      - Otherwise, copy the text content of the \"text:deletion\" element in\n      place of the change mark.\n    \"\"\"\n\n    _tag = \"text:deletion\"\n\n    def get_deleted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n    ) -&gt; str | list[Element] | None:\n        \"\"\"Get the deleted informations stored in the TextDeletion.\n        If as_text is True: returns the text content.\n        If no_header is True: existing Heading are changed in Paragraph\n\n        Arguments:\n\n            as_text -- boolean\n\n            no_header -- boolean\n\n        Return: Paragraph and Header list\n        \"\"\"\n        children = self.children\n        inner = [elem for elem in children if elem.tag != \"office:change-info\"]\n        if no_header:  # crude replace t:h by t:p\n            new_inner = []\n            for element in inner:\n                if element.tag == \"text:h\":\n                    children = element.children\n                    text = element.text\n                    para = Element.from_tag(\"text:p\")\n                    para.text = text\n                    for child in children:\n                        para.append(child)\n                    new_inner.append(para)\n                else:\n                    new_inner.append(element)\n            inner = new_inner\n        if as_text:\n            return \"\\n\".join([elem.get_formatted_text(context=None) for elem in inner])\n        return inner\n\n    def set_deleted(self, paragraph_or_list: Element | list[Element]) -&gt; None:\n        \"\"\"Set the deleted informations stored in the TextDeletion. An\n        actual content that was deleted is expected, embeded in a Paragraph\n        element or Header.\n\n        Arguments:\n\n            paragraph_or_list -- Paragraph or Header element (or list)\n        \"\"\"\n        for element in self.get_deleted():  # type: ignore\n            self.delete(element)  # type: ignore\n        if isinstance(paragraph_or_list, Element):\n            paragraph_or_list = [paragraph_or_list]\n        for element in paragraph_or_list:\n            self.append(element)\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Return None.\"\"\"\n        if as_text:\n            return \"\"\n        return None\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion.get_deleted","title":"<code>get_deleted(as_text=False, no_header=False)</code>","text":"<p>Get the deleted informations stored in the TextDeletion. If as_text is True: returns the text content. If no_header is True: existing Heading are changed in Paragraph</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: Paragraph and Header list</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n) -&gt; str | list[Element] | None:\n    \"\"\"Get the deleted informations stored in the TextDeletion.\n    If as_text is True: returns the text content.\n    If no_header is True: existing Heading are changed in Paragraph\n\n    Arguments:\n\n        as_text -- boolean\n\n        no_header -- boolean\n\n    Return: Paragraph and Header list\n    \"\"\"\n    children = self.children\n    inner = [elem for elem in children if elem.tag != \"office:change-info\"]\n    if no_header:  # crude replace t:h by t:p\n        new_inner = []\n        for element in inner:\n            if element.tag == \"text:h\":\n                children = element.children\n                text = element.text\n                para = Element.from_tag(\"text:p\")\n                para.text = text\n                for child in children:\n                    para.append(child)\n                new_inner.append(para)\n            else:\n                new_inner.append(element)\n        inner = new_inner\n    if as_text:\n        return \"\\n\".join([elem.get_formatted_text(context=None) for elem in inner])\n    return inner\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Return None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Return None.\"\"\"\n    if as_text:\n        return \"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextDeletion.set_deleted","title":"<code>set_deleted(paragraph_or_list)</code>","text":"<p>Set the deleted informations stored in the TextDeletion. An actual content that was deleted is expected, embeded in a Paragraph element or Header.</p> <p>Arguments:</p> <pre><code>paragraph_or_list -- Paragraph or Header element (or list)\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_deleted(self, paragraph_or_list: Element | list[Element]) -&gt; None:\n    \"\"\"Set the deleted informations stored in the TextDeletion. An\n    actual content that was deleted is expected, embeded in a Paragraph\n    element or Header.\n\n    Arguments:\n\n        paragraph_or_list -- Paragraph or Header element (or list)\n    \"\"\"\n    for element in self.get_deleted():  # type: ignore\n        self.delete(element)  # type: ignore\n    if isinstance(paragraph_or_list, Element):\n        paragraph_or_list = [paragraph_or_list]\n    for element in paragraph_or_list:\n        self.append(element)\n</code></pre>"},{"location":"reference.html#odfdo.TextFormatChange","title":"<code>TextFormatChange</code>","text":"<p>               Bases: <code>TextInsertion</code></p> <p>The TextFormatChange \u201ctext:format-change\u201d element represents any change in formatting attributes. The region where the change took place is marked by \u201ctext:change-start\u201d, \u201ctext:change-end\u201d or \u201ctext:change\u201d elements.</p> <p>Note: This element does not contain formatting changes that have taken place.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextFormatChange(TextInsertion):\n    \"\"\"The TextFormatChange \"text:format-change\" element represents any change\n    in formatting attributes. The region where the change took place is\n    marked by \"text:change-start\", \"text:change-end\" or \"text:change\"\n    elements.\n\n    Note: This element does not contain formatting changes that have taken\n    place.\n    \"\"\"\n\n    _tag = \"text:format-change\"\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion","title":"<code>TextInsertion</code>","text":"<p>               Bases: <code>Element</code></p> <p>The TextInsertion \u201ctext:insertion\u201d element contains the information that identifies the person responsible for a change and the date of that change. This information may also contain one or more \u201ctext:p\u201d Paragraph which contain a comment on the insertion. The TextInsertion element\u2019s parent \u201ctext:changed-region\u201d element has an xml:id or text:id attribute, the value of which binds that parent element to the text:change-id attribute on the \u201ctext:change-start\u201d and \u201ctext:change-end\u201d elements.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TextInsertion(Element):\n    \"\"\"The TextInsertion \"text:insertion\" element contains the information\n    that identifies the person responsible for a change and the date of\n    that change. This information may also contain one or more \"text:p\"\n    Paragraph which contain a comment on the insertion. The\n    TextInsertion element's parent \"text:changed-region\" element has an\n    xml:id or text:id attribute, the value of which binds that parent\n    element to the text:change-id attribute on the \"text:change-start\"\n    and \"text:change-end\" elements.\n    \"\"\"\n\n    _tag = \"text:insertion\"\n\n    def get_deleted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n    ) -&gt; str | list[Element] | None:\n        \"\"\"Return: None.\"\"\"\n        if as_text:\n            return \"\"\n        return None\n\n    def get_inserted(\n        self,\n        as_text: bool = False,\n        no_header: bool = False,\n        clean: bool = True,\n    ) -&gt; str | Element | list[Element] | None:\n        \"\"\"Shortcut to text:change-start.get_inserted(). Return the content\n        between text:change-start and text:change-end.\n\n        If as_text is True: returns the text content.\n        If no_header is True: existing Heading are changed in Paragraph\n        If no_header is True: existing text:h are changed in text:p\n        By default: returns a list of Element, cleaned and with headers\n\n        Arguments:\n\n            as_text -- boolean\n\n            clean -- boolean\n\n            no_header -- boolean\n\n        Return: list or Element or text\n        \"\"\"\n        current = self.parent  # text:changed-region\n        if not current:\n            raise ValueError\n        idx = current.get_id()  # type: ignore\n        body = self.document_body\n        if not body:\n            body = self.root\n        text_change = body.get_text_change_start(idx=idx)\n        if not text_change:\n            raise ValueError\n        return text_change.get_inserted(  # type: ignore\n            as_text=as_text, no_header=no_header, clean=clean\n        )\n\n    def get_change_info(self) -&gt; Element | None:\n        \"\"\"Get the ChangeInfo child of the element.\n\n        Return: ChangeInfo element.\n        \"\"\"\n        return self.get_element(\"descendant::office:change-info\")\n\n    def set_change_info(\n        self,\n        change_info: Element | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        comments: Element | list[Element] | None = None,\n    ) -&gt; None:\n        \"\"\"Set the ChangeInfo element for the change element. If change_info\n        is not provided, creator, date and comments will be used to build a\n        suitable change info element. Default for creator is 'Unknown',\n        default for date is current time and default for comments is no\n        comment at all.\n        The new change info element will replace any existant ChangeInfo.\n\n        Arguments:\n\n             change_info -- ChangeInfo element (or None)\n\n             cretor -- str (or None)\n\n             date -- datetime (or None)\n\n             comments -- Paragraph or list of Paragraph elements (or None)\n        \"\"\"\n        if change_info is None:\n            new_change_info = ChangeInfo(creator, date)\n            if comments is not None:\n                if isinstance(comments, Element):\n                    # single pararagraph comment\n                    comments_list = [comments]\n                else:\n                    comments_list = comments\n                # assume iterable of Paragraph\n                for paragraph in comments_list:\n                    if not isinstance(paragraph, Paragraph):\n                        raise TypeError(f\"Not a Paragraph: '{paragraph!r}'\")\n                    new_change_info.insert(paragraph, xmlposition=LAST_CHILD)\n        else:\n            if not isinstance(change_info, ChangeInfo):\n                raise TypeError(f\"Not a ChangeInfo: '{change_info!r}'\")\n            new_change_info = change_info\n\n        old = self.get_change_info()\n        if old is not None:\n            self.replace_element(old, new_change_info)\n        else:\n            self.insert(new_change_info, xmlposition=FIRST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.get_change_info","title":"<code>get_change_info()</code>","text":"<p>Get the ChangeInfo child of the element.</p> <p>Return: ChangeInfo element.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_change_info(self) -&gt; Element | None:\n    \"\"\"Get the ChangeInfo child of the element.\n\n    Return: ChangeInfo element.\n    \"\"\"\n    return self.get_element(\"descendant::office:change-info\")\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.get_deleted","title":"<code>get_deleted(as_text=False, no_header=False)</code>","text":"<p>Return: None.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_deleted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n) -&gt; str | list[Element] | None:\n    \"\"\"Return: None.\"\"\"\n    if as_text:\n        return \"\"\n    return None\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.get_inserted","title":"<code>get_inserted(as_text=False, no_header=False, clean=True)</code>","text":"<p>Shortcut to text:change-start.get_inserted(). Return the content between text:change-start and text:change-end.</p> <p>If as_text is True: returns the text content. If no_header is True: existing Heading are changed in Paragraph If no_header is True: existing text:h are changed in text:p By default: returns a list of Element, cleaned and with headers</p> <p>Arguments:</p> <pre><code>as_text -- boolean\n\nclean -- boolean\n\nno_header -- boolean\n</code></pre> <p>Return: list or Element or text</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def get_inserted(\n    self,\n    as_text: bool = False,\n    no_header: bool = False,\n    clean: bool = True,\n) -&gt; str | Element | list[Element] | None:\n    \"\"\"Shortcut to text:change-start.get_inserted(). Return the content\n    between text:change-start and text:change-end.\n\n    If as_text is True: returns the text content.\n    If no_header is True: existing Heading are changed in Paragraph\n    If no_header is True: existing text:h are changed in text:p\n    By default: returns a list of Element, cleaned and with headers\n\n    Arguments:\n\n        as_text -- boolean\n\n        clean -- boolean\n\n        no_header -- boolean\n\n    Return: list or Element or text\n    \"\"\"\n    current = self.parent  # text:changed-region\n    if not current:\n        raise ValueError\n    idx = current.get_id()  # type: ignore\n    body = self.document_body\n    if not body:\n        body = self.root\n    text_change = body.get_text_change_start(idx=idx)\n    if not text_change:\n        raise ValueError\n    return text_change.get_inserted(  # type: ignore\n        as_text=as_text, no_header=no_header, clean=clean\n    )\n</code></pre>"},{"location":"reference.html#odfdo.TextInsertion.set_change_info","title":"<code>set_change_info(change_info=None, creator=None, date=None, comments=None)</code>","text":"<p>Set the ChangeInfo element for the change element. If change_info is not provided, creator, date and comments will be used to build a suitable change info element. Default for creator is \u2018Unknown\u2019, default for date is current time and default for comments is no comment at all. The new change info element will replace any existant ChangeInfo.</p> <p>Arguments:</p> <pre><code> change_info -- ChangeInfo element (or None)\n\n cretor -- str (or None)\n\n date -- datetime (or None)\n\n comments -- Paragraph or list of Paragraph elements (or None)\n</code></pre> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>def set_change_info(\n    self,\n    change_info: Element | None = None,\n    creator: str | None = None,\n    date: datetime | None = None,\n    comments: Element | list[Element] | None = None,\n) -&gt; None:\n    \"\"\"Set the ChangeInfo element for the change element. If change_info\n    is not provided, creator, date and comments will be used to build a\n    suitable change info element. Default for creator is 'Unknown',\n    default for date is current time and default for comments is no\n    comment at all.\n    The new change info element will replace any existant ChangeInfo.\n\n    Arguments:\n\n         change_info -- ChangeInfo element (or None)\n\n         cretor -- str (or None)\n\n         date -- datetime (or None)\n\n         comments -- Paragraph or list of Paragraph elements (or None)\n    \"\"\"\n    if change_info is None:\n        new_change_info = ChangeInfo(creator, date)\n        if comments is not None:\n            if isinstance(comments, Element):\n                # single pararagraph comment\n                comments_list = [comments]\n            else:\n                comments_list = comments\n            # assume iterable of Paragraph\n            for paragraph in comments_list:\n                if not isinstance(paragraph, Paragraph):\n                    raise TypeError(f\"Not a Paragraph: '{paragraph!r}'\")\n                new_change_info.insert(paragraph, xmlposition=LAST_CHILD)\n    else:\n        if not isinstance(change_info, ChangeInfo):\n            raise TypeError(f\"Not a ChangeInfo: '{change_info!r}'\")\n        new_change_info = change_info\n\n    old = self.get_change_info()\n    if old is not None:\n        self.replace_element(old, new_change_info)\n    else:\n        self.insert(new_change_info, xmlposition=FIRST_CHILD)\n</code></pre>"},{"location":"reference.html#odfdo.TocEntryTemplate","title":"<code>TocEntryTemplate</code>","text":"<p>               Bases: <code>Element</code></p> <p>ODF \u201ctext:table-of-content-entry-template\u201d</p> <p>Arguments:</p> <pre><code>style -- str\n</code></pre> Source code in <code>odfdo/toc.py</code> <pre><code>class TocEntryTemplate(Element):\n    \"\"\"ODF \"text:table-of-content-entry-template\"\n\n    Arguments:\n\n        style -- str\n    \"\"\"\n\n    _tag = \"text:table-of-content-entry-template\"\n    _properties = (PropDef(\"style\", \"text:style-name\"),)\n\n    def __init__(\n        self,\n        style: str | None = None,\n        outline_level: int | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if style:\n                self.style = style\n            if outline_level:\n                self.outline_level = outline_level\n\n    @property\n    def outline_level(self) -&gt; int | None:\n        return self.get_attribute_integer(\"text:outline-level\")\n\n    @outline_level.setter\n    def outline_level(self, level: int) -&gt; None:\n        self.set_attribute(\"text:outline-level\", str(level))\n\n    def complete_defaults(self) -&gt; None:\n        self.append(Element.from_tag(\"text:index-entry-chapter\"))\n        self.append(Element.from_tag(\"text:index-entry-text\"))\n        self.append(Element.from_tag(\"text:index-entry-text\"))\n        ts = Element.from_tag(\"text:index-entry-text\")\n        ts.set_style_attribute(\"style:type\", \"right\")\n        ts.set_style_attribute(\"style:leader-char\", \".\")\n        self.append(ts)\n        self.append(Element.from_tag(\"text:index-entry-page-number\"))\n</code></pre>"},{"location":"reference.html#odfdo.TrackedChanges","title":"<code>TrackedChanges</code>","text":"<p>               Bases: <code>Element</code></p> <p>The TrackedChanges \u201ctext:tracked-changes\u201d element acts as a container for TextChangedRegion elements that represent changes in a certain scope of an OpenDocument document. This scope is the element in which the TrackedChanges element occurs. Changes in this scope shall be tracked by TextChangedRegion elements contained in the TrackedChanges element in this scope. If a TrackedChanges element is absent, there are no tracked changes in the corresponding scope. In this case, all change mark elements in this scope shall be ignored.</p> Source code in <code>odfdo/tracked_changes.py</code> <pre><code>class TrackedChanges(Element):\n    \"\"\"The TrackedChanges \"text:tracked-changes\" element acts as a container\n    for TextChangedRegion elements that represent changes in a certain\n    scope of an OpenDocument document. This scope is the element in which\n    the TrackedChanges element occurs. Changes in this scope shall be\n    tracked by TextChangedRegion elements contained in the\n    TrackedChanges element in this scope. If a TrackedChanges\n    element is absent, there are no tracked changes in the corresponding\n    scope. In this case, all change mark elements in this scope shall be\n    ignored.\n    \"\"\"\n\n    _tag = \"text:tracked-changes\"\n\n    def get_changed_regions(\n        self,\n        creator: str | None = None,\n        date: datetime | None = None,\n        content: str | None = None,\n        role: str | None = None,\n    ) -&gt; list[Element]:\n        changed_regions = self._filtered_elements(\n            \"text:changed-region\",\n            dc_creator=creator,\n            dc_date=date,\n            content=content,\n        )\n        if role is None:\n            return changed_regions\n        result: list[Element] = []\n        for regien in changed_regions:\n            changed = regien.get_change_element()  # type: ignore\n            if not changed:\n                continue\n            if changed.tag.endswith(role):\n                result.append(regien)\n        return result\n\n    def get_changed_region(\n        self,\n        position: int = 0,\n        text_id: str | None = None,\n        creator: str | None = None,\n        date: datetime | None = None,\n        content: str | None = None,\n    ) -&gt; Element | None:\n        return self._filtered_element(\n            \"text:changed-region\",\n            position,\n            text_id=text_id,\n            dc_creator=creator,\n            dc_date=date,\n            content=content,\n        )\n</code></pre>"},{"location":"reference.html#odfdo.UserDefined","title":"<code>UserDefined</code>","text":"<p>               Bases: <code>ElementTyped</code></p> <p>Return a user defined field \u201ctext:user-defined\u201d. If the current document is provided, try to extract the content of the meta user defined field of same name.</p> <p>Arguments:</p> <pre><code>name -- str, name of the user defined field\n\nvalue -- python typed value, value of the field\n\nvalue_type -- str, office:value-type known type\n\ntext -- str\n\nstyle -- str\n\nfrom_document -- ODF document\n</code></pre> Source code in <code>odfdo/variable.py</code> <pre><code>class UserDefined(ElementTyped):\n    \"\"\"Return a user defined field \"text:user-defined\". If the current\n    document is provided, try to extract the content of the meta user defined\n    field of same name.\n\n    Arguments:\n\n        name -- str, name of the user defined field\n\n        value -- python typed value, value of the field\n\n        value_type -- str, office:value-type known type\n\n        text -- str\n\n        style -- str\n\n        from_document -- ODF document\n    \"\"\"\n\n    _tag = \"text:user-defined\"\n    _properties = (\n        PropDef(\"name\", \"text:name\"),\n        PropDef(\"style\", \"style:data-style-name\"),\n    )\n\n    def __init__(\n        self,\n        name: str = \"\",\n        value: Any = None,\n        value_type: str | None = None,\n        text: str | None = None,\n        style: str | None = None,\n        from_document: Document | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if name:\n                self.name = name\n            if style:\n                self.style = style\n            if from_document is not None:\n                meta_infos = from_document.meta\n                content = meta_infos.get_user_defined_metadata_of_name(name)\n                if content is not None:\n                    value = content.get(\"value\", None)\n                    value_type = content.get(\"value_type\", None)\n                    text = content.get(\"text\", None)\n            text = self.set_value_and_type(\n                value=value, value_type=value_type, text=text\n            )\n            self.text = text  # type: ignore\n</code></pre>"},{"location":"reference.html#odfdo.VarChapter","title":"<code>VarChapter</code>","text":"<p>               Bases: <code>Element</code></p> Source code in <code>odfdo/variable.py</code> <pre><code>class VarChapter(Element):\n    _tag = \"text:chapter\"\n    _properties = (\n        PropDef(\"display\", \"text:display\"),\n        PropDef(\"outline_level\", \"text:outline-level\"),\n    )\n    DISPLAY_VALUE_CHOICE = {  # noqa: RUF012\n        \"number\",\n        \"name\",\n        \"number-and-name\",\n        \"plain-number\",\n        \"plain-number-and-name\",\n    }\n\n    def __init__(\n        self,\n        display: str | None = \"name\",\n        outline_level: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"display can be: 'number', 'name', 'number-and-name', 'plain-number' or\n        'plain-number-and-name'\n        \"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if display not in VarChapter.DISPLAY_VALUE_CHOICE:\n                raise ValueError(f\"Unknown display value: '{display}'\")\n            self.display = display\n            if outline_level is not None:\n                self.outline_level = outline_level\n</code></pre>"},{"location":"reference.html#odfdo.VarChapter.__init__","title":"<code>__init__(display='name', outline_level=None, **kwargs)</code>","text":"<p>display can be: \u2018number\u2019, \u2018name\u2019, \u2018number-and-name\u2019, \u2018plain-number\u2019 or \u2018plain-number-and-name\u2019</p> Source code in <code>odfdo/variable.py</code> <pre><code>def __init__(\n    self,\n    display: str | None = \"name\",\n    outline_level: str | None = None,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"display can be: 'number', 'name', 'number-and-name', 'plain-number' or\n    'plain-number-and-name'\n    \"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if display not in VarChapter.DISPLAY_VALUE_CHOICE:\n            raise ValueError(f\"Unknown display value: '{display}'\")\n        self.display = display\n        if outline_level is not None:\n            self.outline_level = outline_level\n</code></pre>"},{"location":"reference.html#odfdo.VarFileName","title":"<code>VarFileName</code>","text":"<p>               Bases: <code>Element</code></p> Source code in <code>odfdo/variable.py</code> <pre><code>class VarFileName(Element):\n    _tag = \"text:file-name\"\n    _properties = (\n        PropDef(\"display\", \"text:display\"),\n        PropDef(\"fixed\", \"text:fixed\"),\n    )\n    DISPLAY_VALUE_CHOICE = {  # noqa: RUF012\n        \"full\",\n        \"path\",\n        \"name\",\n        \"name-and-extension\",\n    }\n\n    def __init__(\n        self,\n        display: str | None = \"full\",\n        fixed: bool = False,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"display can be: 'full', 'path', 'name' or 'name-and-extension'\"\"\"\n        super().__init__(**kwargs)\n        if self._do_init:\n            if display not in VarFileName.DISPLAY_VALUE_CHOICE:\n                raise ValueError(f\"Unknown display value: '{display}'\")\n            self.display = display\n            if fixed:\n                self.fixed = True\n</code></pre>"},{"location":"reference.html#odfdo.VarFileName.__init__","title":"<code>__init__(display='full', fixed=False, **kwargs)</code>","text":"<p>display can be: \u2018full\u2019, \u2018path\u2019, \u2018name\u2019 or \u2018name-and-extension\u2019</p> Source code in <code>odfdo/variable.py</code> <pre><code>def __init__(\n    self,\n    display: str | None = \"full\",\n    fixed: bool = False,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"display can be: 'full', 'path', 'name' or 'name-and-extension'\"\"\"\n    super().__init__(**kwargs)\n    if self._do_init:\n        if display not in VarFileName.DISPLAY_VALUE_CHOICE:\n            raise ValueError(f\"Unknown display value: '{display}'\")\n        self.display = display\n        if fixed:\n            self.fixed = True\n</code></pre>"},{"location":"reference.html#odfdo.VarPageNumber","title":"<code>VarPageNumber</code>","text":"<p>               Bases: <code>Element</code></p> <p>select_page \u2013 string in (\u2018previous\u2019, \u2018current\u2019, \u2018next\u2019)</p> <p>page_adjust \u2013 int (to add or subtract to the page number)</p> Source code in <code>odfdo/variable.py</code> <pre><code>class VarPageNumber(Element):\n    \"\"\"\n    select_page -- string in ('previous', 'current', 'next')\n\n    page_adjust -- int (to add or subtract to the page number)\n    \"\"\"\n\n    _tag = \"text:page-number\"\n    _properties = (\n        PropDef(\"select_page\", \"text:select-page\"),\n        PropDef(\"page_adjust\", \"text:page-adjust\"),\n    )\n\n    def __init__(\n        self,\n        select_page: str | None = None,\n        page_adjust: str | None = None,\n        **kwargs: Any,\n    ) -&gt; None:\n        super().__init__(**kwargs)\n        if self._do_init:\n            if select_page is None:\n                select_page = \"current\"\n            self.select_page = select_page\n            if page_adjust is not None:\n                self.page_adjust = page_adjust\n</code></pre>"},{"location":"reference.html#odfdo.XmlPart","title":"<code>XmlPart</code>","text":"<p>Representation of an XML part.</p> <p>Abstraction of the XML library behind.</p> Source code in <code>odfdo/xmlpart.py</code> <pre><code>class XmlPart:\n    \"\"\"Representation of an XML part.\n\n    Abstraction of the XML library behind.\n    \"\"\"\n\n    def __init__(self, part_name: str, container: Container) -&gt; None:\n        self.part_name = part_name\n        self.container = container\n\n        # Internal state\n        self.__tree: _ElementTree | None = None\n        self.__root: Element | None = None\n\n    def _get_tree(self) -&gt; _ElementTree:\n        if self.__tree is None:\n            part = self.container.get_part(self.part_name)\n            self.__tree = parse(BytesIO(part))  # type: ignore\n        return self.__tree\n\n    def __repr__(self) -&gt; str:\n        return f\"&lt;{self.__class__.__name__} part_name={self.part_name}&gt;\"\n\n    # Public API\n\n    @property\n    def root(self) -&gt; Element:\n        if self.__root is None:\n            tree = self._get_tree()\n            self.__root = Element.from_tag(tree.getroot())\n        return self.__root\n\n    @property\n    def body(self) -&gt; Element:\n        \"\"\"Get or set the document body : 'office:body'\"\"\"\n        body = self.root.document_body\n        if not isinstance(body, Element):\n            raise TypeError(f\"No body found in {self.part_name!r}\")\n        return body\n\n    @body.setter\n    def body(self, new_body: Element) -&gt; None:\n        body = self.root.document_body\n        if not isinstance(body, Element):\n            raise TypeError(\"//office:body not found in document\")\n        tail = body.tail\n        body.clear()\n        for item in new_body.children:\n            body.append(item)\n        if tail:\n            body.tail = tail\n\n    def get_elements(self, xpath_query: str) -&gt; list[Element | EText]:\n        root = self.root\n        return root.xpath(xpath_query)\n\n    def get_element(self, xpath_query: str) -&gt; Any:\n        result = self.get_elements(xpath_query)\n        if not result:\n            return None\n        return result[0]\n\n    def delete_element(self, child: Element) -&gt; None:\n        child.delete()\n\n    def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n        \"\"\"Apply XPath query to the XML part. Return list of Element or\n        EText instances translated from the nodes found.\n        \"\"\"\n        root = self.root\n        return root.xpath(xpath_query)\n\n    @property\n    def clone(self) -&gt; XmlPart:\n        clone = object.__new__(self.__class__)\n        for name in self.__dict__:\n            if name == \"container\":\n                setattr(clone, name, self.container.clone)\n            elif name in (\"_XmlPart__tree\",):\n                setattr(clone, name, None)\n            else:\n                value = getattr(self, name)\n                value = deepcopy(value)\n                setattr(clone, name, value)\n        return clone\n\n    def serialize(self, pretty: bool = False) -&gt; bytes:\n        tree = self._get_tree()\n        xml_header = b'&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\\n'\n        bytes_tree = tostring(\n            tree,\n            pretty_print=pretty,\n            encoding=\"utf8\",\n        )\n        # Lxml with pretty_print is adding a empty line\n        if pretty:\n            bytes_tree = bytes_tree.strip()\n        return xml_header + bytes_tree\n</code></pre>"},{"location":"reference.html#odfdo.XmlPart.body","title":"<code>body: Element</code>  <code>property</code> <code>writable</code>","text":"<p>Get or set the document body : \u2018office:body\u2019</p>"},{"location":"reference.html#odfdo.XmlPart.xpath","title":"<code>xpath(xpath_query)</code>","text":"<p>Apply XPath query to the XML part. Return list of Element or EText instances translated from the nodes found.</p> Source code in <code>odfdo/xmlpart.py</code> <pre><code>def xpath(self, xpath_query: str) -&gt; list[Element | EText]:\n    \"\"\"Apply XPath query to the XML part. Return list of Element or\n    EText instances translated from the nodes found.\n    \"\"\"\n    root = self.root\n    return root.xpath(xpath_query)\n</code></pre>"},{"location":"reference.html#odfdo.PageBreak","title":"<code>PageBreak()</code>","text":"<p>Return an empty paragraph with a manual page break.</p> Using this function requires to register the page break style with <p>document.add_page_break_style()</p> Source code in <code>odfdo/paragraph.py</code> <pre><code>def PageBreak() -&gt; Paragraph:\n    \"\"\"Return an empty paragraph with a manual page break.\n\n    Using this function requires to register the page break style with:\n        document.add_page_break_style()\n    \"\"\"\n    return Paragraph(\"\", style=\"odfdopagebreak\")\n</code></pre>"},{"location":"reference.html#odfdo.create_table_cell_style","title":"<code>create_table_cell_style(border=None, border_top=None, border_bottom=None, border_left=None, border_right=None, padding=None, padding_top=None, padding_bottom=None, padding_left=None, padding_right=None, background_color=None, shadow=None, color=None)</code>","text":"<p>Return a cell style.</p> <p>The borders arguments must be some style attribute strings or None, see the method \u2018make_table_cell_border_string\u2019 to generate them. If the \u2018border\u2019 argument as the value \u2018default\u2019, the default style \u201c0.06pt solid #000000\u201d is used for the 4 borders. If any value is used for border, it is used for the 4 borders, else any of the 4 borders can be specified by it\u2019s own string. If all the border, border_top, border_bottom, \u2026 arguments are None, an empty border is used (ODF value is fo:border=\u201dnone\u201d).</p> <p>Padding arguments are string specifying a length (e.g. \u201c0.5mm\u201d)\u201d. If \u2018padding\u2019 is provided, it is used for the 4 sides, else any of the 4 sides padding can be specified by it\u2019s own string. Default padding is no padding.</p> <p>Arguments:</p> <pre><code>border -- str, style string for borders on four sides\n\nborder_top -- str, style string for top if no 'border' argument\n\nborder_bottom -- str, style string for bottom if no 'border' argument\n\nborder_left -- str, style string for left if no 'border' argument\n\nborder_right -- str, style string for right if no 'border' argument\n\npadding -- str, style string for padding on four sides\n\npadding_top -- str, style string for top if no 'padding' argument\n\npadding_bottom -- str, style string for bottom if no 'padding' argument\n\npadding_left -- str, style string for left if no 'padding' argument\n\npadding_right -- str, style string for right if no 'padding' argument\n\nbackground_color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\nshadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\ncolor -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n</code></pre> <p>Return : Style</p> Source code in <code>odfdo/style.py</code> <pre><code>def create_table_cell_style(\n    border: str | None = None,\n    border_top: str | None = None,\n    border_bottom: str | None = None,\n    border_left: str | None = None,\n    border_right: str | None = None,\n    padding: str | None = None,\n    padding_top: str | None = None,\n    padding_bottom: str | None = None,\n    padding_left: str | None = None,\n    padding_right: str | None = None,\n    background_color: str | tuple | None = None,\n    shadow: str | None = None,\n    color: str | tuple | None = None,\n) -&gt; Style:\n    \"\"\"Return a cell style.\n\n    The borders arguments must be some style attribute strings or None, see the\n    method 'make_table_cell_border_string' to generate them.\n    If the 'border' argument as the value 'default', the default style\n    \"0.06pt solid #000000\" is used for the 4 borders.\n    If any value is used for border, it is used for the 4 borders, else any of\n    the 4 borders can be specified by it's own string. If all the border,\n    border_top, border_bottom, ... arguments are None, an empty border is used\n    (ODF value is fo:border=\"none\").\n\n    Padding arguments are string specifying a length (e.g. \"0.5mm\")\". If\n    'padding' is provided, it is used for the 4 sides, else any of\n    the 4 sides padding can be specified by it's own string. Default padding is\n    no padding.\n\n    Arguments:\n\n        border -- str, style string for borders on four sides\n\n        border_top -- str, style string for top if no 'border' argument\n\n        border_bottom -- str, style string for bottom if no 'border' argument\n\n        border_left -- str, style string for left if no 'border' argument\n\n        border_right -- str, style string for right if no 'border' argument\n\n        padding -- str, style string for padding on four sides\n\n        padding_top -- str, style string for top if no 'padding' argument\n\n        padding_bottom -- str, style string for bottom if no 'padding' argument\n\n        padding_left -- str, style string for left if no 'padding' argument\n\n        padding_right -- str, style string for right if no 'padding' argument\n\n        background_color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\n        shadow -- str, e.g. \"#808080 0.176cm 0.176cm\"\n\n        color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\n    Return : Style\n    \"\"\"\n    if border == \"default\":\n        border = make_table_cell_border_string()  # default border\n    if border is not None:\n        # use the border value for 4 sides.\n        border_bottom = border_top = border_left = border_right = None\n    if (\n        border is None\n        and border_bottom is None\n        and border_top is None\n        and border_left is None\n        and border_right is None\n    ):\n        border = \"none\"\n    if padding is not None:\n        # use the padding value for 4 sides.\n        padding_bottom = padding_top = padding_left = padding_right = None\n    cell_style = Style(\n        \"table-cell\",\n        area=\"table-cell\",\n        border=border,\n        border_top=border_top,\n        border_bottom=border_bottom,\n        border_left=border_left,\n        border_right=border_right,\n        padding=padding,\n        padding_top=padding_top,\n        padding_bottom=padding_bottom,\n        padding_left=padding_left,\n        padding_right=padding_right,\n        background_color=background_color,\n        shadow=shadow,\n    )\n    if color:\n        cell_style.set_properties(area=\"text\", color=color)\n    return cell_style\n</code></pre>"},{"location":"reference.html#odfdo.default_frame_position_style","title":"<code>default_frame_position_style(name='FramePosition', horizontal_pos='from-left', vertical_pos='from-top', horizontal_rel='paragraph', vertical_rel='paragraph')</code>","text":"<p>Helper style for positioning frames in desktop applications that need it.</p> <p>Default arguments should be enough.</p> <p>Use the returned Style as the frame style or build a new graphic style with this style as the parent.</p> Source code in <code>odfdo/frame.py</code> <pre><code>def default_frame_position_style(\n    name: str = \"FramePosition\",\n    horizontal_pos: str = \"from-left\",\n    vertical_pos: str = \"from-top\",\n    horizontal_rel: str = \"paragraph\",\n    vertical_rel: str = \"paragraph\",\n) -&gt; Style:\n    \"\"\"Helper style for positioning frames in desktop applications that need\n    it.\n\n    Default arguments should be enough.\n\n    Use the returned Style as the frame style or build a new graphic style\n    with this style as the parent.\n    \"\"\"\n    return Style(\n        family=\"graphic\",\n        name=name,\n        horizontal_pos=horizontal_pos,\n        horizontal_rel=horizontal_rel,\n        vertical_pos=vertical_pos,\n        vertical_rel=vertical_rel,\n    )\n</code></pre>"},{"location":"reference.html#odfdo.default_toc_level_style","title":"<code>default_toc_level_style(level)</code>","text":"<p>Generate an automatic default style for the given TOC level.</p> Source code in <code>odfdo/toc.py</code> <pre><code>def default_toc_level_style(level: int) -&gt; Style:\n    \"\"\"Generate an automatic default style for the given TOC level.\"\"\"\n    tab_stop = TabStopStyle(style_type=\"right\", leader_style=\"dotted\", leader_text=\".\")\n    position = 17.5 - (0.5 * level)\n    tab_stop.style_position = f\"{position}cm\"\n    tab_stops = Element.from_tag(\"style:tab-stops\")\n    tab_stops.append(tab_stop)\n    properties = Element.from_tag(\"style:paragraph-properties\")\n    properties.append(tab_stops)\n    toc_style_level = Style(\n        family=\"paragraph\",\n        name=_toc_entry_style_name(level),\n        parent=f\"Contents_20_{level}\",\n    )\n    toc_style_level.append(properties)\n    return toc_style_level\n</code></pre>"},{"location":"reference.html#odfdo.hex2rgb","title":"<code>hex2rgb(color)</code>","text":"<p>Turns a \u201c#RRGGBB\u201d hexadecimal color representation into a (R, G, B) tuple.</p> <p>Arguments:</p> <pre><code>color -- str\n</code></pre> <p>Return: tuple</p> Source code in <code>odfdo/utils/color.py</code> <pre><code>def hex2rgb(color: str) -&gt; tuple[int, int, int]:\n    \"\"\"Turns a \"#RRGGBB\" hexadecimal color representation into a (R, G, B)\n    tuple.\n\n    Arguments:\n\n        color -- str\n\n    Return: tuple\n    \"\"\"\n    code = color[1:]\n    if not (len(color) == 7 and color[0] == \"#\" and code.isalnum()):\n        raise ValueError(f'\"{color}\" is not a valid color')\n    red = int(code[:2], 16)\n    green = int(code[2:4], 16)\n    blue = int(code[4:6], 16)\n    return (red, green, blue)\n</code></pre>"},{"location":"reference.html#odfdo.hexa_color","title":"<code>hexa_color(color=None)</code>","text":"<p>Convert a color definition of type tuple or string to hexadecimal representation.</p> <p>Empty string is converted to black. None is converted to None.</p> <p>Arguments:</p> <pre><code>color -- str or tuple or None\n</code></pre> <p>Return: str or None</p> Source code in <code>odfdo/utils/color.py</code> <pre><code>def hexa_color(color: str | tuple[int, int, int] | None = None) -&gt; str | None:\n    \"\"\"Convert a color definition of type tuple or string to hexadecimal\n    representation.\n\n    Empty string is converted to black.\n    None is converted to None.\n\n    Arguments:\n\n        color -- str or tuple or None\n\n    Return: str or None\n    \"\"\"\n    if color is None:\n        return None\n    if isinstance(color, tuple):\n        return rgb2hex(color)\n    if not isinstance(color, str):\n        raise TypeError(f'Invalid color argument \"{color!r}\"')\n    color = color.strip()\n    if not color:\n        return \"#000000\"\n    if color.startswith(\"#\"):\n        return color\n    return rgb2hex(color)\n</code></pre>"},{"location":"reference.html#odfdo.make_table_cell_border_string","title":"<code>make_table_cell_border_string(thick=None, line=None, color=None)</code>","text":"<p>Returns a string for style:table-cell-properties fo:border, with default : \u201c0.06pt solid #000000\u201d</p> <pre><code>thick -- str or float or int\nline -- str\ncolor -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n</code></pre> <p>Returns : str</p> Source code in <code>odfdo/style.py</code> <pre><code>def make_table_cell_border_string(\n    thick: str | float | int | None = None,\n    line: str | None = None,\n    color: str | tuple | None = None,\n) -&gt; str:\n    \"\"\"Returns a string for style:table-cell-properties fo:border,\n    with default : \"0.06pt solid #000000\"\n\n        thick -- str or float or int\n        line -- str\n        color -- str or rgb 3-tuple, str is 'black', 'grey', ... or '#012345'\n\n    Returns : str\n    \"\"\"\n    thick_string = _make_thick_string(thick)\n    line_string = _make_line_string(line)\n    color_string = hexa_color(color) or \"#000000\"\n    return \" \".join((thick_string, line_string, color_string))\n</code></pre>"},{"location":"reference.html#odfdo.rgb2hex","title":"<code>rgb2hex(color)</code>","text":"<p>Turns a color name or a (R, G, B) color tuple into a \u201c#RRGGBB\u201d hexadecimal representation.</p> <p>Arguments:</p> <pre><code>color -- str or tuple\n</code></pre> <p>Return: str</p> <p>Examples::</p> <pre><code>&gt;&gt;&gt; rgb2hex('yellow')\n'#FFFF00'\n&gt;&gt;&gt; rgb2hex((238, 130, 238))\n'#EE82EE'\n</code></pre> Source code in <code>odfdo/utils/color.py</code> <pre><code>def rgb2hex(color: str | tuple[int, int, int]) -&gt; str:\n    \"\"\"Turns a color name or a (R, G, B) color tuple into a \"#RRGGBB\"\n    hexadecimal representation.\n\n    Arguments:\n\n        color -- str or tuple\n\n    Return: str\n\n    Examples::\n\n        &gt;&gt;&gt; rgb2hex('yellow')\n        '#FFFF00'\n        &gt;&gt;&gt; rgb2hex((238, 130, 238))\n        '#EE82EE'\n    \"\"\"\n    if isinstance(color, str):\n        try:\n            code = CSS3_COLORMAP[color.lower()]\n        except KeyError as e:\n            raise KeyError(f'Color \"{color}\" is unknown in CSS color list') from e\n    elif isinstance(color, tuple):\n        if len(color) != 3:\n            raise ValueError(\"Color must be a 3-tuple\")\n        code = color\n    else:\n        raise TypeError(f'Invalid color \"{color}\"')\n    for channel in code:\n        if not 0 &lt;= channel &lt;= 255:\n            raise ValueError(\n                f'Invalid color \"{color}\", channel must be between 0 and 255'\n            )\n    return f\"#{code[0]:02X}{code[1]:02X}{code[2]:02X}\"\n</code></pre>"}]}
\ No newline at end of file
diff --git a/doc/sitemap.xml.gz b/doc/sitemap.xml.gz
index 8ef3ea4..b4f3a20 100644
Binary files a/doc/sitemap.xml.gz and b/doc/sitemap.xml.gz differ
diff --git a/gen_doc.sh b/gen_doc.sh
index 79c7776..f3a4bc9 100755
--- a/gen_doc.sh
+++ b/gen_doc.sh
@@ -4,7 +4,7 @@
     echo "Not in top directory" ; exit 1
 }
 
-pip install -U mkdocs mkdocs-material
+pip install -U mkdocs mkdocs-material mkdocstrings[python]
 
 [ -d doc ] && rm -fr doc
 
diff --git a/poetry.lock b/poetry.lock
index f3c6ca1..5735ffb 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 1.8.2 and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.7.1 and should not be changed by hand.
 
 [[package]]
 name = "build"
@@ -281,43 +281,43 @@ files = [
 
 [[package]]
 name = "cryptography"
-version = "42.0.5"
+version = "42.0.7"
 description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "cryptography-42.0.5-cp37-abi3-macosx_10_12_universal2.whl", hash = "sha256:a30596bae9403a342c978fb47d9b0ee277699fa53bbafad14706af51fe543d16"},
-    {file = "cryptography-42.0.5-cp37-abi3-macosx_10_12_x86_64.whl", hash = "sha256:b7ffe927ee6531c78f81aa17e684e2ff617daeba7f189f911065b2ea2d526dec"},
-    {file = "cryptography-42.0.5-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2424ff4c4ac7f6b8177b53c17ed5d8fa74ae5955656867f5a8affaca36a27abb"},
-    {file = "cryptography-42.0.5-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:329906dcc7b20ff3cad13c069a78124ed8247adcac44b10bea1130e36caae0b4"},
-    {file = "cryptography-42.0.5-cp37-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:b03c2ae5d2f0fc05f9a2c0c997e1bc18c8229f392234e8a0194f202169ccd278"},
-    {file = "cryptography-42.0.5-cp37-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:f8837fe1d6ac4a8052a9a8ddab256bc006242696f03368a4009be7ee3075cdb7"},
-    {file = "cryptography-42.0.5-cp37-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:0270572b8bd2c833c3981724b8ee9747b3ec96f699a9665470018594301439ee"},
-    {file = "cryptography-42.0.5-cp37-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:b8cac287fafc4ad485b8a9b67d0ee80c66bf3574f655d3b97ef2e1082360faf1"},
-    {file = "cryptography-42.0.5-cp37-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:16a48c23a62a2f4a285699dba2e4ff2d1cff3115b9df052cdd976a18856d8e3d"},
-    {file = "cryptography-42.0.5-cp37-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:2bce03af1ce5a5567ab89bd90d11e7bbdff56b8af3acbbec1faded8f44cb06da"},
-    {file = "cryptography-42.0.5-cp37-abi3-win32.whl", hash = "sha256:b6cd2203306b63e41acdf39aa93b86fb566049aeb6dc489b70e34bcd07adca74"},
-    {file = "cryptography-42.0.5-cp37-abi3-win_amd64.whl", hash = "sha256:98d8dc6d012b82287f2c3d26ce1d2dd130ec200c8679b6213b3c73c08b2b7940"},
-    {file = "cryptography-42.0.5-cp39-abi3-macosx_10_12_universal2.whl", hash = "sha256:5e6275c09d2badf57aea3afa80d975444f4be8d3bc58f7f80d2a484c6f9485c8"},
-    {file = "cryptography-42.0.5-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e4985a790f921508f36f81831817cbc03b102d643b5fcb81cd33df3fa291a1a1"},
-    {file = "cryptography-42.0.5-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7cde5f38e614f55e28d831754e8a3bacf9ace5d1566235e39d91b35502d6936e"},
-    {file = "cryptography-42.0.5-cp39-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:7367d7b2eca6513681127ebad53b2582911d1736dc2ffc19f2c3ae49997496bc"},
-    {file = "cryptography-42.0.5-cp39-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:cd2030f6650c089aeb304cf093f3244d34745ce0cfcc39f20c6fbfe030102e2a"},
-    {file = "cryptography-42.0.5-cp39-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:a2913c5375154b6ef2e91c10b5720ea6e21007412f6437504ffea2109b5a33d7"},
-    {file = "cryptography-42.0.5-cp39-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:c41fb5e6a5fe9ebcd58ca3abfeb51dffb5d83d6775405305bfa8715b76521922"},
-    {file = "cryptography-42.0.5-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:3eaafe47ec0d0ffcc9349e1708be2aaea4c6dd4978d76bf6eb0cb2c13636c6fc"},
-    {file = "cryptography-42.0.5-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:1b95b98b0d2af784078fa69f637135e3c317091b615cd0905f8b8a087e86fa30"},
-    {file = "cryptography-42.0.5-cp39-abi3-win32.whl", hash = "sha256:1f71c10d1e88467126f0efd484bd44bca5e14c664ec2ede64c32f20875c0d413"},
-    {file = "cryptography-42.0.5-cp39-abi3-win_amd64.whl", hash = "sha256:a011a644f6d7d03736214d38832e030d8268bcff4a41f728e6030325fea3e400"},
-    {file = "cryptography-42.0.5-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:9481ffe3cf013b71b2428b905c4f7a9a4f76ec03065b05ff499bb5682a8d9ad8"},
-    {file = "cryptography-42.0.5-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:ba334e6e4b1d92442b75ddacc615c5476d4ad55cc29b15d590cc6b86efa487e2"},
-    {file = "cryptography-42.0.5-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:ba3e4a42397c25b7ff88cdec6e2a16c2be18720f317506ee25210f6d31925f9c"},
-    {file = "cryptography-42.0.5-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:111a0d8553afcf8eb02a4fea6ca4f59d48ddb34497aa8706a6cf536f1a5ec576"},
-    {file = "cryptography-42.0.5-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:cd65d75953847815962c84a4654a84850b2bb4aed3f26fadcc1c13892e1e29f6"},
-    {file = "cryptography-42.0.5-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:e807b3188f9eb0eaa7bbb579b462c5ace579f1cedb28107ce8b48a9f7ad3679e"},
-    {file = "cryptography-42.0.5-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:f12764b8fffc7a123f641d7d049d382b73f96a34117e0b637b80643169cec8ac"},
-    {file = "cryptography-42.0.5-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:37dd623507659e08be98eec89323469e8c7b4c1407c85112634ae3dbdb926fdd"},
-    {file = "cryptography-42.0.5.tar.gz", hash = "sha256:6fe07eec95dfd477eb9530aef5bead34fec819b3aaf6c5bd6d20565da607bfe1"},
+    {file = "cryptography-42.0.7-cp37-abi3-macosx_10_12_universal2.whl", hash = "sha256:a987f840718078212fdf4504d0fd4c6effe34a7e4740378e59d47696e8dfb477"},
+    {file = "cryptography-42.0.7-cp37-abi3-macosx_10_12_x86_64.whl", hash = "sha256:bd13b5e9b543532453de08bcdc3cc7cebec6f9883e886fd20a92f26940fd3e7a"},
+    {file = "cryptography-42.0.7-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a79165431551042cc9d1d90e6145d5d0d3ab0f2d66326c201d9b0e7f5bf43604"},
+    {file = "cryptography-42.0.7-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a47787a5e3649008a1102d3df55424e86606c9bae6fb77ac59afe06d234605f8"},
+    {file = "cryptography-42.0.7-cp37-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:02c0eee2d7133bdbbc5e24441258d5d2244beb31da5ed19fbb80315f4bbbff55"},
+    {file = "cryptography-42.0.7-cp37-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:5e44507bf8d14b36b8389b226665d597bc0f18ea035d75b4e53c7b1ea84583cc"},
+    {file = "cryptography-42.0.7-cp37-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:7f8b25fa616d8b846aef64b15c606bb0828dbc35faf90566eb139aa9cff67af2"},
+    {file = "cryptography-42.0.7-cp37-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:93a3209f6bb2b33e725ed08ee0991b92976dfdcf4e8b38646540674fc7508e13"},
+    {file = "cryptography-42.0.7-cp37-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:e6b8f1881dac458c34778d0a424ae5769de30544fc678eac51c1c8bb2183e9da"},
+    {file = "cryptography-42.0.7-cp37-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3de9a45d3b2b7d8088c3fbf1ed4395dfeff79d07842217b38df14ef09ce1d8d7"},
+    {file = "cryptography-42.0.7-cp37-abi3-win32.whl", hash = "sha256:789caea816c6704f63f6241a519bfa347f72fbd67ba28d04636b7c6b7da94b0b"},
+    {file = "cryptography-42.0.7-cp37-abi3-win_amd64.whl", hash = "sha256:8cb8ce7c3347fcf9446f201dc30e2d5a3c898d009126010cbd1f443f28b52678"},
+    {file = "cryptography-42.0.7-cp39-abi3-macosx_10_12_universal2.whl", hash = "sha256:a3a5ac8b56fe37f3125e5b72b61dcde43283e5370827f5233893d461b7360cd4"},
+    {file = "cryptography-42.0.7-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:779245e13b9a6638df14641d029add5dc17edbef6ec915688f3acb9e720a5858"},
+    {file = "cryptography-42.0.7-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0d563795db98b4cd57742a78a288cdbdc9daedac29f2239793071fe114f13785"},
+    {file = "cryptography-42.0.7-cp39-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:31adb7d06fe4383226c3e963471f6837742889b3c4caa55aac20ad951bc8ffda"},
+    {file = "cryptography-42.0.7-cp39-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:efd0bf5205240182e0f13bcaea41be4fdf5c22c5129fc7ced4a0282ac86998c9"},
+    {file = "cryptography-42.0.7-cp39-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:a9bc127cdc4ecf87a5ea22a2556cab6c7eda2923f84e4f3cc588e8470ce4e42e"},
+    {file = "cryptography-42.0.7-cp39-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:3577d029bc3f4827dd5bf8bf7710cac13527b470bbf1820a3f394adb38ed7d5f"},
+    {file = "cryptography-42.0.7-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:2e47577f9b18723fa294b0ea9a17d5e53a227867a0a4904a1a076d1646d45ca1"},
+    {file = "cryptography-42.0.7-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:1a58839984d9cb34c855197043eaae2c187d930ca6d644612843b4fe8513c886"},
+    {file = "cryptography-42.0.7-cp39-abi3-win32.whl", hash = "sha256:e6b79d0adb01aae87e8a44c2b64bc3f3fe59515280e00fb6d57a7267a2583cda"},
+    {file = "cryptography-42.0.7-cp39-abi3-win_amd64.whl", hash = "sha256:16268d46086bb8ad5bf0a2b5544d8a9ed87a0e33f5e77dd3c3301e63d941a83b"},
+    {file = "cryptography-42.0.7-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:2954fccea107026512b15afb4aa664a5640cd0af630e2ee3962f2602693f0c82"},
+    {file = "cryptography-42.0.7-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:362e7197754c231797ec45ee081f3088a27a47c6c01eff2ac83f60f85a50fe60"},
+    {file = "cryptography-42.0.7-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:4f698edacf9c9e0371112792558d2f705b5645076cc0aaae02f816a0171770fd"},
+    {file = "cryptography-42.0.7-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:5482e789294854c28237bba77c4c83be698be740e31a3ae5e879ee5444166582"},
+    {file = "cryptography-42.0.7-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:e9b2a6309f14c0497f348d08a065d52f3020656f675819fc405fb63bbcd26562"},
+    {file = "cryptography-42.0.7-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:d8e3098721b84392ee45af2dd554c947c32cc52f862b6a3ae982dbb90f577f14"},
+    {file = "cryptography-42.0.7-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c65f96dad14f8528a447414125e1fc8feb2ad5a272b8f68477abbcc1ea7d94b9"},
+    {file = "cryptography-42.0.7-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:36017400817987670037fbb0324d71489b6ead6231c9604f8fc1f7d008087c68"},
+    {file = "cryptography-42.0.7.tar.gz", hash = "sha256:ecbfbc00bf55888edda9868a4cf927205de8499e7fabe6c050322298382953f2"},
 ]
 
 [package.dependencies]
@@ -560,23 +560,6 @@ files = [
 test = ["async-timeout", "pytest", "pytest-asyncio (>=0.17)", "pytest-trio", "testpath", "trio"]
 trio = ["async_generator", "trio"]
 
-[[package]]
-name = "jinja2"
-version = "3.1.3"
-description = "A very fast and expressive template engine."
-optional = false
-python-versions = ">=3.7"
-files = [
-    {file = "Jinja2-3.1.3-py3-none-any.whl", hash = "sha256:7d6d50dd97d52cbc355597bd845fabfbac3f551e1f99619e39a35ce8c370b5fa"},
-    {file = "Jinja2-3.1.3.tar.gz", hash = "sha256:ac8bd6544d4bb2c9792bf3a159e80bba8fda7f07e81bc3aed565432d5925ba90"},
-]
-
-[package.dependencies]
-MarkupSafe = ">=2.0"
-
-[package.extras]
-i18n = ["Babel (>=2.7)"]
-
 [[package]]
 name = "keyring"
 version = "24.3.1"
@@ -799,165 +782,153 @@ source = ["Cython (>=3.0.7)"]
 
 [[package]]
 name = "lxml"
-version = "5.2.1"
+version = "5.2.2"
 description = "Powerful and Pythonic XML processing library combining libxml2/libxslt with the ElementTree API."
 optional = false
 python-versions = ">=3.6"
 files = [
-    {file = "lxml-5.2.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:1f7785f4f789fdb522729ae465adcaa099e2a3441519df750ebdccc481d961a1"},
-    {file = "lxml-5.2.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:6cc6ee342fb7fa2471bd9b6d6fdfc78925a697bf5c2bcd0a302e98b0d35bfad3"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:794f04eec78f1d0e35d9e0c36cbbb22e42d370dda1609fb03bcd7aeb458c6377"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c817d420c60a5183953c783b0547d9eb43b7b344a2c46f69513d5952a78cddf3"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:2213afee476546a7f37c7a9b4ad4d74b1e112a6fafffc9185d6d21f043128c81"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b070bbe8d3f0f6147689bed981d19bbb33070225373338df755a46893528104a"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e02c5175f63effbd7c5e590399c118d5db6183bbfe8e0d118bdb5c2d1b48d937"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:3dc773b2861b37b41a6136e0b72a1a44689a9c4c101e0cddb6b854016acc0aa8"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_28_ppc64le.whl", hash = "sha256:d7520db34088c96cc0e0a3ad51a4fd5b401f279ee112aa2b7f8f976d8582606d"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_28_s390x.whl", hash = "sha256:bcbf4af004f98793a95355980764b3d80d47117678118a44a80b721c9913436a"},
-    {file = "lxml-5.2.1-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:a2b44bec7adf3e9305ce6cbfa47a4395667e744097faed97abb4728748ba7d47"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:1c5bb205e9212d0ebddf946bc07e73fa245c864a5f90f341d11ce7b0b854475d"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:2c9d147f754b1b0e723e6afb7ba1566ecb162fe4ea657f53d2139bbf894d050a"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:3545039fa4779be2df51d6395e91a810f57122290864918b172d5dc7ca5bb433"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a91481dbcddf1736c98a80b122afa0f7296eeb80b72344d7f45dc9f781551f56"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:2ddfe41ddc81f29a4c44c8ce239eda5ade4e7fc305fb7311759dd6229a080052"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:a7baf9ffc238e4bf401299f50e971a45bfcc10a785522541a6e3179c83eabf0a"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:31e9a882013c2f6bd2f2c974241bf4ba68c85eba943648ce88936d23209a2e01"},
-    {file = "lxml-5.2.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:0a15438253b34e6362b2dc41475e7f80de76320f335e70c5528b7148cac253a1"},
-    {file = "lxml-5.2.1-cp310-cp310-win32.whl", hash = "sha256:6992030d43b916407c9aa52e9673612ff39a575523c5f4cf72cdef75365709a5"},
-    {file = "lxml-5.2.1-cp310-cp310-win_amd64.whl", hash = "sha256:da052e7962ea2d5e5ef5bc0355d55007407087392cf465b7ad84ce5f3e25fe0f"},
-    {file = "lxml-5.2.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:70ac664a48aa64e5e635ae5566f5227f2ab7f66a3990d67566d9907edcbbf867"},
-    {file = "lxml-5.2.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1ae67b4e737cddc96c99461d2f75d218bdf7a0c3d3ad5604d1f5e7464a2f9ffe"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f18a5a84e16886898e51ab4b1d43acb3083c39b14c8caeb3589aabff0ee0b270"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c6f2c8372b98208ce609c9e1d707f6918cc118fea4e2c754c9f0812c04ca116d"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:394ed3924d7a01b5bd9a0d9d946136e1c2f7b3dc337196d99e61740ed4bc6fe1"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5d077bc40a1fe984e1a9931e801e42959a1e6598edc8a3223b061d30fbd26bbc"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:764b521b75701f60683500d8621841bec41a65eb739b8466000c6fdbc256c240"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:3a6b45da02336895da82b9d472cd274b22dc27a5cea1d4b793874eead23dd14f"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_28_ppc64le.whl", hash = "sha256:5ea7b6766ac2dfe4bcac8b8595107665a18ef01f8c8343f00710b85096d1b53a"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_28_s390x.whl", hash = "sha256:e196a4ff48310ba62e53a8e0f97ca2bca83cdd2fe2934d8b5cb0df0a841b193a"},
-    {file = "lxml-5.2.1-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:200e63525948e325d6a13a76ba2911f927ad399ef64f57898cf7c74e69b71095"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:dae0ed02f6b075426accbf6b2863c3d0a7eacc1b41fb40f2251d931e50188dad"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:ab31a88a651039a07a3ae327d68ebdd8bc589b16938c09ef3f32a4b809dc96ef"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:df2e6f546c4df14bc81f9498bbc007fbb87669f1bb707c6138878c46b06f6510"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:5dd1537e7cc06efd81371f5d1a992bd5ab156b2b4f88834ca852de4a8ea523fa"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:9b9ec9c9978b708d488bec36b9e4c94d88fd12ccac3e62134a9d17ddba910ea9"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:8e77c69d5892cb5ba71703c4057091e31ccf534bd7f129307a4d084d90d014b8"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:a8d5c70e04aac1eda5c829a26d1f75c6e5286c74743133d9f742cda8e53b9c2f"},
-    {file = "lxml-5.2.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:c94e75445b00319c1fad60f3c98b09cd63fe1134a8a953dcd48989ef42318534"},
-    {file = "lxml-5.2.1-cp311-cp311-win32.whl", hash = "sha256:4951e4f7a5680a2db62f7f4ab2f84617674d36d2d76a729b9a8be4b59b3659be"},
-    {file = "lxml-5.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:5c670c0406bdc845b474b680b9a5456c561c65cf366f8db5a60154088c92d102"},
-    {file = "lxml-5.2.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:abc25c3cab9ec7fcd299b9bcb3b8d4a1231877e425c650fa1c7576c5107ab851"},
-    {file = "lxml-5.2.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:6935bbf153f9a965f1e07c2649c0849d29832487c52bb4a5c5066031d8b44fd5"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d793bebb202a6000390a5390078e945bbb49855c29c7e4d56a85901326c3b5d9"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:afd5562927cdef7c4f5550374acbc117fd4ecc05b5007bdfa57cc5355864e0a4"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0e7259016bc4345a31af861fdce942b77c99049d6c2107ca07dc2bba2435c1d9"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:530e7c04f72002d2f334d5257c8a51bf409db0316feee7c87e4385043be136af"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:59689a75ba8d7ffca577aefd017d08d659d86ad4585ccc73e43edbfc7476781a"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:f9737bf36262046213a28e789cc82d82c6ef19c85a0cf05e75c670a33342ac2c"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_28_ppc64le.whl", hash = "sha256:3a74c4f27167cb95c1d4af1c0b59e88b7f3e0182138db2501c353555f7ec57f4"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_28_s390x.whl", hash = "sha256:68a2610dbe138fa8c5826b3f6d98a7cfc29707b850ddcc3e21910a6fe51f6ca0"},
-    {file = "lxml-5.2.1-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:f0a1bc63a465b6d72569a9bba9f2ef0334c4e03958e043da1920299100bc7c08"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c2d35a1d047efd68027817b32ab1586c1169e60ca02c65d428ae815b593e65d4"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:79bd05260359170f78b181b59ce871673ed01ba048deef4bf49a36ab3e72e80b"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:865bad62df277c04beed9478fe665b9ef63eb28fe026d5dedcb89b537d2e2ea6"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:44f6c7caff88d988db017b9b0e4ab04934f11e3e72d478031efc7edcac6c622f"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:71e97313406ccf55d32cc98a533ee05c61e15d11b99215b237346171c179c0b0"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:057cdc6b86ab732cf361f8b4d8af87cf195a1f6dc5b0ff3de2dced242c2015e0"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:f3bbbc998d42f8e561f347e798b85513ba4da324c2b3f9b7969e9c45b10f6169"},
-    {file = "lxml-5.2.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:491755202eb21a5e350dae00c6d9a17247769c64dcf62d8c788b5c135e179dc4"},
-    {file = "lxml-5.2.1-cp312-cp312-win32.whl", hash = "sha256:8de8f9d6caa7f25b204fc861718815d41cbcf27ee8f028c89c882a0cf4ae4134"},
-    {file = "lxml-5.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:f2a9efc53d5b714b8df2b4b3e992accf8ce5bbdfe544d74d5c6766c9e1146a3a"},
-    {file = "lxml-5.2.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:70a9768e1b9d79edca17890175ba915654ee1725975d69ab64813dd785a2bd5c"},
-    {file = "lxml-5.2.1-cp36-cp36m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c38d7b9a690b090de999835f0443d8aa93ce5f2064035dfc48f27f02b4afc3d0"},
-    {file = "lxml-5.2.1-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5670fb70a828663cc37552a2a85bf2ac38475572b0e9b91283dc09efb52c41d1"},
-    {file = "lxml-5.2.1-cp36-cp36m-manylinux_2_28_x86_64.whl", hash = "sha256:958244ad566c3ffc385f47dddde4145088a0ab893504b54b52c041987a8c1863"},
-    {file = "lxml-5.2.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:b6241d4eee5f89453307c2f2bfa03b50362052ca0af1efecf9fef9a41a22bb4f"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:2a66bf12fbd4666dd023b6f51223aed3d9f3b40fef06ce404cb75bafd3d89536"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_1_ppc64le.whl", hash = "sha256:9123716666e25b7b71c4e1789ec829ed18663152008b58544d95b008ed9e21e9"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_1_s390x.whl", hash = "sha256:0c3f67e2aeda739d1cc0b1102c9a9129f7dc83901226cc24dd72ba275ced4218"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:5d5792e9b3fb8d16a19f46aa8208987cfeafe082363ee2745ea8b643d9cc5b45"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_2_aarch64.whl", hash = "sha256:88e22fc0a6684337d25c994381ed8a1580a6f5ebebd5ad41f89f663ff4ec2885"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_2_ppc64le.whl", hash = "sha256:21c2e6b09565ba5b45ae161b438e033a86ad1736b8c838c766146eff8ceffff9"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_2_s390x.whl", hash = "sha256:afbbdb120d1e78d2ba8064a68058001b871154cc57787031b645c9142b937a62"},
-    {file = "lxml-5.2.1-cp36-cp36m-musllinux_1_2_x86_64.whl", hash = "sha256:627402ad8dea044dde2eccde4370560a2b750ef894c9578e1d4f8ffd54000461"},
-    {file = "lxml-5.2.1-cp36-cp36m-win32.whl", hash = "sha256:e89580a581bf478d8dcb97d9cd011d567768e8bc4095f8557b21c4d4c5fea7d0"},
-    {file = "lxml-5.2.1-cp36-cp36m-win_amd64.whl", hash = "sha256:59565f10607c244bc4c05c0c5fa0c190c990996e0c719d05deec7030c2aa8289"},
-    {file = "lxml-5.2.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:857500f88b17a6479202ff5fe5f580fc3404922cd02ab3716197adf1ef628029"},
-    {file = "lxml-5.2.1-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:56c22432809085b3f3ae04e6e7bdd36883d7258fcd90e53ba7b2e463efc7a6af"},
-    {file = "lxml-5.2.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a55ee573116ba208932e2d1a037cc4b10d2c1cb264ced2184d00b18ce585b2c0"},
-    {file = "lxml-5.2.1-cp37-cp37m-manylinux_2_28_x86_64.whl", hash = "sha256:6cf58416653c5901e12624e4013708b6e11142956e7f35e7a83f1ab02f3fe456"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:64c2baa7774bc22dd4474248ba16fe1a7f611c13ac6123408694d4cc93d66dbd"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:74b28c6334cca4dd704e8004cba1955af0b778cf449142e581e404bd211fb619"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:7221d49259aa1e5a8f00d3d28b1e0b76031655ca74bb287123ef56c3db92f213"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:3dbe858ee582cbb2c6294dc85f55b5f19c918c2597855e950f34b660f1a5ede6"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_2_aarch64.whl", hash = "sha256:04ab5415bf6c86e0518d57240a96c4d1fcfc3cb370bb2ac2a732b67f579e5a04"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_2_ppc64le.whl", hash = "sha256:6ab833e4735a7e5533711a6ea2df26459b96f9eec36d23f74cafe03631647c41"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_2_s390x.whl", hash = "sha256:f443cdef978430887ed55112b491f670bba6462cea7a7742ff8f14b7abb98d75"},
-    {file = "lxml-5.2.1-cp37-cp37m-musllinux_1_2_x86_64.whl", hash = "sha256:9e2addd2d1866fe112bc6f80117bcc6bc25191c5ed1bfbcf9f1386a884252ae8"},
-    {file = "lxml-5.2.1-cp37-cp37m-win32.whl", hash = "sha256:f51969bac61441fd31f028d7b3b45962f3ecebf691a510495e5d2cd8c8092dbd"},
-    {file = "lxml-5.2.1-cp37-cp37m-win_amd64.whl", hash = "sha256:b0b58fbfa1bf7367dde8a557994e3b1637294be6cf2169810375caf8571a085c"},
-    {file = "lxml-5.2.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:804f74efe22b6a227306dd890eecc4f8c59ff25ca35f1f14e7482bbce96ef10b"},
-    {file = "lxml-5.2.1-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:08802f0c56ed150cc6885ae0788a321b73505d2263ee56dad84d200cab11c07a"},
-    {file = "lxml-5.2.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0f8c09ed18ecb4ebf23e02b8e7a22a05d6411911e6fabef3a36e4f371f4f2585"},
-    {file = "lxml-5.2.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e3d30321949861404323c50aebeb1943461a67cd51d4200ab02babc58bd06a86"},
-    {file = "lxml-5.2.1-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:b560e3aa4b1d49e0e6c847d72665384db35b2f5d45f8e6a5c0072e0283430533"},
-    {file = "lxml-5.2.1-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:058a1308914f20784c9f4674036527e7c04f7be6fb60f5d61353545aa7fcb739"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:adfb84ca6b87e06bc6b146dc7da7623395db1e31621c4785ad0658c5028b37d7"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:417d14450f06d51f363e41cace6488519038f940676ce9664b34ebf5653433a5"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:a2dfe7e2473f9b59496247aad6e23b405ddf2e12ef0765677b0081c02d6c2c0b"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:bf2e2458345d9bffb0d9ec16557d8858c9c88d2d11fed53998512504cd9df49b"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:58278b29cb89f3e43ff3e0c756abbd1518f3ee6adad9e35b51fb101c1c1daaec"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:64641a6068a16201366476731301441ce93457eb8452056f570133a6ceb15fca"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:78bfa756eab503673991bdcf464917ef7845a964903d3302c5f68417ecdc948c"},
-    {file = "lxml-5.2.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:11a04306fcba10cd9637e669fd73aa274c1c09ca64af79c041aa820ea992b637"},
-    {file = "lxml-5.2.1-cp38-cp38-win32.whl", hash = "sha256:66bc5eb8a323ed9894f8fa0ee6cb3e3fb2403d99aee635078fd19a8bc7a5a5da"},
-    {file = "lxml-5.2.1-cp38-cp38-win_amd64.whl", hash = "sha256:9676bfc686fa6a3fa10cd4ae6b76cae8be26eb5ec6811d2a325636c460da1806"},
-    {file = "lxml-5.2.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:cf22b41fdae514ee2f1691b6c3cdeae666d8b7fa9434de445f12bbeee0cf48dd"},
-    {file = "lxml-5.2.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:ec42088248c596dbd61d4ae8a5b004f97a4d91a9fd286f632e42e60b706718d7"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cd53553ddad4a9c2f1f022756ae64abe16da1feb497edf4d9f87f99ec7cf86bd"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:feaa45c0eae424d3e90d78823f3828e7dc42a42f21ed420db98da2c4ecf0a2cb"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ddc678fb4c7e30cf830a2b5a8d869538bc55b28d6c68544d09c7d0d8f17694dc"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:853e074d4931dbcba7480d4dcab23d5c56bd9607f92825ab80ee2bd916edea53"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc4691d60512798304acb9207987e7b2b7c44627ea88b9d77489bbe3e6cc3bd4"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:beb72935a941965c52990f3a32d7f07ce869fe21c6af8b34bf6a277b33a345d3"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_28_ppc64le.whl", hash = "sha256:6588c459c5627fefa30139be4d2e28a2c2a1d0d1c265aad2ba1935a7863a4913"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_28_s390x.whl", hash = "sha256:588008b8497667f1ddca7c99f2f85ce8511f8f7871b4a06ceede68ab62dff64b"},
-    {file = "lxml-5.2.1-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:b6787b643356111dfd4032b5bffe26d2f8331556ecb79e15dacb9275da02866e"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:7c17b64b0a6ef4e5affae6a3724010a7a66bda48a62cfe0674dabd46642e8b54"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:27aa20d45c2e0b8cd05da6d4759649170e8dfc4f4e5ef33a34d06f2d79075d57"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:d4f2cc7060dc3646632d7f15fe68e2fa98f58e35dd5666cd525f3b35d3fed7f8"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:ff46d772d5f6f73564979cd77a4fffe55c916a05f3cb70e7c9c0590059fb29ef"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:96323338e6c14e958d775700ec8a88346014a85e5de73ac7967db0367582049b"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:52421b41ac99e9d91934e4d0d0fe7da9f02bfa7536bb4431b4c05c906c8c6919"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:7a7efd5b6d3e30d81ec68ab8a88252d7c7c6f13aaa875009fe3097eb4e30b84c"},
-    {file = "lxml-5.2.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:0ed777c1e8c99b63037b91f9d73a6aad20fd035d77ac84afcc205225f8f41188"},
-    {file = "lxml-5.2.1-cp39-cp39-win32.whl", hash = "sha256:644df54d729ef810dcd0f7732e50e5ad1bd0a135278ed8d6bcb06f33b6b6f708"},
-    {file = "lxml-5.2.1-cp39-cp39-win_amd64.whl", hash = "sha256:9ca66b8e90daca431b7ca1408cae085d025326570e57749695d6a01454790e95"},
-    {file = "lxml-5.2.1-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:9b0ff53900566bc6325ecde9181d89afadc59c5ffa39bddf084aaedfe3b06a11"},
-    {file = "lxml-5.2.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fd6037392f2d57793ab98d9e26798f44b8b4da2f2464388588f48ac52c489ea1"},
-    {file = "lxml-5.2.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8b9c07e7a45bb64e21df4b6aa623cb8ba214dfb47d2027d90eac197329bb5e94"},
-    {file = "lxml-5.2.1-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:3249cc2989d9090eeac5467e50e9ec2d40704fea9ab72f36b034ea34ee65ca98"},
-    {file = "lxml-5.2.1-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:f42038016852ae51b4088b2862126535cc4fc85802bfe30dea3500fdfaf1864e"},
-    {file = "lxml-5.2.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:533658f8fbf056b70e434dff7e7aa611bcacb33e01f75de7f821810e48d1bb66"},
-    {file = "lxml-5.2.1-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:622020d4521e22fb371e15f580d153134bfb68d6a429d1342a25f051ec72df1c"},
-    {file = "lxml-5.2.1-pp37-pypy37_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:efa7b51824aa0ee957ccd5a741c73e6851de55f40d807f08069eb4c5a26b2baa"},
-    {file = "lxml-5.2.1-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9c6ad0fbf105f6bcc9300c00010a2ffa44ea6f555df1a2ad95c88f5656104817"},
-    {file = "lxml-5.2.1-pp37-pypy37_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:e233db59c8f76630c512ab4a4daf5a5986da5c3d5b44b8e9fc742f2a24dbd460"},
-    {file = "lxml-5.2.1-pp37-pypy37_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:6a014510830df1475176466b6087fc0c08b47a36714823e58d8b8d7709132a96"},
-    {file = "lxml-5.2.1-pp37-pypy37_pp73-win_amd64.whl", hash = "sha256:d38c8f50ecf57f0463399569aa388b232cf1a2ffb8f0a9a5412d0db57e054860"},
-    {file = "lxml-5.2.1-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:5aea8212fb823e006b995c4dda533edcf98a893d941f173f6c9506126188860d"},
-    {file = "lxml-5.2.1-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ff097ae562e637409b429a7ac958a20aab237a0378c42dabaa1e3abf2f896e5f"},
-    {file = "lxml-5.2.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0f5d65c39f16717a47c36c756af0fb36144069c4718824b7533f803ecdf91138"},
-    {file = "lxml-5.2.1-pp38-pypy38_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:3d0c3dd24bb4605439bf91068598d00c6370684f8de4a67c2992683f6c309d6b"},
-    {file = "lxml-5.2.1-pp38-pypy38_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:e32be23d538753a8adb6c85bd539f5fd3b15cb987404327c569dfc5fd8366e85"},
-    {file = "lxml-5.2.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:cc518cea79fd1e2f6c90baafa28906d4309d24f3a63e801d855e7424c5b34144"},
-    {file = "lxml-5.2.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a0af35bd8ebf84888373630f73f24e86bf016642fb8576fba49d3d6b560b7cbc"},
-    {file = "lxml-5.2.1-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f8aca2e3a72f37bfc7b14ba96d4056244001ddcc18382bd0daa087fd2e68a354"},
-    {file = "lxml-5.2.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5ca1e8188b26a819387b29c3895c47a5e618708fe6f787f3b1a471de2c4a94d9"},
-    {file = "lxml-5.2.1-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:c8ba129e6d3b0136a0f50345b2cb3db53f6bda5dd8c7f5d83fbccba97fb5dcb5"},
-    {file = "lxml-5.2.1-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:e998e304036198b4f6914e6a1e2b6f925208a20e2042563d9734881150c6c246"},
-    {file = "lxml-5.2.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:d3be9b2076112e51b323bdf6d5a7f8a798de55fb8d95fcb64bd179460cdc0704"},
-    {file = "lxml-5.2.1.tar.gz", hash = "sha256:3f7765e69bbce0906a7c74d5fe46d2c7a7596147318dbc08e4a2431f3060e306"},
+    {file = "lxml-5.2.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:364d03207f3e603922d0d3932ef363d55bbf48e3647395765f9bfcbdf6d23632"},
+    {file = "lxml-5.2.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:50127c186f191b8917ea2fb8b206fbebe87fd414a6084d15568c27d0a21d60db"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:74e4f025ef3db1c6da4460dd27c118d8cd136d0391da4e387a15e48e5c975147"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:981a06a3076997adf7c743dcd0d7a0415582661e2517c7d961493572e909aa1d"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:aef5474d913d3b05e613906ba4090433c515e13ea49c837aca18bde190853dff"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1e275ea572389e41e8b039ac076a46cb87ee6b8542df3fff26f5baab43713bca"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f5b65529bb2f21ac7861a0e94fdbf5dc0daab41497d18223b46ee8515e5ad297"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:bcc98f911f10278d1daf14b87d65325851a1d29153caaf146877ec37031d5f36"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_28_ppc64le.whl", hash = "sha256:b47633251727c8fe279f34025844b3b3a3e40cd1b198356d003aa146258d13a2"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_28_s390x.whl", hash = "sha256:fbc9d316552f9ef7bba39f4edfad4a734d3d6f93341232a9dddadec4f15d425f"},
+    {file = "lxml-5.2.2-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:13e69be35391ce72712184f69000cda04fc89689429179bc4c0ae5f0b7a8c21b"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:3b6a30a9ab040b3f545b697cb3adbf3696c05a3a68aad172e3fd7ca73ab3c835"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:a233bb68625a85126ac9f1fc66d24337d6e8a0f9207b688eec2e7c880f012ec0"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:dfa7c241073d8f2b8e8dbc7803c434f57dbb83ae2a3d7892dd068d99e96efe2c"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a7aca7964ac4bb07680d5c9d63b9d7028cace3e2d43175cb50bba8c5ad33316"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:ae4073a60ab98529ab8a72ebf429f2a8cc612619a8c04e08bed27450d52103c0"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:ffb2be176fed4457e445fe540617f0252a72a8bc56208fd65a690fdb1f57660b"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:e290d79a4107d7d794634ce3e985b9ae4f920380a813717adf61804904dc4393"},
+    {file = "lxml-5.2.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:96e85aa09274955bb6bd483eaf5b12abadade01010478154b0ec70284c1b1526"},
+    {file = "lxml-5.2.2-cp310-cp310-win32.whl", hash = "sha256:f956196ef61369f1685d14dad80611488d8dc1ef00be57c0c5a03064005b0f30"},
+    {file = "lxml-5.2.2-cp310-cp310-win_amd64.whl", hash = "sha256:875a3f90d7eb5c5d77e529080d95140eacb3c6d13ad5b616ee8095447b1d22e7"},
+    {file = "lxml-5.2.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:45f9494613160d0405682f9eee781c7e6d1bf45f819654eb249f8f46a2c22545"},
+    {file = "lxml-5.2.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:b0b3f2df149efb242cee2ffdeb6674b7f30d23c9a7af26595099afaf46ef4e88"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d28cb356f119a437cc58a13f8135ab8a4c8ece18159eb9194b0d269ec4e28083"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:657a972f46bbefdbba2d4f14413c0d079f9ae243bd68193cb5061b9732fa54c1"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b74b9ea10063efb77a965a8d5f4182806fbf59ed068b3c3fd6f30d2ac7bee734"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:07542787f86112d46d07d4f3c4e7c760282011b354d012dc4141cc12a68cef5f"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:303f540ad2dddd35b92415b74b900c749ec2010e703ab3bfd6660979d01fd4ed"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:2eb2227ce1ff998faf0cd7fe85bbf086aa41dfc5af3b1d80867ecfe75fb68df3"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_28_ppc64le.whl", hash = "sha256:1d8a701774dfc42a2f0b8ccdfe7dbc140500d1049e0632a611985d943fcf12df"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_28_s390x.whl", hash = "sha256:56793b7a1a091a7c286b5f4aa1fe4ae5d1446fe742d00cdf2ffb1077865db10d"},
+    {file = "lxml-5.2.2-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:eb00b549b13bd6d884c863554566095bf6fa9c3cecb2e7b399c4bc7904cb33b5"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:1a2569a1f15ae6c8c64108a2cd2b4a858fc1e13d25846be0666fc144715e32ab"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:8cf85a6e40ff1f37fe0f25719aadf443686b1ac7652593dc53c7ef9b8492b115"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:d237ba6664b8e60fd90b8549a149a74fcc675272e0e95539a00522e4ca688b04"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:0b3f5016e00ae7630a4b83d0868fca1e3d494c78a75b1c7252606a3a1c5fc2ad"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:23441e2b5339bc54dc949e9e675fa35efe858108404ef9aa92f0456929ef6fe8"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:2fb0ba3e8566548d6c8e7dd82a8229ff47bd8fb8c2da237607ac8e5a1b8312e5"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:79d1fb9252e7e2cfe4de6e9a6610c7cbb99b9708e2c3e29057f487de5a9eaefa"},
+    {file = "lxml-5.2.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:6dcc3d17eac1df7859ae01202e9bb11ffa8c98949dcbeb1069c8b9a75917e01b"},
+    {file = "lxml-5.2.2-cp311-cp311-win32.whl", hash = "sha256:4c30a2f83677876465f44c018830f608fa3c6a8a466eb223535035fbc16f3438"},
+    {file = "lxml-5.2.2-cp311-cp311-win_amd64.whl", hash = "sha256:49095a38eb333aaf44c06052fd2ec3b8f23e19747ca7ec6f6c954ffea6dbf7be"},
+    {file = "lxml-5.2.2-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:7429e7faa1a60cad26ae4227f4dd0459efde239e494c7312624ce228e04f6391"},
+    {file = "lxml-5.2.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:50ccb5d355961c0f12f6cf24b7187dbabd5433f29e15147a67995474f27d1776"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:dc911208b18842a3a57266d8e51fc3cfaccee90a5351b92079beed912a7914c2"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:33ce9e786753743159799fdf8e92a5da351158c4bfb6f2db0bf31e7892a1feb5"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ec87c44f619380878bd49ca109669c9f221d9ae6883a5bcb3616785fa8f94c97"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:08ea0f606808354eb8f2dfaac095963cb25d9d28e27edcc375d7b30ab01abbf6"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:75a9632f1d4f698b2e6e2e1ada40e71f369b15d69baddb8968dcc8e683839b18"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:74da9f97daec6928567b48c90ea2c82a106b2d500f397eeb8941e47d30b1ca85"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_28_ppc64le.whl", hash = "sha256:0969e92af09c5687d769731e3f39ed62427cc72176cebb54b7a9d52cc4fa3b73"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_28_s390x.whl", hash = "sha256:9164361769b6ca7769079f4d426a41df6164879f7f3568be9086e15baca61466"},
+    {file = "lxml-5.2.2-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:d26a618ae1766279f2660aca0081b2220aca6bd1aa06b2cf73f07383faf48927"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ab67ed772c584b7ef2379797bf14b82df9aa5f7438c5b9a09624dd834c1c1aaf"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:3d1e35572a56941b32c239774d7e9ad724074d37f90c7a7d499ab98761bd80cf"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:8268cbcd48c5375f46e000adb1390572c98879eb4f77910c6053d25cc3ac2c67"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:e282aedd63c639c07c3857097fc0e236f984ceb4089a8b284da1c526491e3f3d"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6dfdc2bfe69e9adf0df4915949c22a25b39d175d599bf98e7ddf620a13678585"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:4aefd911793b5d2d7a921233a54c90329bf3d4a6817dc465f12ffdfe4fc7b8fe"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:8b8df03a9e995b6211dafa63b32f9d405881518ff1ddd775db4e7b98fb545e1c"},
+    {file = "lxml-5.2.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:f11ae142f3a322d44513de1018b50f474f8f736bc3cd91d969f464b5bfef8836"},
+    {file = "lxml-5.2.2-cp312-cp312-win32.whl", hash = "sha256:16a8326e51fcdffc886294c1e70b11ddccec836516a343f9ed0f82aac043c24a"},
+    {file = "lxml-5.2.2-cp312-cp312-win_amd64.whl", hash = "sha256:bbc4b80af581e18568ff07f6395c02114d05f4865c2812a1f02f2eaecf0bfd48"},
+    {file = "lxml-5.2.2-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:e3d9d13603410b72787579769469af730c38f2f25505573a5888a94b62b920f8"},
+    {file = "lxml-5.2.2-cp36-cp36m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:38b67afb0a06b8575948641c1d6d68e41b83a3abeae2ca9eed2ac59892b36706"},
+    {file = "lxml-5.2.2-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c689d0d5381f56de7bd6966a4541bff6e08bf8d3871bbd89a0c6ab18aa699573"},
+    {file = "lxml-5.2.2-cp36-cp36m-manylinux_2_28_x86_64.whl", hash = "sha256:cf2a978c795b54c539f47964ec05e35c05bd045db5ca1e8366988c7f2fe6b3ce"},
+    {file = "lxml-5.2.2-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:739e36ef7412b2bd940f75b278749106e6d025e40027c0b94a17ef7968d55d56"},
+    {file = "lxml-5.2.2-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:d8bbcd21769594dbba9c37d3c819e2d5847656ca99c747ddb31ac1701d0c0ed9"},
+    {file = "lxml-5.2.2-cp36-cp36m-musllinux_1_2_x86_64.whl", hash = "sha256:2304d3c93f2258ccf2cf7a6ba8c761d76ef84948d87bf9664e14d203da2cd264"},
+    {file = "lxml-5.2.2-cp36-cp36m-win32.whl", hash = "sha256:02437fb7308386867c8b7b0e5bc4cd4b04548b1c5d089ffb8e7b31009b961dc3"},
+    {file = "lxml-5.2.2-cp36-cp36m-win_amd64.whl", hash = "sha256:edcfa83e03370032a489430215c1e7783128808fd3e2e0a3225deee278585196"},
+    {file = "lxml-5.2.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:28bf95177400066596cdbcfc933312493799382879da504633d16cf60bba735b"},
+    {file = "lxml-5.2.2-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3a745cc98d504d5bd2c19b10c79c61c7c3df9222629f1b6210c0368177589fb8"},
+    {file = "lxml-5.2.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1b590b39ef90c6b22ec0be925b211298e810b4856909c8ca60d27ffbca6c12e6"},
+    {file = "lxml-5.2.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b336b0416828022bfd5a2e3083e7f5ba54b96242159f83c7e3eebaec752f1716"},
+    {file = "lxml-5.2.2-cp37-cp37m-manylinux_2_28_aarch64.whl", hash = "sha256:c2faf60c583af0d135e853c86ac2735ce178f0e338a3c7f9ae8f622fd2eb788c"},
+    {file = "lxml-5.2.2-cp37-cp37m-manylinux_2_28_x86_64.whl", hash = "sha256:4bc6cb140a7a0ad1f7bc37e018d0ed690b7b6520ade518285dc3171f7a117905"},
+    {file = "lxml-5.2.2-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:7ff762670cada8e05b32bf1e4dc50b140790909caa8303cfddc4d702b71ea184"},
+    {file = "lxml-5.2.2-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:57f0a0bbc9868e10ebe874e9f129d2917750adf008fe7b9c1598c0fbbfdde6a6"},
+    {file = "lxml-5.2.2-cp37-cp37m-musllinux_1_2_aarch64.whl", hash = "sha256:a6d2092797b388342c1bc932077ad232f914351932353e2e8706851c870bca1f"},
+    {file = "lxml-5.2.2-cp37-cp37m-musllinux_1_2_x86_64.whl", hash = "sha256:60499fe961b21264e17a471ec296dcbf4365fbea611bf9e303ab69db7159ce61"},
+    {file = "lxml-5.2.2-cp37-cp37m-win32.whl", hash = "sha256:d9b342c76003c6b9336a80efcc766748a333573abf9350f4094ee46b006ec18f"},
+    {file = "lxml-5.2.2-cp37-cp37m-win_amd64.whl", hash = "sha256:b16db2770517b8799c79aa80f4053cd6f8b716f21f8aca962725a9565ce3ee40"},
+    {file = "lxml-5.2.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:7ed07b3062b055d7a7f9d6557a251cc655eed0b3152b76de619516621c56f5d3"},
+    {file = "lxml-5.2.2-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f60fdd125d85bf9c279ffb8e94c78c51b3b6a37711464e1f5f31078b45002421"},
+    {file = "lxml-5.2.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8a7e24cb69ee5f32e003f50e016d5fde438010c1022c96738b04fc2423e61706"},
+    {file = "lxml-5.2.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:23cfafd56887eaed93d07bc4547abd5e09d837a002b791e9767765492a75883f"},
+    {file = "lxml-5.2.2-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:19b4e485cd07b7d83e3fe3b72132e7df70bfac22b14fe4bf7a23822c3a35bff5"},
+    {file = "lxml-5.2.2-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:7ce7ad8abebe737ad6143d9d3bf94b88b93365ea30a5b81f6877ec9c0dee0a48"},
+    {file = "lxml-5.2.2-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:e49b052b768bb74f58c7dda4e0bdf7b79d43a9204ca584ffe1fb48a6f3c84c66"},
+    {file = "lxml-5.2.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:d14a0d029a4e176795cef99c056d58067c06195e0c7e2dbb293bf95c08f772a3"},
+    {file = "lxml-5.2.2-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:be49ad33819d7dcc28a309b86d4ed98e1a65f3075c6acd3cd4fe32103235222b"},
+    {file = "lxml-5.2.2-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:a6d17e0370d2516d5bb9062c7b4cb731cff921fc875644c3d751ad857ba9c5b1"},
+    {file = "lxml-5.2.2-cp38-cp38-win32.whl", hash = "sha256:5b8c041b6265e08eac8a724b74b655404070b636a8dd6d7a13c3adc07882ef30"},
+    {file = "lxml-5.2.2-cp38-cp38-win_amd64.whl", hash = "sha256:f61efaf4bed1cc0860e567d2ecb2363974d414f7f1f124b1df368bbf183453a6"},
+    {file = "lxml-5.2.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:fb91819461b1b56d06fa4bcf86617fac795f6a99d12239fb0c68dbeba41a0a30"},
+    {file = "lxml-5.2.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:d4ed0c7cbecde7194cd3228c044e86bf73e30a23505af852857c09c24e77ec5d"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:54401c77a63cc7d6dc4b4e173bb484f28a5607f3df71484709fe037c92d4f0ed"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:625e3ef310e7fa3a761d48ca7ea1f9d8718a32b1542e727d584d82f4453d5eeb"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:519895c99c815a1a24a926d5b60627ce5ea48e9f639a5cd328bda0515ea0f10c"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c7079d5eb1c1315a858bbf180000757db8ad904a89476653232db835c3114001"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:343ab62e9ca78094f2306aefed67dcfad61c4683f87eee48ff2fd74902447726"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:cd9e78285da6c9ba2d5c769628f43ef66d96ac3085e59b10ad4f3707980710d3"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_28_ppc64le.whl", hash = "sha256:546cf886f6242dff9ec206331209db9c8e1643ae642dea5fdbecae2453cb50fd"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_28_s390x.whl", hash = "sha256:02f6a8eb6512fdc2fd4ca10a49c341c4e109aa6e9448cc4859af5b949622715a"},
+    {file = "lxml-5.2.2-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:339ee4a4704bc724757cd5dd9dc8cf4d00980f5d3e6e06d5847c1b594ace68ab"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:0a028b61a2e357ace98b1615fc03f76eb517cc028993964fe08ad514b1e8892d"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:f90e552ecbad426eab352e7b2933091f2be77115bb16f09f78404861c8322981"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:d83e2d94b69bf31ead2fa45f0acdef0757fa0458a129734f59f67f3d2eb7ef32"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:a02d3c48f9bb1e10c7788d92c0c7db6f2002d024ab6e74d6f45ae33e3d0288a3"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:6d68ce8e7b2075390e8ac1e1d3a99e8b6372c694bbe612632606d1d546794207"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:453d037e09a5176d92ec0fd282e934ed26d806331a8b70ab431a81e2fbabf56d"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:3b019d4ee84b683342af793b56bb35034bd749e4cbdd3d33f7d1107790f8c472"},
+    {file = "lxml-5.2.2-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:cb3942960f0beb9f46e2a71a3aca220d1ca32feb5a398656be934320804c0df9"},
+    {file = "lxml-5.2.2-cp39-cp39-win32.whl", hash = "sha256:ac6540c9fff6e3813d29d0403ee7a81897f1d8ecc09a8ff84d2eea70ede1cdbf"},
+    {file = "lxml-5.2.2-cp39-cp39-win_amd64.whl", hash = "sha256:610b5c77428a50269f38a534057444c249976433f40f53e3b47e68349cca1425"},
+    {file = "lxml-5.2.2-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:b537bd04d7ccd7c6350cdaaaad911f6312cbd61e6e6045542f781c7f8b2e99d2"},
+    {file = "lxml-5.2.2-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4820c02195d6dfb7b8508ff276752f6b2ff8b64ae5d13ebe02e7667e035000b9"},
+    {file = "lxml-5.2.2-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f2a09f6184f17a80897172863a655467da2b11151ec98ba8d7af89f17bf63dae"},
+    {file = "lxml-5.2.2-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:76acba4c66c47d27c8365e7c10b3d8016a7da83d3191d053a58382311a8bf4e1"},
+    {file = "lxml-5.2.2-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:b128092c927eaf485928cec0c28f6b8bead277e28acf56800e972aa2c2abd7a2"},
+    {file = "lxml-5.2.2-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:ae791f6bd43305aade8c0e22f816b34f3b72b6c820477aab4d18473a37e8090b"},
+    {file = "lxml-5.2.2-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a2f6a1bc2460e643785a2cde17293bd7a8f990884b822f7bca47bee0a82fc66b"},
+    {file = "lxml-5.2.2-pp37-pypy37_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e8d351ff44c1638cb6e980623d517abd9f580d2e53bfcd18d8941c052a5a009"},
+    {file = "lxml-5.2.2-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bec4bd9133420c5c52d562469c754f27c5c9e36ee06abc169612c959bd7dbb07"},
+    {file = "lxml-5.2.2-pp37-pypy37_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:55ce6b6d803890bd3cc89975fca9de1dff39729b43b73cb15ddd933b8bc20484"},
+    {file = "lxml-5.2.2-pp37-pypy37_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:8ab6a358d1286498d80fe67bd3d69fcbc7d1359b45b41e74c4a26964ca99c3f8"},
+    {file = "lxml-5.2.2-pp37-pypy37_pp73-win_amd64.whl", hash = "sha256:06668e39e1f3c065349c51ac27ae430719d7806c026fec462e5693b08b95696b"},
+    {file = "lxml-5.2.2-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:9cd5323344d8ebb9fb5e96da5de5ad4ebab993bbf51674259dbe9d7a18049525"},
+    {file = "lxml-5.2.2-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:89feb82ca055af0fe797a2323ec9043b26bc371365847dbe83c7fd2e2f181c34"},
+    {file = "lxml-5.2.2-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e481bba1e11ba585fb06db666bfc23dbe181dbafc7b25776156120bf12e0d5a6"},
+    {file = "lxml-5.2.2-pp38-pypy38_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:9d6c6ea6a11ca0ff9cd0390b885984ed31157c168565702959c25e2191674a14"},
+    {file = "lxml-5.2.2-pp38-pypy38_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:3d98de734abee23e61f6b8c2e08a88453ada7d6486dc7cdc82922a03968928db"},
+    {file = "lxml-5.2.2-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:69ab77a1373f1e7563e0fb5a29a8440367dec051da6c7405333699d07444f511"},
+    {file = "lxml-5.2.2-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:34e17913c431f5ae01d8658dbf792fdc457073dcdfbb31dc0cc6ab256e664a8d"},
+    {file = "lxml-5.2.2-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:05f8757b03208c3f50097761be2dea0aba02e94f0dc7023ed73a7bb14ff11eb0"},
+    {file = "lxml-5.2.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6a520b4f9974b0a0a6ed73c2154de57cdfd0c8800f4f15ab2b73238ffed0b36e"},
+    {file = "lxml-5.2.2-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:5e097646944b66207023bc3c634827de858aebc226d5d4d6d16f0b77566ea182"},
+    {file = "lxml-5.2.2-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:b5e4ef22ff25bfd4ede5f8fb30f7b24446345f3e79d9b7455aef2836437bc38a"},
+    {file = "lxml-5.2.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:ff69a9a0b4b17d78170c73abe2ab12084bdf1691550c5629ad1fe7849433f324"},
+    {file = "lxml-5.2.2.tar.gz", hash = "sha256:bb2dc4898180bea79863d5487e5f9c7c34297414bad54bcd0f0852aee9cfdb87"},
 ]
 
 [package.extras]
@@ -981,75 +952,6 @@ files = [
 [package.extras]
 test = ["coverage[toml] (>=7.2.5)", "mypy (>=1.2.0)", "pytest (>=7.3.0)", "pytest-mypy-plugins (>=1.10.1)"]
 
-[[package]]
-name = "markupsafe"
-version = "2.1.5"
-description = "Safely add untrusted strings to HTML/XML markup."
-optional = false
-python-versions = ">=3.7"
-files = [
-    {file = "MarkupSafe-2.1.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:a17a92de5231666cfbe003f0e4b9b3a7ae3afb1ec2845aadc2bacc93ff85febc"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:72b6be590cc35924b02c78ef34b467da4ba07e4e0f0454a2c5907f473fc50ce5"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e61659ba32cf2cf1481e575d0462554625196a1f2fc06a1c777d3f48e8865d46"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2174c595a0d73a3080ca3257b40096db99799265e1c27cc5a610743acd86d62f"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ae2ad8ae6ebee9d2d94b17fb62763125f3f374c25618198f40cbb8b525411900"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:075202fa5b72c86ad32dc7d0b56024ebdbcf2048c0ba09f1cde31bfdd57bcfff"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:598e3276b64aff0e7b3451b72e94fa3c238d452e7ddcd893c3ab324717456bad"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:fce659a462a1be54d2ffcacea5e3ba2d74daa74f30f5f143fe0c58636e355fdd"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-win32.whl", hash = "sha256:d9fad5155d72433c921b782e58892377c44bd6252b5af2f67f16b194987338a4"},
-    {file = "MarkupSafe-2.1.5-cp310-cp310-win_amd64.whl", hash = "sha256:bf50cd79a75d181c9181df03572cdce0fbb75cc353bc350712073108cba98de5"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:629ddd2ca402ae6dbedfceeba9c46d5f7b2a61d9749597d4307f943ef198fc1f"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:5b7b716f97b52c5a14bffdf688f971b2d5ef4029127f1ad7a513973cfd818df2"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ec585f69cec0aa07d945b20805be741395e28ac1627333b1c5b0105962ffced"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b91c037585eba9095565a3556f611e3cbfaa42ca1e865f7b8015fe5c7336d5a5"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7502934a33b54030eaf1194c21c692a534196063db72176b0c4028e140f8f32c"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:0e397ac966fdf721b2c528cf028494e86172b4feba51d65f81ffd65c63798f3f"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:c061bb86a71b42465156a3ee7bd58c8c2ceacdbeb95d05a99893e08b8467359a"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:3a57fdd7ce31c7ff06cdfbf31dafa96cc533c21e443d57f5b1ecc6cdc668ec7f"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-win32.whl", hash = "sha256:397081c1a0bfb5124355710fe79478cdbeb39626492b15d399526ae53422b906"},
-    {file = "MarkupSafe-2.1.5-cp311-cp311-win_amd64.whl", hash = "sha256:2b7c57a4dfc4f16f7142221afe5ba4e093e09e728ca65c51f5620c9aaeb9a617"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:8dec4936e9c3100156f8a2dc89c4b88d5c435175ff03413b443469c7c8c5f4d1"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:3c6b973f22eb18a789b1460b4b91bf04ae3f0c4234a0a6aa6b0a92f6f7b951d4"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ac07bad82163452a6884fe8fa0963fb98c2346ba78d779ec06bd7a6262132aee"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f5dfb42c4604dddc8e4305050aa6deb084540643ed5804d7455b5df8fe16f5e5"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ea3d8a3d18833cf4304cd2fc9cbb1efe188ca9b5efef2bdac7adc20594a0e46b"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d050b3361367a06d752db6ead6e7edeb0009be66bc3bae0ee9d97fb326badc2a"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:bec0a414d016ac1a18862a519e54b2fd0fc8bbfd6890376898a6c0891dd82e9f"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:58c98fee265677f63a4385256a6d7683ab1832f3ddd1e66fe948d5880c21a169"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-win32.whl", hash = "sha256:8590b4ae07a35970728874632fed7bd57b26b0102df2d2b233b6d9d82f6c62ad"},
-    {file = "MarkupSafe-2.1.5-cp312-cp312-win_amd64.whl", hash = "sha256:823b65d8706e32ad2df51ed89496147a42a2a6e01c13cfb6ffb8b1e92bc910bb"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:c8b29db45f8fe46ad280a7294f5c3ec36dbac9491f2d1c17345be8e69cc5928f"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ec6a563cff360b50eed26f13adc43e61bc0c04d94b8be985e6fb24b81f6dcfdf"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a549b9c31bec33820e885335b451286e2969a2d9e24879f83fe904a5ce59d70a"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4f11aa001c540f62c6166c7726f71f7573b52c68c31f014c25cc7901deea0b52"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:7b2e5a267c855eea6b4283940daa6e88a285f5f2a67f2220203786dfa59b37e9"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:2d2d793e36e230fd32babe143b04cec8a8b3eb8a3122d2aceb4a371e6b09b8df"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:ce409136744f6521e39fd8e2a24c53fa18ad67aa5bc7c2cf83645cce5b5c4e50"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-win32.whl", hash = "sha256:4096e9de5c6fdf43fb4f04c26fb114f61ef0bf2e5604b6ee3019d51b69e8c371"},
-    {file = "MarkupSafe-2.1.5-cp37-cp37m-win_amd64.whl", hash = "sha256:4275d846e41ecefa46e2015117a9f491e57a71ddd59bbead77e904dc02b1bed2"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:656f7526c69fac7f600bd1f400991cc282b417d17539a1b228617081106feb4a"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:97cafb1f3cbcd3fd2b6fbfb99ae11cdb14deea0736fc2b0952ee177f2b813a46"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1f3fbcb7ef1f16e48246f704ab79d79da8a46891e2da03f8783a5b6fa41a9532"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fa9db3f79de01457b03d4f01b34cf91bc0048eb2c3846ff26f66687c2f6d16ab"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ffee1f21e5ef0d712f9033568f8344d5da8cc2869dbd08d87c84656e6a2d2f68"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:5dedb4db619ba5a2787a94d877bc8ffc0566f92a01c0ef214865e54ecc9ee5e0"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:30b600cf0a7ac9234b2638fbc0fb6158ba5bdcdf46aeb631ead21248b9affbc4"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:8dd717634f5a044f860435c1d8c16a270ddf0ef8588d4887037c5028b859b0c3"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-win32.whl", hash = "sha256:daa4ee5a243f0f20d528d939d06670a298dd39b1ad5f8a72a4275124a7819eff"},
-    {file = "MarkupSafe-2.1.5-cp38-cp38-win_amd64.whl", hash = "sha256:619bc166c4f2de5caa5a633b8b7326fbe98e0ccbfacabd87268a2b15ff73a029"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7a68b554d356a91cce1236aa7682dc01df0edba8d043fd1ce607c49dd3c1edcf"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:db0b55e0f3cc0be60c1f19efdde9a637c32740486004f20d1cff53c3c0ece4d2"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3e53af139f8579a6d5f7b76549125f0d94d7e630761a2111bc431fd820e163b8"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:17b950fccb810b3293638215058e432159d2b71005c74371d784862b7e4683f3"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4c31f53cdae6ecfa91a77820e8b151dba54ab528ba65dfd235c80b086d68a465"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:bff1b4290a66b490a2f4719358c0cdcd9bafb6b8f061e45c7a2460866bf50c2e"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:bc1667f8b83f48511b94671e0e441401371dfd0f0a795c7daa4a3cd1dde55bea"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5049256f536511ee3f7e1b3f87d1d1209d327e818e6ae1365e8653d7e3abb6a6"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-win32.whl", hash = "sha256:00e046b6dd71aa03a41079792f8473dc494d564611a8f89bbbd7cb93295ebdcf"},
-    {file = "MarkupSafe-2.1.5-cp39-cp39-win_amd64.whl", hash = "sha256:fa173ec60341d6bb97a89f5ea19c85c5643c1e7dedebc22f5181eb73573142c5"},
-    {file = "MarkupSafe-2.1.5.tar.gz", hash = "sha256:d283d37a890ba4c1ae73ffadf8046435c76e7bc2247bbb63c00bd1a709c6544b"},
-]
-
 [[package]]
 name = "more-itertools"
 version = "10.2.0"
@@ -1138,25 +1040,6 @@ files = [
     {file = "packaging-24.0.tar.gz", hash = "sha256:eb82c5e3e56209074766e6885bb04b8c38a0c015d0a30036ebe7ece34c9989e9"},
 ]
 
-[[package]]
-name = "pdoc"
-version = "14.4.0"
-description = "API Documentation for Python Projects"
-optional = false
-python-versions = ">=3.8"
-files = [
-    {file = "pdoc-14.4.0-py3-none-any.whl", hash = "sha256:6ea4fe07620b1f7601e2708a307a257636ec206e20b5611640b30f2e3cab47d6"},
-    {file = "pdoc-14.4.0.tar.gz", hash = "sha256:c92edc425429ccbe287ace2a027953c24f13de53eab484c1a6d31ca72dd2fda9"},
-]
-
-[package.dependencies]
-Jinja2 = ">=2.11.0"
-MarkupSafe = "*"
-pygments = ">=2.12.0"
-
-[package.extras]
-dev = ["hypothesis", "mypy", "pdoc-pyo3-sample-library (==1.0.11)", "pygments (>=2.14.0)", "pytest", "pytest-cov", "pytest-timeout", "ruff", "tox", "types-pygments"]
-
 [[package]]
 name = "pexpect"
 version = "4.9.0"
@@ -1273,13 +1156,13 @@ testing = ["pytest", "pytest-cov", "wheel"]
 
 [[package]]
 name = "platformdirs"
-version = "4.2.1"
+version = "4.2.2"
 description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`."
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "platformdirs-4.2.1-py3-none-any.whl", hash = "sha256:17d5a1161b3fd67b390023cb2d3b026bbd40abde6fdb052dfbd3a29c3ba22ee1"},
-    {file = "platformdirs-4.2.1.tar.gz", hash = "sha256:031cd18d4ec63ec53e82dceaac0417d218a6863f7745dfcc9efe7793b7039bdf"},
+    {file = "platformdirs-4.2.2-py3-none-any.whl", hash = "sha256:2d7a1657e36a80ea911db832a8a6ece5ee53d8de21edd5cc5879af6530b1bfee"},
+    {file = "platformdirs-4.2.2.tar.gz", hash = "sha256:38b7b51f512eed9e84a22788b4bce1de17c0adb134d6becb09836e37d8654cd3"},
 ]
 
 [package.extras]
@@ -1304,13 +1187,13 @@ testing = ["pytest", "pytest-benchmark"]
 
 [[package]]
 name = "poetry"
-version = "1.8.2"
+version = "1.8.3"
 description = "Python dependency management and packaging made easy."
 optional = false
-python-versions = ">=3.8,<4.0"
+python-versions = "<4.0,>=3.8"
 files = [
-    {file = "poetry-1.8.2-py3-none-any.whl", hash = "sha256:b42b400d9a803af6e788a30a6f3e9998020b77860e28df20647eb10b6f414910"},
-    {file = "poetry-1.8.2.tar.gz", hash = "sha256:49cceb3838104647c3e1021f3a4f13c6053704cc18d33f849a90fe687a29cb73"},
+    {file = "poetry-1.8.3-py3-none-any.whl", hash = "sha256:88191c69b08d06f9db671b793d68f40048e8904c0718404b63dcc2b5aec62d13"},
+    {file = "poetry-1.8.3.tar.gz", hash = "sha256:67f4eb68288eab41e841cc71a00d26cf6bdda9533022d0189a145a34d0a35f48"},
 ]
 
 [package.dependencies]
@@ -1325,7 +1208,7 @@ installer = ">=0.7.0,<0.8.0"
 keyring = ">=24.0.0,<25.0.0"
 packaging = ">=23.1"
 pexpect = ">=4.7.0,<5.0.0"
-pkginfo = ">=1.9.4,<2.0.0"
+pkginfo = ">=1.10,<2.0"
 platformdirs = ">=3.0.0,<5"
 poetry-core = "1.9.0"
 poetry-plugin-export = ">=1.6.0,<2.0.0"
@@ -1352,18 +1235,18 @@ files = [
 
 [[package]]
 name = "poetry-plugin-export"
-version = "1.7.1"
+version = "1.8.0"
 description = "Poetry plugin to export the dependencies to various formats"
 optional = false
-python-versions = ">=3.8,<4.0"
+python-versions = "<4.0,>=3.8"
 files = [
-    {file = "poetry_plugin_export-1.7.1-py3-none-any.whl", hash = "sha256:b2258e53ae0d369a73806f957ed0e726eb95c571a0ce8b1f273da686528cc1da"},
-    {file = "poetry_plugin_export-1.7.1.tar.gz", hash = "sha256:cf62cfb6218a904290ba6db3bc1a24aa076d10f81c48c6e48b2ded430131e22e"},
+    {file = "poetry_plugin_export-1.8.0-py3-none-any.whl", hash = "sha256:adbe232cfa0cc04991ea3680c865cf748bff27593b9abcb1f35fb50ed7ba2c22"},
+    {file = "poetry_plugin_export-1.8.0.tar.gz", hash = "sha256:1fa6168a85d59395d835ca564bc19862a7c76061e60c3e7dfaec70d50937fc61"},
 ]
 
 [package.dependencies]
-poetry = ">=1.8.0,<2.0.0"
-poetry-core = ">=1.7.0,<2.0.0"
+poetry = ">=1.8.0,<3.0.0"
+poetry-core = ">=1.7.0,<3.0.0"
 
 [[package]]
 name = "ptyprocess"
@@ -1387,21 +1270,6 @@ files = [
     {file = "pycparser-2.22.tar.gz", hash = "sha256:491c8be9c040f5390f5bf44a5b07752bd07f56edf992381b05c701439eec10f6"},
 ]
 
-[[package]]
-name = "pygments"
-version = "2.17.2"
-description = "Pygments is a syntax highlighting package written in Python."
-optional = false
-python-versions = ">=3.7"
-files = [
-    {file = "pygments-2.17.2-py3-none-any.whl", hash = "sha256:b27c2826c47d0f3219f29554824c30c5e8945175d888647acd804ddd04af846c"},
-    {file = "pygments-2.17.2.tar.gz", hash = "sha256:da46cec9fd2de5be3a8a784f434e4c4ab670b4ff54d605c4c2717e9d49c4c367"},
-]
-
-[package.extras]
-plugins = ["importlib-metadata"]
-windows-terminal = ["colorama (>=0.4.6)"]
-
 [[package]]
 name = "pyproject-api"
 version = "1.6.1"
@@ -1434,13 +1302,13 @@ files = [
 
 [[package]]
 name = "pytest"
-version = "8.2.0"
+version = "8.2.1"
 description = "pytest: simple powerful testing with Python"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "pytest-8.2.0-py3-none-any.whl", hash = "sha256:1733f0620f6cda4095bbf0d9ff8022486e91892245bb9e7d5542c018f612f233"},
-    {file = "pytest-8.2.0.tar.gz", hash = "sha256:d507d4482197eac0ba2bae2e9babf0672eb333017bcedaa5fb1a3d42c1174b3f"},
+    {file = "pytest-8.2.1-py3-none-any.whl", hash = "sha256:faccc5d332b8c3719f40283d0d44aa5cf101cec36f88cde9ed8f2bc0538612b1"},
+    {file = "pytest-8.2.1.tar.gz", hash = "sha256:5046e5b46d8e4cac199c373041f26be56fdb81eb4e67dc11d4e10811fc3408fd"},
 ]
 
 [package.dependencies]
@@ -1467,101 +1335,104 @@ files = [
 
 [[package]]
 name = "rapidfuzz"
-version = "3.9.0"
+version = "3.9.1"
 description = "rapid fuzzy string matching"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "rapidfuzz-3.9.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:bd375c4830fee11d502dd93ecadef63c137ae88e1aaa29cc15031fa66d1e0abb"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:55e2c5076f38fc1dbaacb95fa026a3e409eee6ea5ac4016d44fb30e4cad42b20"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:488f74126904db6b1bea545c2f3567ea882099f4c13f46012fe8f4b990c683df"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e3f2d1ea7cd57dfcd34821e38b4924c80a31bcf8067201b1ab07386996a9faee"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b11e602987bcb4ea22b44178851f27406fca59b0836298d0beb009b504dba266"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3083512e9bf6ed2bb3d25883922974f55e21ae7f8e9f4e298634691ae1aee583"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b33c6d4b3a1190bc0b6c158c3981535f9434e8ed9ffa40cf5586d66c1819fb4b"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0dcb95fde22f98e6d0480db8d6038c45fe2d18a338690e6f9bba9b82323f3469"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:08d8b49b3a4fb8572e480e73fcddc750da9cbb8696752ee12cca4bf8c8220d52"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:e721842e6b601ebbeb8cc5e12c75bbdd1d9e9561ea932f2f844c418c31256e82"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:7988363b3a415c5194ce1a68d380629247f8713e669ad81db7548eb156c4f365"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:2d267d4c982ab7d177e994ab1f31b98ff3814f6791b90d35dda38307b9e7c989"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:0bb28ab5300cf974c7eb68ea21125c493e74b35b1129e629533468b2064ae0a2"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-win32.whl", hash = "sha256:1b1f74997b6d94d66375479fa55f70b1c18e4d865d7afcd13f0785bfd40a9d3c"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-win_amd64.whl", hash = "sha256:c56d2efdfaa1c642029f3a7a5bb76085c5531f7a530777be98232d2ce142553c"},
-    {file = "rapidfuzz-3.9.0-cp310-cp310-win_arm64.whl", hash = "sha256:6a83128d505cac76ea560bb9afcb3f6986e14e50a6f467db9a31faef4bd9b347"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:e2218d62ab63f3c5ad48eced898854d0c2c327a48f0fb02e2288d7e5332a22c8"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:36bf35df2d6c7d5820da20a6720aee34f67c15cd2daf8cf92e8141995c640c25"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:905b01a9b633394ff6bb5ebb1c5fd660e0e180c03fcf9d90199cc6ed74b87cf7"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:33cfabcb7fd994938a6a08e641613ce5fe46757832edc789c6a5602e7933d6fa"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1179dcd3d150a67b8a678cd9c84f3baff7413ff13c9e8fe85e52a16c97e24c9b"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:47d97e28c42f1efb7781993b67c749223f198f6653ef177a0c8f2b1c516efcaf"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:28da953eb2ef9ad527e536022da7afff6ace7126cdd6f3e21ac20f8762e76d2c"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:182b4e11de928fb4834e8f8b5ecd971b5b10a86fabe8636ab65d3a9b7e0e9ca7"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:c74f2da334ce597f31670db574766ddeaee5d9430c2c00e28d0fbb7f76172036"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:014ac55b03f4074f903248ded181f3000f4cdbd134e6155cbf643f0eceb4f70f"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:c4ef34b2ddbf448f1d644b4ec6475df8bbe5b9d0fee173ff2e87322a151663bd"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:fc02157f521af15143fae88f92ef3ddcc4e0cff05c40153a9549dc0fbdb9adb3"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:ff08081c49b18ba253a99e6a47f492e6ee8019e19bbb6ddc3ed360cd3ecb2f62"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-win32.whl", hash = "sha256:b9bf90b3d96925cbf8ef44e5ee3cf39ef0c422f12d40f7a497e91febec546650"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-win_amd64.whl", hash = "sha256:d5d5684f54d82d9b0cf0b2701e55a630527a9c3dd5ddcf7a2e726a475ac238f2"},
-    {file = "rapidfuzz-3.9.0-cp311-cp311-win_arm64.whl", hash = "sha256:a2de844e0e971d7bd8aa41284627dbeacc90e750b90acfb016836553c7a63192"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:f81fe99a69ac8ee3fd905e70c62f3af033901aeb60b69317d1d43d547b46e510"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:633b9d03fc04abc585c197104b1d0af04b1f1db1abc99f674d871224cd15557a"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ab872cb57ae97c54ba7c71a9e3c9552beb57cb907c789b726895576d1ea9af6f"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bdd8c15c3a14e409507fdf0c0434ec481d85c6cbeec8bdcd342a8cd1eda03825"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2444d8155d9846f206e2079bb355b85f365d9457480b0d71677a112d0a7f7128"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f83bd3d01f04061c3660742dc85143a89d49fd23eb31eccbf60ad56c4b955617"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:0ca799f882364e69d0872619afb19efa3652b7133c18352e4a3d86a324fb2bb1"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6993d361f28b9ef5f0fa4e79b8541c2f3507be7471b9f9cb403a255e123b31e1"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:170822a1b1719f02b58e3dce194c8ad7d4c5b39be38c0fdec603bd19c6f9cf81"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:0e86e39c1c1a0816ceda836e6f7bd3743b930cbc51a43a81bb433b552f203f25"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:731269812ea837e0b93d913648e404736407408e33a00b75741e8f27c590caa2"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:8e5ff882d3a3d081157ceba7e0ebc7fac775f95b08cbb143accd4cece6043819"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:2003071aa633477a01509890c895f9ef56cf3f2eaa72c7ec0b567f743c1abcba"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-win32.whl", hash = "sha256:13857f9070600ea1f940749f123b02d0b027afbaa45e72186df0f278915761d0"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-win_amd64.whl", hash = "sha256:134b7098ac109834eeea81424b6822f33c4c52bf80b81508295611e7a21be12a"},
-    {file = "rapidfuzz-3.9.0-cp312-cp312-win_arm64.whl", hash = "sha256:2a96209f046fe328be30fc43f06e3d4b91f0d5b74e9dcd627dbfd65890fa4a5e"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:544b0bf9d17170720809918e9ccd0d482d4a3a6eca35630d8e1459f737f71755"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:1d536f8beb8dd82d6efb20fe9f82c2cfab9ffa0384b5d184327e393a4edde91d"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:30f7609da871510583f87484a10820b26555a473a90ab356cdda2f3b4456256c"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f4a2468432a1db491af6f547fad8f6d55fa03e57265c2f20e5eaceb68c7907e"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:11a7ec4676242c8a430509cff42ce98bca2fbe30188a63d0f60fdcbfd7e84970"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dcb523243e988c849cf81220164ec3bbed378a699e595a8914fffe80596dc49f"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4eea3bf72c4fe68e957526ffd6bcbb403a21baa6b3344aaae2d3252313df6199"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4514980a5d204c076dd5b756960f6b1b7598f030009456e6109d76c4c331d03c"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:9a06a99f1335fe43464d7121bc6540de7cd9c9475ac2025babb373fe7f27846b"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:6c1ed63345d1581c39d4446b1a8c8f550709656ce2a3c88c47850b258167f3c2"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:cd2e6e97daf17ebb3254285cf8dd86c60d56d6cf35c67f0f9a557ef26bd66290"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:9bc0f7e6256a9c668482c41c8a3de5d0aa12e8ca346dcc427b97c7edb82cba48"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:7c09f4e87e82a164c9db769474bc61f8c8b677f2aeb0234b8abac73d2ecf9799"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-win32.whl", hash = "sha256:e65b8f7921bf60cbb207c132842a6b45eefef48c4c3b510eb16087d6c08c70af"},
-    {file = "rapidfuzz-3.9.0-cp38-cp38-win_amd64.whl", hash = "sha256:9d6478957fb35c7844ad08f2442b62ba76c1857a56370781a707eefa4f4981e1"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:65d9250a4b0bf86320097306084bc3ca479c8f5491927c170d018787793ebe95"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:47b7c0840afa724db3b1a070bc6ed5beab73b4e659b1d395023617fc51bf68a2"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3a16c48c6df8fb633efbbdea744361025d01d79bca988f884a620e63e782fe5b"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:48105991ff6e4a51c7f754df500baa070270ed3d41784ee0d097549bc9fcb16d"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6a7f273906b3c7cc6d63a76e088200805947aa0bc1ada42c6a0e582e19c390d7"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5c396562d304e974b4b0d5cd3afc4f92c113ea46a36e6bc62e45333d6aa8837e"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:68da1b70458fea5290ec9a169fcffe0c17ff7e5bb3c3257e63d7021a50601a8e"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c5b8f9a7b177af6ce7c6ad5b95588b4b73e37917711aafa33b2e79ee80fe709"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:3c42a238bf9dd48f4ccec4c6934ac718225b00bb3a438a008c219e7ccb3894c7"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:a365886c42177b2beab475a50ba311b59b04f233ceaebc4c341f6f91a86a78e2"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:ce897b5dafb7fb7587a95fe4d449c1ea0b6d9ac4462fbafefdbbeef6eee4cf6a"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:413ac49bae291d7e226a5c9be65c71b2630b3346bce39268d02cb3290232e4b7"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:ff8982fc3bd49d55a91569fc8a3feba0de4cef0b391ff9091be546e9df075b81"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-win32.whl", hash = "sha256:3904d0084ab51f82e9f353031554965524f535522a48ec75c30b223eb5a0a488"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-win_amd64.whl", hash = "sha256:3733aede16ea112728ffeafeb29ccc62e095ed8ec816822fa2a82e92e2c08696"},
-    {file = "rapidfuzz-3.9.0-cp39-cp39-win_arm64.whl", hash = "sha256:fc4e26f592b51f97acf0a3f8dfed95e4d830c6a8fbf359361035df836381ab81"},
-    {file = "rapidfuzz-3.9.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:e33362e98c7899b5f60dcb06ada00acd8673ce0d59aefe9a542701251fd00423"},
-    {file = "rapidfuzz-3.9.0-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fb67cf43ad83cb886cbbbff4df7dcaad7aedf94d64fca31aea0da7d26684283c"},
-    {file = "rapidfuzz-3.9.0-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0e2e106cc66453bb80d2ad9c0044f8287415676df5c8036d737d05d4b9cdbf8e"},
-    {file = "rapidfuzz-3.9.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b1256915f7e7a5cf2c151c9ac44834b37f9bd1c97e8dec6f936884f01b9dfc7d"},
-    {file = "rapidfuzz-3.9.0-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:ae643220584518cbff8bf2974a0494d3e250763af816b73326a512c86ae782ce"},
-    {file = "rapidfuzz-3.9.0-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:491274080742110427f38a6085bb12dffcaff1eef12dccf9e8758398c7e3957e"},
-    {file = "rapidfuzz-3.9.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2bc5559b9b94326922c096b30ae2d8e5b40b2e9c2c100c2cc396ad91bcb84d30"},
-    {file = "rapidfuzz-3.9.0-pp39-pypy39_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:849160dc0f128acb343af514ca827278005c1d00148d025e4035e034fc2d8c7f"},
-    {file = "rapidfuzz-3.9.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:623883fb78e692d54ed7c43b09beec52c6685f10a45a7518128e25746667403b"},
-    {file = "rapidfuzz-3.9.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:d20ab9abc7e19767f1951772a6ab14cb4eddd886493c2da5ee12014596ad253f"},
-    {file = "rapidfuzz-3.9.0.tar.gz", hash = "sha256:b182f0fb61f6ac435e416eb7ab330d62efdbf9b63cf0c7fa12d1f57c2eaaf6f3"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:5f897a9bff517d5c6af6a90131796b4298b547b9a9a4df3cf285006be33aae5b"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:83c570ce23b447625929c0e7c4f2eab6d90f5a576db2b26a5aa0594a53d560ea"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e4c6b6455ee8404a663e15477a8bfe98b1afb329ff224bcf6d15f623a3761b95"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:aa44aef769e5834fef4fde091fd646cc1c52a2813b3aa241ae54b3028960abaa"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:25ea055ae40fb60f503f02b44b3ac35a39a9108be33f89e05b81bc4e3c849ec8"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fb592bad9d58b47c6681f0c180767d2c98775a35f7267131d33723139c3d6c2e"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eb023adfefa62410fff877f7cc70cd4758cbfbad963e87d146cf71b022dce197"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:c883d2d2e31c759af1f3fdeb67ec151cf94e307f745b3d02ab3a2ef6595485f2"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:8e11405d81e8baea4999a5757a982009566cff8f6a121d5ccf042aab81ae0230"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:02ed579f35ddd3552c7f74bc0c10800b432d9b09a4cebb19fd7a10b3b4759cc0"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:9f8615a2a67a1f80b3aa7a3d7fbe6a2ed062a54c98988e3f9b664b49a3bc115e"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:64058f4a3698c6c8464df47a3b7da303db2477b2447142da3e67fc091f4c366a"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-win32.whl", hash = "sha256:2ef42c43c94139c890aeec40bc442c4bf8d48e15b456a88ce0f4cc5cfcad1896"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-win_amd64.whl", hash = "sha256:c99d001c45c31c2cd2f7361bc2036d3062b21db5f43beea8bc5109d43fe9f283"},
+    {file = "rapidfuzz-3.9.1-cp310-cp310-win_arm64.whl", hash = "sha256:da3f495cf4f7a443b34a6d3c6805265595fcd13641b3253a8e2034289d828dd9"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8869dcf072227a40a6f9e87b3fc4eb020055a08ad12b63d751c354e3a973ccb"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:9f66f9d5f14141b4b017e76118ec4bda29266f6b281989026e3a9ba1a2aaf032"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:07decc6b058f935d2219423a50aac426027928cc734809f793bc250de4a3756e"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c125095d1828fa10ac79077594dd2d8829167d9e184e20baa97620fc52ebdcc9"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76a55bcc3abc9f8e38a1218cb5a09719126cfc4cba23ebd8caa27dfdc69cedd8"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:50c2f7ad132dfeb6247c90b41431662af939a820f761cf930708d55912377ed8"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:177bddf50577db59bcb00b6f7a5c2b70f2ec5a2aba40c8add7a6f7fd8609224e"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:dec2792f864be731c8339cad99001caa6540aa909e6fd8bc688bb0419c501f44"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:c6437cba4b9460d5ee0bafd796e13ef9307091b81685bbe745b0f1619fb887ca"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:874317057a58a9c6ddf59fe1491e478217daa9fdb043a00358a15de4f62f9a2d"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:5d8eb7fe39e81dc1530a3ec81a35e69770839c76607c461eb9d0902427fab3e1"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:08f85d6674d804a493c3e9ec10a807f9bd8f482781487eda064913b537f99d7f"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-win32.whl", hash = "sha256:eadf8c4b24b63aef8810ed585c24ac1fc022ee771211772a6e9f78c63aa949ff"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-win_amd64.whl", hash = "sha256:0e931539edeb9158ef83537cd571051f8a9608737642c20b088a37bd5d76c5c9"},
+    {file = "rapidfuzz-3.9.1-cp311-cp311-win_arm64.whl", hash = "sha256:bcc0ffcaeb1e499e708f32ec30177ed690b3f25455c91ad8c2240986c69f9ebe"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:8781e45c56f7f3a64940f4d594a4ffd69360147925a706569b2b0c57347b2225"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0edc950c6a04c19db10670cd04e33403b3eb0f175deb620f9668595d378b1005"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0ceb0d7bdec910d93793d32633ba0cb644356cf6778f9d91b727da0075beaec1"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4a231e8f3bae82f10e7188965b37c91d8bfb80136595c860c8a08eb0dd07764d"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9bfa8c0a8ce09b4bcd36322f8f375750dca160fbdbeb2e763a695cef3ae9133e"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1e872627d5359c840f3e431b0beb263518048917c3e076f624870552d84e7dc6"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7f006c3af82c478df09a790fb4846b5acd00a187d75715674d71f5dc0ac982ce"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:32718fa69306df969bf4fca1719f8900b83df315a2a8153942d5b8906f4fd1d6"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:a89b219c1a7933a0673b2dbb1ffe701057d82e5cb843552be4f55b61b557031e"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:b26cc9459e096959fab3a4a8a17b96a6c7c961f9db5c37c1c3c7a06789316cf7"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:2f9044a4470343087cde10beaa36266519d5da110a9a4597b43e6aa35fa928d3"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a3a48fc6dc274b803a366a4baec99e212792ae1b1e73d42235b2042cd3ade7c1"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-win32.whl", hash = "sha256:b71e7f99ed048a338e4a1ac34f56b3b3933a3ba2dfbb04450c786a8ddd97f4db"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-win_amd64.whl", hash = "sha256:e58489934d0147f1edda693cb983bea40f2b45ae6756fd47c1005b538f817a2f"},
+    {file = "rapidfuzz-3.9.1-cp312-cp312-win_arm64.whl", hash = "sha256:829fbad93266fffa0f9d722a94cbb1b95b53e3c04be4e872193496a0cfbd66f0"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:bca2b93c75f87cd85832cdd5bb06b4b5642e2a05c8e3550841ddf5d564ce4abb"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:d3397630f22e6c60dda8be3e9dbcf6a341695d487df8a6c92f4a2f7ebcdaecf7"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:df7bba8d4a8fb8e7559a9e83dfc5385dc6fe89efd73e32d253667242faf1883c"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:8e70605350cb6ec5091e06de62d3dcb058f694b059b4e1a9d85bfbf892f70030"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:678fcaa5117ddb6263160a7c5f33cc9ea3df335465f5d53715707fad103e1d09"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:08dcd347d408912b6da778a73a0d7a2adad7fe238a44263e5e3789f2a8d84669"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7149afaf0294882b6b15bb6fa9fc38ff1d761e50117460ee3561181c1c4e2230"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:0c568b89a5016e76f0b3f85e9379036da99c5e7ec26b33935453d353a1938b74"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:a079164675d24eb715230bf9dd252683ae3c9c0c0a236f0b8098630268b899e9"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:f6f4e8235d0acf1972f5eb4091c4a0473e5670a754f166c0c718ce21e945f879"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:ea62c82eb2c65bd49651e95f4f46874483ae4da1c3b57997e58f1b4fb2de6c05"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:3ab6ad7e70469aed24e24378b19a9e47fc757c847399b22c612a0fccacc795cb"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-win32.whl", hash = "sha256:bf5184b17e26a82b00c7ee05d9ec5d826113df55830bbc447bf6d6e7469c70fb"},
+    {file = "rapidfuzz-3.9.1-cp38-cp38-win_amd64.whl", hash = "sha256:493354f50b9855271ac846b213e394e08446e70cef5cc033e5302a2220f3ae7b"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:c8b0e6640421e55d69e186ce7fb9e6c723cfd3b6f91beaeb28705c2a46c8a194"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:bc68fb8f2a8b5b3a4526b7a65e7d5c7f821882f56d9dcbcce4c6859a9e5bdcd7"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77767b119ac05662d216a8cc4092ac28dbc015d9caabebdbefe371b0dd82a38e"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5dbcc4add07bd60ea73b94392fed28f83dba0fe796097da47627fd539bd6daca"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c0899de4fc1a7a36f14be556a0dacf40ea5c0fe22c6b45b2ea2674e1ac47e269"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e9f075366cee63a6b06bd7f9285eb9f1785382a6493afcb7054202e20508bf94"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:349e9c15092d20a1f6ff1795e068f39a9ee5e84c54b3addbc66d0ac469c4ef43"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:a645f362dafc103dbe7f43a2ad34f76284773cd7d1b00514d1c591848a1c817f"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:03a0a4bc8d4bd3e6f882b4c2ac183825a9b6dabe7e5a97bb6a1075e4635c944d"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:fbce66cb2e331b0888c79b594eab76e2c609c2637050085daadff5325d471dc2"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:e5d7b3154f6df9e05c2016de5e95f8cba4fe636a4e5520ebcd89bc6c54b8e4ed"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:aaba665f92c011c6f284e933ab02b5dc129a6d3f48fce913ec4a214bd530135e"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-win32.whl", hash = "sha256:61b343c581f4926260248069d8fdbbbf293c19c12ef440ad5ced15bcff277a84"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-win_amd64.whl", hash = "sha256:ce3335324198e1388a1c4e50d40f45107367010afe9fa09fd46278160f0ab591"},
+    {file = "rapidfuzz-3.9.1-cp39-cp39-win_arm64.whl", hash = "sha256:998977df2ae01ff8b7bc3b29a860b4a863005e0533e323df3fd555a31ef33f0e"},
+    {file = "rapidfuzz-3.9.1-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:dc4b5de5d6f9347d836d849b56bca630169353cbe5c10fa7fe93bb1677b49770"},
+    {file = "rapidfuzz-3.9.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:9f74d93148081049ccc86f276d54cd7c8c0692250245660b4fcd904ed1db1e01"},
+    {file = "rapidfuzz-3.9.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9f9dfdcd75e16e5874efee233b28aec1322623b0f1f20641452d06ea2d8ba5ef"},
+    {file = "rapidfuzz-3.9.1-pp310-pypy310_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:97ab8f153984a5d827ebb5a5b80ee59563efcf2fa3e569dcd46ea7e7c9845e93"},
+    {file = "rapidfuzz-3.9.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b8a6d5a8edc452920efdf1b499a2a47bb8a28440f7ab3fe28bb7d6636ccf71c3"},
+    {file = "rapidfuzz-3.9.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:06879b598e798a4d33a283c2b4fa0d555d7706b6531e3321b161d62e986f7f57"},
+    {file = "rapidfuzz-3.9.1-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:0f906ab6220778404498e0ce255c4cc89f98ea5e656e54cc59c5813c877eb86b"},
+    {file = "rapidfuzz-3.9.1-pp38-pypy38_pp73-macosx_11_0_arm64.whl", hash = "sha256:d3da444890c9559fd15717d97f8373b1cd14007f68c9b037aa93ef7ca969b559"},
+    {file = "rapidfuzz-3.9.1-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bc4503841cd3cbe22b5ac44f15bc834ec97d811a3c3943f73f5643266c8674e1"},
+    {file = "rapidfuzz-3.9.1-pp38-pypy38_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5713c56b30ed75ada3a8f008cf8e8e6323386ce48fac2bf2d07285fe6c91f5a4"},
+    {file = "rapidfuzz-3.9.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eb3f1af099cd1d98001691fbdadd422f088f21eadcacf5698b393b7569e24dc4"},
+    {file = "rapidfuzz-3.9.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:53477e1e6d85d603c9a319cfd00ab9f0a57b6d68bcdb268d6b15a79e64d693d0"},
+    {file = "rapidfuzz-3.9.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a47550eabf235e5d50e7d448c18f77f6e8082aa3571e9df511c8388525ea9372"},
+    {file = "rapidfuzz-3.9.1-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:c6b11a38b61cc2462a113b123f5e932cda0e525f816d6fe4b68516f97d7f9d49"},
+    {file = "rapidfuzz-3.9.1-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:414644a2fc8a3e5fafda95b430214ed892faa4d0a07401d33892bc9ca5c84974"},
+    {file = "rapidfuzz-3.9.1-pp39-pypy39_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1539e7439b68013c5d2ab7ed9d3d221480a15595207764145ae177077d28016d"},
+    {file = "rapidfuzz-3.9.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e18f0e9351f7e5d5387774ff4d5cabd824341e16b866eb1c8d3f557111b447ef"},
+    {file = "rapidfuzz-3.9.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:d2ff268a8bf57a76512804d5ca2097afaf98e64e8947d514cde7e2e8446aa5f7"},
+    {file = "rapidfuzz-3.9.1.tar.gz", hash = "sha256:a42eb645241f39a59c45a7fc15e3faf61886bff3a4a22263fd0f7cfb90e91b7f"},
 ]
 
 [package.extras]
@@ -1569,13 +1440,13 @@ full = ["numpy"]
 
 [[package]]
 name = "requests"
-version = "2.31.0"
+version = "2.32.2"
 description = "Python HTTP for Humans."
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.8"
 files = [
-    {file = "requests-2.31.0-py3-none-any.whl", hash = "sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f"},
-    {file = "requests-2.31.0.tar.gz", hash = "sha256:942c5a758f98d790eaed1a29cb6eefc7ffb0d1cf7af05c3d2791656dbd6ad1e1"},
+    {file = "requests-2.32.2-py3-none-any.whl", hash = "sha256:fc06670dd0ed212426dfeb94fc1b983d917c4f9847c863f313c9dfaaffb7c23c"},
+    {file = "requests-2.32.2.tar.gz", hash = "sha256:dd951ff5ecf3e3b3aa26b40703ba77495dab41da839ae72ef3c8e5d8e2433289"},
 ]
 
 [package.dependencies]
@@ -1604,28 +1475,28 @@ requests = ">=2.0.1,<3.0.0"
 
 [[package]]
 name = "ruff"
-version = "0.4.3"
+version = "0.4.5"
 description = "An extremely fast Python linter and code formatter, written in Rust."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "ruff-0.4.3-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:b70800c290f14ae6fcbb41bbe201cf62dfca024d124a1f373e76371a007454ce"},
-    {file = "ruff-0.4.3-py3-none-macosx_11_0_arm64.whl", hash = "sha256:08a0d6a22918ab2552ace96adeaca308833873a4d7d1d587bb1d37bae8728eb3"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:eba1f14df3c758dd7de5b55fbae7e1c8af238597961e5fb628f3de446c3c40c5"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:819fb06d535cc76dfddbfe8d3068ff602ddeb40e3eacbc90e0d1272bb8d97113"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0bfc9e955e6dc6359eb6f82ea150c4f4e82b660e5b58d9a20a0e42ec3bb6342b"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:510a67d232d2ebe983fddea324dbf9d69b71c4d2dfeb8a862f4a127536dd4cfb"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc9ff11cd9a092ee7680a56d21f302bdda14327772cd870d806610a3503d001f"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:29efff25bf9ee685c2c8390563a5b5c006a3fee5230d28ea39f4f75f9d0b6f2f"},
-    {file = "ruff-0.4.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:18b00e0bcccf0fc8d7186ed21e311dffd19761cb632241a6e4fe4477cc80ef6e"},
-    {file = "ruff-0.4.3-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:262f5635e2c74d80b7507fbc2fac28fe0d4fef26373bbc62039526f7722bca1b"},
-    {file = "ruff-0.4.3-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:7363691198719c26459e08cc17c6a3dac6f592e9ea3d2fa772f4e561b5fe82a3"},
-    {file = "ruff-0.4.3-py3-none-musllinux_1_2_i686.whl", hash = "sha256:eeb039f8428fcb6725bb63cbae92ad67b0559e68b5d80f840f11914afd8ddf7f"},
-    {file = "ruff-0.4.3-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:927b11c1e4d0727ce1a729eace61cee88a334623ec424c0b1c8fe3e5f9d3c865"},
-    {file = "ruff-0.4.3-py3-none-win32.whl", hash = "sha256:25cacda2155778beb0d064e0ec5a3944dcca9c12715f7c4634fd9d93ac33fd30"},
-    {file = "ruff-0.4.3-py3-none-win_amd64.whl", hash = "sha256:7a1c3a450bc6539ef00da6c819fb1b76b6b065dec585f91456e7c0d6a0bbc725"},
-    {file = "ruff-0.4.3-py3-none-win_arm64.whl", hash = "sha256:71ca5f8ccf1121b95a59649482470c5601c60a416bf189d553955b0338e34614"},
-    {file = "ruff-0.4.3.tar.gz", hash = "sha256:ff0a3ef2e3c4b6d133fbedcf9586abfbe38d076041f2dc18ffb2c7e0485d5a07"},
+    {file = "ruff-0.4.5-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:8f58e615dec58b1a6b291769b559e12fdffb53cc4187160a2fc83250eaf54e96"},
+    {file = "ruff-0.4.5-py3-none-macosx_11_0_arm64.whl", hash = "sha256:84dd157474e16e3a82745d2afa1016c17d27cb5d52b12e3d45d418bcc6d49264"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25f483ad9d50b00e7fd577f6d0305aa18494c6af139bce7319c68a17180087f4"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:63fde3bf6f3ad4e990357af1d30e8ba2730860a954ea9282c95fc0846f5f64af"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:78e3ba4620dee27f76bbcad97067766026c918ba0f2d035c2fc25cbdd04d9c97"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:441dab55c568e38d02bbda68a926a3d0b54f5510095c9de7f95e47a39e0168aa"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1169e47e9c4136c997f08f9857ae889d614c5035d87d38fda9b44b4338909cdf"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:755ac9ac2598a941512fc36a9070a13c88d72ff874a9781493eb237ab02d75df"},
+    {file = "ruff-0.4.5-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f4b02a65985be2b34b170025a8b92449088ce61e33e69956ce4d316c0fe7cce0"},
+    {file = "ruff-0.4.5-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:75a426506a183d9201e7e5664de3f6b414ad3850d7625764106f7b6d0486f0a1"},
+    {file = "ruff-0.4.5-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:6e1b139b45e2911419044237d90b60e472f57285950e1492c757dfc88259bb06"},
+    {file = "ruff-0.4.5-py3-none-musllinux_1_2_i686.whl", hash = "sha256:a6f29a8221d2e3d85ff0c7b4371c0e37b39c87732c969b4d90f3dad2e721c5b1"},
+    {file = "ruff-0.4.5-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:d6ef817124d72b54cc923f3444828ba24fa45c3164bc9e8f1813db2f3d3a8a11"},
+    {file = "ruff-0.4.5-py3-none-win32.whl", hash = "sha256:aed8166c18b1a169a5d3ec28a49b43340949e400665555b51ee06f22813ef062"},
+    {file = "ruff-0.4.5-py3-none-win_amd64.whl", hash = "sha256:b0b03c619d2b4350b4a27e34fd2ac64d0dabe1afbf43de57d0f9d8a05ecffa45"},
+    {file = "ruff-0.4.5-py3-none-win_arm64.whl", hash = "sha256:9d15de3425f53161b3f5a5658d4522e4eee5ea002bf2ac7aa380743dd9ad5fba"},
+    {file = "ruff-0.4.5.tar.gz", hash = "sha256:286eabd47e7d4d521d199cab84deca135557e6d1e0f0d01c29e757c3cb151b54"},
 ]
 
 [[package]]
@@ -1667,13 +1538,13 @@ files = [
 
 [[package]]
 name = "tomlkit"
-version = "0.12.4"
+version = "0.12.5"
 description = "Style preserving TOML library"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "tomlkit-0.12.4-py3-none-any.whl", hash = "sha256:5cd82d48a3dd89dee1f9d64420aa20ae65cfbd00668d6f094d7578a78efbb77b"},
-    {file = "tomlkit-0.12.4.tar.gz", hash = "sha256:7ca1cfc12232806517a8515047ba66a19369e71edf2439d0f5824f91032b6cc3"},
+    {file = "tomlkit-0.12.5-py3-none-any.whl", hash = "sha256:af914f5a9c59ed9d0762c7b64d3b5d5df007448eb9cd2edc8a46b1eafead172f"},
+    {file = "tomlkit-0.12.5.tar.gz", hash = "sha256:eef34fba39834d4d6b73c9ba7f3e4d1c417a4e56f89a7e96e090dd0d24b8fb3c"},
 ]
 
 [[package]]
@@ -1705,13 +1576,13 @@ testing = ["build[virtualenv] (>=1.0.3)", "covdefaults (>=2.3)", "detect-test-po
 
 [[package]]
 name = "trove-classifiers"
-version = "2024.4.10"
+version = "2024.5.22"
 description = "Canonical source for classifiers on PyPI (pypi.org)."
 optional = false
 python-versions = "*"
 files = [
-    {file = "trove-classifiers-2024.4.10.tar.gz", hash = "sha256:49f40bb6a746b72a1cba4f8d55ee8252169cda0f70802e3fd24f04b7fb25a492"},
-    {file = "trove_classifiers-2024.4.10-py3-none-any.whl", hash = "sha256:678bd6fcc5218d72e3304e27a608acc9b91e17bd00c3f3d8c968497c843ad98b"},
+    {file = "trove_classifiers-2024.5.22-py3-none-any.whl", hash = "sha256:c43ade18704823e4afa3d9db7083294bc4708a5e02afbcefacd0e9d03a7a24ef"},
+    {file = "trove_classifiers-2024.5.22.tar.gz", hash = "sha256:8a6242bbb5c9ae88d34cf665e816b287d2212973c8777dfaef5ec18d72ac1d03"},
 ]
 
 [[package]]
@@ -1733,13 +1604,13 @@ zstd = ["zstandard (>=0.18.0)"]
 
 [[package]]
 name = "virtualenv"
-version = "20.26.1"
+version = "20.26.2"
 description = "Virtual Python Environment builder"
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "virtualenv-20.26.1-py3-none-any.whl", hash = "sha256:7aa9982a728ae5892558bff6a2839c00b9ed145523ece2274fad6f414690ae75"},
-    {file = "virtualenv-20.26.1.tar.gz", hash = "sha256:604bfdceaeece392802e6ae48e69cec49168b9c5f4a44e483963f9242eb0e78b"},
+    {file = "virtualenv-20.26.2-py3-none-any.whl", hash = "sha256:a624db5e94f01ad993d476b9ee5346fdf7b9de43ccaee0e0197012dc838a0e9b"},
+    {file = "virtualenv-20.26.2.tar.gz", hash = "sha256:82bf0f4eebbb78d36ddaee0283d43fe5736b53880b8a8cdcd37390a07ac3741c"},
 ]
 
 [package.dependencies]
@@ -1826,20 +1697,20 @@ test = ["pytest"]
 
 [[package]]
 name = "zipp"
-version = "3.18.1"
+version = "3.18.2"
 description = "Backport of pathlib-compatible object wrapper for zip files"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "zipp-3.18.1-py3-none-any.whl", hash = "sha256:206f5a15f2af3dbaee80769fb7dc6f249695e940acca08dfb2a4769fe61e538b"},
-    {file = "zipp-3.18.1.tar.gz", hash = "sha256:2884ed22e7d8961de1c9a05142eb69a247f120291bc0206a00a7642f09b5b715"},
+    {file = "zipp-3.18.2-py3-none-any.whl", hash = "sha256:dce197b859eb796242b0622af1b8beb0a722d52aa2f57133ead08edd5bf5374e"},
+    {file = "zipp-3.18.2.tar.gz", hash = "sha256:6278d9ddbcfb1f1089a88fde84481528b07b0e10474e09dcfe53dad4069fa059"},
 ]
 
 [package.extras]
 docs = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "rst.linker (>=1.9)", "sphinx (>=3.5)", "sphinx-lint"]
-testing = ["big-O", "jaraco.functools", "jaraco.itertools", "more-itertools", "pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-cov", "pytest-enabler (>=2.2)", "pytest-ignore-flaky", "pytest-mypy", "pytest-ruff (>=0.2.1)"]
+testing = ["big-O", "jaraco.functools", "jaraco.itertools", "jaraco.test", "more-itertools", "pytest (>=6,!=8.1.*)", "pytest-checkdocs (>=2.4)", "pytest-cov", "pytest-enabler (>=2.2)", "pytest-ignore-flaky", "pytest-mypy", "pytest-ruff (>=0.2.1)"]
 
 [metadata]
 lock-version = "2.0"
 python-versions = ">=3.9,<4"
-content-hash = "6043de4c4c5a3d9b64c9fe14fa1b9b51871aa785612fb8c44505d62e03a7f3a6"
+content-hash = "f6960ac4cec0865d10d1a02fb088ec41b206d2eeeccf579fe8f4820169c2cb58"