zero-rails_openapi 1.3.1 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5b6fc0f663e643a98f744b0f75431c21a9484014
-  data.tar.gz: 2f0318d949040999a345d91b08f9d1ed63b525f3
+  metadata.gz: 996bf583a71a6c1b34daa068d9fad89761fd8074
+  data.tar.gz: 97858fcf27fdf3bf491e28d8fcba9b5061cebf7c
 SHA512:
-  metadata.gz: 2e9a713e9bb2296ffb3bd9e0c5433256cf90ccf72135c92495d4eebb53778e53a151b6882bf47baf137c2b000b40fc181974f5cfa0dce45048665be7f05f29b4
-  data.tar.gz: 1691cb0d3d6e3e6517f6439ca869a7eeddf7032f6d3c9eb3118e446ac62a8d1e89da05d90cbfda7b5f32a63c70e4601749b11686b1c430664af8fd7426d1b74b
+  metadata.gz: a46294ecd676e965ac1c4b0c3f7e0944751feae640882872d06f7ff52547b1c5b4bc4b71311d5a6b75fa98c66f18c2eb4832c7d2fc70b05c846cdae3456ec170
+  data.tar.gz: 16d36540905bee8b7f242dfadab8cc6f5edeffb83f88b936fc4da8ee6d2941fe0c206030781c8ae8121eed9a6e459dc5a8387b691b19491716a995ca1b1788a8

data/CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at will.huang@dji.com. All
+reported by contacting the project team at zhandao. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

data/Gemfile

@@ -5,6 +5,4 @@ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 # Specify your gem's dependencies in zero-rails_openapi.gemspec
 gemspec
 
-ruby '>= 2.3.0'
-
 gem 'activesupport'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    zero-rails_openapi (1.3.1)
+    zero-rails_openapi (1.3.2)
 
 GEM
   remote: https://rubygems.org/
@@ -44,8 +44,5 @@ DEPENDENCIES
   rspec (~> 3.0)
   zero-rails_openapi!
 
-RUBY VERSION
-   ruby 2.4.1p111
-
 BUNDLED WITH
-   1.16.0.pre.2
+   1.16.0

data/README.md

@@ -278,7 +278,8 @@ parameters, request body, responses, securities, servers.
   # method signature
   param param_type, name, type, required, schema_hash = { }
   # usage
-  param :query, :page, Integer, :req,  range: { gt: 0, le: 5 }, desc: 'page'
+  param :query, :page, Integer, :req,  range: { gt: 0, le: 5 }, desc: 'page',
+        examples: { :example => 5 }
   
   # method signature
   param_ref component_key, *component_keys
@@ -320,7 +321,7 @@ parameters, request body, responses, securities, servers.
   
   ```ruby
   # method signature
-  request_body required, media_type, desc = '', schema_hash = { }
+  request_body required, media_type, desc = '', hash = { }
   # usage
   request_body :opt, :form, type: { id!: Integer, name: String }
 
@@ -330,13 +331,13 @@ parameters, request body, responses, securities, servers.
   body_ref :Body
 
   # method signature
-  body! media_type, desc = '', schema_hash = { }
+  body! media_type, desc = '', hash = { }
   # usage
   body :json
   
   # method implement
-  def form desc = '', schema_hash = { }
-    body :form, desc, schema_hash
+  def form desc = '', hash = { }
+    body :form, desc, hash
   end
   # usage
   form! 'register', data: {
@@ -353,40 +354,41 @@ parameters, request body, responses, securities, servers.
       }
 
   # method implement
-  def file! media_type, desc = '', schema_hash = { type: File }
-    body! media_type, desc, schema_hash
+  def file! media_type, desc = '', hash = { type: File }
+    body! media_type, desc, hash
   end
   ```
   
-  **Notice:** Each API can only declare a request body. 
-  That is, all of the above methods you can only choose one of them.
-  
-  Media Type: We provide some [mapping](https://github.com/zhandao/zero-rails_openapi/blob/master/lib/oas_objs/media_type_obj.rb) from symbols to real media-types.  
-  
-  schema_hash: As above (see param), but more than a `type` (schema type).
+  (1) **Notice:** Each API can only declare a request body. 
+  That is, all of the above methods you can only choose one of them.  
+  (2) Media Type: We provide some [mapping](https://github.com/zhandao/zero-rails_openapi/blob/master/lib/oas_objs/media_type_obj.rb) from symbols to real media-types.  
+  (3) schema_hash: As above (see param), it's just one more a `type` (schema type).
+  (4) `examples` usage see [goods_doc](https://github.com/zhandao/zero-rails_openapi/blob/master/documentation/examples/goods_doc.rb)
   
 - response family methods (OAS - [Response Object](https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.0.md#response-object))
   - `response` (`resp`)
   - `response_ref`
   - `default_response` (`dft_resp`)
   - `error_response` (`other_response`, `oth_resp`, `error`, `err_resp`): Are `response`'s aliases, should be used in the error response context.
+  - `override_response` # TODO
   
   Define the responses for the API(operation).
   You can use the Response Object to link to request body that is defined at the components/responses by method response_ref().
   
   ```ruby
   # method signature
-  response code, desc, media_type = nil, schema_hash = { }
+  response code, desc, media_type = nil, hash = { }
   # usage
-  response '200', 'query result export', :pdf, type: File
+  response 200, 'query result export', :pdf, type: File
 
   # method signature
   response_ref code_compkey_hash
   # usage
-  response_ref '700' => :RespComp, '800' => :RespComp
+  response_ref 700 => :RespComp, 800 => :RespComp
   ```
   
-  **practice:** Combined with wrong class, automatically generate error responses. TODO
+  (1) **practice:** Combined with wrong class, automatically generate error responses. TODO  
+  (2) `examples` usage see [goods_doc](https://github.com/zhandao/zero-rails_openapi/blob/master/documentation/examples/goods_doc.rb)
   
 - security: TODO
 

data/documentation/examples/goods_doc.rb

@@ -14,7 +14,14 @@ class V2::GoodsDoc < BaseDoc
             'expensive goods': :expensive,
                 'cheap goods': :cheap,
     }
-    query :search_type, String, enum: %w[name creator category price]
+    # query :search_type, String, enum: %w[name creator category price]
+    do_query by: {
+        :search_type => { type: String, enum: %w[ name creator category price ] },
+        :export => { type: Boolean, desc: 'export as Excel format', examples: {
+            :right_input => true,
+            :wrong_input => 'wrong input'
+        }}
+    }
   end
 
 
@@ -27,7 +34,12 @@ class V2::GoodsDoc < BaseDoc
            :is_online => { type: Boolean, desc: 'it\'s online?' },
              :remarks => { type: String,  desc: 'remarks' },
             :pic_path => { type: String,  desc: 'picture url', is: :url },
-    }
+    },
+          exp_by:    %i[ name category_id price ],
+          examples: {
+              :right_input => [ 'good1', 6, 5.7 ],
+              :wrong_input => [ 'good2', 0, -1  ]
+          }
   end
 
 

data/lib/oas_objs/example_obj.rb

@@ -0,0 +1,88 @@
+require 'oas_objs/helpers'
+require 'oas_objs/ref_obj'
+
+module OpenApi
+  module DSL
+    # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#exampleObject
+    class ExampleObj < Hash
+      include Helpers
+
+      attr_accessor :processed, :examples_hash, :keys_of_value
+
+      def initialize(examples_hash, keys_of_value = nil)
+        self.examples_hash  = examples_hash
+        self.keys_of_value = keys_of_value
+      end
+
+      def process
+        self.processed =
+          examples_hash.map do |(name, value)|
+            value =
+              if keys_of_value.present? && value.is_a?(Array)
+                { value: Hash[keys_of_value.zip(value)] }
+              elsif value.is_a?(Symbol) && value['$']
+                { '$ref': RefObj.new(:example, value).process }
+              else
+                { value: value }
+              end
+
+            { name => value }
+          end
+      end
+    end
+  end
+end
+
+
+__END__
+
+# in a model
+schemas:
+  properties:
+    name:
+      type: string
+      examples:
+        name:
+          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
+
+# in a request body:
+  requestBody:
+    content:
+      'application/json':
+        schema:
+          $ref: '#/components/schemas/Address'
+        examples:
+          foo:
+            summary: A foo example
+            value: {"foo": "bar"}
+          bar:
+            summary: A bar example
+            value: {"bar": "baz"}
+      'application/xml':
+        examples:
+          xmlExample:
+            summary: This is an example in XML
+            externalValue: 'http://example.org/examples/address-example.xml'
+
+# in a parameter
+  parameters:
+    - name: 'zipCode'
+      in: 'query'
+      schema:
+        type: 'string'
+        format: 'zip-code'
+        examples:
+          zip-example:
+            $ref: '#/components/examples/zip-example'
+
+# in a response
+  responses:
+    '200':
+      description: your car appointment has been booked
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/SuccessResponse'
+          examples:
+            confirmation-success:
+              $ref: '#/components/examples/confirmation-success'

data/lib/oas_objs/helpers.rb

@@ -17,7 +17,7 @@ module OpenApi
     end
 
     # reduceee.then_merge! => for Hash
-    def reduceee(*values)
+    def reducx(*values)
       @assign = values.compact.reduce({ }, :merge).keep_if &value_present
       self
     end

data/lib/oas_objs/media_type_obj.rb

@@ -1,19 +1,28 @@
 require 'oas_objs/schema_obj'
+require 'oas_objs/example_obj'
 
 module OpenApi
   module DSL
     # https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.0.md#media-type-object
     class MediaTypeObj < Hash
-      attr_accessor :media_type, :schema
-      def initialize(media_type, schema_hash)
+      attr_accessor :media_type, :schema, :examples
+
+      def initialize(media_type, hash)
+        examples_hash = hash.delete(:examples)
+        exp_by        = hash.delete(:exp_by)
+        schema_type   = hash.values_at(:type, :data).compact.first
+        exp_by        = schema_type.keys if exp_by == :all
+
+        self.examples   = ExampleObj.new(examples_hash, exp_by) if examples_hash.present?
         self.media_type = media_type_mapping media_type
-        self.schema     = SchemaObj.new(schema_hash.values_at(:type, :data, :t).compact.first, schema_hash)
+        self.schema     = SchemaObj.new(schema_type, hash)
       end
 
       def process
         schema_processed = schema.process
-        schema = schema_processed.values.join.blank? ? { } : { schema: schema_processed }
-        media_type.nil? ? { } : { media_type => schema }
+        result = schema_processed.values.join.blank? ? { } : { schema: schema_processed }
+        result.merge!(examples: examples.process) unless examples.nil?
+        media_type.nil? ? { } : { media_type => result }
       end
 
       # https://swagger.io/docs/specification/media-types/

data/lib/oas_objs/ref_obj.rb

@@ -1,4 +1,3 @@
-require 'oas_objs/media_type_obj'
 require 'oas_objs/helpers'
 
 module OpenApi

data/lib/oas_objs/request_body_obj.rb

@@ -9,8 +9,8 @@ module OpenApi
       include Helpers
 
       attr_accessor :processed, :media_type
-      def initialize(required, media_type, desc, schema_hash)
-        self.media_type = MediaTypeObj.new(media_type, schema_hash)
+      def initialize(required, media_type, desc, hash)
+        self.media_type = MediaTypeObj.new(media_type, hash)
         self.processed  = { required: required.to_s.match?(/req/), description: desc }
       end
 

data/lib/oas_objs/response_obj.rb

@@ -8,11 +8,11 @@ module OpenApi
       include Helpers
 
       attr_accessor :processed, :code, :media_type
-      def initialize(desc, media_type, schema_hash)
-        @schema_hash = schema_hash
+      def initialize(desc, media_type, hash)
+        @hash = hash
         @mt = media_type
         self.code       = code.to_s
-        self.media_type = MediaTypeObj.new(media_type, schema_hash)
+        self.media_type = MediaTypeObj.new(media_type, hash)
         self.processed  = { description: desc }
       end
 
@@ -22,8 +22,8 @@ module OpenApi
       end
 
       def override type_hash
-        @schema_hash[:type].merge!(type_hash)
-        self.media_type = MediaTypeObj.new(@mt, @schema_hash)
+        @hash[:type].merge!(type_hash)
+        self.media_type = MediaTypeObj.new(@mt, @hash)
         self
       end
     end

data/lib/oas_objs/schema_obj.rb

@@ -1,6 +1,7 @@
 require 'oas_objs/helpers'
 require 'open_api/config'
 require 'oas_objs/ref_obj'
+require 'oas_objs/example_obj'
 
 module OpenApi
   module DSL
@@ -9,6 +10,7 @@ module OpenApi
       include Helpers
 
       attr_accessor :processed, :type
+
       def initialize(type, schema_hash)
         self.processed = { }
         # [Note] Here is no limit to type, even if the input isn't up to OAS,
@@ -26,20 +28,21 @@ module OpenApi
         return processed if @preprocessed
 
         processed.merge! processed_type
-        reduceee processed_enum_and_length,
-                 processed_range,
-                 processed_is_and_format(param_name),
-                 {
-                     pattern:    _pattern&.inspect&.delete('/'),
-                     default:    _default,
-                     as:         _as,
-                     permit:     _permit,
-                     not_permit: _npermit,
-                 }
+        reducx processed_enum_and_length,
+               processed_range,
+               processed_is_and_format(param_name),
+               {
+                   pattern:    _pattern&.inspect&.delete('/'),
+                   default:    '_default',
+                   examples:   self[:examples].present? ? ExampleObj.new(self[:examples], self[:exp_by]).process : nil,
+               },
+               { as: _as, permit: _permit, not_permit: _npermit, req_if: _req_if, opt_if: _opt_if }
         then_merge!
+        processed[:default] = _default unless _default.nil?
 
-        reduceee(processed_desc options).then_merge!
+        reducx(processed_desc options).then_merge!
       end
+
       alias process process_for
 
       def preprocess_with_desc desc, param_name = nil
@@ -87,7 +90,7 @@ module OpenApi
           recursive_array_type t
         elsif t.is_a? Symbol
           RefObj.new(:schema, t).process
-        elsif t.in? %w[float double int32 int64] #  TTTTTIP: 这些值应该传 string 进来, symbol 只允许 $ref
+        elsif t.in? %w[float double int32 int64] # to README: 这些值应该传 string 进来, symbol 只允许 $ref
           { type: t.match?('int') ? 'integer' : 'number', format: t}
         elsif t.in? %w[binary base64]
           { type: 'string', format: t}
@@ -99,6 +102,7 @@ module OpenApi
           { type: t }
         end
       end
+
       def recursive_obj_type(t) # DSL use { prop_name: prop_type } to represent object structure
         return processed_type(t) if !t.is_a?(Hash) || t.key?(:type)
 
@@ -114,6 +118,7 @@ module OpenApi
         end
         _schema.keep_if &value_present
       end
+
       def recursive_array_type(t)
         if t.is_a? Array
           {
@@ -148,16 +153,12 @@ module OpenApi
 
         # generate length range fields by _lth array
         lth = _length || [ ]
-        if self[:type] == 'array'
-          {
-              minItems: lth.is_a?(Array) ? lth.first : nil,
-              maxItems: lth.is_a?(Array) ? lth.last : nil
-          }
+        max = lth.is_a?(Array) ? lth.first : ("#{lth}".match?('ge') ? "#{lth}".split('_').last.to_i : nil)
+        min = lth.is_a?(Array) ? lth.last : ("#{lth}".match?('le') ? "#{lth}".split('_').last.to_i : nil)
+        if processed[:type] == 'array'
+          { minItems: max, maxItems: min }
         else
-          {
-              minLength: lth.is_a?(Array) ? lth.first : ("#{lth}".match?('ge') ? "#{lth}".split('_').last.to_i : nil),
-              maxLength: lth.is_a?(Array) ? lth.last : ("#{lth}".match?('le') ? "#{lth}".split('_').last.to_i : nil)
-          }
+          { minLength: max, maxLength: min }
         end.merge!(enum: _enum).keep_if &value_present
       end
 
@@ -180,12 +181,12 @@ module OpenApi
           it.merge! is: _is
         end
       end
+
       def recognize_is_options_in(name)
         # identify whether `is` patterns matched the name, if so, generate `is`.
         Config.is_options.each do |pattern|
           self._is = pattern or break if name.match? /#{pattern}/
         end if _is.nil?
-        self.delete :_is if _is.in?([:x, :we])
       end
 
 
@@ -203,6 +204,8 @@ module OpenApi
           _as:      %i[ as   to  for     map  mapping     ], # NOT OAS Spec, it's for zero-params_processor
           _permit:  %i[ permit   pmt                      ], # NOT OAS Spec, it's for zero-params_processor
           _npermit: %i[ npmt     not_permit   unpermit    ], # NOT OAS Spec, it's for zero-params_processor
+          _req_if:  %i[ req_if   req_when                 ], # NOT OAS Spec, it's for zero-params_processor
+          _opt_if:  %i[ opt_if   opt_when                 ], # NOT OAS Spec, it's for zero-params_processor
       }.each do |key, aliases|
         define_method key do
           aliases.each do |alias_name|
@@ -226,7 +229,12 @@ Primitive Sample
 
 {
   "type": "string",
-  "format": "email"
+  "format": "email",
+  "examples": {
+    "exp1": {
+      "value": 'val'
+    }
+  }
 }
 
 Simple Model

data/lib/open_api/config.rb

@@ -1,4 +1,5 @@
 require 'open_api/config_dsl'
+require 'active_support/all'
 
 module OpenApi
   module Config

data/lib/open_api/dsl.rb

@@ -36,22 +36,22 @@ module OpenApi
         # select the routing info (corresponding to the current method) from the routing list.
         action_path = "#{@_ctrl_path ||= controller_path}##{method}"
         routes_info = ctrl_routes_list&.select { |api| api[:action_path].match? /^#{action_path}$/ }&.first
-        pp "[ZRO Warnning] Routing mapping failed: #{@_ctrl_path}##{method}" and return if routes_info.nil?
+        pp "[ZRO Warning] Routing mapping failed: #{@_ctrl_path}##{method}" and return if routes_info.nil?
         Generator.generate_builder_file(action_path, builder) if builder.present?
 
         # structural { #path: { #http_method:{ } } }, for pushing into Paths Object.
         path = (@_api_infos ||= { })[routes_info[:path]] ||= { }
         current_api = path[routes_info[:http_verb]] =
-            ApiInfoObj.new(action_path, skip: skip, use: use)
+            ApiInfoObj.new(action_path, skip: Array(skip), use: Array(use))
                 .merge! description: '', summary: summary, operationId: method, tags: [@_apis_tag],
                         parameters: [ ], requestBody: '',  responses: { },      security: [ ], servers: [ ]
 
         current_api.tap do |api|
           [method, :all].each do |key| # blocks_store_key
-            @_apis_blocks&.[](key)&.each { |blk| api.instance_eval &blk }
+            @_apis_blocks&.[](key)&.each { |blk| api.instance_eval(&blk) }
           end
           api.param_use = [ ] # skip 和 use 是对 dry 块而言的
-          api.instance_eval &block if block_given?
+          api.instance_eval(&block) if block_given?
           api._process_objs
           api.delete_if { |_, v| v.blank? }
         end

data/lib/open_api/dsl/api_info_obj.rb

@@ -64,12 +64,12 @@ module OpenApi
         self[:parameters].concat([component_key].concat(keys).map { |key| RefObj.new(:parameter, key).process })
       end
 
-      def request_body required, media_type, desc = '', schema_hash = { }
-        self[:requestBody] = RequestBodyObj.new(required, media_type, desc, schema_hash).process
+      def request_body required, media_type, desc = '', hash = { }
+        self[:requestBody] = RequestBodyObj.new(required, media_type, desc, hash).process
       end
 
-      def _request_body_agent media_type, desc = '', schema_hash = { }
-        request_body (@method_name['!'] ? :req : :opt), media_type, desc, schema_hash
+      def _request_body_agent media_type, desc = '', hash = { }
+        request_body (@method_name['!'] ? :req : :opt), media_type, desc, hash
       end
 
       def body_ref component_key
@@ -88,17 +88,21 @@ module OpenApi
       end
 
       # TODO: 目前只能写一句 request body，包括 form 和 file， 需要同时支持一下扁平化
-      def form desc = '', schema_hash = { }
-        body :form, desc, schema_hash
+      def form desc = '', hash = { }
+        body :form, desc, hash
       end
-      def form! desc = '', schema_hash = { }
-        body! :form, desc, schema_hash
+
+      def form! desc = '', hash = { }
+        body! :form, desc, hash
       end
-      def file media_type, desc = '', schema_hash = { type: File }
-        body media_type, desc, schema_hash
+
+      # TODO: 这种情况下 form 和 file 无法共存，需要解决（通过 Discriminator?）
+      def file media_type, desc = '', hash = { type: File }
+        body media_type, desc, hash
       end
-      def file! media_type, desc = '', schema_hash = { type: File }
-        body! media_type, desc, schema_hash
+
+      def file! media_type, desc = '', hash = { type: File }
+        body! media_type, desc, hash
       end
 
       def security scheme_name, requirements = [ ]

data/lib/open_api/dsl/common_dsl.rb

@@ -23,12 +23,12 @@ module OpenApi
       end
 
       # `code`: when defining components, `code` means `component_key`
-      def response code, desc, media_type = nil, schema_hash = { }
-        (self[:responses] ||= { })[code] = ResponseObj.new(desc, media_type, schema_hash)
+      def response code, desc, media_type = nil, hash = { }
+        (self[:responses] ||= { })[code] = ResponseObj.new(desc, media_type, hash)
       end
 
-      def default_response desc, media_type = nil, schema_hash = { }
-        response :default, desc, media_type, schema_hash
+      def default_response desc, media_type = nil, hash = { }
+        response :default, desc, media_type, hash
       end
 
       { # alias_methods mapping

data/lib/open_api/dsl/ctrl_info_obj.rb

@@ -11,6 +11,10 @@ module OpenApi
       end
       arrow_enable :schema
 
+      def example summary, example_hash
+        # TODO
+      end
+
       def param component_key, param_type, name, type, required, schema_hash = { }
         (self[:parameters] ||= { })[component_key] =
             ParamObj.new(name, param_type, type, required, schema_hash).process

data/lib/open_api/generator.rb

@@ -36,6 +36,9 @@ module OpenApi
           doc[:components].merge! ctrl_infos[:components] || { }
         end
         doc[:components].delete_if { |_, v| v.blank? }
+        doc[:tags]  = doc[:tags].sort { |a, b| a[:name] <=> b[:name] }
+        doc[:paths] = doc[:paths].sort.to_h
+
         ($open_apis ||= { })[api_name] ||=
             ActiveSupport::HashWithIndifferentAccess.new(doc.delete_if { |_, v| v.blank? })
       end

data/lib/open_api/version.rb

@@ -1,3 +1,3 @@
 module OpenApi
-  VERSION = '1.3.1'
+  VERSION = '1.3.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zero-rails_openapi
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.3.2
 platform: ruby
 authors:
 - zhandao
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-11-05 00:00:00.000000000 Z
+date: 2017-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -81,6 +81,7 @@ files:
 - documentation/examples/goods_doc.rb
 - documentation/examples/open_api.rb
 - documentation/parameter.md
+- lib/oas_objs/example_obj.rb
 - lib/oas_objs/helpers.rb
 - lib/oas_objs/media_type_obj.rb
 - lib/oas_objs/param_obj.rb
@@ -119,7 +120,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: Generate the OpenAPI Specification 3 documentation for Rails application.