airtable2 0.2.6 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 183776a7059c794118524cb86bf5d22bc59b94626cba3181dd6b3169f084b341
-  data.tar.gz: 983079a2e93fba3fd1b594743c7598ad9f8e62d8d2ee1ea46b15ef3ee9a63e84
+  metadata.gz: f1badb986f7b3fabd00b1311e03f91e95b16888ce75ebe31477b125975e5ae4b
+  data.tar.gz: d734810a0765508d23831fd5f777afcdf3f30df10fcdb27e240bc00c47c95292
 SHA512:
-  metadata.gz: 944fc1084b80554fba6071a29298c13bc888050af4450fccdff76b91ac4144a78e36d53bda708d2e7aa84c1902a90147f25344a1509e672f3468535903c3de24
-  data.tar.gz: ddc2f9d227aeaca38c8921efb305ace62ae888b125371057c73e8557901d7c517205b36b2a407417d4e4f5888418ca37b6f078e3c29b48f59cc558db0215d46e
+  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/base.rb

@@ -17,7 +17,7 @@ class Airtable::Base < Airtable::Resource
 
     check_and_raise_error(response)
 
-    Airtable::Table.new @token, @id, response
+    Airtable::Table.new @token, self, response['id'], response
   end
 
   # @return [Array<Airtable::Table>]

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.6'
+  VERSION = '0.2.8'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: airtable2
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  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