mv-postgresql 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 32dd42e8c1f366be6588c1a5917d036031938022
-  data.tar.gz: 1e4a6cf2e617bd61469a78dff3c69cd5cc7bc702
+  metadata.gz: 5312214a363c7e4dd85d54c07bc72f29791d7ba7
+  data.tar.gz: 58a0227278138a421c75bdee96ee1bf72b616b2c
 SHA512:
-  metadata.gz: dc152b93f0568897e1b3bb1fc87e0248632e90bc562cd7bc4e74c84f0e1d3d0e3b847cf1910954f940fcfbf5dc2a555a64c77465ac401c908ea4c3d74fdcf1c1
-  data.tar.gz: 7bcd5d532fde13ad2c4a5654115037a6dd708c457cc2f2ba4437cb736a6bf13b88334251273360d35bfdf1358e564c2ea5bf3d70b24b2174cdd7dc33ef479b27
+  metadata.gz: 560d9087028db2e17a187ac876ac9fee9ec467f4cb4df27ec63a3a24c614e690c0907cda91a7445f49e17b04c14ae4173a1d1cc934c7decc7c5886bd9db09ddd
+  data.tar.gz: 8ac04ec6d42cf0492d3c28efbb5301b3fed8e86e02f7fee0131ce60dc0c8450898040b155bb658418fb77cc058edffbb360d462ad06a5f04037f342d3341e3c8

data/README.md

