Add jsonSchemaDialect field to openapi node

This is a field introduced in OpenAPI 3.1 and it defaults to the
OpenAPI 3.1 dialect. My intention is to only support this dialect for
OpenAPI 3.1.

Author: kevindew

lib/openapi3_parser/document.rb

@@ -38,6 +38,10 @@ class Document
     #   The value of the info field on the OpenAPI document
     #   @see Node::Openapi#info
     #   @return [Node::Info]
+    # @!method jsonSchemaDialect
+    #   The value of the jsonSchemaDialect field on the OpenAPI document
+    #   @see Node::Openapi#json_schema_dialect
+    #   @return [String, nil]
     # @!method servers
     #   The value of the servers field on the OpenAPI document
     #   @see Node::Openapi#servers
@@ -75,9 +79,9 @@ class Document
     #   Iterate through the attributes of the root object
     # @!method keys
     #   Access keys of the root object
-    def_delegators :root, :openapi, :info, :servers, :paths, :components,
-                   :security, :tags, :external_docs, :extension, :[], :each,
-                   :keys
+    def_delegators :root, :openapi, :info, :json_schema_dialect, :servers,
+                   :paths, :components, :security, :tags, :external_docs,
+                   :extension, :[], :each, :keys
 
     # @param [SourceInput]  source_input
     # @param [Boolean]      emit_warnings   Whether to call Kernel.warn when
@@ -175,7 +179,7 @@ def look_up_pointer(pointer, relative_pointer, subject)
     end
 
     def add_warning(text)
-      warn("Warning: #{text}") if emit_warnings
+      warn("Warning: #{text} - disable these by opening a document with emit_warnings: false") if emit_warnings
       @warnings << text
     end
 

lib/openapi3_parser/node/openapi.rb

@@ -17,6 +17,13 @@ def info
         self["info"]
       end
 
+      # The default jsonSchemaDialect for this document
+      #
+      # @return [String, nil]
+      def json_schema_dialect
+        self["jsonSchemaDialect"]
+      end
+
       # @return [Node::Array<Server>]
       def servers
         self["servers"]

lib/openapi3_parser/node_factory/openapi.rb

@@ -16,6 +16,7 @@ class Openapi < NodeFactory::Object
       field "jsonSchemaDialect",
             default: "https://spec.openapis.org/oas/3.1/dialect/base",
             input_type: String,
+            validate: Validation::InputValidator.new(Validators::Uri),
             allowed: ->(context) { context.openapi_version >= "3.1" }
       field "servers", factory: :servers_factory
       field "paths",

spec/lib/openapi3_parser/node_factory/openapi_spec.rb

@@ -165,10 +165,26 @@
         .to have_validation_error("#/")
         .with_message("At least one of components, paths and webhooks fields are required")
     end
+
+    it "accepts a jsonSchemaDialect field" do
+      factory_context = create_node_factory_context(
+        minimal_openapi_definition.merge({ "openapi" => "3.1.0",
+                                           "jsonSchemaDialect" => "uri://to/dialect" }),
+        document_input: { "openapi" => "3.1.0" }
+      )
+
+      instance = described_class.new(factory_context)
+      expect(instance).to be_valid
+    end
+
+    it "defaults to the OAS 3.1 jsonSchemaDialect" do
+      node = create_node(minimal_openapi_definition.merge({ "openapi" => "3.1.0" }))
+      expect(node.json_schema_dialect).to eq("https://spec.openapis.org/oas/3.1/dialect/base")
+    end
   end
 
   def create_node(input)
-    node_factory_context = create_node_factory_context(input)
+    node_factory_context = create_node_factory_context(input, document_input: { openapi: input["openapi"] })
     instance = described_class.new(node_factory_context)
     node_context = node_factory_context_to_node_context(node_factory_context)
     instance.node(node_context)

spec/support/examples/v3.1/changes.yaml

@@ -3,10 +3,10 @@ info:
   title: Examples of changes in OpenAPI 3.1
   summary: 3.1 introduced a summary field to the Info node
   version: 1.0.0
-  # license:
-  #   name: Apache 2.0
-  #   identifier: Apache-2.0
-# jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
+  license:
+    name: Apache 2.0
+    identifier: Apache-2.0
+jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
 components:
   examples:
     FullExample: