feat: inherit openapi metadata from parent blocks to child blocks

Allow openapi metadata specified in parent describe/context blocks to be
inherited by child it blocks, eliminating the need to specify metadata
on every individual test case.

Author: rhiroe

lib/rspec/openapi/extractors/rails.rb

@@ -16,7 +16,7 @@ def request_attributes(request, example)
 
     raise "No route matched for #{fixed_request.request_method} #{fixed_request.path_info}" if route.nil?
 
-    metadata = example.metadata[:openapi] || {}
+    metadata = merge_openapi_metadata(example.metadata)
     summary = metadata[:summary] || RSpec::OpenAPI.summary_builder.call(example)
     tags = metadata[:tags] || RSpec::OpenAPI.tags_builder.call(example)
     formats = metadata[:formats] || RSpec::OpenAPI.formats_builder.curry.call(example)
@@ -55,6 +55,27 @@ def request_response(context)
     [context.request, context.response]
   end
 
+  private
+
+  def merge_openapi_metadata(metadata)
+    collect_openapi_metadata(metadata).reduce({}, &:merge)
+  end
+
+  # メタデータ階層からOpenAPIメタデータを収集
+  def collect_openapi_metadata(metadata)
+    [].tap do |result|
+      current = metadata
+
+      while current
+        [current[:example_group], current].each do |meta|
+          result.unshift(meta[:openapi]) if meta&.dig(:openapi)
+        end
+
+        current = current[:parent_example_group]
+      end
+    end
+  end
+
   # @param [ActionDispatch::Request] request
   def find_rails_route(request, app: Rails.application, path_prefix: '')
     app.routes.router.recognize(request) do |route, _parameters|

spec/apps/hanami/doc/openapi.json

@@ -496,7 +496,7 @@
     },
     "/tables": {
       "get": {
-        "summary": "index",
+        "summary": "Get a list of tables",
         "tags": [
           "Table"
         ],

spec/apps/hanami/doc/openapi.yaml

@@ -306,7 +306,7 @@ paths:
                 message: not found
   "/tables":
     get:
-      summary: index
+      summary: Get a list of tables
       tags:
       - Table
       parameters:

spec/apps/rails/doc/openapi.json

@@ -539,7 +539,7 @@
     },
     "/tables": {
       "get": {
-        "summary": "index",
+        "summary": "Get a list of tables",
         "tags": [
           "Table"
         ],

spec/apps/rails/doc/openapi.yaml

@@ -333,7 +333,7 @@ paths:
                 message: not found
   "/tables":
     get:
-      summary: index
+      summary: 'Get a list of tables'
       tags:
       - Table
       parameters:

spec/apps/roda/doc/openapi.json

@@ -10,7 +10,7 @@
   "paths": {
     "/roda": {
       "post": {
-        "summary": "POST /roda",
+        "summary": "Create roda resource",
         "requestBody": {
           "content": {
             "application/json": {

spec/apps/roda/doc/openapi.yaml

@@ -7,7 +7,7 @@ servers: []
 paths:
   "/roda":
     post:
-      summary: POST /roda
+      summary: Create roda resource
       requestBody:
         content:
           application/json:

spec/requests/hanami_spec.rb

@@ -50,7 +50,7 @@
 end
 
 RSpec.describe 'Tables', type: :request do
-  describe '#index' do
+  describe '#index', openapi: { summary: 'Get a list of tables' } do
     context 'returns a list of tables' do
       it 'with flat query parameters' do
         get '/tables', { page: '1', per: '10' }, { 'AUTHORIZATION' => 'k0kubun', 'X_AUTHORIZATION_TOKEN' => 'token' }

spec/requests/rails_spec.rb

@@ -38,7 +38,7 @@
 }
 
 RSpec.describe 'Tables', type: :request do
-  describe '#index' do
+  describe '#index', openapi: { summary: 'Get a list of tables' } do
     context it 'returns a list of tables' do
       it 'with flat query parameters' do
         get '/tables', params: { page: '1', per: '10' },

spec/requests/roda_spec.rb

@@ -22,7 +22,7 @@
     RodaApp
   end
 
-  describe '/roda' do
+  describe '/roda', openapi: { summary: 'Create roda resource' } do
     context 'when id is given' do
       it 'returns 200' do
         post '/roda', { id: 1 }.to_json, 'CONTENT_TYPE' => 'application/json'