validate-params 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: abce4d094f5a56366394cab4c9c01e3bbaca5a9ed5cb3524754d941a7a90d6e6
-  data.tar.gz: 17aa70265348cae7d3f661fa07419da90c4ba1b4b08ccf881baaa5bd556bedf4
+  metadata.gz: 4e686013f02bbb7e5fd50eeabb70a7b3abdd3fdcc8458b3e2230d1a288435988
+  data.tar.gz: e2434d12a8b52721b930b426133189db03a84a7dbcb86ed57c1ca98c4b4b06b3
 SHA512:
-  metadata.gz: 4cd4813db2797307b1e47956f02fffe2358cb7aaa130b5248ac0a8635e32c63a582a190d619af1d5bb5d7e4cf80f590862e97a96edab99c39dbbe86533de833d
-  data.tar.gz: 01dbe50eee3aed0eb9ee06dac9035a5e7c81f9f658cdf84e14fc888913a8ed2842049294f7c8c95ee175fb9c0240c66e5193fc87d8008d2c2cb1fb1691f41f6c
+  metadata.gz: 809c060682bd2e8b9e49781589f5fe45bd91abfdfdba7d41b1285b12fef5e8d27fb8476acdd8e1ffee73ec1a16c3f5017acb8348faa0e5b9c8735d499496c094
+  data.tar.gz: 34ee15be73ac94a817b144f246b43e89623c4a81261035448e432bce589b51971d3b8022ac6732a8e27197f0f21efb918b85535866a4109d63582a0a7d12da9a

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.10.0] - 2023-08-28
+
+- Added support for IO type to validate file uploads
+
 ## [0.9.0] - 2023-08-02
 
 - Add :min and :max options to validate param values for Integer types

data/Gemfile

@@ -6,4 +6,4 @@ source "https://rubygems.org"
 gemspec
 
 gem "rake", "~> 13.0"
-gem "rubocop", "~> 1.55"
+gem "rubocop", "~> 1.56"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    validate-params (0.9.0)
+    validate-params (0.10.0)
       activesupport (>= 6.1.0)
       i18n (>= 1.6)
 
@@ -28,6 +28,7 @@ GEM
       tzinfo (~> 2.0)
       zeitwerk (~> 2.3)
     ast (2.4.2)
+    base64 (0.1.1)
     builder (3.2.4)
     concurrent-ruby (1.2.2)
     crass (1.0.6)
@@ -49,7 +50,7 @@ GEM
     parser (3.2.2.3)
       ast (~> 2.4.1)
       racc
-    racc (1.6.2)
+    racc (1.7.1)
     rack (2.2.7)
     rack-test (2.1.0)
       rack (>= 1.3)
@@ -75,7 +76,8 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.0)
-    rubocop (1.55.1)
+    rubocop (1.56.0)
+      base64 (~> 0.1.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -102,7 +104,7 @@ DEPENDENCIES
   bundler (~> 2.0)
   rake (~> 13.0)
   rspec (~> 3.0)
-  rubocop (~> 1.55)
+  rubocop (~> 1.56)
   validate-params!
 
 BUNDLED WITH

data/README.md

@@ -2,7 +2,7 @@
 
 [![Rspec](https://github.com/peopleforce/validate_params/actions/workflows/rspec.yml/badge.svg)](https://github.com/peopleforce/validate_params/actions/workflows/rspec.yml)
 
-ValidateParams is a lightweight, robust Ruby on Rails gem that introduces a simple yet powerful DSL (Domain Specific Language) to validate parameters for your controller actions. It is designed to make your code cleaner, more maintainable, and ensures that your application handles invalid or unexpected parameters gracefully.
+ValidateParams is a lightweight, robust Ruby on Rails gem that introduces a simple yet powerful DSL (Domain Specific Language) to validate and type cast the parameters for your controller actions. It is designed to make your code cleaner, more maintainable, and ensures that your application handles invalid or unexpected parameters gracefully.
 
 ## Installation
 
@@ -25,9 +25,11 @@ class TestController < ActionController::Base
   validate_params :index do |p|
     p.param :name, String, default: "John Doe"
     p.param :occurred_on, Date, required: true, default: proc { Date.today }
+    p.param :per_page, Integer, default: 50, min: 1, max: 50
     p.param :quantity, Integer, required: true, in: [1, 2, 3]
     p.param :user_ids, Array, of: Integer, default: [1, 2, 3]
     p.param :states, Array, of: String, default: ["active", "inactive"], reject_blank: true
+    p.param :file, IO, min: 1.byte, max: 1.megabyte
     p.param :date_of_birth, Hash do |pp|
       pp.param :gt, Date, min: Date.new(2020, 1, 1), max: Date.new(2021, 1, 1)
       pp.param :lt, Date
@@ -44,10 +46,25 @@ class TestController < ActionController::Base
 end
 ```
 
+### Types
+
+Here are the following supported types along with operations supported.
+
+- String (required, default)
+- Integer (required, default, min, max, in)
+- Date (required, default, min, max)
+- DateTime (required, default, min, max)
+- IO (required, min, max)
+- Array of: (String|Integer) (default, reject_blank)
+- Hash - Nested block of types
+
+
 ## Response
 
 If the parameters are valid, the controller action will be executed as normal. If the parameters are invalid, a **400 Bad Request** response will be returned with a JSON body containing the errors, or an empty HTML response.
 
+### JSON (Default)
+
 ```json
 {
     "success": false,
@@ -55,14 +72,22 @@ If the parameters are valid, the controller action will be executed as normal. I
         {
             "message": "hired_on must be a valid Date"
         },
+        {
+            "message": "per_page cannot be more than maximum",
+            "max": 50
+        },
+        {
+            "message": "states is an invalid value",
+            "valid_values": ["active", "inactive"]
+        },
 
     ]
 }
 ```
 
-## Format
+### HTML
 
-By default responses are returned in JSON format. To return responses as an empty HTML response, change the :format options in the validate_params methods to :html.
+By default responses are returned in JSON format. To return responses as an empty HTML response with a **400 Bad Request** status, change the :format option in the validate_params methods to **:html**.
 
 Example:
 

data/lib/validate_params/param_validator.rb

@@ -76,6 +76,18 @@ module ValidateParams
           validate_inclusion if @options[:in].present?
         end
 
+        def io
+          unless Types::IO.valid?(@value)
+            @errors << { message: error_message }
+            return
+          end
+
+          formatted_value = Types::IO.cast(@value)
+
+          validate_min(formatted_value) if @options[:min].present?
+          validate_max(formatted_value) if @options[:max].present?
+        end
+
         def validate_inclusion
           return if @options[:in].include?(@value)
 

data/lib/validate_params/types/i_o.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module ValidateParams
+  class Types
+    class IO
+      def self.valid?(value)
+        value.class.method_defined?(:size)
+      end
+
+      def self.cast(raw_value, **)
+        raw_value.size
+      end
+    end
+  end
+end

data/lib/validate_params/validatable.rb

@@ -5,6 +5,7 @@ require "validate_params/types/date_time"
 require "validate_params/types/integer"
 require "validate_params/types/array"
 require "validate_params/types/string"
+require "validate_params/types/i_o"
 require_relative "param_builder"
 require_relative "param_validator"
 

data/lib/validate_params/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ValidateParams
-  VERSION = "0.9.0"
+  VERSION = "0.10.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: validate-params
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - dcherevatenko
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-07 00:00:00.000000000 Z
+date: 2023-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -116,17 +116,18 @@ files:
 - lib/validate_params/types/array.rb
 - lib/validate_params/types/date.rb
 - lib/validate_params/types/date_time.rb
+- lib/validate_params/types/i_o.rb
 - lib/validate_params/types/integer.rb
 - lib/validate_params/types/string.rb
 - lib/validate_params/validatable.rb
 - lib/validate_params/version.rb
 - sig/validate_params.rbs
 - validate_params.gemspec
-homepage: 
+homepage:
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -141,8 +142,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: Gem to validate params in controllers
 test_files: []