[skip ci] Updates

move-coop · Dec 12, 2024 · 6c5b642 · 6c5b642
1 parent 827b7f8
commit 6c5b642
Show file tree

Hide file tree

Showing 401 changed files with 36 additions and 25 deletions.
diff --git a/html/latest/.buildinfo b/html/latest/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 11e6d8f96ad65d485dac4425568fe5cc
+config: a16c08bb78f283ec65046958535944f4
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/html/latest/.doctrees/actblue.doctree b/html/latest/.doctrees/actblue.doctree
diff --git a/html/latest/.doctrees/action_builder.doctree b/html/latest/.doctrees/action_builder.doctree
diff --git a/html/latest/.doctrees/action_kit.doctree b/html/latest/.doctrees/action_kit.doctree
diff --git a/html/latest/.doctrees/action_network.doctree b/html/latest/.doctrees/action_network.doctree
diff --git a/html/latest/.doctrees/airmeet.doctree b/html/latest/.doctrees/airmeet.doctree
diff --git a/html/latest/.doctrees/airtable.doctree b/html/latest/.doctrees/airtable.doctree
diff --git a/html/latest/.doctrees/alchemer.doctree b/html/latest/.doctrees/alchemer.doctree
diff --git a/html/latest/.doctrees/auth0.doctree b/html/latest/.doctrees/auth0.doctree
diff --git a/html/latest/.doctrees/aws.doctree b/html/latest/.doctrees/aws.doctree
diff --git a/html/latest/.doctrees/azure.doctree b/html/latest/.doctrees/azure.doctree
diff --git a/html/latest/.doctrees/bill_com.doctree b/html/latest/.doctrees/bill_com.doctree
diff --git a/html/latest/.doctrees/bloomerang.doctree b/html/latest/.doctrees/bloomerang.doctree
diff --git a/html/latest/.doctrees/box.doctree b/html/latest/.doctrees/box.doctree
diff --git a/html/latest/.doctrees/braintree.doctree b/html/latest/.doctrees/braintree.doctree
diff --git a/html/latest/.doctrees/build_a_connector.doctree b/html/latest/.doctrees/build_a_connector.doctree
diff --git a/html/latest/.doctrees/capitolcanary.doctree b/html/latest/.doctrees/capitolcanary.doctree
diff --git a/html/latest/.doctrees/catalist.doctree b/html/latest/.doctrees/catalist.doctree
diff --git a/html/latest/.doctrees/census.doctree b/html/latest/.doctrees/census.doctree
diff --git a/html/latest/.doctrees/census_geocoder.doctree b/html/latest/.doctrees/census_geocoder.doctree
diff --git a/html/latest/.doctrees/civis.doctree b/html/latest/.doctrees/civis.doctree
diff --git a/html/latest/.doctrees/contributing.doctree b/html/latest/.doctrees/contributing.doctree
diff --git a/html/latest/.doctrees/controlshift.doctree b/html/latest/.doctrees/controlshift.doctree
diff --git a/html/latest/.doctrees/copper.doctree b/html/latest/.doctrees/copper.doctree
diff --git a/html/latest/.doctrees/crowdtangle.doctree b/html/latest/.doctrees/crowdtangle.doctree
diff --git a/html/latest/.doctrees/databases.doctree b/html/latest/.doctrees/databases.doctree
diff --git a/html/latest/.doctrees/dbsync.doctree b/html/latest/.doctrees/dbsync.doctree
diff --git a/html/latest/.doctrees/donorbox.doctree b/html/latest/.doctrees/donorbox.doctree
diff --git a/html/latest/.doctrees/empower.doctree b/html/latest/.doctrees/empower.doctree
diff --git a/html/latest/.doctrees/environment.pickle b/html/latest/.doctrees/environment.pickle
diff --git a/html/latest/.doctrees/facebook_ads.doctree b/html/latest/.doctrees/facebook_ads.doctree
diff --git a/html/latest/.doctrees/formstack.doctree b/html/latest/.doctrees/formstack.doctree
diff --git a/html/latest/.doctrees/freshdesk.doctree b/html/latest/.doctrees/freshdesk.doctree
diff --git a/html/latest/.doctrees/github.doctree b/html/latest/.doctrees/github.doctree
diff --git a/html/latest/.doctrees/google.doctree b/html/latest/.doctrees/google.doctree
diff --git a/html/latest/.doctrees/hustle.doctree b/html/latest/.doctrees/hustle.doctree
diff --git a/html/latest/.doctrees/index.doctree b/html/latest/.doctrees/index.doctree
diff --git a/html/latest/.doctrees/mailchimp.doctree b/html/latest/.doctrees/mailchimp.doctree
diff --git a/html/latest/.doctrees/mobilecommons.doctree b/html/latest/.doctrees/mobilecommons.doctree
diff --git a/html/latest/.doctrees/mobilize_america.doctree b/html/latest/.doctrees/mobilize_america.doctree
diff --git a/html/latest/.doctrees/nation_builder.doctree b/html/latest/.doctrees/nation_builder.doctree
diff --git a/html/latest/.doctrees/newmode.doctree b/html/latest/.doctrees/newmode.doctree
diff --git a/html/latest/.doctrees/ngpvan.doctree b/html/latest/.doctrees/ngpvan.doctree
diff --git a/html/latest/.doctrees/notifications.doctree b/html/latest/.doctrees/notifications.doctree
diff --git a/html/latest/.doctrees/p2a.doctree b/html/latest/.doctrees/p2a.doctree
diff --git a/html/latest/.doctrees/pdi.doctree b/html/latest/.doctrees/pdi.doctree
diff --git a/html/latest/.doctrees/quickbase.doctree b/html/latest/.doctrees/quickbase.doctree
diff --git a/html/latest/.doctrees/redash.doctree b/html/latest/.doctrees/redash.doctree
diff --git a/html/latest/.doctrees/rockthevote.doctree b/html/latest/.doctrees/rockthevote.doctree
diff --git a/html/latest/.doctrees/salesforce.doctree b/html/latest/.doctrees/salesforce.doctree
diff --git a/html/latest/.doctrees/scytl.doctree b/html/latest/.doctrees/scytl.doctree
diff --git a/html/latest/.doctrees/sftp.doctree b/html/latest/.doctrees/sftp.doctree
diff --git a/html/latest/.doctrees/shopify.doctree b/html/latest/.doctrees/shopify.doctree
diff --git a/html/latest/.doctrees/sisense.doctree b/html/latest/.doctrees/sisense.doctree
diff --git a/html/latest/.doctrees/table.doctree b/html/latest/.doctrees/table.doctree
diff --git a/html/latest/.doctrees/targetsmart.doctree b/html/latest/.doctrees/targetsmart.doctree
diff --git a/html/latest/.doctrees/targetsmart_api.doctree b/html/latest/.doctrees/targetsmart_api.doctree
diff --git a/html/latest/.doctrees/targetsmart_automation_workflows.doctree b/html/latest/.doctrees/targetsmart_automation_workflows.doctree
diff --git a/html/latest/.doctrees/training_guides/etl_best_practices.doctree b/html/latest/.doctrees/training_guides/etl_best_practices.doctree
diff --git a/html/latest/.doctrees/training_guides/getting_set_up.doctree b/html/latest/.doctrees/training_guides/getting_set_up.doctree
diff --git a/html/latest/.doctrees/turbovote.doctree b/html/latest/.doctrees/turbovote.doctree
diff --git a/html/latest/.doctrees/twilio.doctree b/html/latest/.doctrees/twilio.doctree
diff --git a/html/latest/.doctrees/use_cases/civis_job_status_slack_alert.doctree b/html/latest/.doctrees/use_cases/civis_job_status_slack_alert.doctree
diff --git a/html/latest/.doctrees/use_cases/contribute_use_cases.doctree b/html/latest/.doctrees/use_cases/contribute_use_cases.doctree
diff --git a/html/latest/.doctrees/use_cases/mysql_to_googlesheets.doctree b/html/latest/.doctrees/use_cases/mysql_to_googlesheets.doctree
diff --git a/html/latest/.doctrees/use_cases/opt_outs_to_everyaction.doctree b/html/latest/.doctrees/use_cases/opt_outs_to_everyaction.doctree
diff --git a/html/latest/.doctrees/utilities.doctree b/html/latest/.doctrees/utilities.doctree
diff --git a/html/latest/.doctrees/write_tests.doctree b/html/latest/.doctrees/write_tests.doctree
diff --git a/html/latest/.doctrees/zoom.doctree b/html/latest/.doctrees/zoom.doctree
diff --git a/html/latest/_modules/parsons/action_network/action_network.html b/html/latest/_modules/parsons/action_network/action_network.html
@@ -149,7 +149,7 @@ <h1>Source code for parsons.action_network.action_network</h1><div class="highli
 <span class="kn">import</span> <span class="nn">logging</span>
 <span class="kn">import</span> <span class="nn">re</span>
 <span class="kn">import</span> <span class="nn">warnings</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">Union</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">Union</span><span class="p">,</span> <span class="n">Literal</span>
 <span class="kn">from</span> <span class="nn">parsons</span> <span class="kn">import</span> <span class="n">Table</span>
 <span class="kn">from</span> <span class="nn">parsons.utilities</span> <span class="kn">import</span> <span class="n">check_env</span>
 <span class="kn">from</span> <span class="nn">parsons.utilities.api_connector</span> <span class="kn">import</span> <span class="n">APIConnector</span>
@@ -1434,7 +1434,7 @@ <h1>Source code for parsons.action_network.action_network</h1><div class="highli
         <span class="n">languages_spoken</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
         <span class="n">postal_addresses</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
         <span class="n">mobile_number</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-        <span class="n">mobile_status</span><span class="o">=</span><span class="s2">&quot;subscribed&quot;</span><span class="p">,</span>
+        <span class="n">mobile_status</span><span class="p">:</span> <span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;subscribed&quot;</span><span class="p">,</span> <span class="s2">&quot;unsubscribed&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
         <span class="n">background_processing</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>
     <span class="p">):</span>
@@ -1488,7 +1488,10 @@ <h1>Source code for parsons.action_network.action_network</h1><div class="highli
 <span class="sd">                            - &quot;subscribed&quot;</span>
 <span class="sd">                            - &quot;unsubscribed&quot;</span>
 <span class="sd">            mobile_status:</span>
-<span class="sd">                &#39;subscribed&#39; or &#39;unsubscribed&#39;</span>
+<span class="sd">                None, &#39;subscribed&#39; or &#39;unsubscribed&#39;. If included, will update the SMS opt-in</span>
+<span class="sd">                status of the phone in ActionNetwork. If not included, won&#39;t update the status.</span>
+<span class="sd">                None by default, causes no updates to mobile number status. New numbers are set</span>
+<span class="sd">                to &quot;unsubscribed&quot; by default.</span>
 <span class="sd">            background_request: bool</span>
 <span class="sd">                If set `true`, utilize ActionNetwork&#39;s &quot;background processing&quot;. This will return</span>
 <span class="sd">                an immediate success, with an empty JSON body, and send your request to the</span>
@@ -1518,27 +1521,31 @@ <h1>Source code for parsons.action_network.action_network</h1><div class="highli
 
         <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="kc">None</span>
         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
-            <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[</span>
-                <span class="p">{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s2">&quot;[^0-9]&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">,</span> <span class="n">mobile_number</span><span class="p">),</span> <span class="s2">&quot;status&quot;</span><span class="p">:</span> <span class="n">mobile_status</span><span class="p">}</span>
-            <span class="p">]</span>
+            <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s2">&quot;[^0-9]&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">,</span> <span class="n">mobile_number</span><span class="p">)}]</span>
         <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
-            <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">),</span> <span class="s2">&quot;status&quot;</span><span class="p">:</span> <span class="n">mobile_status</span><span class="p">}]</span>
+            <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">)}]</span>
         <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
             <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
                 <span class="k">raise</span> <span class="p">(</span><span class="s2">&quot;Action Network allows only 1 phone number per activist&quot;</span><span class="p">)</span>
             <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">list</span><span class="p">):</span>
                 <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[</span>
-                    <span class="p">{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s2">&quot;[^0-9]&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">,</span> <span class="n">cell</span><span class="p">),</span> <span class="s2">&quot;status&quot;</span><span class="p">:</span> <span class="n">mobile_status</span><span class="p">}</span>
-                    <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="n">mobile_number</span>
+                    <span class="p">{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="s2">&quot;[^0-9]&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">,</span> <span class="n">cell</span><span class="p">)}</span> <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="n">mobile_number</span>
                 <span class="p">]</span>
                 <span class="n">mobile_numbers_field</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s2">&quot;primary&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
             <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">int</span><span class="p">):</span>
