schemacop 3.0.38 → 3.0.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a3a54c489ac60b4a01424d7a4949724c15fdec793de16a4375e3097f691128b
-  data.tar.gz: 48390b41d456f5362ecabf0e97ed37fdc035247ec3d8335d105e97ab0d858378
+  metadata.gz: 5265f8c948ca9f0d23aa7e13ff78a5a980ce12ccd16c6fd1dae4e8ec6a30b833
+  data.tar.gz: 77177403eccb133730a9359172c6d37362d2d76184a2758131bcd35fe5869f0a
 SHA512:
-  metadata.gz: 911a618277694321833a85cc051ff139b14e9a1117dab7380bcc4c9ebc08e87a258f131224e1f3cef40d5b6495de6142f1b6f23009ce62917c8a07bf75960678
-  data.tar.gz: 1add721c851198435cf89b0b9d95d94c607bc443df180072fda1b35d4b956a4a2bdab429252f630fca8e4ddf09baf13153278d60f401318e0ad591bbc7c481b8
+  metadata.gz: 306a17bfebac65db3f0c7fbd37f2b5d0fa3c44b26c6217732241fa8cd43455a552a07f21327c805d421c0a2649f8b1b936b8063d9cf5b97673e416aea3dff8b6
+  data.tar.gz: 64f2e2a148374b811fb4ac251606b25c48be802a1255e3dd72389aa2f4250f59695dba9b20b8cc62f48a9e646ea45d6cc9c9aeacc216b4704300b3864fa1701c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)

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.38
+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.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.38 ruby lib
+# stub: schemacop 3.0.39 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "schemacop".freeze
-  s.version = "3.0.38".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-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-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

metadata

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