mv-sqlite 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f3d48d624d459a19608b840d2fc0bfdd69c5ef4f
-  data.tar.gz: c1f29635fa7ad0309419479c5902db904f8ff159
+  metadata.gz: 041135708ece1d93dd74c9f9d6ab910a36113a24
+  data.tar.gz: 0c1ccb017f85ed3b76cfc35d3f523a06c991f375
 SHA512:
-  metadata.gz: 2fca15126f81cbd55c63818a09617b8b13f70003e85b53474aa2bf2764cbd128ceb3ddfc24e0d83dc37be15d99a71ad1e399678b3cffe09479b4eea013ac521f
-  data.tar.gz: 6f2b3c63d64092341038f2f033e2799e0763cf65e16b66e4bae2106479c639f87832f40aec61ad28c1cf742b93c785e235bf5341c7a5fd5b8cb75f822967431d
+  metadata.gz: b77f5f0d7851d9e524ef85b8134bac98bec4c9b6ed6a5d7b1276ce2f3ecaa450a757c7fcc78e93a89eae6307faae4ec9e101d8c8fdcfb1cbe50d47764a762205
+  data.tar.gz: 66235c8f42816eff1c18d2fea5451a453f9ab665d37c44c73ae8c1a34b73b0ad5da269c95eb89d34ec92f90c0491db8b35f2d317fba3cb22cb45d0f24cbb59d8

data/README.md

@@ -1,11 +1,10 @@
-[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/vprokopchuk256/mv-sqlite/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
 [![Build Status](https://travis-ci.org/vprokopchuk256/mv-sqlite.svg)](https://travis-ci.org/vprokopchuk256/mv-sqlite)
 [![Coverage Status](https://coveralls.io/repos/vprokopchuk256/mv-sqlite/badge.png?branch=master)](https://coveralls.io/r/vprokopchuk256/mv-sqlite?branch=master)
 [![Gem Version](https://badge.fury.io/rb/mv-sqlite.svg)](http://badge.fury.io/rb/mv-sqlite)
 
 # Introduction
 
-mv-sqlite is the SQLite driver for Migration Validators project (details here: https://github.com/vprokopchuk256/mv-core)
+mv-sqlite is the SQLite 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
 
@@ -14,12 +13,12 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
   Examples:
 
   validate uniqueness of the column 'column_name':
-  
+
   ```ruby
   validates :table_name, :column_name, uniqueness: true
   ```
 
-  define validation as trigger with spefified failure message: 
+  define validation as trigger with specified failure message:
 
   ```ruby
   validates :table_name, :column_name, 
@@ -42,7 +41,15 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
   ```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,17 +66,17 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
 ### length
 
-  Examples:
+  Examples: 
 
   column value length should be more than 4 symbols and less than 9. Otherwise 'Wrong length message' error will be raised: 
 
-  ```ruby
+ ```ruby 
   validates :table_name, :column_name, 
                          length: { in: 5..8, 
                                    message: 'Wrong length message' }
-  ```
+ ```
 
-  allow `NULL`:
+ allow `NULL`:
 
   ```ruby
   validates :table_name, :column_name, 
@@ -80,8 +87,34 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
   ```ruby
   validates :table_name, :column_name, 
-                         length: { maximum: 3, 
-                                   too_long: 'Value is longer than 3 symbols' } 
+                        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:
@@ -103,20 +136,45 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
 ### inclusion
 
-  Examples:
+  Examples: 
 
-  valid values array:
+  valid values array: 
 
   ```ruby
   validates :table_name, :column_name, inclusion: { in: [1, 2, 3] }
   ```
 
-  with failure message specified:
+  with failure message specified: 
 
   ```ruby
   validates :table_name, :column_name, 
-              inclusion: { in: [1, 2, 3], 
-              message: "Column 'column_name' should be equal to 1 or 2 or 3" }
+  inclusion: { in: [1, 2, 3], 
+               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:
@@ -133,27 +191,46 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
   
 ### exclusion
 
-  exclude 1, 2, and 3:
+  Examples:
+
+  exclude 1, 2, and 3: 
 
   ```ruby
   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: { 
+    exclusion: {
       in: [1, 2, 3], 
-      message: "Column 'column_name' should not  be equal to 1 or 2 or 3" 
-   }
+      message: "Column 'column_name' should not  be equal to 1 or 2 or 3" }
   ```
 
-  performs verification on update only:
+  all above are available in a create and change table blocks: 
 
   ```ruby
-  validates :table_name, :column_name, exclusion: { in: [1, 2, 3], 
-                                                    on: :update }
+  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:
@@ -171,8 +248,6 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
   Examples: 
 
-  simple presence validator:
-
   ```ruby
   validates :table_name, :column_name, presence: true
   ```
@@ -181,17 +256,41 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
   ```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 }
   ```
 
+  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
@@ -206,8 +305,6 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
   Examples: 
 
-  simple absence validator:
-
   ```ruby
   validates :table_name, :column_name, absence: true
   ```
@@ -216,17 +313,98 @@ mv-sqlite is the SQLite driver for Migration Validators project (details here: h
 
   ```ruby
   validates :table_name, :column_name, 
-            absence: { message: 'value should be 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 be empty', 
-                             on: :create }
+                              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

data/lib/mv-sqlite.rb

@@ -9,6 +9,7 @@ require 'mv/sqlite/validation/builder/trigger/length'
 require 'mv/sqlite/validation/builder/trigger/presence'
 require 'mv/sqlite/validation/builder/trigger/absence'
 require 'mv/sqlite/validation/builder/trigger/uniqueness'
+require 'mv/sqlite/validation/builder/trigger/custom'
 
 ActiveSupport.on_load(:mv_core) do
 
@@ -24,7 +25,8 @@ ActiveSupport.on_load(:mv_core) do
     Mv::Core::Validation::Length      => Mv::Sqlite::Validation::Builder::Trigger::Length,
     Mv::Core::Validation::Presence    => Mv::Sqlite::Validation::Builder::Trigger::Presence,
     Mv::Core::Validation::Absence     => Mv::Sqlite::Validation::Builder::Trigger::Absence,
-    Mv::Core::Validation::Uniqueness  => Mv::Sqlite::Validation::Builder::Trigger::Uniqueness
+    Mv::Core::Validation::Uniqueness  => Mv::Sqlite::Validation::Builder::Trigger::Uniqueness,
+    Mv::Core::Validation::Custom      => Mv::Sqlite::Validation::Builder::Trigger::Custom
   )
 end
 

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mv-sqlite
 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
@@ -123,6 +123,7 @@ files:
 - lib/mv/sqlite/constraint/builder/trigger.rb
 - lib/mv/sqlite/railtie.rb
 - lib/mv/sqlite/validation/builder/trigger/absence.rb
+- lib/mv/sqlite/validation/builder/trigger/custom.rb
 - lib/mv/sqlite/validation/builder/trigger/exclusion.rb
 - lib/mv/sqlite/validation/builder/trigger/inclusion.rb
 - lib/mv/sqlite/validation/builder/trigger/length.rb