openapi_parser 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d03c17295ee85e0cf17e06e83f6e28c1bed8028e7de1ae68574e2d69ad6160b2
-  data.tar.gz: 6cae65df5bab290cff5d7c014d181f5eb631e153863f5eac82c7ce460d224dd9
+  metadata.gz: e570c33d05a24e9b11a3f5b86f5321f895088a672d404df68f3d14b4d3f9fb8f
+  data.tar.gz: fadcedd0e7b7c5ce057f2b0fa36f313218f151ae524dd2290c1242fbdfca02da
 SHA512:
-  metadata.gz: 3074ba856acef7b064c0b1d2cf7b79b274e00766d90797ddfe95626f19ea09571fe72e2346e397bc7cac18f986959c659b62de2933b42d0a403074d5e41a73a9
-  data.tar.gz: 7c373bb6e33c6bf221b7d3dbc41f89951109b8adc7bc9aef362eb5c820733e5c1203279c272e92e96b1cd4a6278b09f70aab5ffee809cf635e9253d6e616bb06
+  metadata.gz: 680325ae11c7dce38425d23c89918d3ce5cb768261dbd48f6d21c166ca0d89b2dbf9304297b2f754830f47cdf8d45dd2501371b396fe972957474e171f4b3b49
+  data.tar.gz: 27b757f70c102671ff1f2891918f5e7abb044796e280027b097214f4f0bbb2ff538b7f7c84d7d1bb7f1fc8b46b63591ad62e37985dab50ebb35c0603b854e92e

data/.github/workflows/ci.yaml

@@ -17,6 +17,7 @@ jobs:
           - "3.2"
           - "3.3"
           - "3.4"
+          - "4.0"
           - ruby-head
     runs-on: ${{ matrix.os }}
     steps:

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## Unreleased
 
+## 2.5.0 (2026-10-21)
+* add OpenAPI 3.2 `SpecValidator` rules
+  * `SelfBefore32`: detect `$self` usage in pre-3.2 documents (3.2 addition)
+* support root-level `$self` (OpenAPI 3.2) in the parse layer (`self_uri`); it is not yet used as the base URI for `$ref` resolution
+* support boolean schemas (OpenAPI 3.1): `true` accepts any value and `false` rejects any value with `FalseSchemaError`, instead of crashing the loader with `NoMethodError`
+* add `SpecValidator` rule `BooleanSchemaIn30`: detect boolean schemas in 3.0 documents (3.1 addition; `additionalProperties` is not affected)
+* coerce non-String values into array-form `type` (3.1) the same way as a single `type` when `coerce_value` is on, so `type: [integer, "null"]` handles a Float the same way as `type: integer`
+* stop truncating a Float with a fractional part in integer coercion (`coerce_value`): `1.5` for `type: integer` now fails instead of becoming `1`, while a Float with no fractional part, like `1.0`, is still converted
+
 ## 2.4.0 (2026-10-14)
 * support `components.pathItems` so `$ref`s into it resolve, unblocking OpenAPI 3.1 documents that use reusable path items
 * support array-form `type` (3.1) in value validation

data/lib/openapi_parser/errors.rb

@@ -38,6 +38,13 @@ module OpenAPIParser
     end
   end
 
+  # 3.1: raised for any value checked against the boolean schema `false`
+  class FalseSchemaError < OpenAPIError
+    def message
+      "#{@reference} does not allow any value"
+    end
+  end
+
   class NotExistRequiredKey < OpenAPIError
     def initialize(keys, reference)
       super(reference)

data/lib/openapi_parser/schema_validator/integer_validator.rb

@@ -21,6 +21,8 @@ class OpenAPIParser::SchemaValidator
 
       def coerce(value)
         return value if value.kind_of?(Integer)
+        # Integer() truncates a Float, so convert only one with no fractional part.
+        return value.finite? && value == value.floor ? value.to_i : value if value.kind_of?(Float)
 
         begin
           Integer(value)

data/lib/openapi_parser/schema_validator.rb

@@ -75,6 +75,13 @@ class OpenAPIParser::SchemaValidator
   def validate_schema(value, schema, **keyword_args)
     return [value, nil] unless schema
 
+    # 3.1: a boolean schema accepts (`true`) or rejects (`false`) any value,
+    # including null.
+    if schema.respond_to?(:raw_schema)
+      return [value, nil] if schema.raw_schema == true
+      return [nil, OpenAPIParser::FalseSchemaError.new(schema.object_reference)] if schema.raw_schema == false
+    end
+
     # 3.1: `const` pins the value to exactly that constant. Checked before
     # type dispatch so it applies uniformly across primitives. Detection
     # uses raw_schema so an intentional `const: null` is honored.
@@ -154,11 +161,14 @@ class OpenAPIParser::SchemaValidator
       end
     end
 
-    # 3.1: request params arrive as Strings, so `type: [integer, "null"]`
-    # never matches by class. When coercing, try each listed type instead.
+    # 3.1: when coercing, a value whose class matches no listed type is tried
+    # against each listed type, the same way a single `type` coerces it.
+    # Request params arrive as Strings ("5" for `type: [integer, "null"]`),
+    # and a single `type: integer` also coerces a Float such as 1.0.
+    # nil is left to the nil validator, as it is for a single `type`.
     # @return [Boolean]
     def coerce_into_type_array?(value, schema)
-      return false unless @coerce_value && value.is_a?(String)
+      return false unless @coerce_value && !value.nil?
       return false if schema.any_of || schema.all_of || schema.one_of
 
       schema.type.is_a?(Array) && pick_array_type(value, schema.type).nil?

data/lib/openapi_parser/schemas/openapi.rb

@@ -53,6 +53,10 @@ module OpenAPIParser::Schemas
     #   @return [String, nil] dialect URI for embedded JSON Schemas (OpenAPI 3.1+)
     openapi_attr_value :json_schema_dialect, schema_key: :jsonSchemaDialect
 
+    # @!attribute [r] self_uri
+    #   @return [String, nil] the document's own URI, `$self` (OpenAPI 3.2+)
+    openapi_attr_value :self_uri, schema_key: :'$self'
+
     # @return [OpenAPIParser::RequestOperation, nil]
     def request_operation(http_method, request_path)
       OpenAPIParser::RequestOperation.create(http_method, request_path, @path_item_finder, @config)

data/lib/openapi_parser/schemas/schema.rb

@@ -125,5 +125,13 @@ module OpenAPIParser::Schemas
     def additional_properties
       @additional_properties.nil? ? true : @additional_properties
     end
+
+    # 3.1: a boolean schema (`true` / `false`) has no keywords to load.
+    def load_data
+      return super if raw_schema.is_a?(::Hash)
+
+      @_openapi_all_child_objects = {}
+      nil
+    end
   end
 end

data/lib/openapi_parser/spec_validator/rules/boolean_schema_in_30.rb

@@ -0,0 +1,26 @@
+module OpenAPIParser
+  class SpecValidator
+    module Rules
+      # A boolean schema (`true` / `false` in place of a schema object) comes
+      # from JSON Schema 2020-12, which 3.1 adopts. 3.0 allows a boolean only
+      # for `additionalProperties`, which is not loaded as a Schema, so any
+      # Schema whose raw value is a boolean is a spec mismatch in 3.0.
+      class BooleanSchemaIn30 < Rule
+        def check(root)
+          return [] unless version_before?('3.1')
+
+          violations = []
+          each_schema(root) do |schema|
+            next unless schema.raw_schema == true || schema.raw_schema == false
+
+            violations << violation(
+              path: schema.object_reference,
+              message: 'a boolean schema is a 3.1 addition (from JSON Schema 2020-12); 3.0 allows a boolean only for `additionalProperties`',
+            )
+          end
+          violations
+        end
+      end
+    end
+  end
+end

data/lib/openapi_parser/spec_validator/rules/self_before_32.rb

@@ -0,0 +1,20 @@
+module OpenAPIParser
+  class SpecValidator
+    module Rules
+      # `$self` is a 3.2 root-level addition declaring the document's own
+      # URI for reference resolution. The parse layer accepts it
+      # permissively; this rule reports the version mismatch.
+      class SelfBefore32 < Rule
+        def check(root)
+          return [] unless version_before?('3.2')
+          return [] unless root.raw_schema.is_a?(Hash) && root.raw_schema.key?('$self')
+
+          [violation(
+            path: '#/$self',
+            message: '`$self` is a 3.2 root-level addition; earlier documents have no such field',
+          )]
+        end
+      end
+    end
+  end
+end

data/lib/openapi_parser/spec_validator.rb

@@ -5,6 +5,7 @@ require_relative 'spec_validator/rules/exclusive_maximum'
 require_relative 'spec_validator/rules/content_encoding_in_30'
 require_relative 'spec_validator/rules/content_media_type_in_30'
 require_relative 'spec_validator/rules/prefix_items_in_30'
+require_relative 'spec_validator/rules/boolean_schema_in_30'
 require_relative 'spec_validator/rules/json_schema_dialect_in_30'
 require_relative 'spec_validator/rules/type_array_in_30'
 require_relative 'spec_validator/rules/path_items_in_30'
@@ -16,6 +17,7 @@ require_relative 'spec_validator/rules/const_in_30'
 require_relative 'spec_validator/rules/dynamic_ref_in_30'
 require_relative 'spec_validator/rules/dynamic_anchor_in_30'
 require_relative 'spec_validator/rules/content_schema_in_30'
+require_relative 'spec_validator/rules/self_before_32'
 
 module OpenAPIParser
   class SpecViolationError < OpenAPIError
@@ -68,6 +70,7 @@ module OpenAPIParser
           Rules::ContentEncodingIn30,
           Rules::ContentMediaTypeIn30,
           Rules::PrefixItemsIn30,
+          Rules::BooleanSchemaIn30,
           Rules::JsonSchemaDialectIn30,
           Rules::TypeArrayIn30,
           Rules::PathItemsIn30,
@@ -79,6 +82,7 @@ module OpenAPIParser
           Rules::DynamicRefIn30,
           Rules::DynamicAnchorIn30,
           Rules::ContentSchemaIn30,
+          Rules::SelfBefore32,
         ]
       end
   end

data/lib/openapi_parser/version.rb

@@ -1,3 +1,3 @@
 module OpenAPIParser
-  VERSION = '2.4.0'.freeze
+  VERSION = '2.5.0'.freeze
 end

data/sig/openapi_parser/spec_validator.rbs

@@ -59,6 +59,10 @@ module OpenAPIParser
         def check: (OpenAPIParser::Schemas::OpenAPI root) -> Array[SpecValidator::SpecViolation]
       end
 
+      class BooleanSchemaIn30 < Rule
+        def check: (OpenAPIParser::Schemas::OpenAPI root) -> Array[SpecValidator::SpecViolation]
+      end
+
       class JsonSchemaDialectIn30 < Rule
         def check: (OpenAPIParser::Schemas::OpenAPI root) -> Array[SpecValidator::SpecViolation]
       end
@@ -102,6 +106,10 @@ module OpenAPIParser
       class ContentSchemaIn30 < Rule
         def check: (OpenAPIParser::Schemas::OpenAPI root) -> Array[SpecValidator::SpecViolation]
       end
+
+      class SelfBefore32 < Rule
+        def check: (OpenAPIParser::Schemas::OpenAPI root) -> Array[SpecValidator::SpecViolation]
+      end
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openapi_parser
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - ota42y
@@ -210,6 +210,7 @@ files:
 - lib/openapi_parser/schemas/schema.rb
 - lib/openapi_parser/spec_validator.rb
 - lib/openapi_parser/spec_validator/rule.rb
+- lib/openapi_parser/spec_validator/rules/boolean_schema_in_30.rb
 - lib/openapi_parser/spec_validator/rules/const_in_30.rb
 - lib/openapi_parser/spec_validator/rules/content_encoding_in_30.rb
 - lib/openapi_parser/spec_validator/rules/content_media_type_in_30.rb
@@ -223,6 +224,7 @@ files:
 - lib/openapi_parser/spec_validator/rules/nullable_deprecation.rb
 - lib/openapi_parser/spec_validator/rules/path_items_in_30.rb
 - lib/openapi_parser/spec_validator/rules/prefix_items_in_30.rb
+- lib/openapi_parser/spec_validator/rules/self_before_32.rb
 - lib/openapi_parser/spec_validator/rules/type_array_in_30.rb
 - lib/openapi_parser/spec_validator/rules/type_null_in_30.rb
 - lib/openapi_parser/spec_validator/rules/webhooks_in_30.rb