Add changes for 3aa1787

Reference/index.html

@@ -170,7 +170,7 @@ <h1>Reference<a class="headerlink" href="#reference" title="Link to this heading
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.filter.wmo2msc">sarracenia.flowcb.filter.wmo2msc</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.gather">sarracenia.flowcb.gather</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.gather.file">sarracenia.flowcb.gather.file</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.gather.message">sarracenia.flowcb.gather.message</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-gather-message">sarracenia.flowcb.gather.message</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.housekeeping">sarracenia.flowcb.housekeeping</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.housekeeping.resources">sarracenia.flowcb.housekeeping.resources</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.log">sarracenia.flowcb.log</a></li>
@@ -184,27 +184,27 @@ <h1>Reference<a class="headerlink" href="#reference" title="Link to this heading
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.scheduled">sarracenia.flowcb.scheduled</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-script">sarracenia.flowcb.script</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.shiftdir2baseurl">sarracenia.flowcb.shiftdir2baseurl</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.poll">sarracenia.flowcb.poll</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.poll.airnow">sarracenia.flowcb.poll.airnow</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.poll.mail">sarracenia.flowcb.poll.mail</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.poll.nasa_mls_nrt">sarracenia.flowcb.poll.nasa_mls_nrt</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll">sarracenia.flowcb.poll</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll-airnow">sarracenia.flowcb.poll.airnow</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll-mail">sarracenia.flowcb.poll.mail</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll-nasa-mls-nrt">sarracenia.flowcb.poll.nasa_mls_nrt</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll-nexrad">sarracenia.flowcb.poll.nexrad</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.poll.noaa_hydrometric">sarracenia.flowcb.poll.noaa_hydrometric</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.poll.usgs">sarracenia.flowcb.poll.usgs</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll-noaa-hydrometric">sarracenia.flowcb.poll.noaa_hydrometric</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-poll-usgs">sarracenia.flowcb.poll.usgs</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.post">sarracenia.flowcb.post</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.send.email">sarracenia.flowcb.send.email</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.post.message">sarracenia.flowcb.post.message</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-post-message">sarracenia.flowcb.post.message</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.send">sarracenia.flowcb.send</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-wistree">sarracenia.flowcb.wistree</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.work">sarracenia.flowcb.work</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.work.age">sarracenia.flowcb.work.age</a></li>
 <li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.work.rxpipe">sarracenia.flowcb.work.rxpipe</a></li>
-<li class="toctree-l2"><a class="reference internal" href="flowcb.html#module-sarracenia.flowcb.v2wrapper">sarracenia.flowcb.v2wrapper</a></li>
+<li class="toctree-l2"><a class="reference internal" href="flowcb.html#sarracenia-flowcb-v2wrapper">sarracenia.flowcb.v2wrapper</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="code.html">Code Reference</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia">sarracenia</a></li>
-<li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.config">sarracenia.config</a></li>
+<li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-config">sarracenia.config</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.credentials">sarracenia.credentials</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.diskqueue">sarracenia.diskqueue</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.filemetadata">sarracenia.filemetadata</a></li>
@@ -218,17 +218,17 @@ <h1>Reference<a class="headerlink" href="#reference" title="Link to this heading
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.flow.subscribe">sarracenia.flow.subscribe</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.flow.watch">sarracenia.flow.watch</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.flow.winnow">sarracenia.flow.winnow</a></li>
-<li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.instance">sarracenia.instance</a></li>
+<li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-instance">sarracenia.instance</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.identity">sarracenia.identity</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.identity.arbitrary">sarracenia.identity.arbitrary</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.identity.sha512">sarracenia.identity.sha512</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.identity.md5">sarracenia.identity.md5</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.identity.random">sarracenia.identity.random</a></li>
-<li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.moth">sarracenia.moth</a></li>
-<li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.moth.amqp">sarracenia.moth.amqp</a></li>
-<li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.moth.pika">sarracenia.moth.pika</a></li>
+<li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-moth">sarracenia.moth</a></li>
+<li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-moth-amqp">sarracenia.moth.amqp</a></li>
+<li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-moth-pika">sarracenia.moth.pika</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-moth-mqtt">sarracenia.moth.mqtt</a></li>
-<li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.moth.amq1">sarracenia.moth.amq1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="code.html#sarracenia-moth-amq1">sarracenia.moth.amq1</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.rabbitmq_admin">sarracenia.rabbitmq_admin</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.transfer">sarracenia.transfer</a></li>
 <li class="toctree-l2"><a class="reference internal" href="code.html#module-sarracenia.transfer.file">sarracenia.transfer.file</a></li>

