activerecord_views 0.0.13 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f3c9db1b593bf137570cde8f2e4fcaf6837aa414
-  data.tar.gz: 81143c5d6e77cfe47971b9bca74dde2f8a1c3847
+  metadata.gz: 39b0e9c321cfad9ac7d28ee1e273612407b088a8
+  data.tar.gz: 83c737c0270414db041cbbd0de28ec43bbec3da8
 SHA512:
-  metadata.gz: fcf258e4d370ee70ad3a96488271d206ec7e8fe27dce4c123b9a176a10d12cd06cf2c1f3d7f2c21446a98045015967cbc4130d8414e48db0b9d1081e8afb6691
-  data.tar.gz: 684a7373b1167ab08a20f565e7f33c93cc5420e85ec34186488af74f36772672927dcaa993198273d83f568fd05ffae05eaf2c8a40d55096a80af1ea9785ac8d
+  metadata.gz: a2ab26da9f69ebf4b37ab0d10a92ee685f7fa577fb089a3d038776b2073d4466108e959e5c232af30b7499048c010a15d283c3b68b5f0504e3e2e635b4eb431b
+  data.tar.gz: 583a160996c2db6067d425fa6a06505a9e6a484ded3d7b5f104c93f0775c25253adce5514d8f2cd57cd8c2b0405d83fa927c7a358dca1da00aa2f8c61a0a3f85

data/README.markdown

@@ -123,6 +123,8 @@ AccountBalance.view_populated? # => true
 
 ActiveRecordViews records when a view was last refreshed. This is often useful for giving users an idea of how stale data. To retrieve this timestamp, call `.refreshed_at` on the model:
 
+ActiveRecordViews also has a convenience method called `ensure_populated!` which checks all materialized views in a chain of dependencies have been initially populated. This can be used as a safeguard to lazily populate views on demand. You will probably also setup a schedule to periodically refresh the view data when it gets stale.
+
 PostgreSQL 9.4 supports refreshing materialized views concurrently. This allows other processes to continue reading old cached data while the view is being updated. To use this feature you must have define a unique index on the materialized view:
 
 ```sql

data/lib/active_record_views/extension.rb

@@ -79,6 +79,17 @@ module ActiveRecordViews
           ActiveSupport::TimeZone['UTC'].parse(value)
         end
       end
+
+      def ensure_populated!
+        ActiveRecordViews.get_view_direct_dependencies(self.connection, self.table_name).each do |class_name|
+          klass = class_name.constantize
+          klass.ensure_populated!
+        end
+
+        if ActiveRecordViews.materialized_view?(self.connection, self.table_name)
+          refresh_view! unless view_populated?
+        end
+      end
     end
   end
 end

data/lib/active_record_views/version.rb

@@ -1,3 +1,3 @@
 module ActiveRecordViews
-  VERSION = '0.0.13'
+  VERSION = '0.0.14'
 end

data/spec/active_record_views_extension_spec.rb

@@ -179,6 +179,29 @@ describe ActiveRecordViews::Extension do
       }.to raise_error ArgumentError, 'not a materialized view'
     end
 
+    it 'supports ensuring a view hierarchy has been populated' do
+      class EnsurePopulatedFoo < ActiveRecord::Base
+        is_view 'SELECT 1 AS id;', materialized: true
+      end
+
+      class EnsurePopulatedBar < ActiveRecord::Base
+        is_view "SELECT * FROM #{EnsurePopulatedFoo.table_name}", dependencies: [EnsurePopulatedFoo]
+      end
+
+      class EnsurePopulatedBaz < ActiveRecord::Base
+        is_view "SELECT * FROM #{EnsurePopulatedBar.table_name}", dependencies: [EnsurePopulatedBar]
+      end
+
+      expect(ActiveRecord::Base.connection).to receive(:execute).with(/^REFRESH MATERIALIZED VIEW/).once.and_call_original
+      allow(ActiveRecord::Base.connection).to receive(:execute).and_call_original
+
+      expect(EnsurePopulatedFoo.view_populated?).to eq false
+      EnsurePopulatedBaz.ensure_populated!
+      expect(EnsurePopulatedFoo.view_populated?).to eq true
+      EnsurePopulatedBaz.ensure_populated!
+      expect(EnsurePopulatedFoo.view_populated?).to eq true
+    end
+
     it 'supports refreshing materialized views concurrently' do
       class MaterializedViewRefreshTestModel < ActiveRecord::Base
         is_view 'SELECT 1 AS id;', materialized: true

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activerecord_views
 version: !ruby/object:Gem::Version
-  version: 0.0.13
+  version: 0.0.14
 platform: ruby
 authors:
 - Jason Weathered
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-25 00:00:00.000000000 Z
+date: 2015-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord