couch_potato 1.19.2 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e1d161e4bd65577a3de846d945bc5787dbdacdec35c7e38f3129e8108cfa5a3
-  data.tar.gz: 967bcb265ed7886130a9fa79acb51a2f4420ec16e45ac7373d1b39a4895951c0
+  metadata.gz: 3550e8fe5b60fb064f2960a62313ee43e41e28c980c7c7d395d6c252fdb4fa20
+  data.tar.gz: 4aff0328b8e0e2162793c8b7f81643a5a3a43b703a64b00c57f044c12aac0ab0
 SHA512:
-  metadata.gz: f5b282eda9e2c8bcaf1ad191cd5f5f867dfc2ef406a6db2f079a5882b198149ef416e07ef3a3fd5ed7c82bbd5ddb9f82243cce16509dce0f8b7d7fa8d9e1768a
-  data.tar.gz: 713b759678703c0bbdf935e17405dd07f62f0b1e2d92a1afed81bde89620c16514320088887f275af8fcfc9114684f754687ed5306b1f8a52ca1bca3888c2407
+  metadata.gz: 676096f6f62795015a3bb26b6fe27689eda09aacb59f05c1f181a2922bc968fd762a9571ef02085425071212cf3ee1c688d36caaf06ee68dafe134d6bf9c04ae
+  data.tar.gz: 49582697b2508b97fc73a9a1a0590e6882f138577ea5ab6492746a61ab654b74170830cf9c61b4de1b36f002bd344b0b193f903dec6dc78e10f6a3f5d2c7c9d1

data/.github/workflows/ruby.yml

@@ -26,7 +26,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Set up CouchDB
-        uses: cobot/couchdb-action@v5
+        uses: cobot/couchdb-action@v5.0.1
         with:
           couchdb-version: "2.3.1"
       - name: Set up Ruby

data/CHANGES.md

@@ -1,5 +1,9 @@
 ## Changes
 
+# 1.20.0
+
+- add passing validation context to save methods
+
 # 1.19.2
 
 - fix 404/409 error when querying single design doc with `digest_view_names` enabled

data/lib/couch_potato/database.rb

@@ -105,17 +105,20 @@ module CouchPotato
     end
 
     # saves a document. returns true on success, false on failure.
+    # By default validations are run before saving. You can disable
+    # validations by passing validate: false as an option.
+    # You can also pass a custom validation context by passing context: :custom_context
     # if passed a block will:
     # * yield the object to be saved to the block and run if once before saving
     # * on conflict: reload the document, run the block again and retry saving
-    def save_document(document, validate = true, retries = 0, &block)
+    def save_document(document, options = {}, retries = 0, &block)
       cache&.clear
       begin
         block&.call document
-        save_document_without_conflict_handling(document, validate)
+        save_document_without_conflict_handling(document, options)
       rescue CouchRest::Conflict
         if block
-          handle_write_conflict document, validate, retries, &block
+          handle_write_conflict document, options, retries, &block
         else
           raise CouchPotato::Conflict
         end
@@ -124,8 +127,8 @@ module CouchPotato
     alias save save_document
 
     # saves a document, raises a CouchPotato::Database::ValidationsFailedError on failure
-    def save_document!(document)
-      save_document(document) || raise(ValidationsFailedError, document.errors.full_messages)
+    def save_document!(document, options = {})
+      save_document(document, options) || raise(ValidationsFailedError, document.errors.full_messages)
     end
     alias save! save_document!
 
@@ -293,7 +296,7 @@ module CouchPotato
       spec.send(:klass).to_s + spec.view_name.to_s + spec.view_parameters.to_s
     end
 
-    def handle_write_conflict(document, validate, retries, &block)
+    def handle_write_conflict(document, options, retries, &block)
       cache&.clear
       if retries == 5
         raise CouchPotato::Conflict
@@ -301,7 +304,7 @@ module CouchPotato
         reloaded = document.reload
         document.attributes = reloaded.attributes
         document._rev = reloaded._rev
-        save_document document, validate, retries + 1, &block
+        save_document document, options, retries + 1, &block
       end
     end
 
@@ -314,11 +317,11 @@ module CouchPotato
       document._rev = nil
     end
 
-    def save_document_without_conflict_handling(document, validate = true)
+    def save_document_without_conflict_handling(document, options = {})
       if document.new?
-        create_document(document, validate)
+        create_document(document, options)
       else
-        update_document(document, validate)
+        update_document(document, options)
       end
     end
 
@@ -337,14 +340,15 @@ module CouchPotato
       end
     end
 
-    def create_document(document, validate)
+    def create_document(document, options)
       document.database = self
+      validate, validation_context = parse_save_options(options)
 
       if validate
         document.errors.clear
         return false if document.run_callbacks(:validation_on_save) do
           return false if document.run_callbacks(:validation_on_create) do
-            return false unless valid_document?(document)
+            return false unless valid_document?(document, validation_context)
           end == false
         end == false
       end
@@ -360,12 +364,25 @@ module CouchPotato
       true
     end
 