Reference/sr3_options.7.html

@@ -1608,6 +1608,16 @@ <h4>sourceFromExchange &lt;flag&gt; (default: off)<a class="headerlink" href="#s
 </div>
 <p>To have data arrive in the standard format tree.</p>
 </section>
+<section id="sourcefrommessage-flag-default-off">
+<h4>sourceFromMessage &lt;flag&gt; (default: off)<a class="headerlink" href="#sourcefrommessage-flag-default-off" title="Link to this heading"></a></h4>
+<p>The <strong>sourceFromMessage</strong> option is mainly for use by administrators.
+Normally the <em>source</em> field from an inbound message is ignored.
+When this option is set, the field in the message is accepted and used
+for processing. (overrides <em>source</em>, and <em>sourceFromExchange</em> )</p>
+<p>It defaults to off because malicious messages can misrepresent data
+origin. To be used only with flows of responsibly curated, trustable
+message flows.</p>
+</section>
 <section id="subtopic-amqp-pattern-default">
 <h4>subtopic &lt;amqp pattern&gt; (default: #)<a class="headerlink" href="#subtopic-amqp-pattern-default" title="Link to this heading"></a></h4>
 <p>Within an exchange’s postings, the subtopic setting narrows the product selection.

Tutorials/4_api_moth_sub_demo.html

@@ -662,7 +662,7 @@ <h2>Downloading Data with Python<a class="headerlink" href="#Downloading-Data-wi
 </section>
 <section id="Conclusion">
 <h2>Conclusion<a class="headerlink" href="#Conclusion" title="Link to this heading"></a></h2>
-<p><a class="reference internal" href="../Reference/code.html#module-sarracenia.moth"><span class="std std-ref">Sarracenia.moth.amqp</span></a> is the lightest-weight way to add consumption of Sarracenia messages to your existing python stack. You explicitly ask for new messages when ready to use them.</p>
+<p>Sarracenia.moth.amqp is the lightest-weight way to add consumption of Sarracenia messages to your existing python stack. You explicitly ask for new messages when ready to use them.</p>
 <p>Things this type of integration does not provide:</p>
 <ul class="simple">
 <li><p>data retrieval: you need your own code to download the corresponding data,</p></li>

_modules/index.html

@@ -71,8 +71,7 @@
 
   <h1>All modules for which code is available</h1>
 <ul><li><a href="sarracenia.html">sarracenia</a></li>
-<ul><li><a href="sarracenia/config.html">sarracenia.config</a></li>
-<li><a href="sarracenia/credentials.html">sarracenia.credentials</a></li>
+<ul><li><a href="sarracenia/credentials.html">sarracenia.credentials</a></li>
 <li><a href="sarracenia/diskqueue.html">sarracenia.diskqueue</a></li>
 <li><a href="sarracenia/filemetadata.html">sarracenia.filemetadata</a></li>
 <li><a href="sarracenia/flow.html">sarracenia.flow</a></li>
@@ -114,39 +113,25 @@ <h1>All modules for which code is available</h1>
 <li><a href="sarracenia/flowcb/filter/pclean_f92.html">sarracenia.flowcb.filter.pclean_f92</a></li>
 <li><a href="sarracenia/flowcb/filter/wmo2msc.html">sarracenia.flowcb.filter.wmo2msc</a></li>
 <li><a href="sarracenia/flowcb/gather/file.html">sarracenia.flowcb.gather.file</a></li>
-<li><a href="sarracenia/flowcb/gather/message.html">sarracenia.flowcb.gather.message</a></li>
 <li><a href="sarracenia/flowcb/housekeeping/resources.html">sarracenia.flowcb.housekeeping.resources</a></li>
 <li><a href="sarracenia/flowcb/log.html">sarracenia.flowcb.log</a></li>
 <li><a href="sarracenia/flowcb/mdelaylatest.html">sarracenia.flowcb.mdelaylatest</a></li>
 <li><a href="sarracenia/flowcb/nodupe.html">sarracenia.flowcb.nodupe</a></li>
 <ul><li><a href="sarracenia/flowcb/nodupe/data.html">sarracenia.flowcb.nodupe.data</a></li>
 <li><a href="sarracenia/flowcb/nodupe/name.html">sarracenia.flowcb.nodupe.name</a></li>
 </ul><li><a href="sarracenia/flowcb/pclean.html">sarracenia.flowcb.pclean</a></li>
-<li><a href="sarracenia/flowcb/poll.html">sarracenia.flowcb.poll</a></li>
-<ul><li><a href="sarracenia/flowcb/poll/airnow.html">sarracenia.flowcb.poll.airnow</a></li>
-<li><a href="sarracenia/flowcb/poll/mail.html">sarracenia.flowcb.poll.mail</a></li>
-<li><a href="sarracenia/flowcb/poll/nasa_mls_nrt.html">sarracenia.flowcb.poll.nasa_mls_nrt</a></li>
-<li><a href="sarracenia/flowcb/poll/noaa_hydrometric.html">sarracenia.flowcb.poll.noaa_hydrometric</a></li>
-<li><a href="sarracenia/flowcb/poll/usgs.html">sarracenia.flowcb.poll.usgs</a></li>
-</ul><li><a href="sarracenia/flowcb/post/message.html">sarracenia.flowcb.post.message</a></li>
 <li><a href="sarracenia/flowcb/retry.html">sarracenia.flowcb.retry</a></li>
 <li><a href="sarracenia/flowcb/sample.html">sarracenia.flowcb.sample</a></li>
 <li><a href="sarracenia/flowcb/scheduled.html">sarracenia.flowcb.scheduled</a></li>
 <li><a href="sarracenia/flowcb/send/email.html">sarracenia.flowcb.send.email</a></li>
 <li><a href="sarracenia/flowcb/shiftdir2baseurl.html">sarracenia.flowcb.shiftdir2baseurl</a></li>
-<li><a href="sarracenia/flowcb/v2wrapper.html">sarracenia.flowcb.v2wrapper</a></li>
 <li><a href="sarracenia/flowcb/work/age.html">sarracenia.flowcb.work.age</a></li>
 <li><a href="sarracenia/flowcb/work/rxpipe.html">sarracenia.flowcb.work.rxpipe</a></li>
 </ul><li><a href="sarracenia/identity.html">sarracenia.identity</a></li>
 <ul><li><a href="sarracenia/identity/arbitrary.html">sarracenia.identity.arbitrary</a></li>
 <li><a href="sarracenia/identity/md5.html">sarracenia.identity.md5</a></li>
 <li><a href="sarracenia/identity/random.html">sarracenia.identity.random</a></li>
 <li><a href="sarracenia/identity/sha512.html">sarracenia.identity.sha512</a></li>
-</ul><li><a href="sarracenia/instance.html">sarracenia.instance</a></li>
-<li><a href="sarracenia/moth.html">sarracenia.moth</a></li>
-<ul><li><a href="sarracenia/moth/amq1.html">sarracenia.moth.amq1</a></li>
-<li><a href="sarracenia/moth/amqp.html">sarracenia.moth.amqp</a></li>
-<li><a href="sarracenia/moth/pika.html">sarracenia.moth.pika</a></li>
 </ul><li><a href="sarracenia/rabbitmq_admin.html">sarracenia.rabbitmq_admin</a></li>
 <li><a href="sarracenia/transfer.html">sarracenia.transfer</a></li>
 <ul><li><a href="sarracenia/transfer/file.html">sarracenia.transfer.file</a></li>