schemacop 3.0.38 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a3a54c489ac60b4a01424d7a4949724c15fdec793de16a4375e3097f691128b
-  data.tar.gz: 48390b41d456f5362ecabf0e97ed37fdc035247ec3d8335d105e97ab0d858378
+  metadata.gz: 9ef422cfe57686302457be2282f2b8e5f45ccdc79d6cd62597e8308bbb94026e
+  data.tar.gz: d45307834a863e1fdfdf616acbb9727fd78db428ce88436c27a67db88a3e802f
 SHA512:
-  metadata.gz: 911a618277694321833a85cc051ff139b14e9a1117dab7380bcc4c9ebc08e87a258f131224e1f3cef40d5b6495de6142f1b6f23009ce62917c8a07bf75960678
-  data.tar.gz: 1add721c851198435cf89b0b9d95d94c607bc443df180072fda1b35d4b956a4a2bdab429252f630fca8e4ddf09baf13153278d60f401318e0ad591bbc7c481b8
+  metadata.gz: 1253508e8f7270b6fa5f8f54563e79fa034a97fa8f89334f416d0e4549a5b374a2cdc0b3b4777e15202a7759a275d389a8390d67efd7acbb9114de38e21aceb1
+  data.tar.gz: 5aa472bf5a7d1aa37f946cf298b76349ad4faee611491c0ecf1bd377baa1127cfaae668f4a71ad00381a0afa88b5c23d073a3b84018ee5387808ad645766b37a

data/.github/workflows/ruby.yml

@@ -12,7 +12,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby-version: ['2.6.2', '2.7.1', '3.0.1', '3.1.0', '3.2.0', '3.3.0', '3.4.0']
+        ruby-version: ['3.2.0', '3.3.0', '3.4.0', '4.0.0']
 
     steps:
     - uses: actions/checkout@v2

data/.rubocop.yml

@@ -10,7 +10,7 @@ AllCops:
     - 'locale/translations.rb'
     - 'lib/scratch.rb'
     - 'schemacop.gemspec'
-
+  SuggestExtensions: false
   DisplayCopNames: true
 
 Style/SignalException:
@@ -108,4 +108,7 @@ Style/CaseLikeIf:
   Enabled: false
 
 Lint/EmptyClass:
+  Enabled: false
+
+Lint/RedundantRequireStatement:
   Enabled: false

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Change log
 
+## 3.1.0 (2026-05-09)
+
+* Add option `encoding` to `str` node for Schemacop V3 schemas to validate that
+  a string has one of the specified encodings. Accepts a single encoding name or
+  an array of encoding names (e.g. `encoding: 'UTF-8'` or
+  `encoding: %w[UTF-8 US-ASCII]`).
+
+  Internal reference: `#143271`.
+
+* All strings are now validated for valid encoding (via `valid_encoding?`),
+  regardless of whether the `encoding` option is set. Strings with invalid byte
+  sequences for their declared encoding will now produce a validation error.
+
+  Internal reference: `#143271`.
+
+* Update RuboCop from 1.24.1 to 1.69.2.
+
+* Drop support for all EOL Rubies (2.6.2, 2.7.1, 3.0.1, 3.1.0)
+
+* Fix `cast_str` default option causing incorrect casting and validation errors
+  when used with combination nodes and array tuples. Numeric-looking strings
+  (e.g. `"1"`) were incorrectly cast to integers in schemas where a string type
+  was also valid. With this fix, `cast_str` only activates when the value cannot
+  be matched natively by another sibling schema.
+
+  Internal reference: `#149255`.
+
+## 3.0.39 (2026-03-26)
+
+* Add `BinaryNode` for validating binary data fields such as file uploads.
+  Represented as `{ type: 'string', format: 'binary' }` in JSON Schema / OpenAPI
+  output. By default accepts `ActionDispatch::Http::UploadedFile`,
+  `Rack::Multipart::UploadedFile`, `Tempfile`, and `String`. Custom classes can
+  be specified via the `classes` option. DSL: `bin` / `bin!` / `bin?`.
+
 ## 3.0.38 (2026-02-25)
 
 * Fix namespaced schema `$ref` paths in generated JSON. For OpenAPI (swagger)

data/Gemfile

@@ -9,5 +9,5 @@ gem 'minitest'
 gem 'minitest-reporters'
 gem 'pry'
 gem 'rake'
-gem 'rubocop', '1.24.1'
+gem 'rubocop', '1.69.2'
 gem 'simplecov', '0.21.2'

data/README.md