-    def update_document(document, validate)
+    def parse_save_options(options)
+      if options.is_a?(Hash)
+        validate = options.fetch(:validate, true)
+        validation_context = options[:context]
+      else
+        validate = !!options
+        validation_context = nil
+      end
+      [validate, validation_context]
+    end
+
+    def update_document(document, options)
+      validate, validation_context = parse_save_options(options)
+
       if validate
         document.errors.clear
         return false if document.run_callbacks(:validation_on_save) do
           return false if document.run_callbacks(:validation_on_update) do
-            return false unless valid_document?(document)
+            return false unless valid_document?(document, validation_context)
           end == false
         end == false
       end
@@ -380,9 +397,9 @@ module CouchPotato
       true
     end
 
-    def valid_document?(document)
+    def valid_document?(document, validation_context = nil)
       original_errors_hash = document.errors.to_hash
-      document.valid?
+      document.valid?(validation_context)
       original_errors_hash.each do |k, v|
         if v.respond_to?(:each)
           v.each { |message| document.errors.add(k, message) }

data/lib/couch_potato/version.rb

@@ -1,4 +1,4 @@
 module CouchPotato
-  VERSION = '1.19.2'.freeze
+  VERSION = '1.20.0'.freeze
   RSPEC_VERSION = '4.2.0'.freeze
 end

data/spec/spec_helper.rb

@@ -39,6 +39,16 @@ class BigDecimalContainer
   property :number, type: BigDecimal
 end
 
+class WithValidationContext
+  include CouchPotato::Persistence
+
+  property :name
+
+  validates_presence_of :name, on: :create
+  validates_length_of :name, minimum: 5, on: :update
+  validates_length_of :name, minimum: 10, on: :custom
+end
+
 def recreate_db
   CouchPotato.couchrest_database.recreate!
 end

data/spec/validation_context_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+
+describe "validation context" do
+  let(:db) { CouchPotato.database }
+
+  context 'when calling save' do
+    
+    it 'uses the :create context on creation' do
+      model = WithValidationContext.new
+
+      db.save(model)
+
+      expect(model.errors[:name]).to eq(["can't be blank"])
+    end
+
+    it 'uses the :update context on update' do
+      model = WithValidationContext.new(name: 'initial name')
+      db.save!(model)
+
+      model.name = 'new'
+      db.save(model)
+
+      expect(model.errors[:name]).to eq(["is too short (minimum is 5 characters)"])
+    end
+
+    it 'uses a custom context on create when specified' do
+      model = WithValidationContext.new(name: 'short')
+      
+      db.save(model, context: :custom)
+
+      expect(model.errors[:name]).to eq(["is too short (minimum is 10 characters)"])
+    end
+
+    it 'uses a custom context on update when specified' do
+      model = WithValidationContext.new(name: 'initial name')
+      db.save!(model)
+
+      model.name = 'new'
+      db.save(model, context: :custom)
+
+      expect(model.errors[:name]).to eq(["is too short (minimum is 10 characters)"])
+    end
+
+  end
+
+  context 'when calling save!' do
+    
+    it 'uses the :create context on creation' do
+      model = WithValidationContext.new
+
+      expect do
+        db.save!(model)
+      end.to raise_error(CouchPotato::Database::ValidationsFailedError, /Name can't be blank/)
+    end
+
+    it 'uses the :update context on update' do
+      model = WithValidationContext.new(name: 'initial name')
+      db.save!(model)
+
+      model.name = 'new'
+      expect do
+        db.save!(model)
+      end.to raise_error(CouchPotato::Database::ValidationsFailedError, /Name is too short \(minimum is 5 characters\)/)
+    end
+
+    it 'uses a custom context on create when specified' do
+      model = WithValidationContext.new(name: 'short')
+
+      expect do
+        db.save!(model, context: :custom)
+      end.to raise_error(CouchPotato::Database::ValidationsFailedError, /Name is too short \(minimum is 10 characters\)/)
+    end
+
+    it 'uses a custom context on update when specified' do
+      model = WithValidationContext.new(name: 'initial name')
+      db.save!(model)
+
+      model.name = 'new'
+      expect do
+        db.save!(model, context: :custom)
+      end.to raise_error(CouchPotato::Database::ValidationsFailedError, /Name is too short \(minimum is 10 characters\)/)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: couch_potato
 version: !ruby/object:Gem::Version
-  version: 1.19.2
+  version: 1.20.0
 platform: ruby
 authors:
 - Alexander Lang
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-08 00:00:00.000000000 Z
+date: 2025-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -207,6 +207,7 @@ files:
 - spec/unit/validation_spec.rb
 - spec/unit/view_query_spec.rb
 - spec/update_spec.rb
+- spec/validation_context_spec.rb
 - spec/view_updates_spec.rb
 - spec/views_spec.rb
 - vendor/pouchdb-collate/LICENSE
@@ -275,5 +276,6 @@ test_files:
 - spec/unit/validation_spec.rb
 - spec/unit/view_query_spec.rb
 - spec/update_spec.rb
+- spec/validation_context_spec.rb
 - spec/view_updates_spec.rb
 - spec/views_spec.rb