mongoid 9.0.11 → 9.1.0

data/spec/mongoid/touchable_spec.rb

@@ -1,23 +1,20 @@
 # frozen_string_literal: true
-# rubocop:todo all
 
-require "spec_helper"
-require_relative './touchable_spec_models'
+require 'spec_helper'
+require_relative 'touchable_spec_models'
 
 describe Mongoid::Touchable do
-
-  describe "#touch" do
-
-    context "when the document has no associations" do
+  describe '#touch' do
+    context 'when the document has no associations' do
       let(:updatable) do
         Updatable.create!
       end
 
-      it "responds to #touch" do
+      it 'responds to #touch' do
         expect(updatable).to respond_to(:touch)
       end
 
-      it "updates the timestamp when called" do
+      it 'updates the timestamp when called' do
         expect(updatable.updated_at).to be_nil
 
         updatable.touch
@@ -35,7 +32,6 @@ describe Mongoid::Touchable do
     end
 
     context 'when the document has a parent association' do
-
       let(:building) do
         parent_cls.create!
       end
@@ -59,7 +55,7 @@ describe Mongoid::Touchable do
       end
 
       shared_examples 'updates the child' do
-        it "updates the updated_at timestamp" do
+        it 'updates the updated_at timestamp' do
           entrance
           update_time
           entrance.touch
@@ -67,7 +63,7 @@ describe Mongoid::Touchable do
           expect(entrance.updated_at).to eq(update_time)
         end
 
-        it "persists the changes" do
+        it 'persists the changes' do
           entrance
           update_time
           entrance.touch
@@ -77,7 +73,6 @@ describe Mongoid::Touchable do
       end
 
       shared_examples 'updates the parent when :touch is true' do
-
         it 'updates updated_at on parent' do
           floor
           update_time
@@ -117,7 +112,7 @@ describe Mongoid::Touchable do
         it_behaves_like 'does not update the parent when :touch is false'
       end
 
-      context "when the document is embedded" do
+      context 'when the document is embedded' do
         let(:parent_cls) { TouchableSpec::Embedded::Building }
 
         include_examples 'updates the child'
@@ -161,7 +156,7 @@ describe Mongoid::Touchable do
         end
       end
 
-      context "when the document is referenced" do
+      context 'when the document is referenced' do
         let(:parent_cls) { TouchableSpec::Referenced::Building }
 
         include_examples 'updates the child'
@@ -170,164 +165,152 @@ describe Mongoid::Touchable do
       end
     end
 
-    context "when no relations have touch options" do
-
-      context "when no updated at is defined" do
-
+    context 'when no relations have touch options' do
+      context 'when no updated at is defined' do
         let(:person) do
           Person.create!
         end
 
-        context "when no attribute is provided" do
-
+        context 'when no attribute is provided' do
           let!(:touched) do
             person.touch
           end
 
-          it "returns true" do
+          it 'returns true' do
             expect(touched).to be true
           end
 
-          it "does not set the updated at field" do
+          it 'does not set the updated at field' do
             expect(person[:updated_at]).to be_nil
           end
         end
 
-        context "when an attribute is provided" do
-
+        context 'when an attribute is provided' do
           let!(:touched) do
             person.touch(:lunch_time)
           end
 
-          it "sets the attribute to the current time" do
+          it 'sets the attribute to the current time' do
             expect(person.lunch_time).to be_within(5).of(Time.now)
           end
 
-          it "persists the change" do
+          it 'persists the change' do
             expect(person.reload.lunch_time).to be_within(5).of(Time.now)
           end
 
-          it "returns true" do
+          it 'returns true' do
             expect(touched).to be true
           end
         end
 
-        context "when an attribute alias is provided" do
-
+        context 'when an attribute alias is provided' do
           let!(:touched) do
             person.touch(:aliased_timestamp)
           end
 
-          it "sets the attribute to the current time" do
+          it 'sets the attribute to the current time' do
             expect(person.aliased_timestamp).to be_within(5).of(Time.now)
           end
 
