added operationId to metadata of request specs

exoego · Aug 17, 2023 · a05157d · a05157d
1 parent 6a1fbf4
commit a05157d
Show file tree

Hide file tree

Showing 3 changed files with 6 additions and 2 deletions.
diff --git a/lib/rspec/openapi/record.rb b/lib/rspec/openapi/record.rb
@@ -11,6 +11,7 @@
   :request_headers,       # @param [Array]  - [["header_key1", "header_value1"], ["header_key2", "header_value2"]]
   :summary,               # @param [String]  - "v1/statuses #show"
   :tags,                  # @param [Array]   - ["Status"]
+  :operation_id,          # @param [String]   - "request-1234"
   :description,           # @param [String]  - "returns a status"
   :security,              # @param [Array]  - [{securityScheme1: []}]
   :status,                # @param [Integer] - 200

diff --git a/lib/rspec/openapi/record_builder.rb b/lib/rspec/openapi/record_builder.rb
@@ -11,7 +11,7 @@ def build(context, example:)
     request, response = extract_request_response(context)
     return if request.nil?
 
-    path, summary, tags, required_request_params, raw_path_params, description, security =
+    path, summary, tags, operation_id, required_request_params, raw_path_params, description, security =
       extract_request_attributes(request, example)
 
     request_headers, response_headers = extract_headers(request, response)
@@ -27,6 +27,7 @@ def build(context, example:)
       request_headers: request_headers,
       summary: summary,
       tags: tags,
+      operation_id: operation_id,
       description: description,
       security: security,
       status: response.status,
@@ -63,6 +64,7 @@ def extract_request_attributes(request, example)
     metadata = example.metadata[:openapi] || {}
     summary = metadata[:summary]
     tags = metadata[:tags]
+    operation_id = metadata[:operation_id]
     required_request_params = metadata[:required_request_params] || []
     security = metadata[:security]
     description = metadata[:description] || RSpec::OpenAPI.description_builder.call(example)
@@ -78,7 +80,7 @@ def extract_request_attributes(request, example)
       raw_path_params = raw_path_params.slice(*(raw_path_params.keys - %i[controller action format]))
     end
     summary ||= "#{request.method} #{path}"
-    [path, summary, tags, required_request_params, raw_path_params, description, security]
+    [path, summary, tags, operation_id, required_request_params, raw_path_params, description, security]
   end
 
   def extract_request_response(context)

diff --git a/lib/rspec/openapi/schema_builder.rb b/lib/rspec/openapi/schema_builder.rb
@@ -27,6 +27,7 @@ def build(record)
           record.http_method.downcase => {
             summary: record.summary,
             tags: record.tags,
+            operationId: record.operation_id,
             security: record.security,
             parameters: build_parameters(record),
             requestBody: build_request_body(record),