mv-mysql 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d5ca9da93b16a59710ffc1d4c2bf5de9c8aac25f
-  data.tar.gz: 88d232eb43849333adc5ce44024ff19098346363
+  metadata.gz: 8afb7fce57625da1922d14fd9176e0ca7f3d611d
+  data.tar.gz: 37417cb342588a253ca31141896ed8d782832670
 SHA512:
-  metadata.gz: cfd2ec34508e35d53227dd4ad8cf24e13448056bb8c2535d5e9a8c0f842d51dd419ec4b7475d2a5783031e27d587e3a3d673be4fbb25b00fc41c0a0f27cf9842
-  data.tar.gz: f8417bfcc539c632683c7bc4020f66bbaa0deeb8f177d78ded1809a7c952abe91608eeea67ad73c79e9a4c766ecd4ffedade134400d5b75096140d8c07b394e7
+  metadata.gz: 5ea89ba6401bbc0b8e29731304a189d54cc8c0733c42b2bdf518e33840fba71027d0042ed8078dd6cfd694623bed3d335d007206742429d696a24d5d735c8ffd
+  data.tar.gz: 8645bac19886ae85dee7526bb3e7eba8ff647a3fb674dcb17e5e88c04de0a5e4d139256e06bf5542e40d1b041f6390af805c6e765cc1ff4d152c9d227c29a893

data/README.md

