rspec-rails-api 0.4.0 → 0.6.0

data/lib/rspec/rails/api/validator.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+require 'active_support/hash_with_indifferent_access'
+require 'rspec_rails_api'
+
+module RSpec
+  module Rails
+    module Api
+      # Set of method to validate data and data structures
+      class Validator
+        class << self
+          ##
+          # Validates an object keys and values types
+          #
+          # @param actual   [*]              Value to compare
+          # @param expected [Hash, NilClass] Definition
+          #
+          # @return [String, Hash, NilClass] Nil when no error, string when not an object and dictionary of errors
+          #         otherwise
+          def validate_object(actual, expected)
+            return 'is not a hash' unless actual.is_a? Hash
+            # Don't validate without a definition
+            return unless expected
+
+            keys_errors = validate_object_keys actual, expected
+            return keys_errors unless keys_errors.nil?
+
+            attributes_errors = validate_object_attributes(actual, expected)
+
+            attributes_errors unless attributes_errors.keys.empty?
+          end
+
+          ##
+          # Validates each entry of an array
+          #
+          # @param array    [*]                      The array to check
+          # @param expected [Symbol, Hash, NilClass] Attributes configuration
+          #
+          # @return [String, Hash, NilClass] Nil when no error, string when not an object and dictionary of errors
+          #         otherwise
+          def validate_array(array, expected)
+            return 'is not an array' unless array.is_a? Array
+            # Arrays without an expected entry type
+            return unless expected
+
+            errors = {}
+            array.each_with_index do |array_entry, index|
+              value_error = validate_array_entry array_entry, expected
+              errors["##{index}"] = value_error if value_error
+            end
+
+            errors unless errors.keys.empty?
+          end
+
+          ##
+          # Returns a human-readable string from matcher errors
+          #
+          # @param errors [String,Hash] Validation errors
+          # @param values [String]      JSON string representing the value
+          #
+          # @return [String]
+          def format_failure_message(errors, values)
+            if errors.is_a? Hash
+              errors = errors.deep_stringify_keys.to_yaml.split("\n")
+              errors.shift
+              errors.map! do |line|
+                "  #{line.sub(/^(\s+)"(#\d+)":(.*)$/, '\1\2:\3')}"
+              end
+              errors = errors.join("\n")
+            end
+
+            <<~TXT
+              expected object structure not to have these errors:
+              #{errors}
+
+              As a notice, here is the JSON object:
+                #{values}
+            TXT
+          end
+
+          ##
+          # Checks if a given type is in the supported types list
+          #
+          # @param type   [Symbol]   Type to check
+          # @param except [[Symbol]] List of types to ignore
+          #
+          # @return [Boolean]
+          def valid_type?(type, except: [])
+            keys = PARAM_TYPES.keys.reject { |key| except.include? key }
+            keys.include?(type)
+          end
+
+          ##
+          # Checks if a value is of the given type
+          #
+          # @param value [*]      Value to test
+          # @param type  [Symbol] Type to compare to
+          #
+          # @return [String,NilClass] True when the value corresponds to the given type
+          def validate_type(value, type)
+            if type == :boolean
+              return nil if value.is_a?(TrueClass) || value.is_a?(FalseClass)
+
+              return 'is not a "boolean"'
+            end
+
+            raise "Unknown type #{type}" unless PARAM_TYPES.key? type
+
+            return nil if value.is_a? PARAM_TYPES[type][:class]
+
+            "is not a \"#{type}\""
+          end
+
+          private
+
+          # Checks if a key should be skipped, whether it's missing and optional or nil
+          #
+          # @param key        [Symbol] Key to check
+          # @param value      [*]      Associated value
+          # @param definition [Hash]   Entity definitions
+          #
+          # @return [Boolean]
+          def skip_key_check?(key, value, definition)
+            # Ignore missing optional keys
+            return true unless value.key?(key.to_s) || definition[key][:required]
+            # Ignore null optional keys
+            return true if !definition[key][:required] && value[key.to_s].nil?
+
+            false
+          end
+
+          # Validates the keys of a hash
+          #
+          # @param actual     [Hash] The hash to check
+          # @param definition [Hash] The object definition
+          #
+          # @return [String, Hash, NilClass] Nil when no error, string when not an object and dictionary of errors
+          #         otherwise
+          def validate_object_keys(actual, definition)
+            # Hashes without an expected attributes type
+            return unless definition
+
+            errors = {}
+            actual.each_key do |key|
+              errors[key] = 'is not defined' unless definition.key?(key.to_sym)
+            end
+
+            errors unless errors.keys.empty?
+          end
+
+          ##
+          # Validates the attributes of a Hash
+          #
+          # @param actual   [Hash] Value to compare
+          # @param expected [Hash] Definition
+          #
+          # @return [String, Hash, NilClass] Nil when no error, string when not an object and dictionary of errors
+          #         otherwise
+          def validate_object_attributes(actual, expected)
+            errors = {}
+            expected.each_key do |key|
+              next if skip_key_check? key, actual, expected
+
+              value_error = validate_object_attribute key, actual, expected[key][:type], expected[key][:attributes]
+              errors[key] = value_error unless value_error.nil?
+            end
+
+            errors unless errors.keys.nil?
+          end
+
+          # Checks the value of an entry in a Hash
+          #
+          # @param key           [Symbol]      Key to check
+          # @param actual        [Hash]        Hash to check
+          # @param expected_type [Symbol]      Expected type
+          # @param definition    [Symbol,Hash] Attribute definition
+          #
+          # @return [String,Hash,NilClass] Nil when no error is met, string when not a primitive and dictionary of
+          #         errors otherwise
+          def validate_object_attribute(key, actual, expected_type, definition)
+            return 'is missing' unless actual.key? key.to_s
+
+            case expected_type
+            when :object
+              validate_object actual[key.to_s], definition
+            when :array
+              validate_array actual[key.to_s], definition
+            else
+              validate_type actual[key.to_s], expected_type
+            end
+          end
+
+          # Checks the validity of an array entry against a definition
+          #
+          # @param entry      [*]    Entry to check
+          # @param definition [Hash] Fields definition
+          #
+          # @return [String,Hash,NilClass] Nil when no error is met, string when not a primitive and dictionary of
+          #         errors otherwise
+          def validate_array_entry(entry, definition)
+            if definition[:type].is_a? Symbol # Array of "simple" values
+              validate_type entry, definition[:type]
+            else # Objects
+              validate_object entry, definition
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rspec/rails/api/version.rb

@@ -3,7 +3,7 @@
 module RSpec
   module Rails
     module Api
-      VERSION = '0.4.0'
+      VERSION = '0.6.0'
     end
   end
 end

data/lib/rspec_rails_api.rb

@@ -30,16 +30,13 @@ module RSpec
         boolean:  { type: 'boolean', format: nil },
         string:   { type: 'string', format: nil, class: String },
         integer:  { type: 'integer', format: nil, class: Integer },
-        number:   { type: 'number', format: nil, class: Float },
+        number:   { type: 'number', format: nil, class: Numeric },
         array:    { type: 'array', format: nil, class: Array },
         object:   { type: 'object', format: nil, class: Hash },
+        file:     { type: 'string', format: 'binary' },
       }.freeze
 
-      EXCLUDED_PRIMITIVES = %i[array object].freeze
-
       PRIMITIVES = PARAM_TYPES.keys
-                              .reject { |key| EXCLUDED_PRIMITIVES.include? key }
-                              .map { |key| "type_#{key}".to_sym }
     end
   end
 end

data/rspec-rails-api.gemspec

@@ -33,15 +33,18 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.5.0'
+  spec.required_ruby_version = '>= 2.7.0'
 
   spec.add_development_dependency 'activesupport', '~> 6.0'
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'rack'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-performance'
+  spec.add_development_dependency 'rubocop-rake'
+  spec.add_development_dependency 'rubocop-rspec'
   spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'yard'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspec-rails-api
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Manuel Tancoigne
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-12-19 00:00:00.000000000 Z
+date: 2023-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -52,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  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
@@ -108,6 +122,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  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: rubocop-rspec
+  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: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -149,10 +191,12 @@ files:
 - ".gitlab-ci.yml"
 - ".rspec"
 - ".rubocop.yml"
+- ".ruby-version"
 - ".travis.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -166,6 +210,7 @@ files:
 - lib/rspec/rails/api/metadata.rb
 - lib/rspec/rails/api/open_api_renderer.rb
 - lib/rspec/rails/api/utils.rb
+- lib/rspec/rails/api/validator.rb
 - lib/rspec/rails/api/version.rb
 - lib/rspec_rails_api.rb
 - rspec-rails-api.gemspec
@@ -185,15 +230,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.4.1
 signing_key: 
 specification_version: 4
 summary: Tests standard Rails API responses and generate doc