rspec-openapi 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61aad8140991defb871eca3436054e43a6e933d6062ac813c987faf93aa767b5
-  data.tar.gz: 8c3d02cf5be2e31131c1d855528f597b0bd604d306dba79e91c782448ae111a3
+  metadata.gz: '04058c6bcfd8f9ec499d5c7eb82da1e1123bfd9a666056384cda5a39aa70e4b7'
+  data.tar.gz: a4df891dbf2ba621f1cf3a78dbfcaab22da75583a40ea974935ad6e9aad1dfa0
 SHA512:
-  metadata.gz: 2b879c9733c1704b94c2f5649de5a3200df3bbdac2b5cb76d668e94da32a45262bf40301d74359f30a86af7622851131243c8e95e3ffcfbc716bbd1d6765b47f
-  data.tar.gz: 16f048fae7721a7986de3dc0a293a29f1986085c55cb6fc793d596826e3fedff0540de4ab94dca2a3363a3c233c58f7d2f63fdcf8ec66793eed4ae72fe237a48
+  metadata.gz: 9764345746f2c8133a18580eb1dffcf97709dd6e077b86e326f62604daffc856fd0c67e2735c7e8dbc16ae56828d9d3d9222cbc75f2f4a2e63789308df6ea4fd
+  data.tar.gz: e54bf06b9d2bd91952b56e91cc2cfcbae1cfb0998ab00a7019c4176b114a3652ef3e3323bf922530c2cf8e207742df6ff6fb6764be680ba8db7a8910bf260cdc

data/.rubocop.yml

@@ -5,7 +5,7 @@ AllCops:
   SuggestExtensions: false
   TargetRubyVersion: 2.7
   Exclude:
-    - 'spec/rails/**/*'
+    - 'spec/apps/**/*'
     - 'vendor/**/*'
 
 Style/TrailingCommaInHashLiteral:

data/.rubocop_todo.yml

@@ -1,35 +1,35 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2024-03-25 05:35:37 UTC using RuboCop version 1.62.1.
+# on 2024-04-12 14:06:44 UTC using RuboCop version 1.62.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 11
+# Offense count: 13
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 48
+  Max: 47
 
-# Offense count: 2
+# Offense count: 1
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 207
+  Max: 195
 
-# Offense count: 8
+# Offense count: 9
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
-  Max: 13
+  Max: 12
 
-# Offense count: 19
+# Offense count: 22
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 34
+  Max: 36
 
-# Offense count: 3
+# Offense count: 5
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
-  Max: 13
+  Max: 12
 
 # Offense count: 1
 # Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
@@ -39,7 +39,7 @@ Naming/VariableNumber:
   Exclude:
     - 'spec/integration_tests/roda_test.rb'
 
-# Offense count: 6
+# Offense count: 7
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Exclude:
@@ -49,3 +49,4 @@ Style/Documentation:
     - 'lib/rspec/openapi/minitest_hooks.rb'
     - 'lib/rspec/openapi/result_recorder.rb'
     - 'lib/rspec/openapi/schema_file.rb'
+    - 'lib/rspec/openapi/shared_hooks.rb'

data/Gemfile

@@ -6,7 +6,16 @@ source 'https://rubygems.org'
 gemspec
 
 gem 'rails', ENV['RAILS_VERSION'] || '6.0.3.7'
+
+if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('3.0.0')
+  gem 'hanami', ENV['HANAMI_VERSION'] || '2.1.0'
+  gem 'hanami-controller', ENV['HANAMI_VERSION'] || '2.1.0'
+  gem 'hanami-router', ENV['HANAMI_VERSION'] || '2.1.0'
+end
+
 gem 'roda'
+
+gem 'rails-dom-testing', '~> 2.2'
 gem 'rspec-rails'
 
 group :test do

data/README.md

@@ -1,4 +1,4 @@
-# rspec-openapi [![Gem Version](https://badge.fury.io/rb/rspec-openapi.svg)](https://badge.fury.io/rb/rspec-openapi) [![test](https://github.com/exoego/rspec-openapi/actions/workflows/test.yml/badge.svg)](https://github.com/exoego/rspec-openapi/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/exoego/rspec-openapi/branch/master/graph/badge.svg?token=egYm6AlxkD)](https://codecov.io/gh/exoego/rspec-openapi)
+# rspec-openapi [![Gem Version](https://badge.fury.io/rb/rspec-openapi.svg)](https://rubygems.org/gems/rspec-openapi) [![test](https://github.com/exoego/rspec-openapi/actions/workflows/test.yml/badge.svg)](https://github.com/exoego/rspec-openapi/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/exoego/rspec-openapi/branch/master/graph/badge.svg?token=egYm6AlxkD)](https://codecov.io/gh/exoego/rspec-openapi) [![Ruby-toolbox](https://img.shields.io/badge/ruby-toolbox-a61414?cacheSeconds=31536000)](https://www.ruby-toolbox.com/projects/rspec-openapi)
 
 Generate OpenAPI schema from RSpec request specs.
 
@@ -97,7 +97,7 @@ paths:
 
 and the schema file can be used as an input of [Swagger UI](https://github.com/swagger-api/swagger-ui) or [Redoc](https://github.com/Redocly/redoc).
 
-![Redoc example](./spec/rails/doc/screenshot.png)
+![Redoc example](./spec/apps/rails/doc/screenshot.png)
 
 
 ### Configuration
@@ -190,6 +190,13 @@ RSpec::OpenAPI.ignored_path_params = %i[controller action format]
 # In that case, you can specify the paths to ignore.
 # String or Regexp is acceptable.
 RSpec::OpenAPI.ignored_paths = ["/admin/full/path/", Regexp.new("^/_internal/")]
+
+# Your custom post-processing hook (like unrandomizing IDs)
+RSpec::OpenAPI.post_process_hook = -> (path, records, spec) do
+  RSpec::OpenAPI::HashHelper.matched_paths(spec, 'paths.*.*.responses.*.content.*.*.*.id').each do |paths|
+    spec.dig(*paths[0..-2]).merge!(id: '123')
+  end
+end
 ```
 
 ### Can I use rspec-openapi with `$ref` to minimize duplication of schema?

data/lib/rspec/openapi/extractors/hanami.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require 'dry/inflector'
+require 'hanami'
+
+# https://github.com/hanami/router/blob/97f75b8529574bd4ff23165460e82a6587bc323c/lib/hanami/router/inspector.rb#L13
+class Inspector
+  attr_accessor :routes, :inflector
+
+  def initialize(routes: [])
+    @routes = routes
+    @inflector = Dry::Inflector.new
+  end
+
+  def add_route(route)
+    routes.push(route)
+  end
+
+  def call(verb, path)
+    route = routes.find { |r| r.http_method == verb && r.path == path }
+
+    if route.to.is_a?(Proc)
+      {
+        tags: [],
+        summary: "#{verb} #{path}",
+      }
+    else
+      data = route.to.split('.')
+
+      {
+        tags: [inflector.classify(data[0])],
+        summary: data[1],
+      }
+    end
+  end
+end
+
+InspectorAnalyzer = Inspector.new
+
+# Add default parameter to load inspector before test cases run
+module InspectorAnalyzerPrepender
+  def router(inspector: InspectorAnalyzer)
+    super
+  end
+end
+
+Hanami::Slice::ClassMethods.prepend(InspectorAnalyzerPrepender)
+
+# Extractor for hanami
+class << RSpec::OpenAPI::Extractors::Hanami = Object.new
+  # @param [RSpec::ExampleGroups::*] context
+  # @param [RSpec::Core::Example] example
+  # @return Array
+  def request_attributes(request, example)
+    metadata = example.metadata[:openapi] || {}
+    summary = metadata[:summary] || RSpec::OpenAPI.summary_builder.call(example)
+    tags = metadata[:tags] || RSpec::OpenAPI.tags_builder.call(example)
+    operation_id = metadata[:operation_id]
+    required_request_params = metadata[:required_request_params] || []
+    security = metadata[:security]
+    description = metadata[:description] || RSpec::OpenAPI.description_builder.call(example)
+    deprecated = metadata[:deprecated]
+    path = request.path
+
+    route = Hanami.app.router.recognize(request.path, method: request.method)
+
+    raw_path_params = route.params.filter { |_key, value| number_or_nil(value) }
+
+    result = InspectorAnalyzer.call(request.method, add_id(path, route))
+
+    summary ||= result[:summary]
+    tags ||= result[:tags]
+    path = add_openapi_id(path, route)
+
+    raw_path_params = raw_path_params.slice(*(raw_path_params.keys - RSpec::OpenAPI.ignored_path_params))
+
+    [path, summary, tags, operation_id, required_request_params, raw_path_params, description, security, deprecated]
+  end
+
+  # @param [RSpec::ExampleGroups::*] context
+  def request_response(context)
+    request = ActionDispatch::Request.new(context.last_request.env)
+    request.body.rewind if request.body.respond_to?(:rewind)
+    response = ActionDispatch::TestResponse.new(*context.last_response.to_a)
+
+    [request, response]
+  end
+
+  def add_id(path, route)
+    return path if route.params.empty?
+
+    route.params.each_pair do |key, value|
+      next unless number_or_nil(value)
+
+      path = path.sub("/#{value}", "/:#{key}")
+    end
+
+    path
+  end
+
+  def add_openapi_id(path, route)
+    return path if route.params.empty?
+
+    route.params.each_pair do |key, value|
+      next unless number_or_nil(value)
+
+      path = path.sub("/#{value}", "/{#{key}}")
+    end
+
+    path
+  end
+
+  def number_or_nil(string)
+    Integer(string || '')
+  rescue ArgumentError
+    nil
+  end
+end

data/lib/rspec/openapi/extractors/rack.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Extractor for rack
+class << RSpec::OpenAPI::Extractors::Rack = Object.new
+  # @param [RSpec::ExampleGroups::*] context
+  # @param [RSpec::Core::Example] example
+  # @return Array
+  def request_attributes(request, example)
+    metadata = example.metadata[:openapi] || {}
+    summary = metadata[:summary] || RSpec::OpenAPI.summary_builder.call(example)
+    tags = metadata[:tags] || RSpec::OpenAPI.tags_builder.call(example)
+    operation_id = metadata[:operation_id]
+    required_request_params = metadata[:required_request_params] || []
+    security = metadata[:security]
+    description = metadata[:description] || RSpec::OpenAPI.description_builder.call(example)
+    deprecated = metadata[:deprecated]
+    raw_path_params = request.path_parameters
+    path = request.path
+    summary ||= "#{request.method} #{path}"
+    [path, summary, tags, operation_id, required_request_params, raw_path_params, description, security, deprecated]
+  end
+
+  # @param [RSpec::ExampleGroups::*] context
+  def request_response(context)
+    request = ActionDispatch::Request.new(context.last_request.env)
+    request.body.rewind if request.body.respond_to?(:rewind)
+    response = ActionDispatch::TestResponse.new(*context.last_response.to_a)
+
+    [request, response]
+  end
+end

data/lib/rspec/openapi/extractors/rails.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# Extractor for rails
+class << RSpec::OpenAPI::Extractors::Rails = Object.new
+  # @param [RSpec::ExampleGroups::*] context
+  # @param [RSpec::Core::Example] example
+  # @return Array
+  def request_attributes(request, example)
+    metadata = example.metadata[:openapi] || {}
+    summary = metadata[:summary] || RSpec::OpenAPI.summary_builder.call(example)
+    tags = metadata[:tags] || RSpec::OpenAPI.tags_builder.call(example)
+    operation_id = metadata[:operation_id]
+    required_request_params = metadata[:required_request_params] || []
+    security = metadata[:security]
+    description = metadata[:description] || RSpec::OpenAPI.description_builder.call(example)
+    deprecated = metadata[:deprecated]
+    raw_path_params = request.path_parameters
+
+    # Reverse the destructive modification by Rails https://github.com/rails/rails/blob/v6.0.3.4/actionpack/lib/action_dispatch/journey/router.rb#L33-L41
+    fixed_request = request.dup
+    fixed_request.path_info = File.join(request.script_name, request.path_info) if request.script_name.present?
+
+    route, path = find_rails_route(fixed_request)
+    raise "No route matched for #{fixed_request.request_method} #{fixed_request.path_info}" if route.nil?
+
+    path = path.delete_suffix('(.:format)')
+    summary ||= route.requirements[:action]
+    tags ||= [route.requirements[:controller]&.classify].compact
+    # :controller and :action always exist. :format is added when routes is configured as such.
+    # TODO: Use .except(:controller, :action, :format) when we drop support for Ruby 2.x
+    raw_path_params = raw_path_params.slice(*(raw_path_params.keys - RSpec::OpenAPI.ignored_path_params))
+
+    summary ||= "#{request.method} #{path}"
+
+    [path, summary, tags, operation_id, required_request_params, raw_path_params, description, security, deprecated]
+  end
+
+  # @param [RSpec::ExampleGroups::*] context
+  def request_response(context)
+    [context.request, context.response]
+  end
+
+  # @param [ActionDispatch::Request] request
+  def find_rails_route(request, app: Rails.application, path_prefix: '')
+    app.routes.router.recognize(request) do |route|
+      path = route.path.spec.to_s
+      if route.app.matches?(request)
+        if route.app.engine?
+          route, path = find_rails_route(request, app: route.app.app, path_prefix: path)
+          next if route.nil?
+        end
+        return [route, path_prefix + path]
+      end
+    end
+
+    nil
+  end
+end

data/lib/rspec/openapi/extractors.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+# Create namespace
+module RSpec::OpenAPI::Extractors
+end

data/lib/rspec/openapi/minitest_hooks.rb

@@ -13,7 +13,7 @@ module RSpec::OpenAPI::Minitest
         human_name = name.sub(/^test_/, '').gsub('_', ' ')
         example = Example.new(self, human_name, {}, file_path)
         path = RSpec::OpenAPI.path.then { |p| p.is_a?(Proc) ? p.call(example) : p }
-        record = RSpec::OpenAPI::RecordBuilder.build(self, example: example)
+        record = RSpec::OpenAPI::RecordBuilder.build(self, example: example, extractor: SharedHooks.find_extractor)
         RSpec::OpenAPI.path_records[path] << record if record
       end
       result

data/lib/rspec/openapi/record.rb

@@ -14,6 +14,7 @@ RSpec::OpenAPI::Record = Struct.new(
   :operation_id,          # @param [String]   - "request-1234"
   :description,           # @param [String]  - "returns a status"
   :security,              # @param [Array]  - [{securityScheme1: []}]
+  :deprecated,            # @param [Boolean] - true
   :status,                # @param [Integer] - 200
   :response_body,         # @param [Object]  - {"status" => "ok"}
   :response_headers,      # @param [Array]  - [["header_key1", "header_value1"], ["header_key2", "header_value2"]]

data/lib/rspec/openapi/record_builder.rb

@@ -7,12 +7,12 @@ class << RSpec::OpenAPI::RecordBuilder = Object.new
   # @param [RSpec::ExampleGroups::*] context
   # @param [RSpec::Core::Example] example
   # @return [RSpec::OpenAPI::Record,nil]
-  def build(context, example:)
-    request, response = extract_request_response(context)
+  def build(context, example:, extractor:)
+    request, response = extractor.request_response(context)
     return if request.nil?
 
-    path, summary, tags, operation_id, required_request_params, raw_path_params, description, security =
-      extract_request_attributes(request, example)
+    path, summary, tags, operation_id, required_request_params, raw_path_params, description, security, deprecated =
+      extractor.request_attributes(request, example)
 
     return if RSpec::OpenAPI.ignored_paths.any? { |ignored_path| path.match?(ignored_path) }
 
@@ -32,6 +32,7 @@ class << RSpec::OpenAPI::RecordBuilder = Object.new
       operation_id: operation_id,
       description: description,
       security: security,
+      deprecated: deprecated,
       status: response.status,
       response_body: safe_parse_body(response, response.media_type),
       response_headers: response_headers,
@@ -54,7 +55,10 @@ class << RSpec::OpenAPI::RecordBuilder = Object.new
   def extract_headers(request, response)
     request_headers = RSpec::OpenAPI.request_headers.each_with_object([]) do |header, headers_arr|
       header_key = header.gsub('-', '_').upcase.to_sym
-      header_value = request.get_header(['HTTP', header_key].join('_')) || request.get_header(header_key)
+
+      header_value = request.get_header(['HTTP', header_key].join('_')) ||
+                     request.get_header(header_key) ||
+                     request.get_header(header_key.to_s)
       headers_arr << [header, header_value] if header_value
     end
     response_headers = RSpec::OpenAPI.response_headers.each_with_object([]) do |header, headers_arr|
@@ -65,70 +69,6 @@ class << RSpec::OpenAPI::RecordBuilder = Object.new
     [request_headers, response_headers]
   end
 
-  def extract_request_attributes(request, example)
-    metadata = example.metadata[:openapi] || {}
-    summary = metadata[:summary] || RSpec::OpenAPI.summary_builder.call(example)
-    tags = metadata[:tags] || RSpec::OpenAPI.tags_builder.call(example)
-    operation_id = metadata[:operation_id]
-    required_request_params = metadata[:required_request_params] || []
-    security = metadata[:security]
-    description = metadata[:description] || RSpec::OpenAPI.description_builder.call(example)
-    raw_path_params = request.path_parameters
-    path = request.path
-    if rails?
-      # Reverse the destructive modification by Rails https://github.com/rails/rails/blob/v6.0.3.4/actionpack/lib/action_dispatch/journey/router.rb#L33-L41
-      fixed_request = request.dup
-      fixed_request.path_info = File.join(request.script_name, request.path_info) if request.script_name.present?
-
-      route, path = find_rails_route(fixed_request)
-      raise "No route matched for #{fixed_request.request_method} #{fixed_request.path_info}" if route.nil?
-
-      path = path.delete_suffix('(.:format)')
-      summary ||= route.requirements[:action]
-      tags ||= [route.requirements[:controller]&.classify].compact
-      # :controller and :action always exist. :format is added when routes is configured as such.
-      # TODO: Use .except(:controller, :action, :format) when we drop support for Ruby 2.x
-      raw_path_params = raw_path_params.slice(*(raw_path_params.keys - RSpec::OpenAPI.ignored_path_params))
-    end
-    summary ||= "#{request.method} #{path}"
-    [path, summary, tags, operation_id, required_request_params, raw_path_params, description, security]
-  end
-
-  def extract_request_response(context)
-    if rack_test?(context)
-      request = ActionDispatch::Request.new(context.last_request.env)
-      request.body.rewind if request.body.respond_to?(:rewind)
-      response = ActionDispatch::TestResponse.new(*context.last_response.to_a)
-    else
-      request = context.request
-      response = context.response
-    end
-    [request, response]
-  end
-
-  def rails?
-    defined?(Rails) && Rails.respond_to?(:application) && Rails.application
-  end
-
-  def rack_test?(context)
-    defined?(Rack::Test::Methods) && context.class < Rack::Test::Methods
-  end
-
-  # @param [ActionDispatch::Request] request
-  def find_rails_route(request, app: Rails.application, path_prefix: '')
-    app.routes.router.recognize(request) do |route|
-      path = route.path.spec.to_s
-      if route.app.matches?(request)
-        if route.app.engine?
-          route, path = find_rails_route(request, app: route.app.app, path_prefix: path)
-          next if route.nil?
-        end
-        return [route, path_prefix + path]
-      end
-    end
-    nil
-  end
-
   # workaround to get real request parameters
   # because ActionController::ParamsWrapper overwrites request_parameters
   def raw_request_params(request)

data/lib/rspec/openapi/result_recorder.rb

@@ -29,11 +29,8 @@ class RSpec::OpenAPI::ResultRecorder
         rescue StandardError, NotImplementedError => e # e.g. SchemaBuilder raises a NotImplementedError
           @error_records[e] = record # Avoid failing the build
         end
-        RSpec::OpenAPI::SchemaCleaner.cleanup_conflicting_security_parameters!(spec)
-        RSpec::OpenAPI::SchemaCleaner.cleanup!(spec, new_from_zero)
-        RSpec::OpenAPI::ComponentsUpdater.update!(spec, new_from_zero)
-        RSpec::OpenAPI::SchemaCleaner.cleanup_empty_required_array!(spec)
-        RSpec::OpenAPI::SchemaSorter.deep_sort!(spec)
+        cleanup_schema!(new_from_zero, spec)
+        execute_post_process_hook(path, records, spec)
       end
     end
   end
@@ -49,4 +46,18 @@ class RSpec::OpenAPI::ResultRecorder
       #{@error_records.map { |e, record| "#{e.inspect}: #{record.inspect}" }.join("\n")}
     ERR_MSG
   end
+
+  private
+
+  def execute_post_process_hook(path, records, spec)
+    RSpec::OpenAPI.post_process_hook.call(path, records, spec) if RSpec::OpenAPI.post_process_hook.is_a?(Proc)
+  end
+
+  def cleanup_schema!(new_from_zero, spec)
+    RSpec::OpenAPI::SchemaCleaner.cleanup_conflicting_security_parameters!(spec)
+    RSpec::OpenAPI::SchemaCleaner.cleanup!(spec, new_from_zero)
+    RSpec::OpenAPI::ComponentsUpdater.update!(spec, new_from_zero)
+    RSpec::OpenAPI::SchemaCleaner.cleanup_empty_required_array!(spec)
+    RSpec::OpenAPI::SchemaSorter.deep_sort!(spec)
+  end
 end

data/lib/rspec/openapi/rspec_hooks.rb

@@ -5,7 +5,7 @@ require 'rspec/core'
 RSpec.configuration.after(:each) do |example|
   if RSpec::OpenAPI.example_types.include?(example.metadata[:type]) && example.metadata[:openapi] != false
     path = RSpec::OpenAPI.path.then { |p| p.is_a?(Proc) ? p.call(example) : p }
-    record = RSpec::OpenAPI::RecordBuilder.build(self, example: example)
+    record = RSpec::OpenAPI::RecordBuilder.build(self, example: example, extractor: SharedHooks.find_extractor)
     RSpec::OpenAPI.path_records[path] << record if record
   end
 end

data/lib/rspec/openapi/schema_builder.rb

@@ -34,6 +34,7 @@ class << RSpec::OpenAPI::SchemaBuilder = Object.new
             tags: record.tags,
             operationId: record.operation_id,
             security: record.security,
+            deprecated: record.deprecated ? true : nil,
             parameters: build_parameters(record),
             requestBody: http_method == 'get' ? nil : build_request_body(record),
             responses: {

data/lib/rspec/openapi/schema_merger.rb

@@ -53,7 +53,8 @@ class << RSpec::OpenAPI::SchemaMerger = Object.new
   def merge_parameters(base, key, value)
     all_parameters = value | base[key]
 
-    unique_base_parameters = base[key].index_by { |parameter| [parameter[:name], parameter[:in]] }
+    unique_base_parameters = build_unique_params(base, key)
+
     all_parameters = all_parameters.map do |parameter|
       base_parameter = unique_base_parameters[[parameter[:name], parameter[:in]]] || {}
       base_parameter ? base_parameter.merge(parameter) : parameter
@@ -63,6 +64,12 @@ class << RSpec::OpenAPI::SchemaMerger = Object.new
     base[key] = all_parameters
   end
 
+  def build_unique_params(base, key)
+    base[key].each_with_object({}) do |parameter, hash|
+      hash[[parameter[:name], parameter[:in]]] = parameter
+    end
+  end
+
   SIMILARITY_THRESHOLD = 0.5
 
   def merge_closest_match!(options, spec)

data/lib/rspec/openapi/shared_hooks.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module SharedHooks
+  def self.find_extractor
+    if defined?(Rails) && Rails.respond_to?(:application) && Rails.application
+      RSpec::OpenAPI::Extractors::Rails
+    elsif defined?(Hanami) && Hanami.respond_to?(:app) && Hanami.app?
+      RSpec::OpenAPI::Extractors::Hanami
+      # elsif defined?(Roda)
+      #   some Roda extractor
+    else
+      RSpec::OpenAPI::Extractors::Rack
+    end
+  end
+end

data/lib/rspec/openapi/version.rb

@@ -2,6 +2,6 @@
 
 module RSpec
   module OpenAPI
-    VERSION = '0.16.0'
+    VERSION = '0.17.0'
   end
 end

data/lib/rspec/openapi.rb

@@ -11,6 +11,23 @@ require 'rspec/openapi/schema_merger'
 require 'rspec/openapi/schema_cleaner'
 require 'rspec/openapi/schema_sorter'
 require 'rspec/openapi/key_transformer'
+require 'rspec/openapi/shared_hooks'
+require 'rspec/openapi/extractors'
+require 'rspec/openapi/extractors/rack'
+
+begin
+  require 'hanami'
+  require 'rspec/openapi/extractors/hanami'
+rescue LoadError
+  puts 'Hanami not detected'
+end
+
+begin
+  require 'rails'
+  require 'rspec/openapi/extractors/rails'
+rescue LoadError
+  puts 'Rails not detected'
+end
 
 require 'rspec/openapi/minitest_hooks' if Object.const_defined?('Minitest')
 require 'rspec/openapi/rspec_hooks' if ENV['OPENAPI'] && Object.const_defined?('RSpec')
@@ -33,6 +50,7 @@ module RSpec::OpenAPI
   @path_records = Hash.new { |h, k| h[k] = [] }
   @ignored_path_params = %i[controller action format]
   @ignored_paths = []
+  @post_process_hook = nil
 
   # This is the configuraion override file name we look for within each path.
   @config_filename = 'rspec_openapi.rb'
@@ -54,7 +72,8 @@ module RSpec::OpenAPI
                   :response_headers,
                   :path_records,
                   :ignored_paths,
-                  :ignored_path_params
+                  :ignored_path_params,
+                  :post_process_hook
 
     attr_reader   :config_filename
   end

data/rspec-openapi.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'actionpack', '>= 5.2.0'
+  spec.add_dependency 'rails-dom-testing'
   spec.add_dependency 'rspec-core'
   spec.metadata['rubygems_mfa_required'] = 'true'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rspec-openapi
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Takashi Kokubun
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-03-28 00:00:00.000000000 Z
+date: 2024-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -25,6 +25,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.0
+- !ruby/object:Gem::Dependency
+  name: rails-dom-testing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-core
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +80,10 @@ files:
 - lib/rspec/openapi.rb
 - lib/rspec/openapi/components_updater.rb
 - lib/rspec/openapi/default_schema.rb
+- lib/rspec/openapi/extractors.rb
+- lib/rspec/openapi/extractors/hanami.rb
+- lib/rspec/openapi/extractors/rack.rb
+- lib/rspec/openapi/extractors/rails.rb
 - lib/rspec/openapi/hash_helper.rb
 - lib/rspec/openapi/key_transformer.rb
 - lib/rspec/openapi/minitest_hooks.rb
@@ -78,6 +96,7 @@ files:
 - lib/rspec/openapi/schema_file.rb
 - lib/rspec/openapi/schema_merger.rb
 - lib/rspec/openapi/schema_sorter.rb
+- lib/rspec/openapi/shared_hooks.rb
 - lib/rspec/openapi/version.rb
 - rspec-openapi.gemspec
 - scripts/rspec
@@ -89,7 +108,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/exoego/rspec-openapi
   source_code_uri: https://github.com/exoego/rspec-openapi
-  changelog_uri: https://github.com/exoego/rspec-openapi/releases/tag/v0.16.0
+  changelog_uri: https://github.com/exoego/rspec-openapi/releases/tag/v0.17.0
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []