grape-swagger 0.20.3 → 0.21.0

data/spec/lib/produces_consumes_spec.rb

@@ -28,7 +28,8 @@ describe GrapeSwagger::DocMethods::ProducesConsumes do
             'application/json',
             'application/octet-stream',
             'text/plain'
-          ])
+          ]
+        )
       end
     end
   end
@@ -59,7 +60,8 @@ describe GrapeSwagger::DocMethods::ProducesConsumes do
             'application/json',
             'application/octet-stream',
             'text/plain'
-          ])
+          ]
+        )
       end
     end
   end
@@ -82,7 +84,8 @@ describe GrapeSwagger::DocMethods::ProducesConsumes do
           'application/json',
           'application/octet-stream',
           'text/plain'
-        ])
+        ]
+      )
     end
 
     subject do
@@ -93,7 +96,8 @@ describe GrapeSwagger::DocMethods::ProducesConsumes do
           'application/json',
           'application/octet-stream',
           :txt
-        ])
+        ]
+      )
     end
 
     specify do
@@ -103,7 +107,8 @@ describe GrapeSwagger::DocMethods::ProducesConsumes do
           'application/json',
           'application/octet-stream',
           'text/plain'
-        ])
+        ]
+      )
     end
   end
 end

data/spec/spec_helper.rb

@@ -1,10 +1,12 @@
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 
-Dir[File.join(Dir.getwd, 'spec/support/**/*.rb')].each { |f| require f }
+MODEL_PARSER = ENV.key?('MODEL_PARSER') ? ENV['MODEL_PARSER'].to_s.downcase.sub('grape-swagger-', '') : 'mock'
 
 require 'grape'
 require 'grape-swagger'
-require 'grape-entity'
+Dir[File.join(Dir.getwd, 'spec/support/*.rb')].each { |f| require f }
+require "grape-swagger/#{MODEL_PARSER}" if MODEL_PARSER != 'mock'
+require File.join(Dir.getwd, "spec/support/model_parsers/#{MODEL_PARSER}_parser.rb")
 
 Bundler.setup :default, :test
 

data/spec/support/empty_model_parser.rb

@@ -0,0 +1,20 @@
+class EmptyClass
+end
+
+module GrapeSwagger
+  class EmptyModelParser
+    attr_reader :model
+    attr_reader :endpoint
+
+    def initialize(model, endpoint)
+      @model = model
+      @endpoint = endpoint
+    end
+
+    def call
+      {}
+    end
+  end
+end
+
+GrapeSwagger.model_parsers.register(GrapeSwagger::EmptyModelParser, EmptyClass)

data/spec/support/mock_parser.rb

@@ -0,0 +1,22 @@
+module GrapeSwagger
+  class MockParser
+    attr_reader :model
+    attr_reader :endpoint
+
+    def initialize(model, endpoint)
+      @model = model
+      @endpoint = endpoint
+    end
+
+    def call
+      {
+        mock_data: {
+          type: :string,
+          description: "it's a mock"
+        }
+      }
+    end
+  end
+end
+
+GrapeSwagger.model_parsers.register(GrapeSwagger::MockParser, OpenStruct)

data/spec/support/model_parsers/entity_parser.rb

