pgdice 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb0186157164f68ab2d28de3f12ca7a2eefabf012951fab5e279e9945ed91bf6
-  data.tar.gz: 3a7c382cdeec7893699dd3006823f7b8ac58f973a9ccd687fc68736c274f69ab
+  metadata.gz: 12fa7e75440961dbabdca09146b652c0b849f4d0e92f7c6e66c5e95d932f7449
+  data.tar.gz: 6c9df08948a598ae17ddfe76ceb9c594c5566a479dce26bf2dd698f9eb54969d
 SHA512:
-  metadata.gz: 9ffb81d9926e552e45cb69994f3bb2272a44b2f81a810817b513ffe50301e2196c9959ee5d38fa51c2a76b657a4a2a489771a9961dd1e018804bf4bbd05a7fa0
-  data.tar.gz: dcdb213293295da91d63c5e0dafaf8e2739f8b6ce35ee30916b620b1c2ef0de55294f5b71643dfaa9a95c0cce75b0545300c4ce5970b0230ed14d057ffa96da2
+  metadata.gz: a54b4dcdc2e9bed2798f5ccee31c1189036b0b37123e23b29c949d53bfbfe3fe7af1f288d4077ff66f3ce04374c113a91746e583bca3404aa221408afa05ceda
+  data.tar.gz: a418c411de0d82e221a1c7de358b1eb9dfd18a0bafd4207c84441852e87adfa1eb674063a194b50b1472e783f21842635dbc2c381958d1d0fc792a788c0914d3

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [v0.4.0] : 2018-12-06
+### Changes
+  - Add `only:` option to `assert_tables` so users can assert on only `past`
+  or `future` tables if they wish.
+  - Fix #21 by adding documentation on how to migrate existing data from 
+  unpartitioned tables
+
+
 ## [v0.3.3] : 2018-11-30
 ### Changes
   - Do not eagerly initialize the `pg_connection` as this can cause some normal

data/README.md

@@ -153,6 +153,15 @@ For more information on what's going on in the background see
 PgDice.partition_table('comments')
 ```
 
+### Copying existing data into new partitions
+
+If you have a table with existing data and you want that data to be split up and copied to your new partitions
+you can use:
+```ruby
+PgDice.partition_table('comments', fill: true)
+```
+
+This will create the partitions and then insert data from the old table into the newly partitioned tables.
 
 ### Notes on partition_table
 
@@ -243,6 +252,12 @@ An [InsufficientTablesError](lib/pgdice.rb) will be raised if any conditions are
 This will check that there are 7 future tables from now and that there are 90 past tables
 per our configuration above.
 
+
+If you want to only assert on `past` tables you could use the example below. The same goes for `future`
+```ruby
+PgDice.assert_tables('comments', only: :past)
+```
+
 ## Listing approved tables
 
 Sometimes you might need to know the tables configured for `PgDice`. To list the configured tables 
@@ -254,6 +269,17 @@ PgDice.approved_tables
 The [ApprovedTables](lib/pgdice/approved_tables.rb) object responds to the most common enumerable methods.
 
 
+# Miscellaneous Notes
+
+All methods for `PgDice` take a hash which will override whatever values would have been automatically supplied.
+
+An example of this would be like so: 
+```ruby
+PgDice.list_droppable_partitions('comments', past: 60)
+```
+This example would use `60` instead of the configured value of `90` from the `comments` table we configured above.
+
+
 # FAQ
 
 1. How do I get a postgres url if I'm running in Rails?

data/lib/pgdice/validation.rb

@@ -38,18 +38,29 @@ module PgDice
 
     def filter_parameters(table, params)
       if params.nil?
-        params = {}
-        params[:future] = table.future
-        params[:past] = table.past
-        period = table.period
+        params, period = handle_nil_params(table)
       else
+        handle_only_param(table, params) if params[:only]
         period = resolve_period(schema: table.schema, table_name: table.name, **params)
       end
+
       all_params = table.smash(params.merge!(period: period))
 
       [table, period, all_params, params]
     end
 
+    def handle_nil_params(table)
+      params = {}
+      params[:future] = table.future
+      params[:past] = table.past
+      [params, table.period]
+    end
+
+    def handle_only_param(table, params)
+      params[:future] = params[:only] == :future ? params[:future] || table.future : nil
+      params[:past] = params[:only] == :past ? params[:past] || table.past : nil
+    end
+
     def assert_future_tables(table_name, partitions, period, expected)
       newer_tables = tables_newer_than(partitions, @current_date_provider.call, period).size
       if newer_tables < expected

data/lib/pgdice/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PgDice
-  VERSION = '0.3.3'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pgdice
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Andrew Newell
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-11-30 00:00:00.000000000 Z
+date: 2018-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg