Issues zipmark#191 zipmark#402 and zipmark#403: Add example property and remove duplicated parameters (generated by the path parameter search: RspecApiDocumentation::DSL.extract_route_parameters!)

Author: Paulo Mateus Moura da Silva

README.md

@@ -359,7 +359,8 @@ This [format](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/
     
 * Several new options on `parameter` helper.
 
-    - `with_example: true`. This option will adjust your description of the parameter with the passed value.
+    - `with_example: true`. This option will adjust your example of the parameter with the passed value.
+    - `example: <value>`. Will provide a example value for the parameter.
     - `default: <value>`. Will provide a default value for the parameter.
     - `minimum: <integer>`. Will setup upper limit for your parameter. 
     - `maximum: <integer>`. Will setup lower limit for your parameter.

lib/rspec_api_documentation/open_api/parameter.rb

@@ -16,18 +16,9 @@ class Parameter < Node
       add_setting :minimum
       add_setting :maximum
       add_setting :enum
-
-      def description_with_example
-        str = description_without_example.dup || ''
-        if with_example && value
-          str << "\n" unless str.empty?
-          str << "Eg, `#{value}`"
-        end
-        str
-      end
+      add_setting :example, :default => lambda { |parameter| parameter.with_example ? parameter.value : nil }
 
       alias_method :description_without_example, :description
-      alias_method :description, :description_with_example
     end
   end
 end

lib/rspec_api_documentation/writers/open_api_writer.rb

@@ -156,8 +156,10 @@ def extract_schema(fields)
       end
 
       def extract_parameters(example)
-        extract_known_parameters(example.extended_parameters.select { |p| !p[:in].nil? }) +
-          extract_unknown_parameters(example, example.extended_parameters.select { |p| p[:in].nil? })
+        parameters = example.extended_parameters.uniq { |parameter| parameter[:name] }
+
+        extract_known_parameters(parameters.select { |p| !p[:in].nil? }) +
+          extract_unknown_parameters(example, parameters.select { |p| p[:in].nil? })
       end
 
       def extract_parameter(opts)
@@ -170,6 +172,7 @@ def extract_parameter(opts)
           value:        opts[:value],
           with_example: opts[:with_example],
           default:      opts[:default],
+          example:      opts[:example],
         ).tap do |elem|
           if elem.type == :array
             elem.items = opts[:items] || OpenApi::Helper.extract_items(opts[:value][0], { minimum: opts[:minimum], maximum: opts[:maximum], enum: opts[:enum] })