Add changes for 96ccb73

Contribution/Development.html

@@ -181,7 +181,7 @@ <h1>MetPX-Sarracenia Developer’s Guide<a class="headerlink" href="#metpx-sarra
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 <section id="tools-you-need">

Contribution/man_page_template.html

@@ -131,7 +131,7 @@ <h2>sr_title<a class="headerlink" href="#sr-title" title="Link to this heading">
 <dd class="field-odd"><p>1</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

Explanation/SarraPluginDev.html

@@ -151,7 +151,7 @@ <h3>Revision Record<a class="headerlink" href="#revision-record" title="Link to
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 </section>

How2Guides/source.html

@@ -145,7 +145,7 @@ <h3>Revision Record<a class="headerlink" href="#revision-record" title="Link to
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 <p>A Sarracenia data pump is a web (or sftp) server with notifications for subscribers

How2Guides/subscriber.html

@@ -143,7 +143,7 @@ <h3>Revision Record<a class="headerlink" href="#revision-record" title="Link to
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 </section>

Reference/sr3.1.html

@@ -130,7 +130,7 @@ <h2>sr3 Sarracenia CLI<a class="headerlink" href="#sr3-sarracenia-cli" title="Li
 <dd class="field-odd"><p>1</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

Reference/sr3_cpump.1.html

@@ -127,7 +127,7 @@ <h2>sr_shovel in C<a class="headerlink" href="#sr-shovel-in-c" title="Link to th
 <dd class="field-odd"><p>1</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

Reference/sr3_credentials.7.html

@@ -124,7 +124,7 @@ <h2>SR3 Credential File Format<a class="headerlink" href="#sr3-credential-file-f
 <dd class="field-odd"><p>7</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

Reference/sr3_options.7.html

@@ -128,7 +128,7 @@ <h2>SR3 Configuration File Format<a class="headerlink" href="#sr3-configuration-
 <dd class="field-odd"><p>7</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>
@@ -712,7 +712,9 @@ <h4>dry_run &lt;flag&gt; (default: False)<a class="headerlink" href="#dry-run-fl
 <h4>durable &lt;flag&gt; (default: True)<a class="headerlink" href="#durable-flag-default-true" title="Link to this heading"></a></h4>
 <p>The AMQP <strong>durable</strong> option, on queue declarations. If set to True,
 the broker will preserve the queue across broker reboots.
-It means writes the queue is on disk if the broker is restarted.</p>
+The queue will be written to and recovered from disk if the broker is restarted.</p>
+<p>Note: only <em>persistent</em> messages will remain in a durable queue after a broker restart.
+Persistent messages can be published by enabling the <strong>persistent</strong> option (it is enabled by default).</p>
 </section>
 <section id="fileevents-event-event">
 <h4>fileEvents &lt;event,event,…&gt;<a class="headerlink" href="#fileevents-event-event" title="Link to this heading"></a></h4>
@@ -1251,6 +1253,16 @@ <h4>permDefault, permDirDefault, permLog, permCopy<a class="headerlink" href="#p
 The <strong>permDefault</strong> options specifies a mask, that is the permissions must be
 at least what is specified.</p>
 </section>
+<section id="persistent-flag-default-true">
+<h4>persistent &lt;flag&gt; (default: True)<a class="headerlink" href="#persistent-flag-default-true" title="Link to this heading"></a></h4>
+<p>The <strong>persistent</strong> option sets the <em>delivery_mode</em> for an AMQP message. When True,
+persistent messages will be published (<code class="docutils literal notranslate"><span class="pre">delivery_mode=2</span></code>), when False, transient
+(non-durable, <code class="docutils literal notranslate"><span class="pre">delivery_mode=1</span></code>) messages will be published.</p>
+<p>Persistent messages are written to disk by the broker, and will survive a broker restart.
+Any transient messages in a queue will be lost when a broker is restarted. Note: persistent
+messages will only survive a broker restart <em>when they reside in a durable queue</em>. Non-durable
+queues, including all messages inside them, will be lost when a broker is restarted.</p>
+</section>
 <section id="pollurl-url">
 <h4>pollUrl &lt;url&gt;<a class="headerlink" href="#pollurl-url" title="Link to this heading"></a></h4>
 <p>Specification of a remote server resources to query with a poll