@@ -0,0 +1,325 @@
+RSpec.shared_context 'entity swagger example' do
+  before :all do
+    module Entities
+      class Something < Grape::Entity
+        expose :id, documentation: { type: Integer, desc: 'Identity of Something' }
+        expose :text, documentation: { type: String, desc: 'Content of something.' }
+        expose :links, documentation: { type: 'link', is_array: true }
+        expose :others, documentation: { type: 'text', is_array: false }
+      end
+
+      class EnumValues < Grape::Entity
+        expose :gender, documentation: { type: 'string', desc: 'Content of something.', values: %w(Male Female) }
+        expose :number, documentation: { type: 'integer', desc: 'Content of something.', values: [1, 2] }
+      end
+
+      class AliasedThing < Grape::Entity
+        expose :something, as: :post, using: Entities::Something, documentation: { type: 'Something', desc: 'Reference to something.' }
+      end
+
+      class FourthLevel < Grape::Entity
+        expose :text, documentation: { type: 'string' }
+      end
+
+      class ThirdLevel < Grape::Entity
+        expose :parts, using: Entities::FourthLevel, documentation: { type: 'FourthLevel' }
+      end
+
+      class SecondLevel < Grape::Entity
+        expose :parts, using: Entities::ThirdLevel, documentation: { type: 'ThirdLevel' }
+      end
+
+      class FirstLevel < Grape::Entity
+        expose :parts, using: Entities::SecondLevel, documentation: { type: 'SecondLevel' }
+      end
+
+      class QueryInputElement < Grape::Entity
+        expose :key, documentation: {
+          type: String, desc: 'Name of parameter', required: true
+        }
+        expose :value, documentation: {
+          type: String, desc: 'Value of parameter', required: true
+        }
+      end
+
+      class QueryInput < Grape::Entity
+        expose :elements, using: Entities::QueryInputElement, documentation: {
+          type: 'QueryInputElement',
+          desc: 'Set of configuration',
+          param_type: 'body',
+          is_array: true,
+          required: true
+        }
+      end
+
+      class ApiError < Grape::Entity
+        expose :code, documentation: { type: Integer, desc: 'status code' }
+        expose :message, documentation: { type: String, desc: 'error message' }
+      end
+
+      class SecondApiError < Grape::Entity
+        expose :code, documentation: { type: Integer }
+        expose :severity, documentation: { type: String }
+        expose :message, documentation: { type: String }
+      end
+
+      class ResponseItem < Grape::Entity
+        expose :id, documentation: { type: Integer }
+        expose :name, documentation: { type: String }
+      end
+
+      class OtherItem < Grape::Entity
+        expose :key, documentation: { type: Integer }
+        expose :symbol, documentation: { type: String }
+      end
+
+      class UseResponse < Grape::Entity
+        expose :description, documentation: { type: String }
+        expose :items, as: '$responses', using: Entities::ResponseItem, documentation: { is_array: true }
+      end
+
+      class UseItemResponseAsType < Grape::Entity
+        expose :description, documentation: { type: String }
+        expose :responses, documentation: { type: Entities::ResponseItem, is_array: false }
+      end
+
+      class UseAddress < Grape::Entity
+        expose :street, documentation: { type: String, desc: 'street' }
+        expose :postcode, documentation: { type: String, desc: 'postcode' }
+        expose :city, documentation: { type: String, desc: 'city' }
+        expose :country, documentation: { type: String, desc: 'country' }
+      end
+
+      class UseNestedWithAddress < Grape::Entity
+        expose :name, documentation: { type: String }
+        expose :address, using: Entities::UseAddress
+      end
+
+      class TypedDefinition < Grape::Entity
+        expose :prop_integer,   documentation: { type: Integer, desc: 'prop_integer description' }
+        expose :prop_long,      documentation: { type: Numeric, desc: 'prop_long description' }
+        expose :prop_float,     documentation: { type: Float, desc: 'prop_float description' }
+        expose :prop_double,    documentation: { type: BigDecimal, desc: 'prop_double description' }
+        expose :prop_string,    documentation: { type: String, desc: 'prop_string description' }
+        expose :prop_symbol,    documentation: { type: Symbol, desc: 'prop_symbol description' }
+        expose :prop_date,      documentation: { type: Date, desc: 'prop_date description' }
+        expose :prop_date_time, documentation: { type: DateTime, desc: 'prop_date_time description' }
+        expose :prop_time,      documentation: { type: Time, desc: 'prop_time description' }
+        expose :prop_password,  documentation: { type: 'password', desc: 'prop_password description' }
+        expose :prop_email,     documentation: { type: 'email', desc: 'prop_email description' }
+        expose :prop_boolean,   documentation: { type: Virtus::Attribute::Boolean, desc: 'prop_boolean description' }
+        expose :prop_file,      documentation: { type: File, desc: 'prop_file description' }
+        expose :prop_json,      documentation: { type: JSON, desc: 'prop_json description' }
+      end
+
+      class RecursiveModel < Grape::Entity
+        expose :name, documentation: { type: String, desc: 'The name.' }
+        expose :children, using: self, documentation: { type: 'RecursiveModel', is_array: true, desc: 'The child nodes.' }
+      end
+    end
+  end
+
+  let(:swagger_definitions_models) do
+    {
+      'ApiError' => { 'type' => 'object', 'properties' => { 'code' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'status code' }, 'message' => { 'type' => 'string', 'description' => 'error message' } } },
+      'ResponseItem' => { 'type' => 'object', 'properties' => { 'id' => { 'type' => 'integer', 'format' => 'int32' }, 'name' => { 'type' => 'string' } } },
+      'UseResponse' => { 'type' => 'object', 'properties' => { 'description' => { 'type' => 'string' }, '$responses' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/ResponseItem' } } } },
+      'RecursiveModel' => { 'type' => 'object', 'properties' => { 'name' => { 'type' => 'string', 'description' => 'The name.' }, 'children' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/RecursiveModel' }, 'description' => 'The child nodes.' } } }
+    }
+  end
+
+  let(:swagger_nested_type) do
+    {
+      'ApiError' => { 'type' => 'object', 'properties' => { 'code' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'status code' }, 'message' => { 'type' => 'string', 'description' => 'error message' } }, 'description' => 'This returns something' },
+      'ResponseItem' => { 'type' => 'object', 'properties' => { 'id' => { 'type' => 'integer', 'format' => 'int32' }, 'name' => { 'type' => 'string' } } },
+      'UseItemResponseAsType' => { 'type' => 'object', 'properties' => { 'description' => { 'type' => 'string' }, 'responses' => { '$ref' => '#/definitions/ResponseItem' } }, 'description' => 'This returns something' }
+    }
+  end
+
+  let(:swagger_entity_as_response_object) do
+    {
+      'ApiError' => { 'type' => 'object', 'properties' => { 'code' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'status code' }, 'message' => { 'type' => 'string', 'description' => 'error message' } }, 'description' => 'This returns something' },
+      'ResponseItem' => { 'type' => 'object', 'properties' => { 'id' => { 'type' => 'integer', 'format' => 'int32' }, 'name' => { 'type' => 'string' } } },
+      'UseResponse' => { 'type' => 'object', 'properties' => { 'description' => { 'type' => 'string' }, '$responses' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/ResponseItem' } } }, 'description' => 'This returns something' }
+    }
+  end
+
+  let(:swagger_params_as_response_object) do
+    {
+      'ApiError' => { 'type' => 'object', 'properties' => { 'code' => { 'description' => 'status code', 'type' => 'integer', 'format' => 'int32' }, 'message' => { 'description' => 'error message', 'type' => 'string' } }, 'description' => 'This returns something' }
+    }
+  end
+
+  let(:swagger_typed_defintion) do
+    {
+      'prop_boolean' => { 'description' => 'prop_boolean description', 'type' => 'boolean' },
+      'prop_date' => { 'description' => 'prop_date description', 'type' => 'string', 'format' => 'date' },
+      'prop_date_time' => { 'description' => 'prop_date_time description', 'type' => 'string', 'format' => 'date-time' },
+      'prop_double' => { 'description' => 'prop_double description', 'type' => 'number', 'format' => 'double' },
+      'prop_email' => { 'description' => 'prop_email description', 'type' => 'string', 'format' => 'email' },
+      'prop_file' => { 'description' => 'prop_file description', 'type' => 'file' },
+      'prop_float' => { 'description' => 'prop_float description', 'type' => 'number', 'format' => 'float' },
+      'prop_integer' => { 'description' => 'prop_integer description', 'type' => 'integer', 'format' => 'int32' },
+      'prop_json' => { 'description' => 'prop_json description', 'type' => 'json' },
+      'prop_long' => { 'description' => 'prop_long description', 'type' => 'integer', 'format' => 'int64' },
+      'prop_password' => { 'description' => 'prop_password description', 'type' => 'string', 'format' => 'password' },
+      'prop_string' => { 'description' => 'prop_string description', 'type' => 'string' },
+      'prop_symbol' => { 'description' => 'prop_symbol description', 'type' => 'string' },
+      'prop_time' => { 'description' => 'prop_time description', 'type' => 'string', 'format' => 'date-time' }
+    }
+  end
+
+  let(:swagger_json) do
+    {
+      'info' => {
+        'title' => 'The API title to be displayed on the API homepage.',
+        'description' => 'A description of the API.',
+        'termsOfServiceUrl' => 'www.The-URL-of-the-terms-and-service.com',
+        'contact' => { 'name' => 'Contact name', 'email' => 'Contact@email.com', 'url' => 'Contact URL' },
+        'license' => { 'name' => 'The name of the license.', 'url' => 'www.The-URL-of-the-license.org' },
+        'version' => '0.0.1'
+      },
+      'swagger' => '2.0',
+      'produces' => ['application/json'],
+      'host' => 'example.org',
+      'basePath' => '/api',
+      'tags' => [
+        { 'name' => 'other_thing', 'description' => 'Operations about other_things' },
+        { 'name' => 'thing', 'description' => 'Operations about things' },
+        { 'name' => 'thing2', 'description' => 'Operations about thing2s' },
+        { 'name' => 'dummy', 'description' => 'Operations about dummies' }
+      ],
+      'paths' => {
+        '/v3/other_thing/{elements}' => {
+          'get' => {
+            'summary' => 'nested route inside namespace',
+            'description' => 'nested route inside namespace',
+            'produces' => ['application/json'],
+            'parameters' => [{ 'in' => 'body', 'name' => 'elements', 'description' => 'Set of configuration', 'type' => 'array', 'items' => { 'type' => 'string' }, 'required' => true }],
+            'responses' => { '200' => { 'description' => 'nested route inside namespace', 'schema' => { '$ref' => '#/definitions/QueryInput' } } },
+            'tags' => ['other_thing'],
+            'operationId' => 'getV3OtherThingElements',
+            'x-amazon-apigateway-auth' => { 'type' => 'none' },
+            'x-amazon-apigateway-integration' => { 'type' => 'aws', 'uri' => 'foo_bar_uri', 'httpMethod' => 'get' }
+          }
+        },
+        '/thing' => {
+          'get' => {
+            'summary' => 'This gets Things.',
+            'description' => 'This gets Things.',
+            'produces' => ['application/json'],
+            'parameters' => [
+              { 'in' => 'query', 'name' => 'id', 'description' => 'Identity of Something', 'type' => 'integer', 'format' => 'int32', 'required' => false },
+              { 'in' => 'query', 'name' => 'text', 'description' => 'Content of something.', 'type' => 'string', 'required' => false },
+              { 'in' => 'formData', 'name' => 'links', 'type' => 'array', 'items' => { 'type' => 'link' }, 'required' => false },
+              { 'in' => 'query', 'name' => 'others', 'type' => 'text', 'required' => false }
+            ],
+            'responses' => { '200' => { 'description' => 'This gets Things.' }, '401' => { 'description' => 'Unauthorized', 'schema' => { '$ref' => '#/definitions/ApiError' } } },
+            'tags' => ['thing'],
+            'operationId' => 'getThing'
+          },
+          'post' => {
+            'summary' => 'This creates Thing.',
+            'description' => 'This creates Thing.',
+            'produces' => ['application/json'],
+            'consumes' => ['application/json'],
+            'parameters' => [
+              { 'in' => 'formData', 'name' => 'text', 'description' => 'Content of something.', 'type' => 'string', 'required' => true },
+              { 'in' => 'formData', 'name' => 'links', 'type' => 'array', 'items' => { 'type' => 'string' }, 'required' => true }
+            ],
+            'responses' => { '201' => { 'description' => 'This creates Thing.', 'schema' => { '$ref' => '#/definitions/Something' } }, '422' => { 'description' => 'Unprocessible Entity' } },
+            'tags' => ['thing'],
+            'operationId' => 'postThing'
+          }
+        },
+        '/thing/{id}' => {
+          'get' => {
+            'summary' => 'This gets Thing.',
+            'description' => 'This gets Thing.',
+            'produces' => ['application/json'],
+            'parameters' => [{ 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true }],
+            'responses' => { '200' => { 'description' => 'getting a single thing' }, '401' => { 'description' => 'Unauthorized' } },
+            'tags' => ['thing'],
+            'operationId' => 'getThingId'
+          },
+          'put' => {
+            'summary' => 'This updates Thing.',
+            'description' => 'This updates Thing.',
+            'produces' => ['application/json'],
+            'consumes' => ['application/json'],
+            'parameters' => [
+              { 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true },
+              { 'in' => 'formData', 'name' => 'text', 'description' => 'Content of something.', 'type' => 'string', 'required' => false },
+              { 'in' => 'formData', 'name' => 'links', 'type' => 'array', 'items' => { 'type' => 'string' }, 'required' => false }
+            ],
+            'responses' => { '200' => { 'description' => 'This updates Thing.', 'schema' => { '$ref' => '#/definitions/Something' } } },
+            'tags' => ['thing'],
+            'operationId' => 'putThingId'
+          },
+          'delete' => {
+            'summary' => 'This deletes Thing.',
+            'description' => 'This deletes Thing.',
+            'produces' => ['application/json'],
+            'parameters' => [{ 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true }],
+            'responses' => { '200' => { 'description' => 'This deletes Thing.', 'schema' => { '$ref' => '#/definitions/Something' } } },
+            'tags' => ['thing'],
+            'operationId' => 'deleteThingId'
+          }
+        },
+        '/thing2' => {
+          'get' => {
+            'summary' => 'This gets Things.',
+            'description' => 'This gets Things.',
+            'produces' => ['application/json'],
+            'responses' => { '200' => { 'description' => 'get Horses', 'schema' => { '$ref' => '#/definitions/Something' } }, '401' => { 'description' => 'HorsesOutError', 'schema' => { '$ref' => '#/definitions/ApiError' } } },
+            'tags' => ['thing2'],
+            'operationId' => 'getThing2'
+          }
+        },
+        '/dummy/{id}' => {
+          'delete' => {
+            'summary' => 'dummy route.',
+            'description' => 'dummy route.',
+            'produces' => ['application/json'],
+            'parameters' => [{ 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true }],
+            'responses' => { '204' => { 'description' => 'dummy route.' }, '401' => { 'description' => 'Unauthorized' } },
+            'tags' => ['dummy'],
+            'operationId' => 'deleteDummyId'
+          }
+        }
+      },
+      'definitions' => {
+        'QueryInput' => {
+          'type' => 'object',
+          'properties' => { 'elements' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/QueryInputElement' }, 'description' => 'Set of configuration' } },
+          'description' => 'nested route inside namespace'
+        },
+        'QueryInputElement' => {
+          'type' => 'object',
+          'properties' => { 'key' => { 'type' => 'string', 'description' => 'Name of parameter' }, 'value' => { 'type' => 'string', 'description' => 'Value of parameter' } }
+        },
+        'ApiError' => {
+          'type' => 'object',
+          'properties' => { 'code' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'status code' }, 'message' => { 'type' => 'string', 'description' => 'error message' } },
+          'description' => 'This gets Things.'
+        },
+        'Something' => {
+          'type' => 'object',
+          'properties' => {
+            'id' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'Identity of Something' },
+            'text' => { 'type' => 'string', 'description' => 'Content of something.' },
+            'links' => { 'type' => 'link' },
+            'others' => { 'type' => 'text' }
+          },
+          'description' => 'This gets Things.'
+        }
+      }
+    }
+  end
+
+  let(:http_verbs) { %w(get post put delete) }
+end
+
+def mounted_paths
+  %w( /thing /other_thing /dummy )
+end

data/spec/support/{api_swagger_v2_result.rb → model_parsers/mock_parser.rb}

@@ -1,60 +1,164 @@
-RSpec.shared_context 'swagger example' do
+RSpec.shared_context 'mock swagger example' do
   before :all do
     module Entities
-      class Something < Grape::Entity
-        expose :id, documentation: { type: Integer, desc: 'Identity of Something' }
-        expose :text, documentation: { type: String, desc: 'Content of something.' }
-        expose :links, documentation: { type: 'link', is_array: true }
-        expose :others, documentation: { type: 'text', is_array: false }
+      class Something < OpenStruct
+        class << self
+          # Representable doesn't have documentation method, mock this
+          def documentation
+            {
+              id: { type: Integer, desc: 'Identity of Something' },
+              text: { type: String, desc: 'Content of something.' },
+              links: { type: 'link', is_array: true },
+              others: { type: 'text', is_array: false }
+            }
+          end
+        end
       end
 
-      class EnumValues < Grape::Entity
-        expose :gender, documentation: { type: 'string', desc: 'Content of something.', values: %w(Male Female) }
-        expose :number, documentation: { type: 'integer', desc: 'Content of something.', values: [1, 2] }
+      class UseResponse < OpenStruct
+        class << self
+          def documentation
+            {
+              :description => { type: String },
+              '$responses' => { is_array: true }
+            }
+          end
+        end
       end
 
-      class AliasedThing < Grape::Entity
-        expose :something, as: :post, using: Entities::Something, documentation: { type: 'Something', desc: 'Reference to something.' }
+      class ResponseItem < OpenStruct
+        class << self
+          def documentation
+            {
+              id: { type: Integer },
+              name: { type: String }
+            }
+          end
+        end
       end
 
-      class FourthLevel < Grape::Entity
-        expose :text, documentation: { type: 'string' }
-      end
-
-      class ThirdLevel < Grape::Entity
-        expose :parts, using: Entities::FourthLevel, documentation: { type: 'FourthLevel' }
-      end
+      class UseNestedWithAddress < OpenStruct; end
+      class TypedDefinition < OpenStruct; end
+      class UseItemResponseAsType < OpenStruct; end
+      class OtherItem < OpenStruct; end
+      class EnumValues < OpenStruct; end
+      class AliasedThing < OpenStruct; end
+      class FourthLevel < OpenStruct; end
+      class ThirdLevel < OpenStruct; end
+      class SecondLevel < OpenStruct; end
+      class FirstLevel < OpenStruct; end
+      class QueryInputElement < OpenStruct; end
+      class QueryInput < OpenStruct; end
+      class ApiError < OpenStruct; end
+      class SecondApiError < OpenStruct; end
+      class RecursiveModel < OpenStruct; end
+    end
+  end
 
-      class SecondLevel < Grape::Entity
-        expose :parts, using: Entities::ThirdLevel, documentation: { type: 'ThirdLevel' }
-      end
+  let(:swagger_definitions_models) do
+    {
+      'ApiError' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        }
+      },
+      'RecursiveModel' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        }
+      },
+      'UseResponse' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        }
+      }
+    }
+  end
 