@@ -12,13 +12,14 @@ use in conjunction with [OpenAPI](https://swagger.io/specification/).
 
 Schemacop is tested with the following ruby versions:
 
-* 2.6.2
-* 2.7.1
-* 3.0.1
-* 3.1.0
-* 3.2.0
-* 3.3.0
-* 3.4.0
+| Schemacop | Ruby                                            |
+|:----------|:------------------------------------------------|
+| >= 3.1.0  | 3.2.0, 3.3.0, 3.4.0, 4.0.0                      |
+| >= 3.0.31 | 2.6.2, 2.7.1, 3.0.1, 3.1.0, 3.2.0, 3.3.0, 3.4.0 |
+| >= 3.0.29 | 2.6.2, 2.7.1, 3.0.1, 3.1.0, 3.2.0, 3.3.0        |
+| >= 3.0.23 | 2.6.2, 2.7.1, 3.0.1, 3.1.0, 3.2.0               |
+| >= 3.0.17 | 2.6.2, 2.7.1, 3.0.1, 3.1.0                      |
+| <= 3.0.16 | 2.6.2, 2.7.1, 3.0.1                             |
 
 Other ruby versions might work but are not covered by our automated tests.
 

data/README_V3.md

@@ -14,11 +14,12 @@
     6. [Array](#array)
     7. [Hash](#hash)
     8. [Object](#object)
-    9. [AllOf](#allOf)
-    10. [AnyOf](#anyOf)
-    11. [OneOf](#oneOf)
-    12. [IsNot](#isNot)
-    13. [Reference](#reference)
+    9. [Binary](#binary)
+    10. [AllOf](#allOf)
+    11. [AnyOf](#anyOf)
+    12. [OneOf](#oneOf)
+    13. [IsNot](#isNot)
+    14. [Reference](#reference)
 5. [Context](#context)
 6. [External schemas](#external-schemas)
 7. [Default options](#default-options)
@@ -223,6 +224,15 @@ transformed into various types.
   By default, blank strings are allowed and left as they are when casted (e.g.
   the string `''` is valid). If you want to disallow blank strings, set this
   option to `false`.
+* `encoding`
+  Validates the encoding of the string. Accepts a single encoding name or an
+  array of encoding names (e.g. `encoding: 'UTF-8'` or
+  `encoding: %w[UTF-8 US-ASCII]`). See `Encoding.name_list` for all available
+  encoding names.
+
+Note that regardless of the `encoding` option, all strings are validated for
+valid encoding using `valid_encoding?`. Strings with invalid byte sequences for
+their declared encoding will always produce a validation error.
 
 #### Formats
 
@@ -1290,6 +1300,45 @@ schema.validate!('foo'.html_safe) # => "foo"
 If you set the `strict` option to `false`, the check is done using `is_a?` instead of
 `instance_of?`, which also allows subclasses
 
+### Binary
+
+Type: `:binary`\
+DSL: `bin`
+
+The binary type represents binary data fields such as file uploads. It is
+represented as `{ type: 'string', format: 'binary' }` in JSON Schema / OpenAPI
+output. At runtime, it validates that the value is an instance of one of the
+configured classes (using `is_a?`, so subclasses are accepted).
+
+By default, the node accepts instances of `ActionDispatch::Http::UploadedFile`,
+`Rack::Multipart::UploadedFile`, `Tempfile`, and `String`. Missing classes (e.g.
+when not running within Rails) are silently skipped.
+
+```ruby
+schema = Schemacop::Schema3.new :binary, classes: [Tempfile, String]
+
+schema.validate!(nil)                # => nil
+schema.validate!(Tempfile.new('f'))  # => #<Tempfile:...>
+schema.validate!('binary data')      # => "binary data"
+schema.validate!(42)                 # => Schemacop::Exceptions::ValidationError: /: Invalid type, got type "Integer", expected "String" or "Tempfile".
+```
+
+If you want to limit the accepted classes, use the `classes` option:
+
+```ruby
+schema = Schemacop::Schema3.new :binary, classes: [Tempfile]
+
+schema.validate!(nil)                 # => nil
+schema.validate!(Tempfile.new('f'))   # => #<Tempfile:...>
+schema.validate!('foo')              # => Schemacop::Exceptions::ValidationError: /: Invalid type, got type "String", expected "Tempfile".
+```
+
+#### Options
+
+* `classes`
+  An array of `Class` objects that should be accepted. Must not be empty. If not
+  given, the default classes listed above are used.
+
 ### AllOf
 
 Type: `:all_of`\

data/VERSION

@@ -1 +1 @@
-3.0.38
+3.1.0

data/lib/schemacop/schema3.rb

@@ -1,8 +1,8 @@
 module Schemacop
   class Schema3 < BaseSchema
-    def initialize(*args, **kwargs, &block)
+    def initialize(...)
       super()
-      @root = V3::Node.create(*args, **kwargs, &block)
+      @root = V3::Node.create(...)
     end
 
     # Validate data for the defined Schema

data/lib/schemacop/v2/node.rb

@@ -88,7 +88,7 @@ module Schemacop
 
         if option?(:cast) && self.class.klasses.size > 1
           fail Exceptions::InvalidSchemaError,
-               "Casting is only allowed for single-value datatypes, but type #{self.class.inspect} has classes "\
+               "Casting is only allowed for single-value datatypes, but type #{self.class.inspect} has classes " \
                "#{self.class.klasses.map(&:inspect)}."
         end
       end

data/lib/schemacop/v2/validator/string_validator.rb

@@ -7,7 +7,7 @@ module Schemacop
       option :max
 
       def initialize(options = {})
-        super(options)
+        super
 
         validate_options!
       end

data/lib/schemacop/v3/any_of_node.rb

@@ -5,6 +5,19 @@ module Schemacop
         :anyOf
       end
 
+      protected
+
+      def matches(data)
+        all_matches = super
+        if all_matches.size > 1
+          non_wrappers = all_matches.reject(&:cast_str_wrapper?)
+          return non_wrappers if non_wrappers.any?
+        end
+        all_matches
+      end
+
+      public
+
       def _validate(data, result:)
         super_data = super
         return if super_data.nil?

data/lib/schemacop/v3/array_node.rb

@@ -156,7 +156,7 @@ module Schemacop
         result = []
 
         value.each_with_index do |value_item, index|
-          if cont_item.present? && item_matches?(cont_item, value_item)
+          if cont_item.present? && !cont_item.cast_str_wrapper? && item_matches?(cont_item, value_item)
             result << cont_item.cast(value_item)
           elsif list?
             result << list_item.cast(value_item)
@@ -168,8 +168,7 @@ module Schemacop
                 result << value_item
               end
             else
-              item = item_for_data(value_item)
-              result << item.cast(value_item)
+              result << items[index].cast(value_item)
             end
           else
             result << value_item

data/lib/schemacop/v3/binary_node.rb

@@ -0,0 +1,75 @@
+module Schemacop
+  module V3
+    # Node type for binary data fields such as file uploads. Represented as
+    # `{ type: 'string', format: 'binary' }` in JSON Schema / OpenAPI output.
+    #
+    # At runtime, validates that the value is an instance of one of the
+    # configured classes (using `is_a?`).
+    #
+    # Default accepted classes (resolved lazily, missing classes are silently
+    # skipped):
+    # - `ActionDispatch::Http::UploadedFile`
+    # - `Rack::Multipart::UploadedFile`
+    # - `Tempfile`
+    # - `String`
+    #
+    # @example Default usage (accepts common upload and binary types)
+    #   bin! :file
+    #
+    # @example Restrict to specific classes
+    #   bin! :file, classes: [ActionDispatch::Http::UploadedFile]
+    class BinaryNode < Node
+      # Classes that are always available (stdlib).
+      DEFAULT_CLASSES = [Tempfile, String].freeze
+
+      # Optional classes resolved lazily via `safe_constantize` (may not be
+      # available outside of Rails/Rack).
+      OPTIONAL_CLASS_NAMES = %w[
+        ActionDispatch::Http::UploadedFile
+        Rack::Multipart::UploadedFile
+      ].freeze
+
+      def self.allowed_options
+        super + %i[classes]
+      end
+
+      def as_json
+        process_json([], type: :string, format: :binary)
+      end
+
+      protected
+
+      def init
+        @classes = options.delete(:classes)
+      end
+
+      def allowed_types
+        resolved_classes.to_h { |c| [c, c.name] }
+      end
+
+      def validate_self
+        return unless @classes
+
+        unless @classes.is_a?(Array)
+          fail 'Option "classes" must be an array of classes.'
+        end
+
+        if @classes.empty?
+          fail 'Option "classes" must not be empty.'
+        end
+
+        @classes.each do |c|
+          unless c.is_a?(Class)
+            fail "Option \"classes\" must contain classes, got #{c.inspect}."
+          end
+        end
+      end
+
+      private
+
+      def resolved_classes
+        @resolved_classes ||= @classes || (OPTIONAL_CLASS_NAMES.map(&:safe_constantize).compact + DEFAULT_CLASSES)
+      end
+    end
+  end
+end

data/lib/schemacop/v3/global_context.rb

@@ -97,7 +97,7 @@ module Schemacop
           fail "Schema #{path.inspect} does not define any schema."
         when 1
           if @schemas.include?(virtual_path)
-            fail "Schema #{virtual_path.to_s.inspect} is defined in both load paths "\
+            fail "Schema #{virtual_path.to_s.inspect} is defined in both load paths " \
                  "#{@load_paths_by_schemas[virtual_path].inspect} and #{load_path.inspect}."
           end
 

data/lib/schemacop/v3/hash_node.rb

@@ -65,8 +65,8 @@ module Schemacop
         end
 
         json = {}
-        json[:properties] = properties.values.map { |p| [p.name, p.as_json] }.to_h if properties.any?
-        json[:patternProperties] = pattern_properties.values.map { |p| [V3.sanitize_exp(p.name), p.as_json] }.to_h if pattern_properties.any?
+        json[:properties] = properties.values.to_h { |p| [p.name, p.as_json] } if properties.any?
+        json[:patternProperties] = pattern_properties.values.to_h { |p| [V3.sanitize_exp(p.name), p.as_json] } if pattern_properties.any?
 
         # In schemacop, by default, additional properties are not allowed,
         # the users explicitly need to enable additional properties
@@ -300,19 +300,15 @@ module Schemacop
       protected
 
       def as_json_with_inline_refs(properties, pattern_properties)
-        all_of = []
-
         # Add each inline ref
-        @inline_refs.each do |inline_ref|
-          all_of << inline_ref.as_json
-        end
+        all_of = @inline_refs.map(&:as_json)
 
         # Add own properties schema if any direct properties exist
         if properties.any? || pattern_properties.any?
           own_schema = {}
           own_schema[:type] = :object
-          own_schema[:properties] = properties.values.map { |p| [p.name, p.as_json] }.to_h if properties.any?
-          own_schema[:patternProperties] = pattern_properties.values.map { |p| [V3.sanitize_exp(p.name), p.as_json] }.to_h if pattern_properties.any?
+          own_schema[:properties] = properties.values.to_h { |p| [p.name, p.as_json] } if properties.any?
+          own_schema[:patternProperties] = pattern_properties.values.to_h { |p| [V3.sanitize_exp(p.name), p.as_json] } if pattern_properties.any?
 
           if options[:additional_properties].is_a?(TrueClass)
             own_schema[:additionalProperties] = true

data/lib/schemacop/v3/node.rb

@@ -45,6 +45,7 @@ module Schemacop
             self.node node
             str format: format, format_options: options
           end
+          node.instance_variable_set(:@cast_str_wrapper, true)
         end
 
         return node
@@ -136,6 +137,10 @@ module Schemacop
         (parent&.schemas || {}).merge(@schemas)
       end
 
+      def cast_str_wrapper?
+        !!@cast_str_wrapper
+      end
+
       def required?
         @required
       end

data/lib/schemacop/v3/numeric_node.rb

@@ -30,7 +30,7 @@ module Schemacop
           attrs -= %i[exclusive_minimum exclusive_maximum]
         end
 
-        super attrs, json
+        super
       end
 
       def _validate(data, result:)
@@ -102,7 +102,7 @@ module Schemacop
           fail 'Option "minimum" can\'t be greater than "maximum".'
         end
 
-        if options[:exclusive_minimum] && options[:exclusive_maximum]\
+        if options[:exclusive_minimum] && options[:exclusive_maximum] \
            && options[:exclusive_minimum] > options[:exclusive_maximum]
           fail 'Option "exclusive_minimum" can\'t be greater than "exclusive_maximum".'
         end

data/lib/schemacop/v3/object_node.rb

@@ -12,7 +12,7 @@ module Schemacop
       protected
 
       def allowed_types
-        @classes.map { |c| [c, c.name] }.to_h
+        @classes.to_h { |c| [c, c.name] }
       end
 
       def init

data/lib/schemacop/v3/one_of_node.rb

@@ -23,12 +23,25 @@ module Schemacop
         return item.cast(value)
       end
 
+      protected
+
+      def matches(data)
+        all_matches = super
+        if all_matches.size > 1
+          non_wrappers = all_matches.reject(&:cast_str_wrapper?)
+          return non_wrappers if non_wrappers.any?
+        end
+        all_matches
+      end
+
+      public
+
       def _validate(data, result:)
         if options[:treat_blank_as_nil] && data.blank? && !data.is_a?(FalseClass)
           data = nil
         end
 
-        super_data = super(data, result: result)
+        super_data = super
         return if super_data.nil?
 
         matches = matches(super_data)

data/lib/schemacop/v3/string_node.rb

@@ -8,7 +8,7 @@ module Schemacop
       ].freeze
 
       def self.allowed_options
-        super + ATTRIBUTES + %i[format_options pattern allow_blank]
+        super + ATTRIBUTES + %i[format_options pattern allow_blank encoding]
       end
 
       def allowed_types
@@ -55,6 +55,19 @@ module Schemacop
           end
         end
 
+        # Validate encoding matches #
+        if options[:encoding]
+          allowed_encodings = Array(options[:encoding])
+          unless allowed_encodings.include?(super_data.encoding.name)
+            result.error "String has encoding #{super_data.encoding.name.inspect} but must be #{allowed_encodings.map(&:inspect).join(' or ')}."
+          end
+        end
+
+        # Validate encoding #
+        unless super_data.valid_encoding?
+          result.error "String has invalid #{super_data.encoding.name.inspect} encoding."
+        end
+
         # Validate format #
         if options[:format] && Schemacop.string_formatters.include?(options[:format])
           pattern = Schemacop.string_formatters[options[:format]][:pattern]
@@ -109,6 +122,18 @@ module Schemacop
           fail 'Option "min_length" can\'t be greater than "max_length".'
         end
 
+        if options[:encoding]
+          unless options[:encoding].is_a?(String) || (options[:encoding].is_a?(Array) && options[:encoding].all? { |e| e.is_a?(String) })
+            fail 'Option "encoding" must be a string or an array of strings.'
+          end
+
+          Array(options[:encoding]).each do |encoding|
+            Encoding.find(encoding)
+          rescue ArgumentError
+            fail "Option \"encoding\" contains unknown encoding #{encoding.inspect}."
+          end
+        end
+
         if options[:pattern]
           unless options[:pattern].is_a?(String) || options[:pattern].is_a?(Regexp)
             fail 'Option "pattern" must be a string or Regexp.'

data/lib/schemacop/v3.rb

@@ -39,6 +39,7 @@ require 'schemacop/v3/numeric_node'
 require 'schemacop/v3/all_of_node'
 require 'schemacop/v3/any_of_node'
 require 'schemacop/v3/array_node'
+require 'schemacop/v3/binary_node'
 require 'schemacop/v3/boolean_node'
 require 'schemacop/v3/hash_node'
 require 'schemacop/v3/integer_node'
@@ -54,6 +55,7 @@ require 'schemacop/v3/symbol_node'
 Schemacop::V3.register :all_of,    :all_of, Schemacop::V3::AllOfNode
 Schemacop::V3.register :any_of,    :any_of, Schemacop::V3::AnyOfNode
 Schemacop::V3.register :array,     :ary,    Schemacop::V3::ArrayNode
+Schemacop::V3.register :binary,    :bin,    Schemacop::V3::BinaryNode
 Schemacop::V3.register :boolean,   :boo,    Schemacop::V3::BooleanNode
 Schemacop::V3.register :integer,   :int,    Schemacop::V3::IntegerNode
 Schemacop::V3.register :is_not,    :is_not, Schemacop::V3::IsNotNode

data/lib/schemacop.rb

@@ -77,7 +77,7 @@ module Schemacop
   register_string_formatter(
     :symbol,
     pattern: nil,
-    handler: ->(value) { value.to_sym }
+    handler: lambda(&:to_sym)
   )
 
   register_string_formatter(

data/schemacop.gemspec

@@ -1,20 +1,20 @@
 # -*- encoding: utf-8 -*-
-# stub: schemacop 3.0.38 ruby lib
+# stub: schemacop 3.1.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "schemacop".freeze
-  s.version = "3.0.38".freeze
+  s.version = "3.1.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Sitrox".freeze]
-  s.date = "2026-02-25"
-  s.files = [".github/workflows/ruby.yml".freeze, ".gitignore".freeze, ".releaser_config".freeze, ".rubocop.yml".freeze, ".yardopts".freeze, "CHANGELOG.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "README_V2.md".freeze, "README_V3.md".freeze, "RUBY_VERSION".freeze, "Rakefile".freeze, "VERSION".freeze, "lib/schemacop.rb".freeze, "lib/schemacop/base_schema.rb".freeze, "lib/schemacop/exceptions.rb".freeze, "lib/schemacop/railtie.rb".freeze, "lib/schemacop/schema.rb".freeze, "lib/schemacop/schema2.rb".freeze, "lib/schemacop/schema3.rb".freeze, "lib/schemacop/scoped_env.rb".freeze, "lib/schemacop/v2.rb".freeze, "lib/schemacop/v2/caster.rb".freeze, "lib/schemacop/v2/collector.rb".freeze, "lib/schemacop/v2/dupper.rb".freeze, "lib/schemacop/v2/field_node.rb".freeze, "lib/schemacop/v2/node.rb".freeze, "lib/schemacop/v2/node_resolver.rb".freeze, "lib/schemacop/v2/node_supporting_field.rb".freeze, "lib/schemacop/v2/node_supporting_type.rb".freeze, "lib/schemacop/v2/node_with_block.rb".freeze, "lib/schemacop/v2/validator/array_validator.rb".freeze, "lib/schemacop/v2/validator/boolean_validator.rb".freeze, "lib/schemacop/v2/validator/float_validator.rb".freeze, "lib/schemacop/v2/validator/hash_validator.rb".freeze, "lib/schemacop/v2/validator/integer_validator.rb".freeze, "lib/schemacop/v2/validator/nil_validator.rb".freeze, "lib/schemacop/v2/validator/number_validator.rb".freeze, "lib/schemacop/v2/validator/object_validator.rb".freeze, "lib/schemacop/v2/validator/string_validator.rb".freeze, "lib/schemacop/v2/validator/symbol_validator.rb".freeze, "lib/schemacop/v3.rb".freeze, "lib/schemacop/v3/all_of_node.rb".freeze, "lib/schemacop/v3/any_of_node.rb".freeze, "lib/schemacop/v3/array_node.rb".freeze, "lib/schemacop/v3/boolean_node.rb".freeze, "lib/schemacop/v3/combination_node.rb".freeze, "lib/schemacop/v3/context.rb".freeze, "lib/schemacop/v3/dsl_scope.rb".freeze, "lib/schemacop/v3/global_context.rb".freeze, "lib/schemacop/v3/hash_node.rb".freeze, "lib/schemacop/v3/integer_node.rb".freeze, "lib/schemacop/v3/is_not_node.rb".freeze, "lib/schemacop/v3/node.rb".freeze, "lib/schemacop/v3/node_registry.rb".freeze, "lib/schemacop/v3/number_node.rb".freeze, "lib/schemacop/v3/numeric_node.rb".freeze, "lib/schemacop/v3/object_node.rb".freeze, "lib/schemacop/v3/one_of_node.rb".freeze, "lib/schemacop/v3/reference_node.rb".freeze, "lib/schemacop/v3/result.rb".freeze, "lib/schemacop/v3/string_node.rb".freeze, "lib/schemacop/v3/symbol_node.rb".freeze, "schemacop.gemspec".freeze, "test/lib/test_helper.rb".freeze, "test/schemas/nested/group.rb".freeze, "test/schemas/user.rb".freeze, "test/unit/schemacop/v2/casting_test.rb".freeze, "test/unit/schemacop/v2/collector_test.rb".freeze, "test/unit/schemacop/v2/custom_check_test.rb".freeze, "test/unit/schemacop/v2/custom_if_test.rb".freeze, "test/unit/schemacop/v2/defaults_test.rb".freeze, "test/unit/schemacop/v2/empty_test.rb".freeze, "test/unit/schemacop/v2/nil_dis_allow_test.rb".freeze, "test/unit/schemacop/v2/node_resolver_test.rb".freeze, "test/unit/schemacop/v2/short_forms_test.rb".freeze, "test/unit/schemacop/v2/types_test.rb".freeze, "test/unit/schemacop/v2/validator_array_test.rb".freeze, "test/unit/schemacop/v2/validator_boolean_test.rb".freeze, "test/unit/schemacop/v2/validator_float_test.rb".freeze, "test/unit/schemacop/v2/validator_hash_test.rb".freeze, "test/unit/schemacop/v2/validator_integer_test.rb".freeze, "test/unit/schemacop/v2/validator_nil_test.rb".freeze, "test/unit/schemacop/v2/validator_number_test.rb".freeze, "test/unit/schemacop/v2/validator_object_test.rb".freeze, "test/unit/schemacop/v2/validator_string_test.rb".freeze, "test/unit/schemacop/v2/validator_symbol_test.rb".freeze, "test/unit/schemacop/v3/all_of_node_test.rb".freeze, "test/unit/schemacop/v3/any_of_node_test.rb".freeze, "test/unit/schemacop/v3/array_node_test.rb".freeze, "test/unit/schemacop/v3/boolean_node_test.rb".freeze, "test/unit/schemacop/v3/global_context_test.rb".freeze, "test/unit/schemacop/v3/hash_node_test.rb".freeze, "test/unit/schemacop/v3/integer_node_test.rb".freeze, "test/unit/schemacop/v3/is_not_node_test.rb".freeze, "test/unit/schemacop/v3/node_test.rb".freeze, "test/unit/schemacop/v3/number_node_test.rb".freeze, "test/unit/schemacop/v3/object_node_test.rb".freeze, "test/unit/schemacop/v3/one_of_node_test.rb".freeze, "test/unit/schemacop/v3/reference_node_test.rb".freeze, "test/unit/schemacop/v3/string_node_test.rb".freeze, "test/unit/schemacop/v3/symbol_node_test.rb".freeze]
+  s.date = "2026-05-12"
+  s.files = [".github/workflows/ruby.yml".freeze, ".gitignore".freeze, ".releaser_config".freeze, ".rubocop.yml".freeze, ".yardopts".freeze, "CHANGELOG.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "README_V2.md".freeze, "README_V3.md".freeze, "RUBY_VERSION".freeze, "Rakefile".freeze, "VERSION".freeze, "lib/schemacop.rb".freeze, "lib/schemacop/base_schema.rb".freeze, "lib/schemacop/exceptions.rb".freeze, "lib/schemacop/railtie.rb".freeze, "lib/schemacop/schema.rb".freeze, "lib/schemacop/schema2.rb".freeze, "lib/schemacop/schema3.rb".freeze, "lib/schemacop/scoped_env.rb".freeze, "lib/schemacop/v2.rb".freeze, "lib/schemacop/v2/caster.rb".freeze, "lib/schemacop/v2/collector.rb".freeze, "lib/schemacop/v2/dupper.rb".freeze, "lib/schemacop/v2/field_node.rb".freeze, "lib/schemacop/v2/node.rb".freeze, "lib/schemacop/v2/node_resolver.rb".freeze, "lib/schemacop/v2/node_supporting_field.rb".freeze, "lib/schemacop/v2/node_supporting_type.rb".freeze, "lib/schemacop/v2/node_with_block.rb".freeze, "lib/schemacop/v2/validator/array_validator.rb".freeze, "lib/schemacop/v2/validator/boolean_validator.rb".freeze, "lib/schemacop/v2/validator/float_validator.rb".freeze, "lib/schemacop/v2/validator/hash_validator.rb".freeze, "lib/schemacop/v2/validator/integer_validator.rb".freeze, "lib/schemacop/v2/validator/nil_validator.rb".freeze, "lib/schemacop/v2/validator/number_validator.rb".freeze, "lib/schemacop/v2/validator/object_validator.rb".freeze, "lib/schemacop/v2/validator/string_validator.rb".freeze, "lib/schemacop/v2/validator/symbol_validator.rb".freeze, "lib/schemacop/v3.rb".freeze, "lib/schemacop/v3/all_of_node.rb".freeze, "lib/schemacop/v3/any_of_node.rb".freeze, "lib/schemacop/v3/array_node.rb".freeze, "lib/schemacop/v3/binary_node.rb".freeze, "lib/schemacop/v3/boolean_node.rb".freeze, "lib/schemacop/v3/combination_node.rb".freeze, "lib/schemacop/v3/context.rb".freeze, "lib/schemacop/v3/dsl_scope.rb".freeze, "lib/schemacop/v3/global_context.rb".freeze, "lib/schemacop/v3/hash_node.rb".freeze, "lib/schemacop/v3/integer_node.rb".freeze, "lib/schemacop/v3/is_not_node.rb".freeze, "lib/schemacop/v3/node.rb".freeze, "lib/schemacop/v3/node_registry.rb".freeze, "lib/schemacop/v3/number_node.rb".freeze, "lib/schemacop/v3/numeric_node.rb".freeze, "lib/schemacop/v3/object_node.rb".freeze, "lib/schemacop/v3/one_of_node.rb".freeze, "lib/schemacop/v3/reference_node.rb".freeze, "lib/schemacop/v3/result.rb".freeze, "lib/schemacop/v3/string_node.rb".freeze, "lib/schemacop/v3/symbol_node.rb".freeze, "schemacop.gemspec".freeze, "test/lib/test_helper.rb".freeze, "test/schemas/nested/group.rb".freeze, "test/schemas/user.rb".freeze, "test/unit/schemacop/v2/casting_test.rb".freeze, "test/unit/schemacop/v2/collector_test.rb".freeze, "test/unit/schemacop/v2/custom_check_test.rb".freeze, "test/unit/schemacop/v2/custom_if_test.rb".freeze, "test/unit/schemacop/v2/defaults_test.rb".freeze, "test/unit/schemacop/v2/empty_test.rb".freeze, "test/unit/schemacop/v2/nil_dis_allow_test.rb".freeze, "test/unit/schemacop/v2/node_resolver_test.rb".freeze, "test/unit/schemacop/v2/short_forms_test.rb".freeze, "test/unit/schemacop/v2/types_test.rb".freeze, "test/unit/schemacop/v2/validator_array_test.rb".freeze, "test/unit/schemacop/v2/validator_boolean_test.rb".freeze, "test/unit/schemacop/v2/validator_float_test.rb".freeze, "test/unit/schemacop/v2/validator_hash_test.rb".freeze, "test/unit/schemacop/v2/validator_integer_test.rb".freeze, "test/unit/schemacop/v2/validator_nil_test.rb".freeze, "test/unit/schemacop/v2/validator_number_test.rb".freeze, "test/unit/schemacop/v2/validator_object_test.rb".freeze, "test/unit/schemacop/v2/validator_string_test.rb".freeze, "test/unit/schemacop/v2/validator_symbol_test.rb".freeze, "test/unit/schemacop/v3/all_of_node_test.rb".freeze, "test/unit/schemacop/v3/any_of_node_test.rb".freeze, "test/unit/schemacop/v3/array_node_test.rb".freeze, "test/unit/schemacop/v3/binary_node_test.rb".freeze, "test/unit/schemacop/v3/boolean_node_test.rb".freeze, "test/unit/schemacop/v3/global_context_test.rb".freeze, "test/unit/schemacop/v3/hash_node_test.rb".freeze, "test/unit/schemacop/v3/integer_node_test.rb".freeze, "test/unit/schemacop/v3/is_not_node_test.rb".freeze, "test/unit/schemacop/v3/node_test.rb".freeze, "test/unit/schemacop/v3/number_node_test.rb".freeze, "test/unit/schemacop/v3/object_node_test.rb".freeze, "test/unit/schemacop/v3/one_of_node_test.rb".freeze, "test/unit/schemacop/v3/reference_node_test.rb".freeze, "test/unit/schemacop/v3/string_node_test.rb".freeze, "test/unit/schemacop/v3/symbol_node_test.rb".freeze]
   s.homepage = "https://github.com/sitrox/schemacop".freeze
   s.licenses = ["MIT".freeze]
   s.rubygems_version = "3.5.18".freeze
   s.summary = "Schemacop validates ruby structures consisting of nested hashes and arrays against simple schema definitions.".freeze
-  s.test_files = ["test/lib/test_helper.rb".freeze, "test/schemas/nested/group.rb".freeze, "test/schemas/user.rb".freeze, "test/unit/schemacop/v2/casting_test.rb".freeze, "test/unit/schemacop/v2/collector_test.rb".freeze, "test/unit/schemacop/v2/custom_check_test.rb".freeze, "test/unit/schemacop/v2/custom_if_test.rb".freeze, "test/unit/schemacop/v2/defaults_test.rb".freeze, "test/unit/schemacop/v2/empty_test.rb".freeze, "test/unit/schemacop/v2/nil_dis_allow_test.rb".freeze, "test/unit/schemacop/v2/node_resolver_test.rb".freeze, "test/unit/schemacop/v2/short_forms_test.rb".freeze, "test/unit/schemacop/v2/types_test.rb".freeze, "test/unit/schemacop/v2/validator_array_test.rb".freeze, "test/unit/schemacop/v2/validator_boolean_test.rb".freeze, "test/unit/schemacop/v2/validator_float_test.rb".freeze, "test/unit/schemacop/v2/validator_hash_test.rb".freeze, "test/unit/schemacop/v2/validator_integer_test.rb".freeze, "test/unit/schemacop/v2/validator_nil_test.rb".freeze, "test/unit/schemacop/v2/validator_number_test.rb".freeze, "test/unit/schemacop/v2/validator_object_test.rb".freeze, "test/unit/schemacop/v2/validator_string_test.rb".freeze, "test/unit/schemacop/v2/validator_symbol_test.rb".freeze, "test/unit/schemacop/v3/all_of_node_test.rb".freeze, "test/unit/schemacop/v3/any_of_node_test.rb".freeze, "test/unit/schemacop/v3/array_node_test.rb".freeze, "test/unit/schemacop/v3/boolean_node_test.rb".freeze, "test/unit/schemacop/v3/global_context_test.rb".freeze, "test/unit/schemacop/v3/hash_node_test.rb".freeze, "test/unit/schemacop/v3/integer_node_test.rb".freeze, "test/unit/schemacop/v3/is_not_node_test.rb".freeze, "test/unit/schemacop/v3/node_test.rb".freeze, "test/unit/schemacop/v3/number_node_test.rb".freeze, "test/unit/schemacop/v3/object_node_test.rb".freeze, "test/unit/schemacop/v3/one_of_node_test.rb".freeze, "test/unit/schemacop/v3/reference_node_test.rb".freeze, "test/unit/schemacop/v3/string_node_test.rb".freeze, "test/unit/schemacop/v3/symbol_node_test.rb".freeze]
+  s.test_files = ["test/lib/test_helper.rb".freeze, "test/schemas/nested/group.rb".freeze, "test/schemas/user.rb".freeze, "test/unit/schemacop/v2/casting_test.rb".freeze, "test/unit/schemacop/v2/collector_test.rb".freeze, "test/unit/schemacop/v2/custom_check_test.rb".freeze, "test/unit/schemacop/v2/custom_if_test.rb".freeze, "test/unit/schemacop/v2/defaults_test.rb".freeze, "test/unit/schemacop/v2/empty_test.rb".freeze, "test/unit/schemacop/v2/nil_dis_allow_test.rb".freeze, "test/unit/schemacop/v2/node_resolver_test.rb".freeze, "test/unit/schemacop/v2/short_forms_test.rb".freeze, "test/unit/schemacop/v2/types_test.rb".freeze, "test/unit/schemacop/v2/validator_array_test.rb".freeze, "test/unit/schemacop/v2/validator_boolean_test.rb".freeze, "test/unit/schemacop/v2/validator_float_test.rb".freeze, "test/unit/schemacop/v2/validator_hash_test.rb".freeze, "test/unit/schemacop/v2/validator_integer_test.rb".freeze, "test/unit/schemacop/v2/validator_nil_test.rb".freeze, "test/unit/schemacop/v2/validator_number_test.rb".freeze, "test/unit/schemacop/v2/validator_object_test.rb".freeze, "test/unit/schemacop/v2/validator_string_test.rb".freeze, "test/unit/schemacop/v2/validator_symbol_test.rb".freeze, "test/unit/schemacop/v3/all_of_node_test.rb".freeze, "test/unit/schemacop/v3/any_of_node_test.rb".freeze, "test/unit/schemacop/v3/array_node_test.rb".freeze, "test/unit/schemacop/v3/binary_node_test.rb".freeze, "test/unit/schemacop/v3/boolean_node_test.rb".freeze, "test/unit/schemacop/v3/global_context_test.rb".freeze, "test/unit/schemacop/v3/hash_node_test.rb".freeze, "test/unit/schemacop/v3/integer_node_test.rb".freeze, "test/unit/schemacop/v3/is_not_node_test.rb".freeze, "test/unit/schemacop/v3/node_test.rb".freeze, "test/unit/schemacop/v3/number_node_test.rb".freeze, "test/unit/schemacop/v3/object_node_test.rb".freeze, "test/unit/schemacop/v3/one_of_node_test.rb".freeze, "test/unit/schemacop/v3/reference_node_test.rb".freeze, "test/unit/schemacop/v3/string_node_test.rb".freeze, "test/unit/schemacop/v3/symbol_node_test.rb".freeze]
 
   s.specification_version = 4
 

data/test/unit/schemacop/v2/casting_test.rb

@@ -75,7 +75,7 @@ module Schemacop
           end
         end
 
-        assert_equal 'Casting is only allowed for single-value datatypes, '\
+        assert_equal 'Casting is only allowed for single-value datatypes, ' \
                      'but type Schemacop::V2::NumberValidator has classes ["Integer", "Float"].',
                      e.message
       end

data/test/unit/schemacop/v2/custom_check_test.rb

@@ -4,7 +4,7 @@ module Schemacop
   module V2
     class CustomCheckTest < V2Test
       def test_integer_check_short_form
-        s = Schema.new :integer, check: proc { |i| i.even? }
+        s = Schema.new :integer, check: proc(&:even?)
         assert_nothing_raised { s.validate!(2) }
         assert_nothing_raised { s.validate!(-8) }
         assert_nothing_raised { s.validate!(0) }
@@ -22,7 +22,7 @@ module Schemacop
 
       def test_integer_check_with_lambda
         s = Schema.new do
-          type :integer, check: ->(i) { i.even? }
+          type :integer, check: lambda(&:even?)
         end
 
         assert_nothing_raised { s.validate!(2) }

data/test/unit/schemacop/v2/custom_if_test.rb

@@ -5,7 +5,7 @@ module Schemacop
     class CustomIfTest < V2Test
       def test_allowed_subset_only
         s = Schema.new do
-          type :integer, if: proc { |data| data.odd? }
+          type :integer, if: proc(&:odd?)
         end
 
         assert_nothing_raised { s.validate! 5 }
@@ -15,7 +15,7 @@ module Schemacop
 
       def test_if_with_multiple_types
         s = Schema.new do
-          type :integer, if: proc { |data| data.odd? }
+          type :integer, if: proc(&:odd?)
           type :string
         end
 

data/test/unit/schemacop/v3/any_of_node_test.rb

@@ -362,6 +362,30 @@ module Schemacop
           schema :any_of
         end
       end
+
+      # With cast_str as default option, int gets wrapped in a OneOfNode containing
+      # [IntegerNode, StringNode(format: :integer)]. In any_of, the first matching
+      # schema is used for casting. Since the wrapped int node matches numeric-looking
+      # strings (via StringNode(format: :integer)), a string like "1" gets cast to
+      # integer 1, even though the plain str branch also matches and the value is
+      # already a valid string.
+      def test_default_cast_str_with_int_and_str
+        Schemacop.v3_default_options = { cast_str: true }.freeze
+
+        schema :any_of do
+          int
+          str
+        end
+
+        assert_validation(42)
+        assert_validation('hello')
+        assert_validation('1')
+        assert_cast(42, 42)
+        assert_cast('hello', 'hello')
+        assert_cast('1', '1')
+      ensure
+        Schemacop.v3_default_options = {}
+      end
     end
   end
 end

data/test/unit/schemacop/v3/array_node_test.rb

@@ -988,13 +988,52 @@ module Schemacop
         end
 
         assert_validation('{42]') do
-          error '/', /JSON parse error: "((\d+: )?unexpected token at '{42]'|expected object key, got '42]' at line \d+ column \d+)"\./
+          error '/', /JSON parse error: "((\d+: )?unexpected token at '{42\]'|expected object key, got '42\]' at line \d+ column \d+)"\./
         end
 
         assert_validation('"foo"') do
           error '/', 'Invalid type, got type "String", expected "array".'
         end
       end
+
+      def test_tuple_cast_with_default_cast_str
+        Schemacop.v3_default_options = { cast_str: true }.freeze
+
+        schema :array do
+          list :array do
+            int
+            str
+          end
+        end
+
+        # String "1" at position 1 (str) must not be cast to integer
+        assert_validation([[1, '1']])
+        assert_cast([[1, '1']], [[1, '1']])
+
+        # String "1" at position 0 (int with cast_str) should be cast to integer
+        assert_validation([%w[1 foo]])
+        assert_cast([%w[1 foo]], [[1, 'foo']])
+      ensure
+        Schemacop.v3_default_options = {}
+      end
+
+      # With cast_str as default option, cont :integer creates a OneOfNode containing
+      # [IntegerNode, StringNode(format: :integer)]. The cont_item takes priority in
+      # casting over the list_item, so numeric-looking strings that match the cont
+      # schema get cast to integers even though the list schema says they are strings.
+      def test_cont_cast_with_default_cast_str
+        Schemacop.v3_default_options = { cast_str: true }.freeze
+
+        schema :array do
+          list :string
+          cont :integer
+        end
+
+        assert_validation(%w[hello 42 world])
+        assert_cast(%w[hello 42 world], %w[hello 42 world])
+      ensure
+        Schemacop.v3_default_options = {}
+      end
     end
   end
 end

data/test/unit/schemacop/v3/binary_node_test.rb

@@ -0,0 +1,266 @@
+require 'test_helper'
+
+module Schemacop
+  module V3
+    class BinaryNodeTest < V3Test
+      def test_basic
+        schema :binary
+
+        assert_validation nil
+        assert_validation Tempfile.new('test')
+        assert_validation 'binary string data'
+
+        assert_json(type: :string, format: :binary)
+      end
+
+      def test_required
+        schema :binary, required: true
+
+        assert_validation Tempfile.new('test')
+
+        assert_validation nil do
+          error '/', 'Value must be given.'
+        end
+
+        assert_json(type: :string, format: :binary)
+      end
+
+      def test_type
+        schema :binary
+
+        assert_validation 'foo'
+        assert_validation Tempfile.new('test')
+
+        assert_validation 42 do
+          error '/', 'Invalid type, got type "Integer", expected "String" or "Tempfile".'
+        end
+
+        assert_validation true do
+          error '/', 'Invalid type, got type "TrueClass", expected "String" or "Tempfile".'
+        end
+
+        assert_validation :foo do
+          error '/', 'Invalid type, got type "Symbol", expected "String" or "Tempfile".'
+        end
+      end
+
+      def test_hash
+        schema do
+          bin! :attachment
+        end
+
+        assert_json(
+          type:                 :object,
+          properties:           {
+            attachment: { type: :string, format: :binary }
+          },
+          required:             %i[attachment],
+          additionalProperties: false
+        )
+
+        assert_validation attachment: Tempfile.new('test')
+        assert_validation attachment: 'binary data'
+
+        assert_validation({}) do
+          error '/attachment', 'Value must be given.'
+        end
+
+        assert_validation(attachment: 42) do
+          error '/attachment', 'Invalid type, got type "Integer", expected "String" or "Tempfile".'
+        end
+      end
+
+      def test_hash_optional
+        schema do
+          bin? :attachment
+        end
+
+        assert_json(
+          type:                 :object,
+          properties:           {
+            attachment: { type: :string, format: :binary }
+          },
+          additionalProperties: false
+        )
+
+        assert_validation attachment: Tempfile.new('test')
+        assert_validation({})
+        assert_validation attachment: nil
+      end
+
+      def test_array
+        schema(:array) do
+          list :binary
+        end
+
+        assert_validation [Tempfile.new('a'), Tempfile.new('b')]
+        assert_json(type: :array, items: { type: :string, format: :binary })
+      end
+
+      def test_with_custom_classes
+        schema :binary, classes: [String, Integer]
+
+        assert_validation 'hello'
+        assert_validation 42
+        assert_validation nil
+
+        assert_validation :foo do
+          error '/', 'Invalid type, got type "Symbol", expected "Integer" or "String".'
+        end
+      end
+
+      def test_with_single_custom_class
+        schema :binary, classes: [Tempfile]
+
+        assert_validation Tempfile.new('test')
+
+        assert_validation 'hello' do
+          error '/', 'Invalid type, got type "String", expected "Tempfile".'
+        end
+      end
+
+      def test_custom_classes_uses_is_a
+        schema :binary, classes: [Numeric]
+
+        assert_validation 42
+        assert_validation 3.14
+        assert_validation BigDecimal('1.5')
+
+        assert_validation 'hello' do
+          error '/', 'Invalid type, got type "String", expected "Numeric".'
+        end
+      end
+
+      def test_default
+        schema :binary, default: Tempfile.new('default')
+
+        assert_validation nil
+        assert_validation Tempfile.new('other')
+      end
+
+      def test_enum
+        tempfile_a = Tempfile.new('a')
+        tempfile_b = Tempfile.new('b')
+        tempfile_c = Tempfile.new('c')
+
+        schema :binary, enum: [tempfile_a, tempfile_b]
+
+        assert_validation nil
+        assert_validation tempfile_a
+        assert_validation tempfile_b
+
+        assert_validation tempfile_c do
+          error '/', /Value not included in enum/
+        end
+      end
+
+      def test_with_generic_keywords
+        schema :binary, title:       'Binary schema',
+                        description: 'Binary schema holding generic keywords',
+                        examples:    [
+                          'binary data'
+                        ]
+
+        assert_json(
+          type:        :string,
+          format:      :binary,
+          title:       'Binary schema',
+          description: 'Binary schema holding generic keywords',
+          examples:    [
+            'binary data'
+          ]
+        )
+      end
+
+      def test_validate_self_classes_not_array
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "classes" must be an array of classes.' do
+          schema :binary, classes: 'String'
+        end
+      end
+
+      def test_validate_self_classes_empty
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "classes" must not be empty.' do
+          schema :binary, classes: []
+        end
+      end
+
+      def test_validate_self_classes_not_classes
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "classes" must contain classes, got "String".' do
+          schema :binary, classes: ['String']
+        end
+      end
+
+      def test_validate_self_classes_mixed
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "classes" must contain classes, got :symbol.' do
+          schema :binary, classes: [String, :symbol]
+        end
+      end
+
+      def test_validate_self_classes_with_module
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "classes" must contain classes, got Comparable.' do
+          schema :binary, classes: [Comparable]
+        end
+      end
+
+      def test_cast
+        tempfile = Tempfile.new('test')
+        schema :binary
+
+        result = @schema.validate(tempfile)
+        assert_empty result.errors
+        assert_equal tempfile, result.data
+
+        result = @schema.validate(nil)
+        assert_empty result.errors
+        assert_nil result.data
+      end
+
+      def test_cast_default
+        default_file = Tempfile.new('default')
+        schema :binary, default: default_file
+
+        result = @schema.validate(nil)
+        assert_empty result.errors
+        assert_equal default_file, result.data
+      end
+
+      def test_cast_in_hash
+        schema do
+          bin? :attachment
+        end
+
+        tempfile = Tempfile.new('test')
+        result = @schema.validate(attachment: tempfile)
+        assert_empty result.errors
+        assert_equal({ 'attachment' => tempfile }, result.data)
+
+        result = @schema.validate({})
+        assert_empty result.errors
+        assert_equal({}, result.data)
+      end
+
+      def test_default_classes_include_string
+        schema :binary
+
+        assert_validation 'a plain string'
+      end
+
+      def test_as_json
+        schema :binary
+
+        assert_json(type: :string, format: :binary)
+      end
+
+      def test_swagger_json
+        schema :binary
+
+        assert_swagger_json(type: :string, format: :binary)
+      end
+    end
+  end
+end

data/test/unit/schemacop/v3/hash_node_test.rb

@@ -32,7 +32,7 @@ module Schemacop
         end
 
         assert_validation('{42]') do
-          error '/', /JSON parse error: "((\d+: )?unexpected token at '{42]'|expected object key, got '42]' at line \d+ column \d+)"\./
+          error '/', /JSON parse error: "((\d+: )?unexpected token at '{42\]'|expected object key, got '42\]' at line \d+ column \d+)"\./
         end
 
         assert_validation('"foo"') do

data/test/unit/schemacop/v3/integer_node_test.rb

@@ -256,7 +256,7 @@ module Schemacop
         end
 
         assert_raises_with_message Exceptions::InvalidSchemaError,
-                                   'Option "exclusive_minimum" can\'t be '\
+                                   'Option "exclusive_minimum" can\'t be ' \
                                    'greater than "exclusive_maximum".' do
           schema :integer, exclusive_minimum: 5, exclusive_maximum: 4
         end

data/test/unit/schemacop/v3/number_node_test.rb

@@ -298,7 +298,7 @@ module Schemacop
         end
 
         assert_raises_with_message Exceptions::InvalidSchemaError,
-                                   'Option "exclusive_minimum" can\'t be '\
+                                   'Option "exclusive_minimum" can\'t be ' \
                                    'greater than "exclusive_maximum".' do
           schema :number, exclusive_minimum: 5, exclusive_maximum: 4
         end

data/test/unit/schemacop/v3/one_of_node_test.rb

@@ -259,6 +259,29 @@ module Schemacop
         assert_validation('true')
         assert_validation(true)
       end
+
+      # With cast_str as default option, int gets wrapped in a OneOfNode containing
+      # [IntegerNode, StringNode(format: :integer)]. When combined with a sibling str
+      # node in one_of, numeric-looking strings like "1" match both the wrapped int
+      # (via StringNode(format: :integer)) and the plain str, causing a "matches 2"
+      # validation error.
+      def test_default_cast_str_with_int_and_str
+        Schemacop.v3_default_options = { cast_str: true }.freeze
+
+        schema :one_of do
+          int
+          str
+        end
+
+        assert_validation(42)
+        assert_validation('hello')
+        assert_validation('1')
+        assert_cast(42, 42)
+        assert_cast('hello', 'hello')
+        assert_cast('1', '1')
+      ensure
+        Schemacop.v3_default_options = {}
+      end
     end
   end
 end

data/test/unit/schemacop/v3/string_node_test.rb

@@ -653,7 +653,7 @@ module Schemacop
         end
 
         assert_raises_with_message Exceptions::InvalidSchemaError,
-                                   'Option "pattern" can\'t be parsed: end pattern '\
+                                   'Option "pattern" can\'t be parsed: end pattern ' \
                                    'with unmatched parenthesis: /(abcde/.' do
           schema :string, pattern: '(abcde'
         end
@@ -750,6 +750,74 @@ module Schemacop
         assert_cast("\t", "\t")
       end
 
+      def test_encoding_single
+        schema :string, encoding: 'UTF-8'
+
+        assert_validation 'Hello World'
+        assert_validation ''
+
+        assert_validation 'Hello World'.encode('ASCII') do
+          error '/', 'String has encoding "US-ASCII" but must be "UTF-8".'
+        end
+      end
+
+      def test_encoding_multiple
+        schema :string, encoding: %w[UTF-8 US-ASCII]
+
+        assert_validation 'Hello World'
+        assert_validation 'Hello World'.encode('ASCII')
+
+        assert_validation 'Hello World'.encode('ISO-8859-1') do
+          error '/', 'String has encoding "ISO-8859-1" but must be "UTF-8" or "US-ASCII".'
+        end
+      end
+
+      def test_encoding_with_nil
+        schema :string, encoding: 'UTF-8'
+
+        assert_validation nil
+      end
+
+      def test_encoding_invalid_bytes
+        schema :string, encoding: 'UTF-8'
+
+        invalid_string = "abc\x80def".force_encoding('UTF-8')
+        assert_validation invalid_string do
+          error '/', 'String has invalid "UTF-8" encoding.'
+        end
+      end
+
+      def test_encoding_invalid_bytes_without_specific_encoding
+        schema :string
+
+        invalid_string = "abc\x80def".force_encoding('UTF-8')
+        assert_validation invalid_string do
+          error '/', 'String has invalid "UTF-8" encoding.'
+        end
+      end
+
+      def test_encoding_validate_self
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "encoding" must be a string or an array of strings.' do
+          schema :string, encoding: 123
+        end
+
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "encoding" must be a string or an array of strings.' do
+          schema :string, encoding: [123]
+        end
+
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "encoding" contains unknown encoding "UNKNOWN-FOO".' do
+          schema :string, encoding: 'UNKNOWN-FOO'
+        end
+
+        assert_raises_with_message Exceptions::InvalidSchemaError,
+                                   'Option "encoding" contains unknown encoding "UNKNOWN-FOO".' do
+          schema :string, encoding: %w[UTF-8 UNKNOWN-FOO]
+        end
+      end
+
       def test_empty_or_whitespace_string_blank_not_allowed
         schema :string, allow_blank: false
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: schemacop
 version: !ruby/object:Gem::Version
-  version: 3.0.38
+  version: 3.1.0
 platform: ruby
 authors:
 - Sitrox
 bindir: bin
 cert_chain: []
-date: 2026-02-25 00:00:00.000000000 Z
+date: 2026-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -87,6 +87,7 @@ files:
 - lib/schemacop/v3/all_of_node.rb
 - lib/schemacop/v3/any_of_node.rb
 - lib/schemacop/v3/array_node.rb
+- lib/schemacop/v3/binary_node.rb
 - lib/schemacop/v3/boolean_node.rb
 - lib/schemacop/v3/combination_node.rb
 - lib/schemacop/v3/context.rb
@@ -132,6 +133,7 @@ files:
 - test/unit/schemacop/v3/all_of_node_test.rb
 - test/unit/schemacop/v3/any_of_node_test.rb
 - test/unit/schemacop/v3/array_node_test.rb
+- test/unit/schemacop/v3/binary_node_test.rb
 - test/unit/schemacop/v3/boolean_node_test.rb
 - test/unit/schemacop/v3/global_context_test.rb
 - test/unit/schemacop/v3/hash_node_test.rb
@@ -193,6 +195,7 @@ test_files:
 - test/unit/schemacop/v3/all_of_node_test.rb
 - test/unit/schemacop/v3/any_of_node_test.rb
 - test/unit/schemacop/v3/array_node_test.rb
+- test/unit/schemacop/v3/binary_node_test.rb
 - test/unit/schemacop/v3/boolean_node_test.rb
 - test/unit/schemacop/v3/global_context_test.rb
 - test/unit/schemacop/v3/hash_node_test.rb