Add pathItems to components for OpenAPI 3.1

Author: kevindew

lib/openapi3_parser/node_factory/components.rb

@@ -15,6 +15,9 @@ class Components < NodeFactory::Object
       field "securitySchemes", factory: :security_schemes_factory
       field "links", factory: :links_factory
       field "callbacks", factory: :callbacks_factory
+      field "pathItems",
+            factory: :path_items_factory,
+            allowed: ->(context) { context.openapi_version >= "3.1" }
 
       def build_node(data, node_context)
         Node::Components.new(data, node_context)
@@ -62,6 +65,10 @@ def callbacks_factory(context)
         referenceable_map_factory(context, NodeFactory::Callback)
       end
 
+      def path_items_factory(context)
+        referenceable_map_factory(context, NodeFactory::PathItem)
+      end
+
       def referenceable_map_factory(context, factory)
         NodeFactory::Map.new(
           context,

spec/lib/openapi3_parser/node_factory/components_spec.rb

@@ -131,4 +131,30 @@
       expect(instance).to have_validation_error("#/responses")
     end
   end
+
+  describe "pathItems field" do
+    it "accepts this field for OpenAPI >= 3.1" do
+      factory_context = create_node_factory_context(
+        {
+          "pathItems" => { "key" => { "summary" => "Item summary" } }
+        },
+        document_input: { "openapi" => "3.1.0" }
+      )
+
+      instance = described_class.new(factory_context)
+      expect(instance).to be_valid
+    end
+
+    it "rejects this field for OpenAPI < 3.1" do
+      factory_context = create_node_factory_context(
+        {
+          "pathItems" => { "key" => { "summary" => "Item summary" } }
+        },
+        document_input: { "openapi" => "3.0.0" }
+      )
+
+      instance = described_class.new(factory_context)
+      expect(instance).not_to be_valid
+    end
+  end
 end