Support tag generation

README.md

@@ -65,15 +65,19 @@ paths:
   "/tables":
     get:
       summary: 'tables #index'
+      tags:
+      - tables
       parameters:
       - name: page
         in: query
         schema:
           type: integer
+        example: 1
       - name: per
         in: query
         schema:
           type: integer
+        example: 10
       responses:
         '200':
           description: returns a list of tables

lib/rspec/openapi/record.rb

@@ -6,6 +6,7 @@
   :request_params,        # @param [Hash]    - {:request=>"body"}
   :request_content_type,  # @param [String]  - "application/json"
   :summary,               # @param [String]  - "v1/statuses #show"
+  :tags,                  # @param [Array]   - ["Status"]
   :description,           # @param [String]  - "returns a status"
   :status,                # @param [Integer] - 200
   :response_body,         # @param [Object]  - {"status" => "ok"}

lib/rspec/openapi/record_builder.rb

@@ -19,6 +19,7 @@ def build(context, example:)
       route = find_rails_route(request)
       path = route.path.spec.to_s.delete_suffix('(.:format)')
       summary = "#{route.requirements[:controller]} ##{route.requirements[:action]}"
+      tags = [route.requirements[:controller]]
     else
       path = request.path
       summary = "#{request.method} #{request.path}"
@@ -39,6 +40,7 @@ def build(context, example:)
       request_params: raw_request_params(request),
       request_content_type: request.content_type,
       summary: summary,
+      tags: tags,
       description: RSpec::OpenAPI.description_builder.call(example),
       status: response.status,
       response_body: response_body,

lib/rspec/openapi/schema_builder.rb

@@ -20,6 +20,7 @@ def build(record)
         normalize_path(record.path) => {
           record.method.downcase => {
             summary: record.summary,
+            tags: record.tags,
             parameters: build_parameters(record),
             requestBody: build_request_body(record),
             responses: {

spec/rails/doc/openapi.yaml

@@ -10,6 +10,8 @@ paths:
   "/tables":
     get:
       summary: 'tables #index'
+      tags:
+      - tables
       parameters:
       - name: page
         in: query
@@ -73,6 +75,8 @@ paths:
                 message: Unauthorized
     post:
       summary: 'tables #create'
+      tags:
+      - tables
       requestBody:
         content:
           application/json:
@@ -129,6 +133,8 @@ paths:
   "/tables/{id}":
     get:
       summary: 'tables #show'
+      tags:
+      - tables
       parameters:
       - name: id
         in: path
@@ -197,6 +203,8 @@ paths:
                 message: not found
     patch:
       summary: 'tables #update'
+      tags:
+      - tables
       parameters:
       - name: id
         in: path
@@ -243,6 +251,8 @@ paths:
                 updated_at: '2020-07-17T00:00:00+00:00'
     delete:
       summary: 'tables #destroy'
+      tags:
+      - tables
       parameters:
       - name: id
         in: path