Reference/sr3_post.1.html

@@ -128,7 +128,7 @@ <h2>Publish the Availability of Files<a class="headerlink" href="#publish-the-av
 <dd class="field-odd"><p>1</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

Reference/sr_post.7.html

@@ -133,7 +133,7 @@ <h2>Sarracenia v03 Notification Message Format/Protocol<a class="headerlink" hre
 <dd class="field-odd"><p>7</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

Tutorials/Install.html

@@ -134,7 +134,7 @@ <h2>Revision Record<a class="headerlink" href="#revision-record" title="Link to
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 </section>

_modules/sarracenia/config.html

@@ -220,7 +220,7 @@ <h1>Source code for sarracenia.config</h1><div class="highlight"><pre>
     <span class="s1">&#39;delete&#39;</span><span class="p">,</span> <span class="s1">&#39;discard&#39;</span><span class="p">,</span> <span class="s1">&#39;download&#39;</span><span class="p">,</span> <span class="s1">&#39;dry_run&#39;</span><span class="p">,</span> <span class="s1">&#39;durable&#39;</span><span class="p">,</span> <span class="s1">&#39;exchangeDeclare&#39;</span><span class="p">,</span> <span class="s1">&#39;exchangeSplit&#39;</span><span class="p">,</span> <span class="s1">&#39;logReject&#39;</span><span class="p">,</span> <span class="s1">&#39;realpathFilter&#39;</span><span class="p">,</span> \
     <span class="s1">&#39;follow_symlinks&#39;</span><span class="p">,</span> <span class="s1">&#39;force_polling&#39;</span><span class="p">,</span> <span class="s1">&#39;inline&#39;</span><span class="p">,</span> <span class="s1">&#39;inlineOnly&#39;</span><span class="p">,</span> <span class="s1">&#39;inplace&#39;</span><span class="p">,</span> <span class="s1">&#39;logMetrics&#39;</span><span class="p">,</span> <span class="s1">&#39;logStdout&#39;</span><span class="p">,</span> <span class="s1">&#39;logReject&#39;</span><span class="p">,</span> <span class="s1">&#39;restore&#39;</span><span class="p">,</span> \
     <span class="s1">&#39;messageDebugDump&#39;</span><span class="p">,</span> <span class="s1">&#39;mirror&#39;</span><span class="p">,</span> <span class="s1">&#39;timeCopy&#39;</span><span class="p">,</span> <span class="s1">&#39;notify_only&#39;</span><span class="p">,</span> <span class="s1">&#39;overwrite&#39;</span><span class="p">,</span> <span class="s1">&#39;post_on_start&#39;</span><span class="p">,</span> \
-    <span class="s1">&#39;permCopy&#39;</span><span class="p">,</span> <span class="s1">&#39;queueBind&#39;</span><span class="p">,</span> <span class="s1">&#39;queueDeclare&#39;</span><span class="p">,</span> <span class="s1">&#39;randomize&#39;</span><span class="p">,</span> <span class="s1">&#39;recursive&#39;</span><span class="p">,</span> <span class="s1">&#39;realpathPost&#39;</span><span class="p">,</span> \
+    <span class="s1">&#39;permCopy&#39;</span><span class="p">,</span> <span class="s1">&#39;persistent&#39;</span><span class="p">,</span> <span class="s1">&#39;queueBind&#39;</span><span class="p">,</span> <span class="s1">&#39;queueDeclare&#39;</span><span class="p">,</span> <span class="s1">&#39;randomize&#39;</span><span class="p">,</span> <span class="s1">&#39;recursive&#39;</span><span class="p">,</span> <span class="s1">&#39;realpathPost&#39;</span><span class="p">,</span> \
     <span class="s1">&#39;reconnect&#39;</span><span class="p">,</span> <span class="s1">&#39;report&#39;</span><span class="p">,</span> <span class="s1">&#39;reset&#39;</span><span class="p">,</span> <span class="s1">&#39;retry_refilter&#39;</span><span class="p">,</span> <span class="s1">&#39;retryEmptyBeforeExit&#39;</span><span class="p">,</span> <span class="s1">&#39;save&#39;</span><span class="p">,</span> <span class="s1">&#39;sundew_compat_regex_first_match_is_zero&#39;</span><span class="p">,</span> \
     <span class="s1">&#39;sourceFromExchange&#39;</span><span class="p">,</span> <span class="s1">&#39;statehost&#39;</span><span class="p">,</span> <span class="s1">&#39;users&#39;</span><span class="p">,</span> <span class="s1">&#39;v2compatRenameDoublePost&#39;</span>
                 <span class="p">]</span>

_modules/sarracenia/moth/amqp.html

@@ -131,6 +131,7 @@ <h1>Source code for sarracenia.moth.amqp</h1><div class="highlight"><pre>
     <span class="s1">&#39;exchangeDeclare&#39;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
     <span class="s1">&#39;expire&#39;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
     <span class="s1">&#39;logLevel&#39;</span><span class="p">:</span> <span class="s1">&#39;info&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;persistent&#39;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
     <span class="s1">&#39;prefetch&#39;</span><span class="p">:</span> <span class="mi">25</span><span class="p">,</span>
     <span class="s1">&#39;queueName&#39;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
     <span class="s1">&#39;queueBind&#39;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
@@ -779,6 +780,11 @@ <h1>Source code for sarracenia.moth.amqp</h1><div class="highlight"><pre>
                 <span class="n">sarracenia</span><span class="o">.</span><span class="n">durationToSeconds</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">o</span><span class="p">[</span><span class="s1">&#39;message_ttl&#39;</span><span class="p">])</span> <span class="o">*</span> <span class="mi">1000</span><span class="p">)</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="n">ttl</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span>
+
+        <span class="k">if</span> <span class="s1">&#39;persistent&#39;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">o</span><span class="p">:</span>
+            <span class="n">deliv_mode</span> <span class="o">=</span> <span class="mi">2</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">o</span><span class="p">[</span><span class="s1">&#39;persistent&#39;</span><span class="p">]</span> <span class="k">else</span> <span class="mi">1</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="n">deliv_mode</span> <span class="o">=</span> <span class="mi">2</span>
 
         <span class="n">raw_body</span><span class="p">,</span> <span class="n">headers</span><span class="p">,</span> <span class="n">content_type</span> <span class="o">=</span> <span class="n">PostFormat</span><span class="o">.</span><span class="n">exportAny</span><span class="p">(</span> <span class="n">body</span><span class="p">,</span> <span class="n">version</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">o</span><span class="p">[</span><span class="s1">&#39;topicPrefix&#39;</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">o</span> <span class="p">)</span>
 
@@ -814,7 +820,7 @@ <h1>Source code for sarracenia.moth.amqp</h1><div class="highlight"><pre>
                                         <span class="n">content_type</span><span class="o">=</span><span class="n">content_type</span><span class="p">,</span>
                                         <span class="n">application_headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
                                         <span class="n">expire</span><span class="o">=</span><span class="n">ttl</span><span class="p">,</span>
-                                        <span class="n">delivery_mode</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+                                        <span class="n">delivery_mode</span><span class="o">=</span><span class="n">deliv_mode</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">metrics</span><span class="p">[</span><span class="s1">&#39;txByteCount&#39;</span><span class="p">]</span> <span class="o">+=</span> <span class="nb">len</span><span class="p">(</span><span class="n">raw_body</span><span class="p">)</span> 
         <span class="k">if</span> <span class="n">headers</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">metrics</span><span class="p">[</span><span class="s1">&#39;txByteCount&#39;</span><span class="p">]</span> <span class="o">+=</span> <span class="nb">len</span><span class="p">(</span><span class="s1">&#39;&#39;</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">headers</span><span class="p">)))</span>

_sources/Reference/sr3_options.7.rst.txt

@@ -686,7 +686,10 @@ durable <flag> (default: True)
 
 The AMQP **durable** option, on queue declarations. If set to True, 
 the broker will preserve the queue across broker reboots.
-It means writes the queue is on disk if the broker is restarted.
+The queue will be written to and recovered from disk if the broker is restarted.
+
+Note: only *persistent* messages will remain in a durable queue after a broker restart. 
+Persistent messages can be published by enabling the **persistent** option (it is enabled by default).
 
 fileEvents <event,event,...>
 ----------------------------