@@ -1,11 +1,10 @@
-[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/vprokopchuk256/mv-postgresql/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
 [![Build Status](https://travis-ci.org/vprokopchuk256/mv-postgresql.svg?branch=master)](https://travis-ci.org/vprokopchuk256/mv-postgresql)
 [![Coverage Status](https://coveralls.io/repos/vprokopchuk256/mv-postgresql/badge.png?branch=master)](https://coveralls.io/r/vprokopchuk256/mv-postgresql?branch=master)
 [![Gem Version](https://badge.fury.io/rb/mv-postgresql.svg)](http://badge.fury.io/rb/mv-postgresql)
 
 # Introduction
 
-mv-postgresql is the PostgreSQL driver for Migration Validators project (details here: https://github.com/vprokopchuk256/mv-core)
+mv-postgresql is the PostgreSQL driver for Migration Validators project (details here: https://github.com/vprokopchuk256/mv-core). Allows RoR developer to define database constraints in a familiar ActiveRecord validations manner
 
 # Validators
 
@@ -13,7 +12,7 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
 
   Examples: 
 
-  validate uniqueness of the column 'column_name':
+  validate uniqueness of the column `column_name`:
   
   ```ruby
   validates :table_name, :column_name, uniqueness: true
@@ -42,7 +41,15 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
 
   ```ruby
   change :table_name do |t|
-     t.change :column_name, :string, :validates: { uniqueness: false }
+     t.change :column_name, :string, validates: { uniqueness: false }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+     t.string :column_name, uniqueness: true
   end
   ```
 
@@ -59,27 +66,27 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
 
 ### length
 
-  Examples: 
+Examples: 
 
   ```ruby
   validates :table_name, :column_name, 
-                               length: { in: 5..8, 
-                                         message: 'Wrong length message'}
+            length: { in: 5..8, message: 'Wrong length message'}
   ```
 
- allow `NULL`:
+allow `NULL`:
 
   ```ruby
   validates :table_name, :column_name, 
-                               length: { is: 3, allow_nil: true}
+            length: { is: 3, allow_nil: true}
   ```
 
   allow blank values: 
 
   ```ruby
   validates :table_name, :column_name, 
-                        length: { maximum: 3, 
-                                  too_long: 'Value is longer than 3 symbols' } 
+            length: { maximum: 3, 
+                      allow_blank: true, 
+                      too_long: 'Value is longer than 3 symbols' } 
   ```
 
   define constraint in trigger: 
@@ -91,6 +98,32 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
                                   too_long: 'Value is longer than 3 symbols' } 
   ```
 
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+     t.string :column_name, validates: { length: { is: 3, allow_nil: true} }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :string, validates: { length: { is: 3 } }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :string_3, length: 3
+    t.string :string_from_1_to_3, length: 1..3,
+    t.string :string_1_or_3, length: [1, 3]
+    t.string :string_4, validates: { length: 4 }
+    t.string :string_4_in_trigger: length: { is: 4, as: :trigger }
+  end
+  ```
+
   Options:
 
   * `in` - range or array that length of the value should be contained in.
@@ -130,18 +163,41 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
 
   ```ruby
   validates :table_name, :column_name, 
-                               inclusion: { in: [1, 2, 3], 
-                                            on: :update, 
-                                            as: :check }
+            inclusion: { in: [1, 2, 3], as: :check }
   ```
 
   make it in trigger: 
 
   ```ruby
   validates :table_name, :column_name, 
-                               inclusion: { in: 1..3, 
-                                            on: :create, 
-                                            as: :trigger }
+                         inclusion: { in: 1..3, 
+                                      on: :create, 
+                                      as: :trigger }
+  ```
+
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+     t.integer :column_name, validates: { inclusion: { in: 1..3 } }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :integer, validates: { inclusion: { in: 1..3 } }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :str_or_str_1, inclusion: ['str', 'str1']
+    t.string :from_str_to_str_1, inclusion: 'str'..'str1'
+    t.string :str_or_str_1_in_trigger, inclusion: { in: ['str', 'str1'], 
+                                                    as: :trigger}
+  end
   ```
 
   Options:
@@ -161,6 +217,16 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
   Examples:
 
   exclude 1, 2, and 3: 
+ 
+  within `create_table` statement: 
+
+  ```ruby
+  create_tablel :tabld_name do |t|
+    t.integer :column_name, validates: { exclusion: { in: [1, 2, 3] } }
+  end
+  ```
+
+  or as standalone statements: 
 
   ```ruby
   validates :table_name, :column_name, exclusion: { in: [1, 2, 3] }
@@ -179,9 +245,7 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
 
   ```ruby
   validates :table_name, :column_name, 
-                               exclusion: { in: [1, 2, 3], 
-                                            on: :update, 
-                                            as: :check }
+                         exclusion: { in: [1, 2, 3], as: :check }
   ```
 
   as trigger: 
@@ -193,6 +257,30 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
                                             as: :trigger }
   ```
 
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+     t.integer :column_name, validates: { exclusion: { in: 1..3 } }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :integer, validates: { exclusion: { in: 1..3 } }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :neither_str_nor_str_1, exclusion: ['str', 'str1']
+    t.string :from_str_to_str_1, exclusion: 'str'..'str1'
+    t.string :str_or_str_1_in_trigger, exclusion: { in: ['str', 'str1'], 
+                                                    as: :trigger}
+  end
+  ```
 
   Options:
 
@@ -237,6 +325,29 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
                               on: :create }
   ```
 
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+     t.string :column_name, validates: { presence: true }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :string, validates: { presence: true }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :presence_in_check, presence: true
+    t.string :presence_in_trigger, presence: { as: :trigger, on: :create }
+  end
+  ```
+
   Options:
 
   * `message` - message that should be shown if validation failed
@@ -279,6 +390,29 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
                               on: :create }
   ```
 
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+     t.string :column_name, validates: { absence: true }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :string, validates: { absence: true }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :absence_in_check, absence: true
+    t.string :absence_in_trigger, absence: { as: :trigger, on: :create }
+  end
+  ```
+
   Options:
 
   * `message` - message that should be shown if validation failed
@@ -316,6 +450,29 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
               as: :trigger }
   ```
 
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :column_name, validates { format: { with: /word/ } }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+    t.change :column_name, :string, validates: { format: { with: /word/ } }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :contains_word, format: /word/ 
+    t.string :contains_word_in_trigger, format: { with: /word/, as: :trigger }
+  end
+  ```
+
   Options:
 
   * `with` - regular expression that column value should be matched to
@@ -327,6 +484,74 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
   * `allow_blank` - ignore validation for blank values. Default value: `false`
   * `as` - defines the way how constraint will be implemented. Possible values: `[:trigger, :check]` Default value: `:check`
 
+### custom (version >= 2.1 is required)
+
+  Examples: 
+
+  allows only values that contains 'word' inside: 
+
+  ```ruby
+  validates :table_name, :column_name, 
+                         custom: { statement: "TRIM({column_name}) ~ 'word'" }
+  ```
+
+  with failure message: 
+
+  ```ruby
+  validates :table_name, :column_name, 
+    custom: { statement: "TRIM({column_name}) ~ 'word'", 
+              message: 'Column_name value should contain start word' }
+  ```
+
+  implemented as trigger:
+
+  ```ruby
+  validates :table_name, :column_name, 
+    custom: { statement: "TRIM({column_name}) ~ 'word'", 
+              message: 'Column_name value should contain start word', 
+              as: :trigger }
+  ```
+
+  all above are available in a create and change table blocks: 
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :column_name, 
+            validates: { custom: { statement: "TRIM({column_name}) ~ 'word'"} }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+    t.change :column_name, :string, 
+            validates: { custom: { statement: "TRIM({column_name}) ~ 'word'"} }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+    t.string :contains_word, custom: "TRIM({contains_word}) ~ 'word'"
+    t.string :contains_word_synonym, 
+             validates: "TRIM({contains_word_synonym}) ~ 'word'"
+    t.string :contains_word_in_trigger, 
+             custom: { statement: "TRIM({contains_word_in_trigger}) ~ 'word'", 
+             as: :trigger }
+  end
+  ```
+
+  Options:
+
+  * `statement` - db expression that column value should be matched to
+  * `message` - message that should be shown if validation failed
+  * `on` -  validation event. Possible values `[:save, :update, :create]`. Ignored unless `:as == :trigger`. Default value: `:save`
+  * `create_tigger_name` - Name of the 'before insert' trigger that will be created if `:as == :trigger` && `:on` in `[:save, :create]`
+  * `update_tigger_name` - Name of the 'before update' trigger that will be created if `:as == :trigger` && `:on` in `[:save, :update]`
+  * `allow_nil` - ignore validation for `nil` values. Default value: `false`
+  * `allow_blank` - ignore validation for blank values. Default value: `false`
+  * `as` - defines the way how constraint will be implemented. Possible values: `[:trigger, :check]` Default value: `:check`
+
 ## Contributing to mv-postgresql
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet

data/lib/mv-postgresql.rb

@@ -14,6 +14,7 @@ require 'mv/postgresql/validation/inclusion'
 require 'mv/postgresql/validation/length'
 require 'mv/postgresql/validation/presence'
 require 'mv/postgresql/validation/absence'
+require 'mv/postgresql/validation/custom'
 
 require 'mv/postgresql/validation/builder/trigger/exclusion'
 require 'mv/postgresql/validation/builder/trigger/inclusion'
@@ -22,6 +23,7 @@ require 'mv/postgresql/validation/builder/trigger/format'
 require 'mv/postgresql/validation/builder/trigger/presence'
 require 'mv/postgresql/validation/builder/trigger/absence'
 require 'mv/postgresql/validation/builder/trigger/uniqueness'
+require 'mv/postgresql/validation/builder/trigger/custom'
 
 ActiveSupport.on_load(:mv_core) do
   #router
@@ -43,7 +45,8 @@ ActiveSupport.on_load(:mv_core) do
     :inclusion => Mv::Postgresql::Validation::Inclusion,
     :length    => Mv::Postgresql::Validation::Length,
     :presence  => Mv::Postgresql::Validation::Presence,
-    :absence   => Mv::Postgresql::Validation::Absence
+    :absence   => Mv::Postgresql::Validation::Absence,
+    :custom   => Mv::Postgresql::Validation::Custom
   )
 
   #validation builders in trigger
@@ -54,7 +57,8 @@ ActiveSupport.on_load(:mv_core) do
     Mv::Postgresql::Validation::Format    => Mv::Postgresql::Validation::Builder::Trigger::Format,
     Mv::Postgresql::Validation::Presence  => Mv::Postgresql::Validation::Builder::Trigger::Presence,
     Mv::Postgresql::Validation::Absence   => Mv::Postgresql::Validation::Builder::Trigger::Absence,
-    Mv::Core::Validation::Uniqueness      => Mv::Postgresql::Validation::Builder::Trigger::Uniqueness
+    Mv::Core::Validation::Uniqueness      => Mv::Postgresql::Validation::Builder::Trigger::Uniqueness,
+    Mv::Postgresql::Validation::Custom    => Mv::Postgresql::Validation::Builder::Trigger::Custom,
   )
 
   #validation builders in check
@@ -64,7 +68,8 @@ ActiveSupport.on_load(:mv_core) do
     Mv::Postgresql::Validation::Length    => Mv::Core::Validation::Builder::Length,
     Mv::Postgresql::Validation::Format    => Mv::Postgresql::Validation::Builder::Format,
     Mv::Postgresql::Validation::Presence  => Mv::Core::Validation::Builder::Presence,
-    Mv::Postgresql::Validation::Absence   => Mv::Core::Validation::Builder::Absence
+    Mv::Postgresql::Validation::Absence   => Mv::Core::Validation::Builder::Absence,
+    Mv::Postgresql::Validation::Custom   => Mv::Core::Validation::Builder::Custom
   )
 
 end

data/lib/mv/postgresql/validation/builder/trigger/custom.rb

@@ -0,0 +1,15 @@
+require 'mv/postgresql/validation/builder/trigger/trigger_column'
+
+module Mv
+  module Postgresql
+    module Validation
+      module Builder
+        module Trigger
+          class Custom < Mv::Core::Validation::Builder::Custom
+            include TriggerColumn
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mv/postgresql/validation/check_support.rb

@@ -11,7 +11,7 @@ module Mv
         def initialize(table_name, column_name, opts)
           super
 
-          @check_name = opts.with_indifferent_access[:check_name] || default_check_name
+          @check_name = options.with_indifferent_access[:check_name] || default_check_name
         end
 
         def to_a

data/lib/mv/postgresql/validation/custom.rb

@@ -0,0 +1,11 @@
+require 'mv/postgresql/validation/check_support'
+
+module Mv
+  module Postgresql
+    module Validation
+      class Custom < Mv::Core::Validation::Custom
+        include CheckSupport
+      end
+    end
+  end
+end

data/lib/mv/postgresql/validation/format.rb

@@ -11,6 +11,8 @@ module Mv
         validates :with, presence: true
 
         def initialize(table_name, column_name, opts)
+          opts = { with: opts } unless opts.is_a?(Hash)
+          
           super(table_name, column_name, opts)
 
           @with = opts.with_indifferent_access[:with]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mv-postgresql
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Valeriy Prokopchuk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-19 00:00:00.000000000 Z
+date: 2015-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
@@ -144,6 +144,7 @@ files:
 - lib/mv/postgresql/validation/builder/format.rb
 - lib/mv/postgresql/validation/builder/inclusion.rb
 - lib/mv/postgresql/validation/builder/trigger/absence.rb
+- lib/mv/postgresql/validation/builder/trigger/custom.rb
 - lib/mv/postgresql/validation/builder/trigger/exclusion.rb
 - lib/mv/postgresql/validation/builder/trigger/format.rb
 - lib/mv/postgresql/validation/builder/trigger/inclusion.rb
@@ -152,6 +153,7 @@ files:
 - lib/mv/postgresql/validation/builder/trigger/trigger_column.rb
 - lib/mv/postgresql/validation/builder/trigger/uniqueness.rb
 - lib/mv/postgresql/validation/check_support.rb
+- lib/mv/postgresql/validation/custom.rb
 - lib/mv/postgresql/validation/exclusion.rb
 - lib/mv/postgresql/validation/format.rb
 - lib/mv/postgresql/validation/inclusion.rb