@@ -1,11 +1,10 @@
-[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/vprokopchuk256/mv-mysql/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
 [![Build Status](https://travis-ci.org/vprokopchuk256/mv-mysql.svg?branch=master)](https://travis-ci.org/vprokopchuk256/mv-mysql)
 [![Coverage Status](https://coveralls.io/repos/vprokopchuk256/mv-mysql/badge.png?branch=master)](https://coveralls.io/r/vprokopchuk256/mv-mysql?branch=master)
 [![Gem Version](https://badge.fury.io/rb/mv-mysql.svg)](http://badge.fury.io/rb/mv-mysql)
 
 # Introduction
 
-mv-mysql is the MySQL driver for Migration Validators project (details here: https://github.com/vprokopchuk256/mv-core)
+mv-mysql is the MySQL 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
 
@@ -46,6 +45,14 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
   end
   ```
 
+  simplifications (version >= 2.1 is required):
+
+  ```ruby
+  create_table :table_name do |t|
+     t.string :column_name, uniqueness: true
+  end
+  ```
+
   Options: 
 
   * `:message` - text of the error message that will be shown if constraint violated.  Ignored unless `:as == :trigger`
@@ -83,6 +90,32 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
                         length: { maximum: 3, 
                                   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:
 
@@ -105,10 +138,12 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
 
   Examples:
 
+  Examples: 
+
   valid values array: 
 
   ```ruby
-  validates :table_name, :column_name, inclusion: { in: [1, 2, 3]}
+  validates :table_name, :column_name, inclusion: { in: [1, 2, 3] }
   ```
 
   with failure message specified: 
@@ -119,6 +154,31 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
                message: "Column 'column_name' should be equal to 1 or 2 or 3" }
   ```
 
+  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:
 
   * `:in range` - or array that column value should be contained in.
@@ -141,22 +201,38 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
   validates :table_name, :column_name, exclusion: { in: [1, 2, 3] }
   ```
 
-  exclude values with specified failure message:
+  the same with failure message: 
 
   ```ruby
   validates :table_name, :column_name, 
-    exclusion: { 
-        in: [1, 2, 3], 
-        message: "Column 'column_name' should not  be equal to 1 or 2 or 3"
-    }
+    exclusion: {
+      in: [1, 2, 3], 
+      message: "Column 'column_name' should not  be equal to 1 or 2 or 3" }
+  ```
+
+  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
   ```
 
-  performs verification on update only:
+  ```ruby
+  change :table_name do |t|
+     t.change :column_name, :integer, validates: { exclusion: { in: 1..3 } }
+  end
+  ```
+
+  simplifications (version >= 2.1 is required):
 
   ```ruby
-  validates :table_name, :column_name, 
-                               exclusion: { in: [1, 2, 3], 
-                                            on: :update }
+  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:
@@ -172,9 +248,7 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
 
 ### presence
 
-  Examples:
-
-  simple presence validator: 
+  Examples: 
 
   ```ruby
   validates :table_name, :column_name, presence: true
@@ -184,22 +258,44 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
 
   ```ruby
   validates :table_name, :column_name, 
-                  :presence: { message: 'value should not be empty' }
+                  presence: { message: 'value should not be empty' }
   ```
 
-  performs verification only when new record is inserted:
+  check when record is inserted only: 
 
   ```ruby
   validates :table_name, :column_name, 
                   presence: { message: 'value should not be empty', 
+                              as: :trigger, 
                               on: :create }
   ```
 
-### absence
+  all above are available in a create and change table blocks: 
 
-  Examples:
+  ```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
+  ```
+
+### absence
 
-  simple absence validator: 
+  Examples: 
 
   ```ruby
   validates :table_name, :column_name, absence: true
@@ -209,17 +305,98 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
 
   ```ruby
   validates :table_name, :column_name, 
-                         :absence: { message: 'value should not empty' }
+                  absence: { message: 'value should be empty' }
   ```
 
-  performs verification only when new record is inserted:
+  check when record is inserted only: 
 
   ```ruby
   validates :table_name, :column_name, 
-                         absence: { message: 'value should not empty', 
-                                    on: :create }
+                  absence: { message: 'value should be empty', 
+                              as: :trigger, 
+                              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
+  ```
+
+### custom (version >= 2.1 is required)
+
+  Examples: 
+
+  allows only values that equals 'word' when trimmed: 
+
+  ```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 on insert event:
+
+  ```ruby
+  validates :table_name, :column_name, 
+    custom: { statement: "TRIM({column_name}) = 'word'", 
+              message: 'Column_name value should contain start word', 
+              as: :trigger, 
+              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: { 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:
 
   * `:message` - message that should be shown if validation failed
@@ -230,6 +407,74 @@ mv-mysql is the MySQL driver for Migration Validators project (details here: htt
   * `:allow_blank` - ignore validation for blank values. Default value: `false`
   * `:as` - defines the way how constraint will be implemented. Possible values: `[:trigger]`
 
+### custom (version >= 2.1 is required)
+
+  Examples: 
+
+  allows only values that equals 'word' when trimmed: 
+
+  ```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 on insert event:
+
+  ```ruby
+  validates :table_name, :column_name, 
+    custom: { statement: "TRIM({column_name}) = 'word'", 
+              message: 'Column_name value should contain start word', 
+              as: :trigger, 
+              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: { 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]` Default value: `:trigger`
+  
 ## Contributing to mv-mysql
  
 * 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-mysql.rb

@@ -9,6 +9,7 @@ require 'mv/mysql/validation/length'
 require 'mv/mysql/validation/presence'
 require 'mv/mysql/validation/absence'
 require 'mv/mysql/validation/uniqueness'
+require 'mv/mysql/validation/custom'
 
 require 'mv/mysql/validation/builder/trigger/exclusion'
 require 'mv/mysql/validation/builder/trigger/inclusion'
@@ -16,6 +17,7 @@ require 'mv/mysql/validation/builder/trigger/length'
 require 'mv/mysql/validation/builder/trigger/presence'
 require 'mv/mysql/validation/builder/trigger/absence'
 require 'mv/mysql/validation/builder/trigger/uniqueness'
+require 'mv/mysql/validation/builder/trigger/custom'
 
 ActiveSupport.on_load(:mv_core) do
 
@@ -31,27 +33,19 @@ ActiveSupport.on_load(:mv_core) do
     :length      => Mv::Mysql::Validation::Length,
     :presence    => Mv::Mysql::Validation::Presence,
     :absence     => Mv::Mysql::Validation::Absence,
-    :uniqueness  => Mv::Mysql::Validation::Uniqueness
+    :uniqueness  => Mv::Mysql::Validation::Uniqueness, 
+    :custom      => Mv::Mysql::Validation::Custom
   )
 
-  #validation builders in trigger
+  # validation builders in trigger
   Mv::Mysql::Constraint::Builder::Trigger.validation_builders_factory.register_builders(
-    Mv::Mysql::Validation::Exclusion   => Mv::Mysql::Validation::Builder::Trigger::Exclusion      ,
+    Mv::Mysql::Validation::Exclusion   => Mv::Mysql::Validation::Builder::Trigger::Exclusion,
     Mv::Mysql::Validation::Inclusion   => Mv::Mysql::Validation::Builder::Trigger::Inclusion,
     Mv::Mysql::Validation::Length      => Mv::Mysql::Validation::Builder::Trigger::Length,
     Mv::Mysql::Validation::Presence    => Mv::Mysql::Validation::Builder::Trigger::Presence,
     Mv::Mysql::Validation::Absence     => Mv::Mysql::Validation::Builder::Trigger::Absence,
-    Mv::Mysql::Validation::Uniqueness  => Mv::Mysql::Validation::Builder::Trigger::Uniqueness
-  )
-
-  #validation builders in trigger
-  Mv::Mysql::Constraint::Builder::Trigger.validation_builders_factory.register_builders(
-    Mv::Core::Validation::Exclusion   => Mv::Mysql::Validation::Builder::Trigger::Exclusion,
-    Mv::Core::Validation::Inclusion   => Mv::Mysql::Validation::Builder::Trigger::Inclusion,
-    Mv::Core::Validation::Length      => Mv::Mysql::Validation::Builder::Trigger::Length,
-    Mv::Core::Validation::Presence    => Mv::Mysql::Validation::Builder::Trigger::Presence,
-    Mv::Core::Validation::Absence     => Mv::Mysql::Validation::Builder::Trigger::Absence,
-    Mv::Core::Validation::Uniqueness  => Mv::Mysql::Validation::Builder::Trigger::Uniqueness
+    Mv::Mysql::Validation::Uniqueness  => Mv::Mysql::Validation::Builder::Trigger::Uniqueness,
+    Mv::Mysql::Validation::Custom      => Mv::Mysql::Validation::Builder::Trigger::Custom
   )
 end
 

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

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

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

@@ -0,0 +1,11 @@
+require 'mv/mysql/validation/mysql_error_message_restrictions'
+
+module Mv
+  module Mysql
+    module Validation
+      class Custom < Mv::Core::Validation::Custom
+        include MysqlErrorMessageRestrictions
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mv-mysql
 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
@@ -138,6 +138,7 @@ files:
 - lib/mv/mysql/railtie.rb
 - lib/mv/mysql/validation/absence.rb
 - lib/mv/mysql/validation/builder/trigger/absence.rb
+- lib/mv/mysql/validation/builder/trigger/custom.rb
 - lib/mv/mysql/validation/builder/trigger/exclusion.rb
 - lib/mv/mysql/validation/builder/trigger/inclusion.rb
 - lib/mv/mysql/validation/builder/trigger/length.rb
@@ -145,6 +146,7 @@ files:
 - lib/mv/mysql/validation/builder/trigger/presence.rb
 - lib/mv/mysql/validation/builder/trigger/trigger_column.rb
 - lib/mv/mysql/validation/builder/trigger/uniqueness.rb
+- lib/mv/mysql/validation/custom.rb
 - lib/mv/mysql/validation/exclusion.rb
 - lib/mv/mysql/validation/inclusion.rb
 - lib/mv/mysql/validation/length.rb