-          it "persists the change" do
+          it 'persists the change' do
             expect(person.reload.aliased_timestamp).to be_within(5).of(Time.now)
           end
 
-          it "returns true" do
+          it 'returns true' do
             expect(touched).to be true
           end
         end
       end
 
-      context "when an updated at is defined" do
-
+      context 'when an updated at is defined' do
         let!(:agent) do
           Agent.create!(updated_at: 2.days.ago)
         end
 
-        context "when no attribute is provided" do
-
+        context 'when no attribute is provided' do
           let!(:touched) do
             agent.touch
           end
 
-          it "sets the updated at to the current time" do
+          it 'sets the updated at to the current time' do
             expect(agent.updated_at).to be_within(5).of(Time.now)
           end
 
-          it "persists the change" do
+          it 'persists the change' do
             expect(agent.reload.updated_at).to be_within(5).of(Time.now)
           end
 
-          it "returns true" do
+          it 'returns true' do
             expect(touched).to be true
           end
 
-          it "clears changes" do
+          it 'clears changes' do
             expect(agent.changes).to be_empty
           end
         end
 
-        context "when an attribute is provided" do
-
+        context 'when an attribute is provided' do
           let!(:touched) do
             agent.touch(:dob)
           end
 
-          it "sets the updated at to the current time" do
+          it 'sets the updated at to the current time' do
             expect(agent.updated_at).to be_within(5).of(Time.now)
           end
 
-          it "sets the attribute to the current time" do
+          it 'sets the attribute to the current time' do
             expect(agent.dob).to be_within(5).of(Time.now)
           end
 
-          it "sets both attributes to the exact same time" do
+          it 'sets both attributes to the exact same time' do
             expect(agent.updated_at).to eq(agent.dob)
           end
 
-          it "persists the updated at change" do
+          it 'persists the updated at change' do
             expect(agent.reload.updated_at).to be_within(5).of(Time.now)
           end
 
-          it "persists the attribute change" do
+          it 'persists the attribute change' do
             expect(agent.reload.dob).to be_within(5).of(Time.now)
           end
 
-          it "returns true" do
+          it 'returns true' do
             expect(touched).to be true
           end
 
-          it "clears changes" do
+          it 'clears changes' do
             expect(agent.changes).to be_empty
           end
         end
       end
 
-      context "when record is new" do
-
+      context 'when record is new' do
         let!(:agent) do
           Agent.new(updated_at: 2.days.ago)
         end
 
-        context "when no attribute is provided" do
-
+        context 'when no attribute is provided' do
           let(:touched) do
             agent.touch
           end
 
-          it "returns false" do
+          it 'returns false' do
             expect(touched).to be false
           end
         end
 
-        context "when an attribute is provided" do
-
+        context 'when an attribute is provided' do
           let(:touched) do
             agent.touch(:dob)
           end
 
-          it "returns false" do
+          it 'returns false' do
             expect(touched).to be false
           end
         end
       end
 
-      context "when record is destroyed" do
-
+      context 'when record is destroyed' do
         let!(:agent) do
           Agent.create!(updated_at: 2.days.ago).tap do |agent|
             agent.destroy
@@ -338,26 +321,24 @@ describe Mongoid::Touchable do
           FrozenError
         end
 
-        context "when no attribute is provided" do
-
+        context 'when no attribute is provided' do
           let(:touched) do
             agent.touch
           end
 
-          it "raises FrozenError" do
+          it 'raises FrozenError' do
             expect do
               touched
             end.to raise_error(frozen_error_cls)
           end
         end
 
-        context "when an attribute is provided" do
-
+        context 'when an attribute is provided' do
           let(:touched) do
             agent.touch(:dob)
           end
 
-          it "raises FrozenError" do
+          it 'raises FrozenError' do
             expect do
               touched
             end.to raise_error(frozen_error_cls)
@@ -365,8 +346,7 @@ describe Mongoid::Touchable do
         end
       end
 
-      context "when creating the child" do
-
+      context 'when creating the child' do
         let(:time) do
           Time.utc(2012, 4, 3, 12)
         end
