purview 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4075095b0198b4d1a9f104e39cef70a86f678038
-  data.tar.gz: 8d87f15b33df6603d107edee2a5206f4579bca30
+  metadata.gz: 1369176b107aba11f52e4a8604fdfd440969f3e1
+  data.tar.gz: 989bbb48900af7fb712c9745b505727bd4963d53
 SHA512:
-  metadata.gz: fe1283a266267325800140f453efe51da2be244c150a094d5d22c40d8b2e129b9a0192fdd004e44799377ec97625aa7c5621cdf24f0f6e4f46cef58ca216361d
-  data.tar.gz: 5f5bd8092e10d1f3f34b39aceb15ab4b4ccf307b0e94dead6a801b1c964818069e7775d5af24251be61670307f27555ae0993fa54c3411142048326ad9fd0d1c
+  metadata.gz: 96aed3e255fe0a70bbaec213852a50da2ae7ddcf81ba9633a50d45ee6979cfdcfc1ffc614a5412c9b27964934d4b62bda405bb314f829acaa009133a4228964a
+  data.tar.gz: 2a8645de4002ef60ba092c796d0099ab0ed2851bc54261cf9e494cc41999f434002fe4a04ec904d3e34a1c4b6b718f305aa9e4a7aa51971272ed5e4d5cbf47f4

data/CHANGELOG

@@ -1,3 +1,8 @@
+Release 1.1.1
+-------------
+
+* Add `baseline_table` helper to `Database` class
+
 Release 1.1.0
 -------------
 

data/README.md

@@ -128,6 +128,14 @@ as the high-water mark for records pulled from its source
 database.initialize_table(table, timestamp)
 ```
 
+Baseline the `Table`. This process will quickly get the state of the `Table` as
+close to the current state as possible. This is generally useful when adding a
+new `Table` to an existing schema (ideally this should be done while the `Table`
+is disabled)
+```ruby
+database.baseline_table(table)
+```
+
 Enable the `Table` (in the DB). This process sets the `enabled_at` value in the
 `table_metadata` table and is used by the candidate `Table` selection algorithm
 to determine the pool of `Table(s)` available for synchronization (to remove a

data/lib/purview/databases/base.rb

@@ -8,6 +8,31 @@ module Purview
         @opts = opts
       end
 
+      def baseline_table(table)
+        with_context_logging('`baseline_table`') do
+          raise Purview::Exceptions::WrongDatabase.new(table) \
+            unless tables.include?(table)
+          starting_timestamp = Time.now.utc
+          with_table_locked(table, starting_timestamp) do
+            last_window = nil
+            begin
+              with_new_connection do |connection|
+                with_transaction(connection) do |transaction_timestamp|
+                  with_next_window(
+                    connection,
+                    table,
+                    transaction_timestamp
+                  ) do |window|
+                    table.sync(connection, window)
+                    last_window = window
+                  end
+                end
+              end
+            end while last_window.max < starting_timestamp
+          end
+        end
+      end
+
       def create_table(table, opts={})
         ensure_table_metadata_exists_for_table(table)
         table_opts = extract_table_options(opts)
@@ -134,14 +159,14 @@ module Purview
       def sync
         with_context_logging('`sync`') do
           with_new_connection do |connection|
-            with_transaction(connection) do |timestamp|
-              with_next_table(connection, timestamp) do |table|
+            with_transaction(connection) do |transaction_timestamp|
+              with_next_table(connection, transaction_timestamp) do |table|
                 with_next_window(
                   connection,
                   table,
-                  timestamp
+                  transaction_timestamp
                 ) do |window|
-                  with_table_locked(table, timestamp) do
+                  with_table_locked(table, transaction_timestamp) do
                     table.sync(connection, window)
                   end
                 end

data/lib/purview/exceptions/wrong_database.rb

@@ -0,0 +1,9 @@
+module Purview
+  module Exceptions
+    class WrongDatabase < BaseTable
+      def message
+        "Wrong database for table: #{table.name}"
+      end
+    end
+  end
+end

data/lib/purview/exceptions.rb

@@ -11,3 +11,4 @@ require 'purview/exceptions/database_already_assigned'
 require 'purview/exceptions/no_table'
 require 'purview/exceptions/no_window'
 require 'purview/exceptions/rows_outside_window'
+require 'purview/exceptions/wrong_database'

data/lib/purview/version.rb

@@ -1,3 +1,3 @@
 module Purview
-  VERSION = '1.1.0'
+  VERSION = '1.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: purview
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Jonathan W. Zaleski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-01 00:00:00.000000000 Z
+date: 2015-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -121,6 +121,7 @@ files:
 - lib/purview/exceptions/no_table.rb
 - lib/purview/exceptions/no_window.rb
 - lib/purview/exceptions/rows_outside_window.rb
+- lib/purview/exceptions/wrong_database.rb
 - lib/purview/loaders.rb
 - lib/purview/loaders/base.rb
 - lib/purview/loaders/mysql.rb