-                <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[</span>
-                    <span class="p">{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="n">cell</span><span class="p">,</span> <span class="s2">&quot;status&quot;</span><span class="p">:</span> <span class="n">mobile_status</span><span class="p">}</span> <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="n">mobile_number</span>
-                <span class="p">]</span>
+                <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="p">[{</span><span class="s2">&quot;number&quot;</span><span class="p">:</span> <span class="n">cell</span><span class="p">}</span> <span class="k">for</span> <span class="n">cell</span> <span class="ow">in</span> <span class="n">mobile_number</span><span class="p">]</span>
                 <span class="n">mobile_numbers_field</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s2">&quot;primary&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">dict</span><span class="p">):</span>
-                <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="n">mobile_number</span>
+
+        <span class="c1"># Including status in this field changes the opt-in status in</span>
+        <span class="c1"># ActionNetwork. This is not always desireable, so we should</span>
+        <span class="c1"># only do so when a status is included.</span>
+        <span class="k">if</span> <span class="n">mobile_status</span> <span class="ow">and</span> <span class="n">mobile_numbers_field</span><span class="p">:</span>
+            <span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">mobile_numbers_field</span><span class="p">:</span>
+                <span class="n">field</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">mobile_status</span>
+
+        <span class="c1"># If the mobile_number field is passed a list of dictionaries, just use that directly</span>
+        <span class="k">if</span> <span class="n">mobile_number</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">,</span> <span class="nb">list</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mobile_number</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">dict</span><span class="p">):</span>
+            <span class="n">mobile_numbers_field</span> <span class="o">=</span> <span class="n">mobile_number</span>
 
         <span class="k">if</span> <span class="ow">not</span> <span class="n">email_addresses_field</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">mobile_numbers_field</span><span class="p">:</span>
             <span class="k">raise</span> <span class="p">(</span>
@@ -1568,6 +1575,7 @@ <h1>Source code for parsons.action_network.action_network</h1><div class="highli
         <span class="n">url</span> <span class="o">=</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">api_url</span><span class="si">}</span><span class="s2">/people&quot;</span>
         <span class="k">if</span> <span class="n">background_processing</span><span class="p">:</span>
             <span class="n">url</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">url</span><span class="si">}</span><span class="s2">?background_processing=true&quot;</span>
+
         <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">api</span><span class="o">.</span><span class="n">post_request</span><span class="p">(</span><span class="n">url</span><span class="p">,</span> <span class="n">data</span><span class="o">=</span><span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">data</span><span class="p">))</span>
 
         <span class="n">identifiers</span> <span class="o">=</span> <span class="n">response</span><span class="p">[</span><span class="s2">&quot;identifiers&quot;</span><span class="p">]</span>