@@ -381,18 +361,16 @@ describe Mongoid::Touchable do
           jar.cookies.create!(updated_at: time)
         end
 
-        it "does not touch the parent" do
+        it 'does not touch the parent' do
           expect(jar.updated_at).to eq(time)
         end
       end
     end
 
-    context "when relations have touch options" do
-
-      context "when the relation is a parent of an embedded doc" do
-
+    context 'when relations have touch options' do
+      context 'when the relation is a parent of an embedded doc' do
         let(:page) do
-          WikiPage.create!(title: "test")
+          WikiPage.create!(title: 'test')
         end
 
         let!(:edit) do
@@ -404,13 +382,12 @@ describe Mongoid::Touchable do
           edit.touch
         end
 
-        it "touches the parent document" do
+        it 'touches the parent document' do
           expect(page.updated_at).to be_within(5).of(Time.now)
         end
       end
 
-      context "when the parent of embedded doc has cascade callbacks" do
-
+      context 'when the parent of embedded doc has cascade callbacks' do
         let!(:book) do
           Book.new
         end
@@ -422,13 +399,12 @@ describe Mongoid::Touchable do
           book.pages.first.touch
         end
 
-        it "touches the parent document" do
+        it 'touches the parent document' do
           expect(book.updated_at).to be_within(5).of(Time.now)
         end
       end
 
-      context "when multiple embedded docs with cascade callbacks" do
-
+      context 'when multiple embedded docs with cascade callbacks' do
         let!(:book) do
           Book.new
         end
@@ -437,36 +413,33 @@ describe Mongoid::Touchable do
           2.times { book.pages.new }
           book.save!
           book.unset(:updated_at)
-          book.pages.first.content  = "foo"
-          book.pages.second.content = "bar"
+          book.pages.first.content  = 'foo'
+          book.pages.second.content = 'bar'
           book.pages.first.touch
         end
 
-        it "touches the parent document" do
+        it 'touches the parent document' do
           expect(book.updated_at).to be_within(5).of(Time.now)
         end
       end
 
-      context "when the relation is nil" do
-
+      context 'when the relation is nil' do
         let!(:agent) do
           Agent.create!
         end
 
-        context "when the relation autobuilds" do
-
+        context 'when the relation autobuilds' do
           let!(:touched) do
             agent.touch
           end
 
-          it "does nothing to the relation" do
+          it 'does nothing to the relation' do
             expect(agent.instance_variable_get(:@agency)).to be_nil
           end
         end
       end
 
-      context "when the relation is not nil" do
-
+      context 'when the relation is not nil' do
         let!(:agent) do
           Agent.create!
         end
@@ -481,17 +454,16 @@ describe Mongoid::Touchable do
           agent.touch
         end
 
-        it "sets the parent updated at to the current time" do
+        it 'sets the parent updated at to the current time' do
           expect(agency.updated_at).to be_within(5).of(Time.now)
         end
 
-        it "persists the change" do
+        it 'persists the change' do
           expect(agency.reload.updated_at).to be_within(5).of(Time.now)
         end
       end
 
-      context "when creating the child" do
-
+      context 'when creating the child' do
         let!(:agency) do
           Agency.create!
         end
@@ -505,12 +477,11 @@ describe Mongoid::Touchable do
         end
 
         it "updates the parent's updated at" do
-          expect(agency.updated_at).to_not eq(updated)
+          expect(agency.updated_at).not_to eq(updated)
         end
       end
 
-      context "when modifying the child" do
-
+      context 'when modifying the child' do
         let!(:agency) do
           Agency.create!
         end
@@ -520,14 +491,13 @@ describe Mongoid::Touchable do
         end
 
         it "updates the parent's updated at" do
-          expect {
+          expect do
             agent.update_attributes!(number: '2')
-          }.to change { agency.updated_at }
+          end.to(change { agency.updated_at })
         end
       end
 
-      context "when destroying the child" do
-
+      context 'when destroying the child' do
         let!(:agency) do
           Agency.create!
         end
@@ -545,46 +515,43 @@ describe Mongoid::Touchable do
         end
 
         it "updates the parent's updated at" do
-          expect(agency.updated_at).to_not eq(updated)
+          expect(agency.updated_at).not_to eq(updated)
         end
       end
     end
 
-    context "when other document attributes have been changed" do
-
+    context 'when other document attributes have been changed' do
       let(:band) do
-        Band.create!(name: "Placebo")
+        Band.create!(name: 'Placebo')
       end
 
-      context "when an attribute is provided" do
+      context 'when an attribute is provided' do
         before do
           band.name = 'Nocebo'
           band.touch(:last_release)
         end
 
-        it "does not persist other attribute changes" do
+        it 'does not persist other attribute changes' do
           expect(band.name).to eq('Nocebo')
           expect(band.reload.name).not_to eq('Nocebo')
         end
       end
 
-      context "when an attribute is not provided" do
+      context 'when an attribute is not provided' do
         before do
           band.name = 'Nocebo'
           band.touch
         end
 
-        it "does not persist other attribute changes" do
+        it 'does not persist other attribute changes' do
           expect(band.name).to eq('Nocebo')
           expect(band.reload.name).not_to eq('Nocebo')
         end
       end
     end
 
-    context "when the touch option is true" do
-
+    context 'when the touch option is true' do
       shared_examples "updates the parent's updated_at" do
-
         let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
 
         let(:update_time) do
@@ -610,8 +577,8 @@ describe Mongoid::Touchable do
           floor.send(meth)
         end
 
-        it "the parent is not nil" do
-          expect(floor.building).to_not be nil
+        it 'the parent is not nil' do
+          expect(floor.building).not_to be_nil
         end
 
         it "updates the parent's timestamp" do
@@ -621,7 +588,6 @@ describe Mongoid::Touchable do
       end
 
       shared_examples "updates the child's updated_at" do
-
         let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
 
         let(:update_time) do
@@ -647,17 +613,17 @@ describe Mongoid::Touchable do
           floor.send(meth)
         end
 
-        it "the parent is not nil" do
-          expect(floor.building).to_not be nil
+        it 'the parent is not nil' do
+          expect(floor.building).not_to be_nil
         end
 
         it "updates the child's timestamp" do
-          floor.updated_at.should == update_time
-          floor.reload.updated_at.should == update_time
+          floor.updated_at.should eq update_time
+          floor.reload.updated_at.should eq update_time
         end
       end
 
-      [ :save!, :destroy, :touch].each do |meth|
+      %i[save! destroy touch].each do |meth|
         context "with #{meth} on referenced associations" do
           let(:parent_cls) { TouchableSpec::Referenced::Building }
           let(:meth) { meth }
@@ -676,9 +642,8 @@ describe Mongoid::Touchable do
       end
     end
 
-    context "when the touch option is false" do
-
-      shared_examples "does not update the parent" do
+    context 'when the touch option is false' do
+      shared_examples 'does not update the parent' do
         let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
         let(:update_time) { Timecop.freeze(Time.at(Time.now.to_i) + 2) }
 
@@ -716,27 +681,25 @@ describe Mongoid::Touchable do
         end
       end
 
-      [ :save!, :destroy, :touch].each do |meth|
+      %i[save! destroy touch].each do |meth|
         context "with #{meth} on belongs_to" do
           let(:meth) { meth }
           let(:parent_cls) { TouchableSpec::Referenced::Building }
 
-          include_examples "does not update the parent"
+          include_examples 'does not update the parent'
         end
 
         context "with #{meth} on embedded_in" do
           let(:meth) { meth }
           let(:parent_cls) { TouchableSpec::Embedded::Building }
 
-          include_examples "does not update the parent"
+          include_examples 'does not update the parent'
         end
       end
     end
 
-    context "when a custom field is specified" do
-
+    context 'when a custom field is specified' do
       shared_examples "updates the child's updated_at" do
-
         let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
 
         let(:update_time) { Timecop.freeze(Time.at(Time.now.to_i) + 2) }
@@ -765,7 +728,6 @@ describe Mongoid::Touchable do
       end
 
       shared_examples "updates the parent's custom field and updated_at" do
-
         let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
 
         let(:update_time) { Timecop.freeze(Time.at(Time.now.to_i) + 2) }
@@ -796,12 +758,12 @@ describe Mongoid::Touchable do
           expect(label.updated_at).to eq(update_time)
           expect(label.reload.updated_at).to eq(update_time)
         end
-
       end
 
-      [:save, :destroy, :touch].each do |meth|
+      %i[save destroy touch].each do |meth|
         context "with #{meth} on referenced associations" do
           let(:meth) { meth }
+
           include_examples "updates the child's updated_at" unless meth == :destroy
           include_examples "updates the parent's custom field and updated_at"
         end
@@ -809,7 +771,6 @@ describe Mongoid::Touchable do
     end
 
     context 'multi-level' do
-
       let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
 
       let(:update_time) { Timecop.freeze(Time.at(Time.now.to_i) + 2) }
@@ -836,35 +797,35 @@ describe Mongoid::Touchable do
         grandchild
       end
 
-      shared_examples "updates the parent" do
+      shared_examples 'updates the parent' do
         it "updates the parent's timestamp" do
           expect(parent.updated_at).to eq(update_time)
           expect(parent.reload.updated_at).to eq(update_time)
         end
       end
 
-      shared_examples "does not update the parent" do
+      shared_examples 'does not update the parent' do
         it "does not update the parent's timestamp" do
           expect(parent.updated_at).to eq(start_time)
           expect(parent.reload.updated_at).to eq(start_time)
         end
       end
 
-      shared_examples "updates the child" do
+      shared_examples 'updates the child' do
         it "updates the child's timestamp" do
           expect(child.updated_at).to eq(update_time)
           expect(child.reload.updated_at).to eq(update_time)
         end
       end
 
-      shared_examples "does not update the child" do
+      shared_examples 'does not update the child' do
         it "does not update the child's timestamp" do
           expect(child.updated_at).to eq(start_time)
           expect(child.reload.updated_at).to eq(start_time)
         end
       end
 
-      shared_examples "updates the grandchild" do
+      shared_examples 'updates the grandchild' do
         it "updates the grandchild's timestamp" do
           if grandchild.destroyed?
             expect(grandchild.updated_at).to eq(start_time)
@@ -875,7 +836,7 @@ describe Mongoid::Touchable do
         end
       end
 
-      shared_examples "does not update the grandchild" do
+      shared_examples 'does not update the grandchild' do
         it "does not update the grandchild's timestamp" do
           expect(grandchild.updated_at).to eq(start_time)
           expect(grandchild.reload.updated_at).to eq(start_time) unless grandchild.destroyed?
@@ -893,86 +854,79 @@ describe Mongoid::Touchable do
       end
 
       context 'parent > embedded child > embedded grandchild' do
-
         let(:parent_cls) { TouchableSpec::Embedded::Building }
 
         context 'child touch: true' do
-
           let(:child_cls) do
             TouchableSpec::Embedded::Floor
           end
 
           context 'grandchild touch: true' do
-
             let(:grandchild_cls) do
               TouchableSpec::Embedded::Sofa
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "updates the parent"
-                it_behaves_like "updates the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'updates the parent'
+                it_behaves_like 'updates the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
 
           context 'grandchild touch: false' do
-
             let(:grandchild_cls) do
               TouchableSpec::Embedded::Chair
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "does not update the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'does not update the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
         end
 
         context 'child touch: false' do
-
           let(:child_cls) do
             TouchableSpec::Embedded::Entrance
           end
 
           context 'grandchild touch: true' do
-
             let(:grandchild_cls) do
               TouchableSpec::Embedded::Camera
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "updates the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'updates the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
 
           context 'grandchild touch: false' do
-
             let(:grandchild_cls) do
               TouchableSpec::Embedded::Keypad
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "does not update the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'does not update the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
@@ -980,86 +934,79 @@ describe Mongoid::Touchable do
       end
 
       context 'parent > referenced child > embedded grandchild' do
-
         let(:parent_cls) { TouchableSpec::Referenced::Building }
 
         context 'child touch: true' do
-
           let(:child_cls) do
             TouchableSpec::Referenced::Floor
           end
 
           context 'grandchild touch: true' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Sofa
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "updates the parent"
-                it_behaves_like "updates the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'updates the parent'
+                it_behaves_like 'updates the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
 
           context 'grandchild touch: false' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Chair
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "does not update the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'does not update the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
         end
 
         context 'child touch: false' do
-
           let(:child_cls) do
             TouchableSpec::Referenced::Entrance
           end
 
           context 'grandchild touch: true' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Camera
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "updates the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'updates the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
 
           context 'grandchild touch: false' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Keypad
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "does not update the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'does not update the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
@@ -1067,86 +1014,79 @@ describe Mongoid::Touchable do
       end
 
       context 'parent > referenced child > referenced grandchild' do
-
         let(:parent_cls) { TouchableSpec::Referenced::Building }
 
         context 'child touch: true' do
-
           let(:child_cls) do
             TouchableSpec::Referenced::Floor
           end
 
           context 'grandchild touch: true' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Window
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "updates the parent"
-                it_behaves_like "updates the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'updates the parent'
+                it_behaves_like 'updates the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
 
           context 'grandchild touch: false' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Plant
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "does not update the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'does not update the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
         end
 
         context 'child touch: false' do
-
           let(:child_cls) do
             TouchableSpec::Referenced::Entrance
           end
 
           context 'grandchild touch: true' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Window
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "updates the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'updates the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
 
           context 'grandchild touch: false' do
-
             let(:grandchild_cls) do
               TouchableSpec::Referenced::Plant
             end
 
-            [ :save!, :destroy, :touch ].each do |meth|
+            %i[save! destroy touch].each do |meth|
               context "when calling #{meth} method" do
                 let(:meth) { meth }
 
-                it_behaves_like "does not update the parent"
-                it_behaves_like "does not update the child"
-                it_behaves_like "updates the grandchild"
+                it_behaves_like 'does not update the parent'
+                it_behaves_like 'does not update the child'
+                it_behaves_like 'updates the grandchild'
               end
             end
           end
@@ -1155,8 +1095,7 @@ describe Mongoid::Touchable do
     end
   end
 
-  describe "when saving a document" do
-
+  describe 'when saving a document' do
     let!(:start_time) { Timecop.freeze(Time.at(Time.now.to_i)) }
 
     let(:update_time) do
@@ -1167,23 +1106,22 @@ describe Mongoid::Touchable do
       Timecop.return
     end
 
-    context "when only using the root document" do
-
-      shared_examples "timeless is cleared" do
-        it "clears the timeless option" do
+    context 'when only using the root document' do
+      shared_examples 'timeless is cleared' do
+        it 'clears the timeless option' do
           expect(doc.timeless?).to be false
         end
       end
 
-      shared_examples "touches the document" do
-        it "touches the document" do
+      shared_examples 'touches the document' do
+        it 'touches the document' do
           expect(doc.created_at).to eq(start_time)
           expect(doc.updated_at).to eq(start_time)
         end
       end
 
-      shared_examples "updates the document" do
-        it "updates the document" do
+      shared_examples 'updates the document' do
+        it 'updates the document' do
           expect(doc.created_at).to eq(start_time)
           expect(doc.updated_at).to eq(update_time)
         end
@@ -1191,110 +1129,102 @@ describe Mongoid::Touchable do
 
       let(:doc) { Dokument.new }
 
-      context "when saving a new document" do
-
-        context "when not passing a touch option" do
-
+      context 'when saving a new document' do
+        context 'when not passing a touch option' do
           before do
             doc.save!
           end
 
-          include_examples "touches the document"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: true" do
-
+        context 'when passing touch: true' do
           before do
             doc.save!(touch: true)
           end
 
-          include_examples "touches the document"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: false" do
-
+        context 'when passing touch: false' do
           before do
             doc.save!(touch: false)
           end
 
-          include_examples "touches the document"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'timeless is cleared'
         end
       end
 
-      context "when updating a document" do
+      context 'when updating a document' do
         before do
           doc.save!
-          doc.title = "title"
+          doc.title = 'title'
           update_time
         end
 
-        context "when not passing a touch option" do
-
+        context 'when not passing a touch option' do
           before do
             doc.save!
           end
 
-          include_examples "updates the document"
-          include_examples "timeless is cleared"
+          include_examples 'updates the document'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: true" do
-
+        context 'when passing touch: true' do
           before do
             doc.save!(touch: true)
           end
 
-          include_examples "updates the document"
-          include_examples "timeless is cleared"
+          include_examples 'updates the document'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: false" do
-
+        context 'when passing touch: false' do
           before do
             doc.save!(touch: false)
           end
 
-          include_examples "touches the document"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'timeless is cleared'
         end
       end
     end
 
-    context "when saving embedded associations with cascading callbacks" do
-
-      shared_examples "timeless is cleared" do
-        it "clears the timeless option" do
+    context 'when saving embedded associations with cascading callbacks' do
+      shared_examples 'timeless is cleared' do
+        it 'clears the timeless option' do
           expect(book.timeless?).to be false
           expect(book.covers.first.timeless?).to be false
         end
       end
 
-      shared_examples "touches the document" do
-        it "touches the document" do
+      shared_examples 'touches the document' do
+        it 'touches the document' do
           expect(book.created_at).to eq(start_time)
           expect(book.updated_at).to eq(start_time)
         end
       end
 
-      shared_examples "updates the document" do
-        it "updates the document" do
+      shared_examples 'updates the document' do
+        it 'updates the document' do
           expect(book.created_at).to eq(start_time)
           expect(book.updated_at).to eq(update_time)
         end
       end
 
-      shared_examples "touches the children" do
-        it "touches the children" do
+      shared_examples 'touches the children' do
+        it 'touches the children' do
           expect(book.covers.first.created_at).to eq(start_time)
           expect(book.covers.first.updated_at).to eq(start_time)
         end
       end
 
-      shared_examples "updates the children" do
-        it "updates the children" do
+      shared_examples 'updates the children' do
+        it 'updates the children' do
           expect(book.covers.first.created_at).to eq(start_time)
           expect(book.covers.first.updated_at).to eq(update_time)
         end
@@ -1308,81 +1238,74 @@ describe Mongoid::Touchable do
         Cover.new
       end
 
-      context "when saving a new document" do
-
-        context "when not passing a touch option" do
-
+      context 'when saving a new document' do
+        context 'when not passing a touch option' do
           before do
             book.save!
           end
 
-          include_examples "touches the document"
-          include_examples "touches the children"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'touches the children'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: true" do
-
+        context 'when passing touch: true' do
           before do
             book.save!(touch: true)
           end
 
-          include_examples "touches the document"
-          include_examples "touches the children"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'touches the children'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: false" do
-
+        context 'when passing touch: false' do
           before do
             book.save!(touch: false)
           end
 
-          include_examples "touches the document"
-          include_examples "touches the children"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'touches the children'
+          include_examples 'timeless is cleared'
         end
       end
 
-      context "when updating a document" do
+      context 'when updating a document' do
         before do
           book.save!
-          book.title = "title"
-          book.covers.first.title = "title"
+          book.title = 'title'
+          book.covers.first.title = 'title'
           update_time
         end
 
-        context "when not passing a touch option" do
-
+        context 'when not passing a touch option' do
           before do
             book.save!
           end
 
-          include_examples "updates the document"
-          include_examples "updates the children"
-          include_examples "timeless is cleared"
+          include_examples 'updates the document'
+          include_examples 'updates the children'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: true" do
-
+        context 'when passing touch: true' do
           before do
             book.save!(touch: true)
           end
 
-          include_examples "updates the document"
-          include_examples "updates the children"
-          include_examples "timeless is cleared"
+          include_examples 'updates the document'
+          include_examples 'updates the children'
+          include_examples 'timeless is cleared'
         end
 
-        context "when passing touch: false" do
-
+        context 'when passing touch: false' do
           before do
             book.save!(touch: false)
           end
 
-          include_examples "touches the document"
-          include_examples "touches the children"
-          include_examples "timeless is cleared"
+          include_examples 'touches the document'
+          include_examples 'touches the children'
+          include_examples 'timeless is cleared'
         end
       end
     end
@@ -1460,7 +1383,7 @@ describe Mongoid::Touchable do
       expect(parent.after_touch_called).to eq(true)
     end
 
-    context 'when touch is calles on a child' do
+    context 'when touch is called on a child' do
       before do
         child.touch
       end
@@ -1476,4 +1399,117 @@ describe Mongoid::Touchable do
       end
     end
   end
+
+  describe 'touch merged with embedded insert' do
+    context 'when pushing an embedded document with touch: true' do
+      let(:building) do
+        TouchableSpec::Embedded::Building.create!(title: 'Tower')
+      end
+
+      let(:floor) do
+        building.floors.create!(level: 1)
+      end
+
+      before do
+        # Ensure building and floor are persisted and timestamps are set.
+        building
+        floor
+      end
+
+      it 'issues a single update_one when pushing a child into a touchable parent' do
+        sofa = TouchableSpec::Embedded::Sofa.new
+
+        expect_query(1) do
+          floor.sofas.push(sofa)
+        end
+      end
+
+      it 'updates updated_at on the parent after push' do
+        original_floor_updated_at = floor.updated_at
+        original_building_updated_at = building.updated_at
+
+        Timecop.travel(Time.now + 10) do
+          floor.sofas.push(TouchableSpec::Embedded::Sofa.new)
+        end
+
+        building.reload
+        expect(building.updated_at).to be > original_building_updated_at
+        expect(building.floors.first.updated_at).to be > original_floor_updated_at
+      end
+
+      it 'persists the embedded document' do
+        sofa = TouchableSpec::Embedded::Sofa.new
+        floor.sofas.push(sofa)
+
+        building.reload
+        expect(building.floors.first.sofas.length).to eq(1)
+      end
+
+      it 'runs touch callbacks on the parent chain' do
+        sofa = TouchableSpec::Embedded::Sofa.new
+        floor.sofas.push(sofa)
+
+        # Verify callbacks ran by checking the in-memory timestamps
+        # were updated (touch sets updated_at in-memory via write_attribute).
+        expect(floor.updated_at).to be_within(5).of(Time.now)
+        expect(building.updated_at).to be_within(5).of(Time.now)
+      end
+    end
+
+    context 'when pushing an embedded document with touch: false' do
+      let(:building) do
+        TouchableSpec::Embedded::Building.create!(title: 'Tower')
+      end
+
+      let(:floor) do
+        building.floors.create!(level: 1)
+      end
+
+      before do
+        building
+        floor
+      end
+
+      it 'does not merge touch updates (touch: false on Chair)' do
+        original_floor_updated_at = floor.updated_at
+
+        Timecop.travel(Time.now + 10) do
+          floor.chairs.push(TouchableSpec::Embedded::Chair.new)
+        end
+
+        # Floor should not be touched because Chair has touch: false.
+        expect(floor.updated_at).to eq(original_floor_updated_at)
+      end
+    end
+
+    context 'when pushing into a non-touchable parent' do
+      let(:building) do
+        TouchableSpec::Embedded::Building.create!(title: 'Tower')
+      end
+
+      let(:entrance) do
+        building.entrances.create!(level: 0)
+      end
+
+      before do
+        building
+        entrance
+      end
+
+      it 'does not touch the building (Entrance has touch: false)' do
+        # Reload to get the MongoDB-persisted timestamp (with truncated
+        # sub-millisecond precision) so the comparison is stable.
+        building.reload
+        original_building_updated_at = building.updated_at
+
+        Timecop.travel(Time.now + 10) do
+          entrance.cameras.push(TouchableSpec::Embedded::Camera.new)
+        end
+
+        building.reload
+        # Camera touches Entrance, but Entrance does NOT touch Building.
+        expect(building.updated_at).to eq(original_building_updated_at)
+      end
+    end
+  end
 end