airctiverecord 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b646edd0e5f82349a4aeb249a12c8b56ee34b6fb1f090351341c1bb429a9edb
-  data.tar.gz: b5a8aaffeb5eb8fcc403f37dccb08f0fcbd4e51bc20c3e5a6ab63c170cf98b50
+  metadata.gz: ae3765d9f17173d90f9e6bbbce91fca4adaf5dbcf2543acacab671cb9ecb577c
+  data.tar.gz: ef36c911e89d741eb5f33d9a0bba89b2b866283e4f3d89cc447b089247ce36d4
 SHA512:
-  metadata.gz: 40749055a208071322ceaae739c4b93a2df42d1da1a19711fdc42db4dba1724fcb976b9ee876dcce8c4e2c4a72920187c7319e9c0aa6e04c54651767eef8293c
-  data.tar.gz: 41b2f812a0ba8b6a42e1c2b0bca4d8bc889d119668ef094348216e961c9bf67d8830a8bfffb620f69617e1eced2456af517005ea88908a1ad0eae4fe37ea8cf2
+  metadata.gz: c87e579fc0a84a2acfe7f6b9649606190672efec26d80c769432d5e135e80881cb3141410d8a0a3fabad55f48843883a345f667c08673889cae96fdcace44bc8
+  data.tar.gz: a110512bd802d6e5181bc982874ffce213a7c01f4055211a795deacaf0f888797cd68663fc7bdb3585318c80d2c182b93b125ba60f5b9a1f7be54ed754911004

data/README.md

@@ -106,6 +106,16 @@ user = User.first
 user = User.find_by(email: "alice@example.com")
 user = User.find_by!(email: "alice@example.com") # raises if not found
 
+# find or create
+user = User.find_or_create_by(email: "alice@example.com")
+user = User.find_or_create_by!(email: "alice@example.com") # raises on validation error
+
+# block is yielded to the new record only (not if found)
+user = User.find_or_create_by(email: "alice@example.com") do |u|
+  u.first_name = "Alice"
+  u.role = "admin"
+end
+
 # update
 user.update(first_name: "Alicia")
 user.first_name = "Alicia"
@@ -323,17 +333,21 @@ User.first(10)   # limit(10)
 
 **large tables**
 
-for tables with 25k+ records, process in batches:
+for tables with many records, use `find_each` or `find_in_batches`:
 
 ```ruby
-# batch processing
-offset = 0
-loop do
-  batch = User.limit(100).offset(offset).to_a
-  break if batch.empty?
-  batch.each { |user| process(user) }
-  offset += 100
+# process records one at a time (fetches in batches of 100 internally)
+User.where(active: true).find_each do |user|
+  process(user)
 end
+
+# process records in batches
+User.find_in_batches(batch_size: 50) do |batch|
+  bulk_import(batch)
+end
+
+# works with scopes and conditions
+User.active.admins.find_each(batch_size: 50) { |user| sync(user) }
 ```
 
 ## license

data/lib/airctiverecord/base.rb

@@ -35,8 +35,10 @@ module AirctiveRecord
       id = kwargs.delete(:id)
       created_at = kwargs.delete(:created_at)
 
-      # Merge positional hash and kwargs to handle both styles
-      all_attrs = attributes.is_a?(Hash) ? attributes.merge(kwargs) : kwargs
+      # Merge positional hash and kwargs to handle both styles.
+      # Call to_h to handle ActionController::Parameters, which is not a Hash subclass.
+      attr_hash = attributes.respond_to?(:to_h) ? attributes.to_h : {}
+      all_attrs = attr_hash.merge(kwargs)
 
       # Norairrecord::Table expects field names as STRING keys
       # We need to convert Ruby attribute names to Airtable field names
@@ -72,29 +74,25 @@ module AirctiveRecord
     def save(**options)
       return false unless valid?
 
-      begin
-        run_callbacks :save do
-          if new_record?
-            run_callbacks :create do
-              super(**options)
-            end
-          else
-            run_callbacks :update do
-              super(**options)
-            end
+      run_callbacks :save do
+        if new_record?
+          run_callbacks :create do
+            super(**options)
+          end
+        else
+          run_callbacks :update do
+            super(**options)
           end
         end
-        changes_applied
-        true
-      rescue StandardError
-        false
       end
+      changes_applied
+      true
     end
 
     def save!(**options)
       raise RecordInvalid, errors.full_messages.join(", ") unless valid?
 
-      save(**options) || raise(RecordNotSaved, "Failed to save record")
+      save(**options)
     end
 
     def update(attributes)

data/lib/airctiverecord/scoping.rb

@@ -36,6 +36,14 @@ module AirctiveRecord
 
       def find_by!(conditions) = all.find_by!(conditions)
 
+      def find_or_create_by(conditions, &block)
+        find_by(conditions) || new(conditions).tap { |r| block&.call(r) }.tap(&:save)
+      end
+
+      def find_or_create_by!(conditions, &block)
+        find_by(conditions) || new(conditions).tap { |r| block&.call(r) }.tap(&:save!)
+      end
+
       def first(limit = nil) = all.first(limit)
 
       def last(limit = nil) = all.last(limit)

data/lib/airctiverecord/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AirctiveRecord
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: airctiverecord
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - 24c02