@@ -1305,6 +1308,18 @@ a file to be accepted.
 The **permDefault** options specifies a mask, that is the permissions must be
 at least what is specified.
 
+persistent <flag> (default: True)
+----------------------------------
+
+The **persistent** option sets the *delivery_mode* for an AMQP message. When True,
+persistent messages will be published (``delivery_mode=2``), when False, transient
+(non-durable, ``delivery_mode=1``) messages will be published.
+
+Persistent messages are written to disk by the broker, and will survive a broker restart.
+Any transient messages in a queue will be lost when a broker is restarted. Note: persistent
+messages will only survive a broker restart *when they reside in a durable queue*. Non-durable
+queues, including all messages inside them, will be lost when a broker is restarted.
+
 pollUrl <url>
 -------------
 

_sources/fr/Reference/sr3_options.7.rst.txt

@@ -671,6 +671,9 @@ L’option AMQP **durable**, sur les déclarations de fil d’attente. Si la val
 le courtier conservera la fil d’attente lors des redémarrages du courtier.
 Cela signifie que la fil d’attente est sur le disque si le courtier est redémarré.
 
+Remarque: seuls les messages *persistants* resteront dans une file d'attente durable après le redémarrage du courtier.
+Les messages persistants peuvent être publiés en activant l'option **persistant** (elle est activée par défaut).
+
 
 fileEvents <évènement, évènement,...>
 -------------------------------------
@@ -1280,6 +1283,20 @@ qu'un dossier puis être accepté.
 Les options **permDefault** spécifient un masque, c’est-à-dire que les autorisations doivent être
 au moins ce qui est spécifié.
 
+persistent <flag> (défaut: True)
+----------------------------------
+
+L'option **persistent** définit le *delivery_mode* pour un message AMQP. Lorsqu'il
+est choisi, les messages persistants seront publiés (``delivery_mode=2``). Lorsqu'ils
+ne le sont pas, ils seront placés en mode transitoire (non durables, ``delivery_mode=1``).
+
+Les messages persistants sont écrits sur le disque par le courtier et survivront au 
+redémarrage du courtier. Tous les messages transitoires dans une file d’attente seront
+perdus au redémarrage d’un courtier. Une remarque : les messages persistants ne survivront
+pas le redémarrage du courtier *quand ils résident dans une file d'attente durable*. 
+Non-durable les files d'attente, y compris tous les messages qu'elles contiennent, 
+seront perdues au redémarrage d'un courtier.
+
 pollUrl
 -------
 

fr/CommentFaire/source.html

@@ -144,7 +144,7 @@ <h3>Enregistrement de révision<a class="headerlink" href="#enregistrement-de-re
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 <p>Une pompe de données Sarracenia est un serveur Web (ou sftp) avec des notifications pour que les

fr/CommentFaire/subscriber.html

@@ -133,7 +133,7 @@ <h3>Enregistrement de révision<a class="headerlink" href="#enregistrement-de-re
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 </section>

fr/Contribution/Développement.html

@@ -142,7 +142,7 @@ <h1>Guide du développeur MetPX-Sarracenia<a class="headerlink" href="#guide-du-
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 <section id="outillage">

fr/Contribution/modèle_de_page_man.html

@@ -131,7 +131,7 @@ <h2>sr_titre<a class="headerlink" href="#sr-titre" title="Link to this heading">
 <dd class="field-odd"><p>1</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>

fr/Explication/SarraPluginDev.html

@@ -135,7 +135,7 @@ <h2>Travailler avec des plugins<a class="headerlink" href="#travailler-avec-des-
 <dd class="field-odd"><p>UNKNOWN</p>
 </dd>
 <dt class="field-even">date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 </dl>
 <section id="audience">

fr/Reference/sr3.1.html

@@ -127,7 +127,7 @@ <h2>sr3 Sarracenia CLI<a class="headerlink" href="#sr3-sarracenia-cli" title="Li
 <dd class="field-odd"><p>1</p>
 </dd>
 <dt class="field-even">Date<span class="colon">:</span></dt>
-<dd class="field-even"><p>Apr 05, 2024</p>
+<dd class="field-even"><p>Apr 06, 2024</p>
 </dd>
 <dt class="field-odd">Version<span class="colon">:</span></dt>
 <dd class="field-odd"><p>UNKNOWN</p>