airtable2 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cb8122de01b3500ed7e204ada1973d50aef0f4137592a2354205f2365294349
-  data.tar.gz: cddb9e3845811711a9fb7d7767aae1e14213cd9ba026931295bd1fbc26427c11
+  metadata.gz: f1badb986f7b3fabd00b1311e03f91e95b16888ce75ebe31477b125975e5ae4b
+  data.tar.gz: d734810a0765508d23831fd5f777afcdf3f30df10fcdb27e240bc00c47c95292
 SHA512:
-  metadata.gz: 1623bc5b488e6a99f6e4ec90e57afebf46262d02f80bd375c72b6852762dca527a5af9705707747bdd7f09c455376ed1657fabd6e1dc5f784f1241a511362156
-  data.tar.gz: 0140bf44f2a129e368c08ddec910267bc80565678055d70e1775fede397facd2360f12e8e9870e1c3f42787b94c28112dd824827527b785146cd8dbfb17bdf40
+  metadata.gz: 9b9e84cfbbc55b179fa9747d7ee27716ea517c9d3a7303f1eb2b59fe66817d6072b9cbc4beed3abdbd145f9f47ddf6ce59d53ae130e94c40e234240b451f501a
+  data.tar.gz: f966f605482ad29b80c83199dfc7e63085b16a847e5cb0df649de6e381aa983c94949f2d4c7ce1d19d3e7cd1e0b3ece316d7b83ddc95768c6e54bd4c14f543c8

data/README.md

@@ -108,6 +108,14 @@ A single record or an array of records can be inserted using the `create_records
 @table.create_records([{ 'Name': 'name value', 'Age': 35 }, { 'Name': 'another name value', 'Age': 40 }])
 ```
 
+You can upsert records by calling `upsert_records` and providing the field names to match to (also max 10 at a time):
+
+```ruby
+# Array
+records_to_upsert = [{ 'Name': 'name value', 'Age': 35 }, { 'Name': 'another name value', 'Age': 40 }]
+@table.upsert_records(records_to_upsert, ['Name'])
+```
+
 A single record or an array of records can be destroyed by passing their ids to the `delete_records` method on a table (max 10 at a time):
 
 ```ruby

data/lib/airtable/table.rb

@@ -71,6 +71,19 @@ class Airtable::Table < Airtable::Resource
     response['records'].map { Airtable::Record.new(@token, self, _1['id'], _1) }
   end
 
+  # @param [Array] Record objects to upsert
+  # @return [Array<Airtable::Record>]
+  # @see https://airtable.com/developers/web/api/update-multiple-records
+  # @note API maximum of 10 records at a time
+  def upsert_records(records, fields_to_merge_on)
+    response = self.class.patch(table_url,
+                                body: { performUpsert: { fieldsToMergeOn: fields_to_merge_on }, records: Array(records).map { |fields| { fields: } } }.to_json).parsed_response
+
+    check_and_raise_error(response)
+
+    response['records'].map { Airtable::Record.new(@token, self, _1['id'], _1) }
+  end
+
   # @param [Array] IDs of records to delete
   # @return [Array] Deleted record ids
   # @see https://airtable.com/developers/web/api/delete-multiple-records

data/lib/airtable/version.rb

@@ -2,5 +2,5 @@
 
 # Version
 module Airtable
-  VERSION = '0.2.7'
+  VERSION = '0.2.8'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: airtable2
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - Andrew Seroff
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-29 00:00:00.000000000 Z
+date: 2024-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty