Add support for response links (#11)

* Remove duplicate ExampleGroupHelpers spec example

* Add support for response links

Author: chewi

rswag-specs/lib/open_api/rswag/specs/example_group_helpers.rb

@@ -176,6 +176,11 @@ def header(name, attributes)
           metadata[:response][:headers][name] = attributes
         end
 
+        def link(name, attributes)
+          metadata[:response][:links] ||= {}
+          metadata[:response][:links][name] = attributes
+        end
+
         # NOTE: Similar to 'description', 'examples' need to handle the case when
         # being invoked with no params to avoid overriding 'examples' method of
         # rspec-core ExampleGroup

rswag-specs/spec/rswag/specs/example_group_helpers_spec.rb

@@ -36,31 +36,6 @@ module Specs
           end
         end
 
-        describe '#tags|description|operationId|consumes|produces|schemes|deprecated(value)' do
-          before do
-            subject.tags('Blogs', 'Admin')
-            subject.description('Some description')
-            subject.operationId('createBlog')
-            subject.consumes('application/json', 'application/xml')
-            subject.produces('application/json', 'application/xml')
-            subject.schemes('http', 'https')
-            subject.deprecated(true)
-          end
-          let(:api_metadata) { { operation: {} } }
-
-          it "adds to the 'operation' metadata" do
-            expect(api_metadata[:operation]).to match(
-                                                    tags: %w[Blogs Admin],
-                                                    description: 'Some description',
-                                                    operationId: 'createBlog',
-                                                    consumes: ['application/json', 'application/xml'],
-                                                    produces: ['application/json', 'application/xml'],
-                                                    schemes: %w[http https],
-                                                    deprecated: true
-                                                )
-          end
-        end
-
         describe '#tags|description|operationId|consumes|produces|schemes|deprecated|security(value)' do
           before do
             subject.tags('Blogs', 'Admin')
@@ -195,6 +170,22 @@ module Specs
           end
         end
 
+        describe '#link(name, attributes)' do
+          before do
+            subject.link('GetUserByUserId', '$ref' => '#/components/links/GetUserByUserId')
+            subject.link('GetUserByReference', '$ref' => '#/components/links/GetUserByReference')
+          end
+
+          let(:api_metadata) { { response: {} } }
+
+          it "adds to the 'response links' metadata" do
+            expect(api_metadata[:response][:links]).to match(
+              'GetUserByUserId' => { '$ref' => '#/components/links/GetUserByUserId' },
+              'GetUserByReference' => { '$ref' => '#/components/links/GetUserByReference' }
+            )
+          end
+        end
+
         describe '#examples(example)' do
           let(:json_example) do
             {