parametron 0.3.4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7dcdccf1f3be6a66dcc1d9e908438f12e3455727
-  data.tar.gz: 18a54b7cbabf0e427e35b889643a9014133d84d4
+  metadata.gz: 658e94725bd642f4c1612120ed3a42ade927dc8f
+  data.tar.gz: f085908b94b530e83a04af25725175384c3d2f59
 SHA512:
-  metadata.gz: beba071b20a06987b53f225baa2c93d6699e6494209002810d036d65de832d88082ed9dcb3081bfc22e68a5bfcc795d2f14e04f86180a493864bbc64226ee8dc
-  data.tar.gz: a4ab379a513fc033c48f342f254f34b8b67c8b376ba6e2da4628089e3d6ea3e2b0ce915282464fc14043561be27745c9164a703d358f1c7fdb1f01a4c7da865b
+  metadata.gz: 291b2da26f3c6dc34611dd90d5410a38b4cc6f6f801b7fabdf5c4ad8b687a2671a57f4113079338a66bdcffd7c4434bc319b059973f63791e5f8f6e20a3acaf0
+  data.tar.gz: 49a7b0de9b23fb73a2ac9181689d94c255371f7fdadbc93a39e091e99f323a26f9511161ebe9398ab661c6df8fa1f0021a182399aa3882c5820147c2298c0d93

data/CHANGELOG.md

@@ -1,4 +1,8 @@
-0.3.5 / 2015-12-29
+0.4.0 / 2015-12-29
+==================
+ * Implement `on_exception` handler
+
+0.3.4 / 2015-12-28
 ==================
  * Implement call cast lambda with parameters
 

data/README.md

@@ -130,6 +130,25 @@ it will get |current_value, current_casted_parameters, original_params|
 This could be handy when you want to have access to other parameters from input hash already
 casted.
 
+## Exceptions
+
+Normally `parametron` raise exceptions when mandatory required parameter missed,
+when `cast` expect something other than it gets and so on.
+You could change this behavior if you need adding exception handler:
+
+
+```ruby
+    params_for(:fetch) do
+      required :city,   validator: /\w+/
+      required :year,   validator: /\d{4}/
+      on_exception ->(ex) {
+        # return something other then exception `ex`
+        return false
+      }
+    end
+```
+
+
 
 ## Contributing
 

data/lib/parametron.rb

@@ -29,7 +29,15 @@ module Parametron
       remove_method(name.to_sym)
 
       define_method(name) do |params={}|
-        new_params = _rename_params!(_cast!(_validate!(_set_defaults!(params))))
+        begin
+          new_params = _rename_params!(_cast!(_validate!(_set_defaults!(params))))
+        rescue => e
+          if self.class.params_validator.on_exception_handler
+            return self.class.params_validator.on_exception_handler.call(e)
+          else
+            raise e
+          end
+        end
         original.bind(self).call(new_params)
       end
     end

data/lib/parametron/params_validator.rb

@@ -1,12 +1,18 @@
 class Parametron::ParamsValidator
 
-  attr_accessor :required_vals, :optional_vals
+  attr_accessor :required_vals, :optional_vals, :on_exception_handler
 
   def initialize(opts)
     @reject_unexpected = opts.fetch(:reject, true)
     @raise_on_excess   = opts.fetch(:strict, false)
     self.required_vals = []
     self.optional_vals = []
+    self.on_exception_handler  = nil
+  end
+
+  def on_exception(lmbd)
+    raise ArgumentError.new('on_exception expects lambda or proc') unless lmbd.respond_to? :call
+    self.on_exception_handler = lmbd
   end
 
   def optional(name, opts={})

data/lib/parametron/version.rb

@@ -1,3 +1,3 @@
 module Parametron
-  VERSION = "0.3.4"
+  VERSION = "0.4.0"
 end

data/parametron.gemspec

@@ -21,6 +21,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version     = ">= 1.9"
 
   spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "pry"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
 

data/spec/casting_spec.rb

@@ -93,8 +93,6 @@ describe Parametron, "Casting" do
         end.to raise_error
       end
 
-
-
     end
 
     it 'not raises exception on casting when parameter not required' do

data/spec/on_exception_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe Parametron, "On exception" do
+
+  it 'accepts on_exception handler' do
+    expect do
+      class VictimWithOnExceptionHandlerTest
+        include Parametron
+        params_for(:fetch, strict: true) do
+          required :title, validator: /\w+/
+          on_exception -> e {}
+        end
+        def fetch params; params; end
+      end
+    end.not_to raise_error
+  end
+
+  it 'calls on_exeption handler on exception raised in params' do
+    class VictimWithOnExceptionHandler1
+      include Parametron
+      params_for(:fetch, strict: true) do
+        required :title, validator: /\w+/
+        on_exception -> e { [false, e] }
+      end
+      def fetch params; params; end
+    end
+
+    v = VictimWithOnExceptionHandler1.new
+    expect do
+      v.fetch()
+    end.not_to raise_error
+
+    result = v.fetch()
+    expect(result[0]).to eq false
+    expect(result[1]).to be_an_instance_of(Parametron::RequiredParamError)
+  end
+
+end

data/spec/spec_helper.rb

@@ -1,2 +1,3 @@
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 require 'parametron'
+require 'pry'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parametron
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.4.0
 platform: ruby
 authors:
 - Yury Batenko
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -74,6 +88,7 @@ files:
 - lib/parametron/version.rb
 - parametron.gemspec
 - spec/casting_spec.rb
+- spec/on_exception_spec.rb
 - spec/parametron_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/svenyurgensson/parametron
@@ -102,5 +117,6 @@ specification_version: 4
 summary: DSL for method arguments validation and casting
 test_files:
 - spec/casting_spec.rb
+- spec/on_exception_spec.rb
 - spec/parametron_spec.rb
 - spec/spec_helper.rb