-      class FirstLevel < Grape::Entity
-        expose :parts, using: Entities::SecondLevel, documentation: { type: 'SecondLevel' }
-      end
+  let(:swagger_nested_type) do
+    {
+      'ApiError' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        },
+        'description' => 'This returns something'
+      },
+      'UseItemResponseAsType' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        },
+        'description' => 'This returns something'
+      }
+    }
+  end
 
-      class QueryInputElement < Grape::Entity
-        expose :key, documentation: {
-          type: String, desc: 'Name of parameter', required: true }
-        expose :value, documentation: {
-          type: String, desc: 'Value of parameter', required: true }
-      end
+  let(:swagger_entity_as_response_object) do
+    {
+      'UseResponse' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        },
+        'description' => 'This returns something'
+      },
+      'ApiError' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        },
+        'description' => 'This returns something'
+      }
+    }
+  end
 
-      class QueryInput < Grape::Entity
-        expose :elements, using: Entities::QueryInputElement, documentation: {
-          type: 'QueryInputElement',
-          desc: 'Set of configuration',
-          param_type: 'body',
-          is_array: true,
-          required: true
-        }
-      end
+  let(:swagger_params_as_response_object) do
+    {
+      'ApiError' => {
+        'type' => 'object',
+        'properties' => {
+          'mock_data' => {
+            'type' => 'string',
+            'description' => "it's a mock"
+          }
+        },
+        'description' => 'This returns something'
+      }
+    }
+  end
 
