schemacop 3.0.39 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5265f8c948ca9f0d23aa7e13ff78a5a980ce12ccd16c6fd1dae4e8ec6a30b833
-  data.tar.gz: 77177403eccb133730a9359172c6d37362d2d76184a2758131bcd35fe5869f0a
+  metadata.gz: 9ef422cfe57686302457be2282f2b8e5f45ccdc79d6cd62597e8308bbb94026e
+  data.tar.gz: d45307834a863e1fdfdf616acbb9727fd78db428ce88436c27a67db88a3e802f
 SHA512:
-  metadata.gz: 306a17bfebac65db3f0c7fbd37f2b5d0fa3c44b26c6217732241fa8cd43455a552a07f21327c805d421c0a2649f8b1b936b8063d9cf5b97673e416aea3dff8b6
-  data.tar.gz: 64f2e2a148374b811fb4ac251606b25c48be802a1255e3dd72389aa2f4250f59695dba9b20b8cc62f48a9e646ea45d6cc9c9aeacc216b4704300b3864fa1701c
+  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,32 @@
 # 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.

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

@@ -224,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
 

data/VERSION

@@ -1 +1 @@
-3.0.39
+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/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.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,14 +1,14 @@
 # -*- encoding: utf-8 -*-
-# stub: schemacop 3.0.39 ruby lib
+# stub: schemacop 3.1.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "schemacop".freeze
-  s.version = "3.0.39".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-03-26"
+  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]

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/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.39
+  version: 3.1.0
 platform: ruby
 authors:
 - Sitrox
 bindir: bin
 cert_chain: []
-date: 2026-03-26 00:00:00.000000000 Z
+date: 2026-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport