schemacop 3.0.37 → 3.0.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56a24074bd3792c20ee7e2f0bb1a8c3f4aa6d411a9a4c8010c9a52f0e828e6a3
-  data.tar.gz: ca4a752be493fe721122a77c5fb6844098c968dddf860fdcb0e33ef9a98880c3
+  metadata.gz: 5265f8c948ca9f0d23aa7e13ff78a5a980ce12ccd16c6fd1dae4e8ec6a30b833
+  data.tar.gz: 77177403eccb133730a9359172c6d37362d2d76184a2758131bcd35fe5869f0a
 SHA512:
-  metadata.gz: da3e3672206befe40e6487677c6c879192a3fdaf450e3621566be86dd1ccc9c487571a70cf7f1933294d5de9cd86094791e22cd659109a97baa432917138f296
-  data.tar.gz: 69d79cf5ad0702b80f930a9227f9279c2f758b3cb51965596145d82ec735b0fe8bb6648f219b6c1858d82f8a339ccdc388db71c3767573a074562a063eefcade
+  metadata.gz: 306a17bfebac65db3f0c7fbd37f2b5d0fa3c44b26c6217732241fa8cd43455a552a07f21327c805d421c0a2649f8b1b936b8063d9cf5b97673e416aea3dff8b6
+  data.tar.gz: 64f2e2a148374b811fb4ac251606b25c48be802a1255e3dd72389aa2f4250f59695dba9b20b8cc62f48a9e646ea45d6cc9c9aeacc216b4704300b3864fa1701c

data/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Change log
 
+## 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)
+  output, `/` and `~` in schema paths are replaced with `.` (e.g.
+  `namespaced/user` becomes `namespaced.user`) to comply with the OpenAPI schema
+  name format. For plain JSON Schema output, paths are escaped per RFC 6901
+  (`~0` for `~`, `~1` for `/`).
+
+  Internal reference: `#146922`.
+
+* Fix `CombinationNode` (`one_of`, `any_of`, `all_of`) not exposing its items
+  via `children`. This caused `used_external_schemas` to miss any `ref` nodes
+  nested inside combination nodes, leading to missing entries in
+  `components.schemas` in OpenAPI output.
+
+* Normalize `ReferenceNode` path to symbol. When a schema reference is created
+  with a string path (e.g. `ref 'foo'`), the path is now converted to a symbol
+  to match the keys used by `GlobalContext`.
+
+  Internal reference: `#146922`.
+
 ## 3.0.37 (2026-02-24)
 
 * Add inline ref support for hash nodes via `ref! nil, :SchemaName`. This

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)
@@ -1290,6 +1291,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.37
+3.0.39

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/combination_node.rb

@@ -23,6 +23,10 @@ module Schemacop
         return item.cast(value)
       end
 
+      def children
+        @items
+      end
+
       def add_child(node)
         @items << node
       end

data/lib/schemacop/v3/reference_node.rb

@@ -1,6 +1,8 @@
 module Schemacop
   module V3
     class ReferenceNode < Node
+      RFC6901_ESCAPE = { '~' => '~0', '/' => '~1' }.freeze
+
       def self.allowed_options
         super + %i[path]
       end
@@ -12,9 +14,16 @@ module Schemacop
 
       def as_json
         if context.swagger_json?
-          process_json([], '$ref': "#/components/schemas/#{@path}")
+          # OpenAPI schema names must match ^[a-zA-Z0-9._-]+$, so we replace
+          # all non-conforming characters: `/` and `~` become `.`.
+          sanitized = @path.to_s.gsub(%r{[~/]}, '.')
+          process_json([], '$ref': "#/components/schemas/#{sanitized}")
         else
-          process_json([], '$ref': "#/definitions/#{@path}")
+          # Plain JSON Schema: use RFC 6901 JSON Pointer escaping in $ref.
+          # gsub with a hash is a single-pass substitution, so the RFC 6901
+          # order-of-escaping concern (~ before /) does not apply here.
+          escaped = @path.to_s.gsub(%r{[~/]}, RFC6901_ESCAPE)
+          process_json([], '$ref': "#/definitions/#{escaped}")
         end
       end
 
@@ -56,7 +65,7 @@ module Schemacop
       protected
 
       def init
-        @path = options.delete(:path)
+        @path = options.delete(:path)&.to_sym
       end
     end
   end

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/schemacop.gemspec

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

@@ -706,6 +706,104 @@ module Schemacop
         end
       end
 
+      def test_namespaced_schema_reference
+        context = Context.new
+
+        context.schema :'namespaced/user' do
+          str! :name
+        end
+
+        Schemacop.with_context context do
+          schema do
+            ref! :user, :'namespaced/user'
+          end
+
+          assert_json({
+                        properties:           {
+                          user: {
+                            '$ref' => '#/definitions/namespaced~1user'
+                          }
+                        },
+                        additionalProperties: false,
+                        required:             %w[user],
+                        type:                 :object
+                      })
+
+          assert_swagger_json({
+                                properties:           {
+                                  user: {
+                                    '$ref' => '#/components/schemas/namespaced.user'
+                                  }
+                                },
+                                additionalProperties: false,
+                                required:             %w[user],
+                                type:                 :object
+                              })
+
+          assert_validation(user: { name: 'John' })
+          assert_validation(user: { name: 42 }) do
+            error '/user/name', 'Invalid type, got type "Integer", expected "string".'
+          end
+        end
+      end
+
+      def test_namespaced_schema_reference_with_tilde
+        context = Context.new
+
+        context.schema :'config~item/sub' do
+          str! :value
+        end
+
+        Schemacop.with_context context do
+          schema do
+            ref! :item, :'config~item/sub'
+          end
+
+          assert_json({
+                        properties:           {
+                          item: {
+                            '$ref' => '#/definitions/config~0item~1sub'
+                          }
+                        },
+                        additionalProperties: false,
+                        required:             %w[item],
+                        type:                 :object
+                      })
+
+          assert_swagger_json({
+                                properties:           {
+                                  item: {
+                                    '$ref' => '#/components/schemas/config.item.sub'
+                                  }
+                                },
+                                additionalProperties: false,
+                                required:             %w[item],
+                                type:                 :object
+                              })
+
+          assert_validation(item: { value: 'hello' })
+        end
+      end
+
+      def test_ref_inside_one_of_used_external_schemas
+        context = Context.new
+
+        context.schema :Nested do
+          str! :value
+        end
+
+        Schemacop.with_context context do
+          schema do
+            one_of! :item do
+              ref :Nested
+              str
+            end
+          end
+
+          assert_includes @schema.root.used_external_schemas, :Nested
+        end
+      end
+
       def test_inline_ref_property_name_collision
         schema do
           scm :BasicInfo do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: schemacop
 version: !ruby/object:Gem::Version
-  version: 3.0.37
+  version: 3.0.39
 platform: ruby
 authors:
 - Sitrox
 bindir: bin
 cert_chain: []
-date: 2026-02-24 00:00:00.000000000 Z
+date: 2026-03-26 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