[skip ci] Updates

html/latest/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: c0aa1c538e7198450f57e3e1882e7651
+config: 3157411cc0eedc813844e9b15493c628
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/latest/airtable.html

@@ -61,6 +61,10 @@
 <li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.insert_record"><code class="docutils literal notranslate"><span class="pre">Airtable.insert_record()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.insert_records"><code class="docutils literal notranslate"><span class="pre">Airtable.insert_records()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.update_record"><code class="docutils literal notranslate"><span class="pre">Airtable.update_record()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.update_records"><code class="docutils literal notranslate"><span class="pre">Airtable.update_records()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.upsert_records"><code class="docutils literal notranslate"><span class="pre">Airtable.upsert_records()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.delete_record"><code class="docutils literal notranslate"><span class="pre">Airtable.delete_record()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#parsons.Airtable.delete_records"><code class="docutils literal notranslate"><span class="pre">Airtable.delete_records()</span></code></a></li>
 </ul>
 </li>
 </ul>
@@ -219,10 +223,12 @@ <h2>API<a class="headerlink" href="#api" title="Permalink to this heading"></
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">parsons.</span></span><span class="sig-name descname"><span class="pre">Airtable</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">base_key</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">table_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">personal_access_token</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable" title="Permalink to this definition"></a></dt>
 <dd><dl class="simple">
 <dt><cite>Args:</cite></dt><dd><dl class="simple">
-<dt>base_key: str</dt><dd><p>The key of the Airtable base that you will interact with.</p>
+<dt>base_key: str</dt><dd><p>The key/ID of the Airtable base that you will interact with, typically
+prefixed with <cite>app</cite>.</p>
 </dd>
-<dt>table_name: str</dt><dd><p>The name of the table in the base. The table name is the equivilant of the sheet name
-in Excel or GoogleDocs.</p>
+<dt>table_name: str</dt><dd><p>The name or key/ID of the table in the base. The table name is the
+equivalent of the sheet name in Excel or GoogleDocs. The ID can be
+found in the URL and is typically prefixed with <cite>tbl</cite>.</p>
 </dd>
 <dt>personal_access_token: str</dt><dd><p>The Airtable personal access token. Not required if <code class="docutils literal notranslate"><span class="pre">AIRTABLE_PERSONAL_ACCESS_TOKEN</span></code>
 env variable set.</p>
@@ -236,7 +242,7 @@ <h2>API<a class="headerlink" href="#api" title="Permalink to this heading"></
 <dd><p>Returns a single record.</p>
 <dl class="simple">
 <dt><cite>Args:</cite></dt><dd><dl class="simple">
-<dt>record_id: str</dt><dd><p>The Airtable record id</p>
+<dt>record_id: str</dt><dd><p>The Airtable record <cite>id</cite></p>
 </dd>
 </dl>
 </dd>
@@ -293,7 +299,7 @@ <h2>API<a class="headerlink" href="#api" title="Permalink to this heading"></
 
 <dl class="py method">
 <dt class="sig sig-object py" id="parsons.Airtable.insert_record">
-<span class="sig-name descname"><span class="pre">insert_record</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">row</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.insert_record"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.insert_record" title="Permalink to this definition"></a></dt>
+<span class="sig-name descname"><span class="pre">insert_record</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">row</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">typecast</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.insert_record"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.insert_record" title="Permalink to this definition"></a></dt>
 <dd><p>Insert a single record into an Airtable.</p>
 <dl class="simple">
 <dt><cite>Args:</cite></dt><dd><dl class="simple">
@@ -329,20 +335,110 @@ <h2>API<a class="headerlink" href="#api" title="Permalink to this heading"></
 
 <dl class="py method">
 <dt class="sig sig-object py" id="parsons.Airtable.update_record">
-<span class="sig-name descname"><span class="pre">update_record</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">record_id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">fields</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">typecast</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.update_record"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.update_record" title="Permalink to this definition"></a></dt>
-<dd><p>Updates a record by its record id. Only Fields passed are updated, the rest are left as
+<span class="sig-name descname"><span class="pre">update_record</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">record_id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">fields</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">typecast</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">replace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.update_record"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.update_record" title="Permalink to this definition"></a></dt>
+<dd><p>Updates a record by its record <cite>id</cite>. Only Fields passed are updated, the rest are left as
 is.</p>
 <dl class="simple">
 <dt><cite>Args:</cite></dt><dd><dl class="simple">
-<dt>record_id: str</dt><dd><p>The Airtable record id</p>
+<dt>record_id: str</dt><dd><p>The Airtable record <cite>id</cite></p>
 </dd>
 <dt>fields: dict</dt><dd><p>Fields to insert. Must be dictionary with Column names as Key.</p>
 </dd>
 <dt>typecast: boolean</dt><dd><p>Automatic data conversion from string values.</p>
 </dd>
+<dt>replace: boolean</dt><dd><p>Only provided fields are updated. If <cite>True</cite>, record is replaced in its
+entirety by provided fields; if a field is not included its value
+will bet set to null.</p>
+</dd>
+</dl>
+</dd>
+<dt><cite>Returns:</cite></dt><dd><p>Dictionary of updated row</p>
+</dd>
 </dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="parsons.Airtable.update_records">
+<span class="sig-name descname"><span class="pre">update_records</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">typecast</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">replace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.update_records"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.update_records" title="Permalink to this definition"></a></dt>
+<dd><p>Update multiple records into an Airtable. The columns in your Parsons table must
+exist in the Airtable, and the record <cite>id</cite> column must be present. The method
+will attempt to map based on column name, so the order of the columns is irrelevant.</p>
+<dl class="simple">
+<dt><cite>Args:</cite></dt><dd><dl class="simple">
+<dt>table: A Parsons Table or list of dicts</dt><dd><p>Insert a Parsons table or list. Record must contain the record <cite>id</cite> column
+and columns containing the fields to update</p>
+</dd>
+<dt>typecast: boolean</dt><dd><p>Automatic data conversion from string values.</p>
+</dd>
+<dt>replace: boolean</dt><dd><p>Only provided fields are updated. If <cite>True</cite>, record is replaced in its
+entirety by provided fields; if a field is not included its value
+will bet set to null.</p>
+</dd>
+</dl>
+</dd>
+<dt><cite>Returns:</cite></dt><dd><p>List of dicts of updated records</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="parsons.Airtable.upsert_records">
+<span class="sig-name descname"><span class="pre">upsert_records</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">key_fields</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">typecast</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">replace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.upsert_records"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.upsert_records" title="Permalink to this definition"></a></dt>
+<dd><p>Update and/or create records, either using <cite>id</cite> (if included) or using a set of
+fields (<cite>key_fields</cite>) to look for matches. The columns in your Parsons table must
+exist in the Airtable. The method will attempt to map based on column name,
+so the order of the columns is irrelevant.</p>
+<dl class="simple">
+<dt><cite>Args:</cite></dt><dd><dl class="simple">
+<dt>table: A Parsons Table or list of dicts</dt><dd><p>Parsons table or list with records to upsert. Records must contain the record
+<cite>id</cite> column or the column(s) defined in <cite>key_fields</cite>.</p>
+</dd>
+<dt>key_fields: list of str</dt><dd><p>List of field names that Airtable should use to match records in the input
+with existing records.</p>
+</dd>
+<dt>typecast: boolean</dt><dd><p>Automatic data conversion from string values.</p>
+</dd>
+<dt>replace: boolean</dt><dd><p>Only provided fields are updated. If <cite>True</cite>, record is replaced in its
+entirety by provided fields; if a field is not included its value
+will bet set to null.</p>
+</dd>
+</dl>
+</dd>
+<dt><cite>Returns:</cite></dt><dd><dl class="simple">
+<dt>Dictionary containing:</dt><dd><ul class="simple">
+<li><p><cite>updated_records</cite>: list of updated record <a href="#id2"><span class="problematic" id="id3">`</span></a>id`s</p></li>
+<li><p><cite>created_records</cite>: list of created records <a href="#id4"><span class="problematic" id="id5">`</span></a>id`s</p></li>
+<li><p><cite>records</cite>: list of records</p></li>
+</ul>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="parsons.Airtable.delete_record">
+<span class="sig-name descname"><span class="pre">delete_record</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">record_id</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.delete_record"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.delete_record" title="Permalink to this definition"></a></dt>
+<dd><p>Deletes a record by its record <cite>id</cite>.</p>
+<dl class="simple">
+<dt><cite>Args:</cite></dt><dd><dl class="simple">
+<dt>record_id: str</dt><dd><p>The Airtable record <cite>id</cite></p>
+</dd>
+</dl>
+</dd>
+<dt><cite>Returns:</cite></dt><dd><p>Dictionary of record <cite>id</cite> and <cite>deleted</cite> status</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="parsons.Airtable.delete_records">
+<span class="sig-name descname"><span class="pre">delete_records</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">table</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/airtable/airtable.html#Airtable.delete_records"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.Airtable.delete_records" title="Permalink to this definition"></a></dt>
+<dd><p>Delete multiple records from an Airtable.</p>
+<dl class="simple">
+<dt><cite>Args:</cite></dt><dd><p>table: A Parsons Table or list containing the record <a href="#id6"><span class="problematic" id="id7">`</span></a>id`s to delete.</p>
 </dd>
-<dt><cite>Returns:</cite></dt><dd><p><code class="docutils literal notranslate"><span class="pre">None</span></code></p>
+<dt><cite>Returns:</cite></dt><dd><p>List of dicts with record <cite>id</cite> and <cite>deleted</cite> status</p>
 </dd>
 </dl>
 </dd></dl>

html/latest/genindex.html

@@ -598,9 +598,15 @@ <h2 id="D">D</h2>
 </li>
       <li><a href="ngpvan.html#parsons.ngpvan.van.SupporterGroups.delete_person_supporter_group">delete_person_supporter_group() (parsons.ngpvan.van.SupporterGroups method)</a>
 </li>
+      <li><a href="airtable.html#parsons.Airtable.delete_record">delete_record() (parsons.Airtable method)</a>
+
+      <ul>
+        <li><a href="salesforce.html#parsons.Salesforce.delete_record">(parsons.Salesforce method)</a>
+</li>
+      </ul></li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="salesforce.html#parsons.Salesforce.delete_record">delete_record() (parsons.Salesforce method)</a>
+      <li><a href="airtable.html#parsons.Airtable.delete_records">delete_records() (parsons.Airtable method)</a>
 </li>
       <li><a href="sisense.html#parsons.Sisense.delete_shared_dashboard">delete_shared_dashboard() (parsons.Sisense method)</a>
 </li>
@@ -2064,8 +2070,6 @@ <h2 id="U">U</h2>
 </li>
       <li><a href="action_kit.html#parsons.ActionKit.update_paymenttoken">update_paymenttoken() (parsons.ActionKit method)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="action_network.html#parsons.ActionNetwork.update_person">update_person() (parsons.ActionNetwork method)</a>
 
       <ul>
@@ -2074,6 +2078,8 @@ <h2 id="U">U</h2>
         <li><a href="ngpvan.html#parsons.ngpvan.van.People.update_person">(parsons.ngpvan.van.People method)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="ngpvan.html#parsons.ngpvan.van.People.update_person_json">update_person_json() (parsons.ngpvan.van.People method)</a>
 </li>
       <li><a href="action_network.html#parsons.ActionNetwork.update_petition">update_petition() (parsons.ActionNetwork method)</a>
@@ -2086,6 +2092,8 @@ <h2 id="U">U</h2>
         <li><a href="salesforce.html#parsons.Salesforce.update_record">(parsons.Salesforce method)</a>
 </li>
       </ul></li>
+      <li><a href="airtable.html#parsons.Airtable.update_records">update_records() (parsons.Airtable method)</a>
+</li>
       <li><a href="ngpvan.html#parsons.ngpvan.van.Scores.update_score_status">update_score_status() (parsons.ngpvan.van.Scores method)</a>
 </li>
       <li><a href="action_network.html#parsons.ActionNetwork.update_signature">update_signature() (parsons.ActionNetwork method)</a>
@@ -2143,6 +2151,8 @@ <h2 id="U">U</h2>
       <li><a href="ngpvan.html#parsons.ngpvan.van.People.upsert_person_json">upsert_person_json() (parsons.ngpvan.van.People method)</a>
 </li>
       <li><a href="salesforce.html#parsons.Salesforce.upsert_record">upsert_record() (parsons.Salesforce method)</a>
+</li>
+      <li><a href="airtable.html#parsons.Airtable.upsert_records">upsert_records() (parsons.Airtable method)</a>
 </li>
       <li><a href="auth0.html#parsons.Auth0.upsert_user">upsert_user() (parsons.Auth0 method)</a>
 </li>

html/stable/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: d7cce6a207189c01be1287a301e31d3b
+config: 9eccfdad2bd332a947b8a16376bf27dd
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.14.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: d73e9d313170d5e19d7db0693f544ac2
+config: b533e4c3ccdc7d32a089a7957b5c1a9d
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.15.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 62a16bfae65cc9eef5546a7826113673
+config: c2cb8d5e255d26d070905aeb319774c8
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.16.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: ff5049747c11e2c8284537d0e7ba42cb
+config: 4a9d08c70ff239bd64377a290abbc6ea
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.17.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 1699bb561ac5ea43dcf7b8d0716838a8
+config: ceff5a501728188a5b76b6ef591243bb
 tags: 645f666f9bcd5a90fca523b33c5a78b7