Merge pull request #7 from stantoncbradley/master

Hash, array, nested and BigDecimal feature

README.md

@@ -47,7 +47,7 @@ end
 
 ### Parameter Types
 
-By declaring parameter types, incoming parameters will automatically be transformed into an object of that type. For instance, if a param is `:boolean`, values of `'1'`, `'true'`, `'t'`, `'yes'`, and `'y'` will be automatically transformed into `true`.
+By declaring parameter types, incoming parameters will automatically be transformed into an object of that type. For instance, if a param is `:boolean`, values of `'1'`, `'true'`, `'t'`, `'yes'`, and `'y'` will be automatically transformed into `true`.  `BigDecimal` defaults to a precision of 14, but this can but changed by passing in the optional `precision:` argument. Any `$` and `,` are automatically stripped when converting to `BigDecimal`.
 
 - `String`
 - `Integer`
@@ -56,6 +56,7 @@ By declaring parameter types, incoming parameters will automatically be transfor
 - `Array` _("1,2,3,4,5")_
 - `Hash` _("key1:value1,key2:value2")_
 - `Date`, `Time`, & `DateTime`
+- `BigDecimal` _("$1,000,000")_
 
 ### Validations
 
@@ -85,6 +86,44 @@ param! :order, String, in: ["ASC", "DESC"], transform: :upcase, default: "ASC"
 param! :offset, Integer, min: 0, transform: lambda {|n| n - (n % 10)}
 ```
 
+### Nested Attributes
+
+rails_param allows you to apply any of the above mentioned validations to attributes nested in hashes:
+
+```ruby
+param! :book, Hash do |b|
+  b.param! :title, String, blank: false
+  b.param! :price, BigDecimal, precision: 4, required: true
+  b.param! :author, Hash, required: true do |a|
+    a.param! :first_name, String
+    a.param! :last_name, String, blank: false
+  end
+end
+```
+
+### Arrays
+
+Validate every element of your array, including nested hashes and arrays:
+
+```ruby
+# primitive datatype syntax
+param! :integer_array, Array do |array,index|
+  array.param! index, Integer, required: true
+end
+
+# complex array
+param! :books_array, Array, required: true  do |b|
+  b.param! :title, String, blank: false
+  b.param! :author, Hash, required: true, do |a|
+    a.param! :first_name, String
+    a.param! :last_name, String, required: true
+  end
+  b.param! :subjects, Array do |s,i|
+    s.param! i, String, blank: false
+  end
+end
+```
+
 ## Thank you
 
 Many thanks to:

lib/rails_param/param.rb

 module RailsParam
   module Param
 
+    DEFAULT_PRECISION = 14
+
     class InvalidParameterError < StandardError
       attr_accessor :param, :options
     end
 
-    def param!(name, type, options = {})
-      name = name.to_s
+    class MockController
+      include RailsParam::Param
+      attr_accessor :params
+    end
+
+    def param!(name, type, options = {}, &block)
+      name = name.to_s unless name.is_a? Integer # keep index for validating elements
 
       return unless params.member?(name) || options[:default].present? || options[:required]
 
@@ -15,8 +22,25 @@ module RailsParam
         params[name] = (options[:default].call if options[:default].respond_to?(:call)) || options[:default] if params[name].nil? and options[:default]
         params[name] = options[:transform].to_proc.call(params[name]) if params[name] and options[:transform]
         validate!(params[name], options)
+
+        if block_given?
+          if type == Array
+            params[name].each_with_index do |element, i|
+              if element.is_a?(Hash)
+                recurse element, &block
+              else
+                params[name][i] = recurse({ i => element }, i, &block) # supply index as key unless value is hash
+              end
+            end
+          else
+            recurse params[name], &block
+          end
+        end
+        params[name]
+
       rescue InvalidParameterError => exception
-        exception.param, exception.options = name, options
+        exception.param ||= name
+        exception.options ||= options
         raise exception
       end
     end
@@ -41,6 +65,13 @@ module RailsParam
 
     private
 
+    def recurse(params, index = nil)
+      raise InvalidParameterError, 'no block given' unless block_given?
+      controller = RailsParam::Param::MockController.new
+      controller.params = params
+      yield(controller, index)
+    end
+
     def coerce(param, type, options = {})
       begin
         return nil if param.nil?
@@ -52,8 +83,12 @@ module RailsParam
         return Time.parse(param) if type == Time
         return DateTime.parse(param) if type == DateTime
         return Array(param.split(options[:delimiter] || ",")) if type == Array
-        return Hash[param.split(options[:delimiter] || ",").map{|c| c.split(options[:separator] || ":")}] if type == Hash
+        return Hash[param.split(options[:delimiter] || ",").map { |c| c.split(options[:separator] || ":") }] if type == Hash
         return (/(false|f|no|n|0)$/i === param.to_s ? false : (/(true|t|yes|y|1)$/i === param.to_s ? true : nil)) if type == TrueClass || type == FalseClass || type == :boolean
+        if type == BigDecimal
+          param = param.delete('$,').strip.to_f if param.is_a?(String)
+          return BigDecimal.new(param, (options[:precision] || DEFAULT_PRECISION))
+        end
         return nil
       rescue ArgumentError
         raise InvalidParameterError, "'#{param}' is not a valid #{type}"

spec/fixtures/controllers.rb

@@ -17,4 +17,18 @@ class FakeController < ActionController::Base
   def new
     render text: "new"
   end
+
+  def edit
+    param! :book, Hash, required: true do |b|
+      b.param! :title, String, required: true
+      b.param! :author, Hash do |a|
+        a.param! :first_name, String, required: true
+        a.param! :last_name, String, required: true
+        a.param! :age, Integer, required: true
+      end
+      b.param! :price, BigDecimal, required: true
+    end
+    render text: :book
+  end
+
 end

spec/fixtures/fake_rails_application.rb

@@ -15,6 +15,7 @@ module Rails
         get '/fake/new' => "fake#new"
         get '/fakes' => "fake#index"
         get '/fake/(:id)' => "fake#show"
+          get '/fake/edit' => "fake#edit"
       end
       @routes
     end

spec/rails_integration_spec.rb

@@ -10,12 +10,60 @@ describe FakeController, type: :controller do
     end
   end
 
+  describe "nested_hash" do
+    it "validates nested properties" do
+      params = {
+        'book' => {
+          'title' => 'One Hundred Years of Solitude',
+          'author' => {
+            'first_name' => 'Garbriel Garcia',
+            'last_name' => 'Marquez',
+            'age' => '70'
+          },
+          'price' => '$1,000.00'
+        }}
+      get :edit, params
+      expect(controller.params[:book][:author][:age]).to eql 70
+      expect(controller.params[:book][:author][:age]).to be_kind_of Integer
+      expect(controller.params[:book][:price]).to eql 1000.0
+      expect(controller.params[:book][:price]).to be_instance_of BigDecimal
+    end
+
+    it "raises error when required nested attribute missing" do
+      params = {
+        'book' => {
+          'title' => 'One Hundred Years of Solitude',
+          'author' => {
+            'last_name' => 'Marquez',
+            'age' => '70'
+          },
+          'price' => '$1,000.00'
+        }}
+      expect { get :edit, params }.to raise_error { |error|
+        expect(error).to be_a(RailsParam::Param::InvalidParameterError)
+        expect(error.param).to eql("first_name")
+        expect(error.options).to eql({:required => true})
+      }
+    end
+
+    it "passes when hash that's not required but has required attributes is missing" do
+      params = {
+        'book' => {
+          'title' => 'One Hundred Years of Solitude',
+          'price' => '$1,000.00'
+        }}
+      get :edit, params
+      expect(controller.params[:book][:price]).to eql 1000.0
+      expect(controller.params[:book][:price]).to be_instance_of BigDecimal
+    end
+  end
+
   describe "InvalidParameterError" do
     it "raises an exception with params attributes" do
       expect { get :index, sort: "foo" }.to raise_error { |error|
         expect(error).to be_a(RailsParam::Param::InvalidParameterError)
         expect(error.param).to eql("sort")
-        expect(error.options).to eql({ :in => ["asc", "desc"], :default => "asc", :transform => :downcase })
+        expect(error.options).to eql({:in => ["asc", "desc"], :default => "asc", :transform => :downcase})
       }
     end
   end