mv-postgresql 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 55f73cb78b65d65965a1ab979397267ce7f9544c
-  data.tar.gz: 6dab8a6673f29d98eebd3a73b074c282b1ad035f
+  metadata.gz: 13c089d60aae49617aa26da0fe977a1908b03e3c
+  data.tar.gz: 08cc2f9ed8b940c4075f78db5af52459b81800bd
 SHA512:
-  metadata.gz: 1bbcf7adf064e441f1b852b74d07bad86649ad476e0d0899b1cd52e6d2692b381f881f753f2f85297b0c8e84770059a2e6cf1d08c0b0c547fe0460c7cde217db
-  data.tar.gz: 59f922d9cd4b366ddf2e46b1a6c8bf805cfbea2ac0dd7ab0ebf75a368c9cf43a291e1987d77c51b3798106c8dd8e288f87fc7b3695d6f71b506933a3bf4f4186
+  metadata.gz: b14170815495b1c873fde107ad3a441e967b78c815e46c9ec49848152373da3f0c56b994ca96d7bce6494c13088888eac6a1566f52eb2c5c3fe31e1f2d51fcfe
+  data.tar.gz: c08a261687f1d624d7d690737dfee64175a960e5abc693261c593ac39f4acceec48b87e8501d6acade946bffcd91b45065c4d554402fa3a1ea35b5fc885320ca

data/README.rdoc

@@ -1,151 +1,286 @@
-= Introduction
+# Introduction
 
 mv-postgresql is the PostgreSQL driver for Migration Validators project (details here: https://github.com/vprokopchuk256/mv-core)
 
-= Validators
+# Validators
 
-=== uniqueness
+### uniqueness
 
-  Value uniqueness validation
+  Examples: 
 
-  Usage:
+  validate uniqueness of the column 'column_name':
   
-  validate_column :table_name, :column_name, :uniqueness => true
-  validate_column :table_name, :column_name, :uniqueness => {:message => 'Error message', :as => :trigger}
-  validate_column :table_name, :column_name, :uniqueness => {:as => :index}
+  ```ruby
+  validate_column :table_name, :column_name, uniqueness: true
+  ```
 
+  define validation as trigger with specified failure message:  
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                  uniqueness: { message: 'Error message', as: :trigger }
+  ```
+
+  define validation as unique index: 
+
+  ```ruby
+  validate_column :table_name, :column_name, uniqueness: { as: :index }
+  ```
+
+  all above are available in a create and change table blocks: 
+
+  ```ruby
   create_table :table_name do |t|
-     t.string :column_name, :validates => {uniqueness => true}
+     t.string :column_name, validates: { uniqueness: true }
+  end
+  ```
+
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :string, :validates: { uniqueness: false }
   end
+  ```
 
   Options: 
 
-  message:  text of the error message that will be shown if constraint violated.  Ignored unless :as == :trigger
-  index_name:   name of the index that will be created for validator. Ignored unless :as == :index
-  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. Ignored unless :as == :trigger. Default value: false
-  allow_blank: ignore validation for blank values. Ignored unless :as == :trigger. Default value: false
-  as: defines the way how constraint will be implemented. Possible values: [:index, :trigger]. Default value: :index
+  * `:message` - text of the error message that will be shown if constraint violated.  Ignored unless `:as == :trigger`
+  * `:index_name` - name of the index that will be created for validator. Ignored unless `:as == :index`
+  * `: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. Ignored unless `:as == :trigger`. Default value: `false`
+  * `:allow_blank` - ignore validation for blank values. Ignored unless `:as == :trigger`. Default value: `false`
+  * `:as` - defines the way how constraint will be implemented. Possible values: `[:index, :trigger]`. Default value: `:index`
 
-=== length
+### length
 
-  Value length validation
+  Examples: 
 
-  Usage: 
+  ```ruby
+  validate_column :table_name, :column_name, 
+                               length: { in: 5..8, 
+                                         message: 'Wrong length message'}
+  ```
 
-  validate_column :table_name, :column_name, :length => {:in => 5..8, :message => "Wrong length message"}
-  validate_column :table_name, :column_name, :length => {:is => 3, :allow_nil => true}
-  validate_column :table_name, :column_name, :length => {:maximum => 3, :too_long => "Value is longer than 3 symbols"} 
+ allow `NULL`:
 
-  Options:
+  ```ruby
+  validate_column :table_name, :column_name, 
+                               length: { is: 3, allow_nil: true}
+  ```
+
+  allow blank values: 
 
-  in: range or array that length of the value should be contained in.
-  within: synonym of :in
-  is: exact length of the value
-  maximum:  maximum allowed length
-  minimum: minimum allowed length
-  message: message that should be shown if validation failed and specific message is not defined
-  too_long: message that will be shown if value longer than allowed. Ignored unless maximum value is defined
-  too_short: message that will be shown if value shorter than allowed. Ignored unless minimum value is defined
-  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
+  ```ruby
+  validate_column :table_name, :column_name, 
+                        length: { maximum: 3, 
+                                  too_long: 'Value is longer than 3 symbols' } 
+  ```
 
-=== inclusion
+  define constraint in trigger: 
 
-  Value inclusion validation
+  ```ruby
+  validate_column :table_name, :column_name, 
+                        length: { maximum: 3, 
+                                  as: :trigger, 
+                                  too_long: 'Value is longer than 3 symbols' } 
+  ```
 
-  Usage:
+  Options:
 
-  validate_column :table_name, :column_name, :inclusion => {:in => [1, 2, 3]}
-  validate_column :table_name, :column_name, :inclusion => {:in => [1, 2, 3], :message => "Column 'column_name' should be equal to 1 or 2 or 3"}
-  validate_column :table_name, :column_name, :inclusion => {:in => [1, 2, 3], :on => :update, :as => :check}
-  validate_column :table_name, :column_name, :inclusion => {:in => 1..3, :on => :create, :as => :trigger}
+  * `in` - range or array that length of the value should be contained in.
+  * `within` - synonym of `:in`
+  * `is` - exact length of the value
+  * `maximum` -  maximum allowed length
+  * `minimum` - minimum allowed length
+  * `message` - message that should be shown if validation failed and specific message is not defined
+  * `too_long` - message that will be shown if value longer than allowed. Ignored unless maximum value is defined
+  * `too_short` - message that will be shown if value shorter than allowed. Ignored unless minimum value is defined
+  * `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`
+
+### inclusion
+
+  Examples: 
+
+  valid values array: 
+
+  ```ruby
+  validate_column :table_name, :column_name, inclusion: { in: [1, 2, 3] }
+  ```
+
+  with failure message specified: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+  inclusion: { in: [1, 2, 3], 
+               message: "Column 'column_name' should be equal to 1 or 2 or 3" }
+  ```
+
+  make it as check constraint:
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                               inclusion: { in: [1, 2, 3], 
+                                            on: :update, 
+                                            as: :check }
+  ```
+
+  make it in trigger: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                               inclusion: { in: 1..3, 
+                                            on: :create, 
+                                            as: :trigger }
+  ```
 
   Options:
 
-  in: range or array that column value should be contained in.
-  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
+  * `in` - range or array that column value should be contained in.
+  * `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`
 
   
-=== exclusion
+### exclusion
+
+  Examples:
+
+  exclude 1, 2, and 3: 
+
+  ```ruby
+  validate_column :table_name, :column_name, exclusion: { in: [1, 2, 3] }
+  ```
+
+  the same with failure message: 
 
-  Value exclusion validation
+  ```ruby
+  validate_column :table_name, :column_name, 
+    exclusion: {
+      in: [1, 2, 3], 
+      message: "Column 'column_name' should not  be equal to 1 or 2 or 3" }
+  ```
 
-  Usage:
+  as check constraint: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                               exclusion: { in: [1, 2, 3], 
+                                            on: :update, 
+                                            as: :check }
+  ```
+
+  as trigger: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                               exclusion: { in: 1..3, 
+                                            on: :create, 
+                                            as: :trigger }
+  ```
 
-  validate_column :table_name, :column_name, :exclusion => {:in => [1, 2, 3]}
-  validate_column :table_name, :column_name, :exclusion => {:in => [1, 2, 3], :message => "Column 'column_name' should not  be equal to 1 or 2 or 3"}
-  validate_column :table_name, :column_name, :exclusion => {:in => [1, 2, 3], :on => :update, :as => :check}
-  validate_column :table_name, :column_name, :exclusion => {:in => 1..3, :on => :create, :as => :trigger}
 
   Options:
 
-  in: range or array that column value should NOT be contained in.
-  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
+  * `:in` - range or array that column value should NOT be contained in.
+  * `: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`
 
-=== presense
+### presence
 
-  Value presense validation
+  Examples: 
 
-  Usage:
+  ```ruby
+  validate_column :table_name, :column_name, presence: true
+  ```
 
-  validate_column :table_name, :column_name, :presense => true
-  validate_column :table_name, :column_name, :presense => {:message => "value should not be empty"}
-  validate_column :table_name, :column_name, :presense => {:message => "value should not be empty", :as=> :trigger}
-  validate_column :table_name, :column_name, :presense => {:message => "value should not be empty", :as=> :trigger, :on => :create}
-  
+  with failure message: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                  presence: { message: 'value should not be empty' }
+  ```
+
+  implemented as trigger: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                  presence: { message: 'value should not be empty', 
+                              as: :trigger }
+  ```
+
+  check when record is inserted only: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+                  presence: { message: 'value should not be empty', 
+                              as: :trigger, 
+                              on: :create }
+  ```
 
   Options:
 
-  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
+  * `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`
 
-=== format
+### format
 
-  Allows to define regular expression that column value will be mathed  with
+  Examples: 
 
-  Usage:
+  allows only values that contains 'word' inside: 
 
-  validate_column :table_name, :column_name, :format => {:with => /word/}
-  validate_column :table_name, :column_name, :format => {:with => /word/, :messsage => "Column_name value should contain start word"}
-  validate_column :table_name, :column_name, :format => {:with => /word/, :messsage => "Column_name value should contain start word", :as => :trigger}
-  
+  ```ruby
+  validate_column :table_name, :column_name, format: { with: /word/ }
+  ```
+
+  with failure message: 
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+    format: { with: /word/, 
+              message: 'Column_name value should contain start word' }
+  ```
+
+  implemented as trigger:
+
+  ```ruby
+  validate_column :table_name, :column_name, 
+    format: { with: /word/, 
+              message: 'Column_name value should contain start word', 
+              as: :trigger }
+  ```
 
   Options:
 
-  with: regular 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
+  * `with` - regular 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
+## 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
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
@@ -155,7 +290,7 @@ mv-postgresql is the PostgreSQL driver for Migration Validators project (details
 * Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
 * Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
 
-== Copyright
+## Copyright
 
 Copyright (c) 2011 Valeriy Prokopchuk. See LICENSE.txt for
 further details.

data/lib/migration_validators/adapters/postgresql.rb

@@ -105,11 +105,11 @@ module MigrationValidators
       end
 
 
-      route :presense, :trigger do
+      route :presence, :trigger do
         to :insert_trigger, :if => {:on => [:save, :create, nil]}
         to :update_trigger, :if => {:on => [:save, :update, nil]}
       end
-      route :presense, :check, :to => :check, :default => true
+      route :presence, :check, :to => :check, :default => true
 
       route :inclusion, :trigger do
         to :insert_trigger, :if => {:on => [:save, :create, nil]}

metadata

@@ -1,57 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: mv-postgresql
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Valeriy Prokopchuk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-08 00:00:00.000000000 Z
+date: 2014-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.17'
 - !ruby/object:Gem::Dependency
   name: mv-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 description: Migration Validators project postgresql driver
 email: vprokopchuk@gmail.com
 executables: []
@@ -60,10 +60,10 @@ extra_rdoc_files:
 - LICENSE.txt
 - README.rdoc
 files:
-- lib/migration_validators/adapters/postgresql.rb
-- lib/mv-postgresql.rb
 - LICENSE.txt
 - README.rdoc
+- lib/migration_validators/adapters/postgresql.rb
+- lib/mv-postgresql.rb
 homepage: http://github.com/vprokopchuk256/mv-postgresql
 licenses:
 - MIT
@@ -84,7 +84,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.10
+rubygems_version: 2.4.2
 signing_key: 
 specification_version: 4
 summary: Migration Validators project postgresql driver