-      class ApiError < Grape::Entity
-        expose :code, documentation: { type: Integer, desc: 'status code' }
-        expose :message, documentation: { type: String, desc: 'error message' }
-      end
-    end
+  let(:swagger_typed_defintion) do
+    {
+      'mock_data' => {
+        'type' => 'string',
+        'description' => "it's a mock"
+      }
+    }
   end
 
   let(:swagger_json) do
@@ -80,6 +184,7 @@ RSpec.shared_context 'swagger example' do
       'paths' => {
         '/v3/other_thing/{elements}' => {
           'get' => {
+            'summary' => 'nested route inside namespace',
             'description' => 'nested route inside namespace',
             'produces' => ['application/json'],
             'parameters' => [{ 'in' => 'body', 'name' => 'elements', 'description' => 'Set of configuration', 'type' => 'array', 'items' => { 'type' => 'string' }, 'required' => true }],
@@ -88,9 +193,11 @@ RSpec.shared_context 'swagger example' do
             'operationId' => 'getV3OtherThingElements',
             'x-amazon-apigateway-auth' => { 'type' => 'none' },
             'x-amazon-apigateway-integration' => { 'type' => 'aws', 'uri' => 'foo_bar_uri', 'httpMethod' => 'get' }
-          } },
+          }
+        },
         '/thing' => {
           'get' => {
+            'summary' => 'This gets Things.',
             'description' => 'This gets Things.',
             'produces' => ['application/json'],
             'parameters' => [
@@ -104,6 +211,7 @@ RSpec.shared_context 'swagger example' do
             'operationId' => 'getThing'
           },
           'post' => {
+            'summary' => 'This creates Thing.',
             'description' => 'This creates Thing.',
             'produces' => ['application/json'],
             'consumes' => ['application/json'],
@@ -114,9 +222,11 @@ RSpec.shared_context 'swagger example' do
             'responses' => { '201' => { 'description' => 'This creates Thing.', 'schema' => { '$ref' => '#/definitions/Something' } }, '422' => { 'description' => 'Unprocessible Entity' } },
             'tags' => ['thing'],
             'operationId' => 'postThing'
-          } },
+          }
+        },
         '/thing/{id}' => {
           'get' => {
+            'summary' => 'This gets Thing.',
             'description' => 'This gets Thing.',
             'produces' => ['application/json'],
             'parameters' => [{ 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true }],
@@ -125,6 +235,7 @@ RSpec.shared_context 'swagger example' do
             'operationId' => 'getThingId'
           },
           'put' => {
+            'summary' => 'This updates Thing.',
             'description' => 'This updates Thing.',
             'produces' => ['application/json'],
             'consumes' => ['application/json'],
@@ -138,55 +249,70 @@ RSpec.shared_context 'swagger example' do
             'operationId' => 'putThingId'
           },
           'delete' => {
+            'summary' => 'This deletes Thing.',
             'description' => 'This deletes Thing.',
             'produces' => ['application/json'],
             'parameters' => [{ 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true }],
             'responses' => { '200' => { 'description' => 'This deletes Thing.', 'schema' => { '$ref' => '#/definitions/Something' } } },
             'tags' => ['thing'],
             'operationId' => 'deleteThingId'
-          } },
+          }
+        },
         '/thing2' => {
           'get' => {
+            'summary' => 'This gets Things.',
             'description' => 'This gets Things.',
             'produces' => ['application/json'],
             'responses' => { '200' => { 'description' => 'get Horses', 'schema' => { '$ref' => '#/definitions/Something' } }, '401' => { 'description' => 'HorsesOutError', 'schema' => { '$ref' => '#/definitions/ApiError' } } },
             'tags' => ['thing2'],
             'operationId' => 'getThing2'
-          } },
+          }
+        },
         '/dummy/{id}' => {
           'delete' => {
+            'summary' => 'dummy route.',
             'description' => 'dummy route.',
             'produces' => ['application/json'],
             'parameters' => [{ 'in' => 'path', 'name' => 'id', 'type' => 'integer', 'format' => 'int32', 'required' => true }],
             'responses' => { '204' => { 'description' => 'dummy route.' }, '401' => { 'description' => 'Unauthorized' } },
             'tags' => ['dummy'],
             'operationId' => 'deleteDummyId'
-          } } },
+          }
+        }
+      },
       'definitions' => {
         'QueryInput' => {
           'type' => 'object',
-          'properties' => { 'elements' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/QueryInputElement' }, 'description' => 'Set of configuration' } },
+          'properties' => {
+            'mock_data' => {
+              'type' => 'string',
+              'description' => "it's a mock"
+            }
+          },
           'description' => 'nested route inside namespace'
         },
-        'QueryInputElement' => {
-          'type' => 'object',
-          'properties' => { 'key' => { 'type' => 'string', 'description' => 'Name of parameter' }, 'value' => { 'type' => 'string', 'description' => 'Value of parameter' } }
-        },
         'ApiError' => {
           'type' => 'object',
-          'properties' => { 'code' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'status code' }, 'message' => { 'type' => 'string', 'description' => 'error message' } },
+          'properties' => {
+            'mock_data' => {
+              'type' => 'string',
+              'description' => "it's a mock"
+            }
+          },
           'description' => 'This gets Things.'
         },
         'Something' => {
           'type' => 'object',
           'properties' => {
-            'id' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'Identity of Something' },
-            'text' => { 'type' => 'string', 'description' => 'Content of something.' },
-            'links' => { 'type' => 'link' },
-            'others' => { 'type' => 'text' }
+            'mock_data' => {
+              'type' => 'string',
+              'description' => "it's a mock"
+            }
           },
           'description' => 'This gets Things.'
-        } } }
+        }
+      }
+    }
   end
 
   let(:http_verbs) { %w(get post put delete) }