grape-swagger 1.6.0 → 2.0.0

data/spec/support/model_parsers/representable_parser.rb

@@ -1,406 +0,0 @@
-# frozen_string_literal: true
-
-require 'representable/json'
-
-RSpec.shared_context 'representable swagger example' do
-  before :all do
-    module Entities
-      class Something < Representable::Decorator
-        include Representable::JSON
-
-        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
-
-        property :id, documentation: { type: Integer, desc: 'Identity of Something' }
-        property :text, documentation: { type: String, desc: 'Content of something.' }
-        property :links, documentation: { type: 'link', is_array: true }
-        property :others, documentation: { type: 'text', is_array: false }
-      end
-
-      class EnumValues < Representable::Decorator
-        include Representable::JSON
-
-        property :gender, documentation: { type: 'string', desc: 'Content of something.', values: %w[Male Female] }
-        property :number, documentation: { type: 'integer', desc: 'Content of something.', values: [1, 2] }
-      end
-
-      class AliasedThing < Representable::Decorator
-        include Representable::JSON
-
-        property :something, as: :post, decorator: Entities::Something, documentation: { type: 'Something', desc: 'Reference to something.' }
-      end
-
-      class FourthLevel < Representable::Decorator
-        include Representable::JSON
-
-        property :text, documentation: { type: 'string' }
-      end
-
-      class ThirdLevel < Representable::Decorator
-        include Representable::JSON
-
-        property :parts, decorator: Entities::FourthLevel, documentation: { type: 'FourthLevel' }
-      end
-
-      class SecondLevel < Representable::Decorator
-        include Representable::JSON
-
-        property :parts, decorator: Entities::ThirdLevel, documentation: { type: 'ThirdLevel' }
-      end
-
-      class FirstLevel < Representable::Decorator
-        include Representable::JSON
-
-        property :parts, decorator: Entities::SecondLevel, documentation: { type: 'SecondLevel' }
-      end
-
-      class QueryInputElement < Representable::Decorator
-        include Representable::JSON
-
-        property :key, documentation: {
-          type: String, desc: 'Name of parameter', required: true
-        }
-        property :value, documentation: {
-          type: String, desc: 'Value of parameter', required: true
-        }
-      end
-
-      class QueryInput < Representable::Decorator
-        include Representable::JSON
-
-        property :elements, decorator: Entities::QueryInputElement, documentation: {
-          type: 'QueryInputElement',
-          desc: 'Set of configuration',
-          param_type: 'body',
-          is_array: true,
-          required: true
-        }
-      end
-
-      class ApiError < Representable::Decorator
-        include Representable::JSON
-
-        property :code, documentation: { type: Integer, desc: 'status code' }
-        property :message, documentation: { type: String, desc: 'error message' }
-      end
-
-      module NestedModule
-        class ApiResponse < Representable::Decorator
-          include Representable::JSON
-
-          property :status, documentation: { type: String }
-          property :error, documentation: { type: ::Entities::ApiError }
-        end
-      end
-
-      class SecondApiError < Representable::Decorator
-        include Representable::JSON
-
-        property :code, documentation: { type: Integer }
-        property :severity, documentation: { type: String }
-        property :message, documentation: { type: String }
-      end
-
-      class ResponseItem < Representable::Decorator
-        include Representable::JSON
-
-        class << self
-          def documentation
-            {
-              id: { type: Integer },
-              name: { type: String }
-            }
-          end
-        end
-
-        property :id, documentation: { type: Integer }
-        property :name, documentation: { type: String }
-      end
-
-      class OtherItem < Representable::Decorator
-        include Representable::JSON
-
-        property :key, documentation: { type: Integer }
-        property :symbol, documentation: { type: String }
-      end
-
-      class UseResponse < Representable::Decorator
-        include Representable::JSON
-
-        class << self
-          def documentation
-            {
-              :description => { type: String },
-              '$responses' => { is_array: true }
-            }
-          end
-        end
-
-        property :description, documentation: { type: String }
-        property :items, as: '$responses', decorator: Entities::ResponseItem, documentation: { is_array: true }
-      end
-
-      class UseItemResponseAsType < Representable::Decorator
-        include Representable::JSON
-
-        property :description, documentation: { type: String }
-        property :responses, documentation: { type: Entities::ResponseItem, is_array: false }
-      end
-
-      class UseAddress < Representable::Decorator
-        include Representable::JSON
-
-        property :street, documentation: { type: String, desc: 'street' }
-        property :postcode, documentation: { type: String, desc: 'postcode' }
-        property :city, documentation: { type: String, desc: 'city' }
-        property :country, documentation: { type: String, desc: 'country' }
-      end
-
-      class UseNestedWithAddress < Representable::Decorator
-        include Representable::JSON
-
-        property :name, documentation: { type: String }
-        property :address, decorator: Entities::UseAddress
-      end
-
-      class TypedDefinition < Representable::Decorator
-        include Representable::JSON
-
-        property :prop_integer,   documentation: { type: Integer, desc: 'prop_integer description' }
-        property :prop_long,      documentation: { type: Numeric, desc: 'prop_long description' }
-        property :prop_float,     documentation: { type: Float, desc: 'prop_float description' }
-        property :prop_double,    documentation: { type: BigDecimal, desc: 'prop_double description' }
-        property :prop_string,    documentation: { type: String, desc: 'prop_string description' }
-        property :prop_symbol,    documentation: { type: Symbol, desc: 'prop_symbol description' }
-        property :prop_date,      documentation: { type: Date, desc: 'prop_date description' }
-        property :prop_date_time, documentation: { type: DateTime, desc: 'prop_date_time description' }
-        property :prop_time,      documentation: { type: Time, desc: 'prop_time description' }
-        property :prop_password,  documentation: { type: 'password', desc: 'prop_password description' }
-        property :prop_email,     documentation: { type: 'email', desc: 'prop_email description' }
-        property :prop_boolean,   documentation: { type: Grape::API::Boolean, desc: 'prop_boolean description' }
-        property :prop_file,      documentation: { type: File, desc: 'prop_file description' }
-        property :prop_json,      documentation: { type: JSON, desc: 'prop_json description' }
-      end
-
-      class RecursiveModel < Representable::Decorator
-        include Representable::JSON
-
-        property :name, documentation: { type: String, desc: 'The name.' }
-        property :children, decorator: self, documentation: { type: 'RecursiveModel', is_array: true, desc: 'The child nodes.' }
-      end
-
-      class DocumentedHashAndArrayModel < Representable::Decorator
-        include Representable::JSON
-
-        property :raw_hash, documentation: { type: Hash, desc: 'Example Hash.' }
-        property :raw_array, documentation: { type: Array, desc: 'Example Array' }
-      end
-    end
-  end
-
-  let(:swagger_definitions_models) do
-    {
-      'ApiError' => { 'type' => 'object', 'properties' => { 'code' => { 'description' => 'status code', 'type' => 'integer', 'format' => 'int32' }, 'message' => { 'description' => 'error message', 'type' => 'string' } } },
-      'ResponseItem' => { 'type' => 'object', 'properties' => { 'id' => { 'description' => '', 'type' => 'integer', 'format' => 'int32' }, 'name' => { 'description' => '', 'type' => 'string' } } },
-      'UseResponse' => { 'type' => 'object', 'properties' => { 'description' => { 'description' => '', 'type' => 'string' }, '$responses' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/ResponseItem' }, 'description' => '' } } },
-      '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' => { 'description' => 'status code', 'type' => 'integer', 'format' => 'int32' }, 'message' => { 'description' => 'error message', 'type' => 'string' } }, 'description' => 'ApiError model' },
-      'UseItemResponseAsType' => { 'type' => 'object', 'properties' => { 'description' => { 'description' => '', 'type' => 'string' }, 'responses' => { 'description' => '', 'type' => 'ResponseItem' } }, 'description' => 'UseItemResponseAsType model' }
-    }
-  end
-
-  let(:swagger_entity_as_response_object) do
-    {
-      'ApiError' => { 'type' => 'object', 'properties' => { 'code' => { 'description' => 'status code', 'type' => 'integer', 'format' => 'int32' }, 'message' => { 'description' => 'error message', 'type' => 'string' } }, 'description' => 'ApiError model' },
-      'ResponseItem' => { 'type' => 'object', 'properties' => { 'id' => { 'description' => '', 'type' => 'integer', 'format' => 'int32' }, 'name' => { 'description' => '', 'type' => 'string' } } },
-      'UseResponse' => { 'type' => 'object', 'properties' => { 'description' => { 'description' => '', 'type' => 'string' }, '$responses' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/ResponseItem' }, 'description' => '' } }, 'description' => 'UseResponse model' }
-    }
-  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' => 'ApiError model' }
-    }
-  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.',
-        'termsOfService' => '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' => {
-            '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' => {
-            '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' => {
-            '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' => {
-            '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' => {
-            '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' => {
-            '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' => {
-            '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' => {
-            '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',
-          'required' => ['elements'],
-          'properties' => { 'elements' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/QueryInputElement' }, 'description' => 'Set of configuration' } },
-          'description' => 'QueryInput model'
-        },
-        'QueryInputElement' => {
-          'type' => 'object',
-          'required' => %w[key value],
-          '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' => 'ApiError model'
-        },
-        'Something' => {
-          'type' => 'object',
-          'properties' => {
-            'id' => { 'type' => 'integer', 'format' => 'int32', 'description' => 'Identity of Something' },
-            'text' => { 'type' => 'string', 'description' => 'Content of something.' },
-            'links' => { 'type' => 'array', 'items' => { 'description' => '', 'type' => 'link' } },
-            'others' => { 'description' => '', 'type' => 'text' }
-          },
-          'description' => 'Something model'
-        }
-      }
-    }
-  end
-
-  let(:http_verbs) { %w[get post put delete] }
-end
-
-def mounted_paths
-  %w[/thing /other_thing /dummy]
-end

data/spec/support/namespace_tags.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.shared_context 'namespace example' do
-  before :all do
-    module TheApi
-      # rubocop:disable Lint/EmptyClass
-      class CustomType; end
-      # rubocop:enable Lint/EmptyClass
-
-      class NamespaceApi < Grape::API
-        namespace :hudson do
-          desc 'Document root'
-          get '/' do
-            { message: 'hi' }
-          end
-        end
-
-        namespace :colorado do
-          desc 'This gets something.',
-               notes: '_test_'
-
-          get '/simple' do
-            { bla: 'something' }
-          end
-        end
-
-        namespace :colorado do
-          desc 'This gets something for URL using - separator.',
-               notes: '_test_'
-
-          get '/simple-test' do
-            { bla: 'something' }
-          end
-        end
-
-        namespace :thames do
-          desc 'this gets something else',
-               headers: {
-                 'XAuthToken' => { description: 'A required header.', required: true },
-                 'XOtherHeader' => { description: 'An optional header.', required: false }
-               },
-               http_codes: [
-                 { code: 403, message: 'invalid pony' },
-                 { code: 405, message: 'no ponies left!' }
-               ]
-
-          get '/simple_with_headers' do
-            { bla: 'something_else' }
-          end
-        end
-
-        namespace :niles do
-          desc 'this takes an array of parameters',
-               params: {
-                 'items[]' => { description: 'array of items', is_array: true }
-               }
-
-          post '/items' do
-            {}
-          end
-        end
-
-        namespace :niles do
-          desc 'this uses a custom parameter',
-               params: {
-                 'custom' => { type: CustomType, description: 'array of items', is_array: true }
-               }
-
-          get '/custom' do
-            {}
-          end
-        end
-      end
-
-      class ParentLessNamespaceApi < Grape::API
-        route_param :animal do
-          route_param :breed do
-            resource :queues do
-              route_param :queue_id do
-                resource :reservations do
-                  desc 'Lists all reservations specific type of animal of specific breed in specific queue'
-                  get do
-                    { bla: 'Bla Black' }
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/spec/support/the_paths_definitions.rb

@@ -1,109 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.shared_context 'the api paths/defs' do
-  let(:paths) do
-    {
-      '/in_body' => {
-        post: {
-          produces: ['application/json'],
-          consumes: ['application/json'],
-          parameters: [
-            { in: 'body', name: 'in_body_1', description: 'in_body_1', type: 'integer', format: 'int32', required: true, example: 23 },
-            { in: 'body', name: 'in_body_2', description: 'in_body_2', type: 'string', required: false },
-            { in: 'body', name: 'in_body_3', description: 'in_body_3', type: 'string', required: false }
-          ],
-          responses: { 201 => { description: 'post in body /wo entity', schema: { '$ref' => '#/definitions/InBody' } } },
-          tags: ['in_body'],
-          operationId: 'postInBody'
-        },
-        get: {
-          produces: ['application/json'],
-          responses: { 200 => { description: 'get in path /wo entity', schema: { '$ref' => '#/definitions/InBody' } } },
-          tags: ['in_body'],
-          operationId: 'getInBody'
-        }
-      },
-      '/in_body/{key}' => {
-        put: {
-          produces: ['application/json'],
-          consumes: ['application/json'],
-          parameters: [
-            { in: 'path', name: 'key', description: nil, type: 'integer', format: 'int32', required: true },
-            { in: 'body', name: 'in_body_1', description: 'in_body_1', type: 'integer', format: 'int32', required: true },
-            { in: 'body', name: 'in_body_2', description: 'in_body_2', type: 'string', required: false },
-            { in: 'body', name: 'in_body_3', description: 'in_body_3', type: 'string', required: false, example: 'my example string' }
-          ],
-          responses: { 200 => { description: 'put in body /wo entity', schema: { '$ref' => '#/definitions/InBody' } } },
-          tags: ['in_body'],
-          operationId: 'putInBodyKey'
-        },
-        get: {
-          produces: ['application/json'],
-          parameters: [
-            { in: 'path', name: 'key', description: nil, type: 'integer', format: 'int32', required: true }
-          ],
-          responses: { 200 => { description: 'get in path /wo entity', schema: { '$ref' => '#/definitions/InBody' } } },
-          tags: ['in_body'],
-          operationId: 'getInBodyKey'
-        }
-      }
-    }
-  end
-
-  let(:found_path) do
-    {
-      post: {
-        produces: ['application/json'],
-        consumes: ['application/json'],
-        parameters: [
-          { in: 'body', name: 'in_body_1', description: 'in_body_1', type: 'integer', format: 'int32', required: true },
-          { in: 'body', name: 'in_body_2', description: 'in_body_2', type: 'string', required: false },
-          { in: 'body', name: 'in_body_3', description: 'in_body_3', type: 'string', required: false }
-        ],
-        responses: { 201 => { description: 'post in body /wo entity', schema: { '$ref' => '#/definitions/InBody' } } },
-        tags: ['in_body'],
-        operationId: 'postInBody'
-      }
-    }
-  end
-
-  let(:definitions) do
-    {
-      'InBody' => {
-        type: 'object',
-        properties: {
-          in_body_1: { type: 'integer', format: 'int32' },
-          in_body_2: { type: 'string' },
-          in_body_3: { type: 'string' },
-          key: { type: 'integer', format: 'int32' }
-        }
-      }
-    }
-  end
-
-  let(:expected_post_defs) do
-    {
-      type: 'object',
-      properties: {
-        in_body_1: { type: 'integer', format: 'int32', description: 'in_body_1', example: 23 },
-        in_body_2: { type: 'string', description: 'in_body_2' },
-        in_body_3: { type: 'string', description: 'in_body_3' }
-      },
-      required: [:in_body_1]
-    }
-  end
-
-  let(:expected_put_defs) do
-    {
-      type: 'object',
-      properties: {
-        in_body_1: { type: 'integer', format: 'int32', description: 'in_body_1' },
-        in_body_2: { type: 'string', description: 'in_body_2' },
-        in_body_3: { type: 'string', description: 'in_body_3', example: 'my example string' }
-      },
-      required: [:in_body_1]
-    }
-  end
-
-  let(:expected_path) { [] }
-end

data/spec/swagger_v2/api_documentation_spec.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-
-describe 'API with additional options' do
-  let(:api) do
-    Class.new(Grape::API) do
-      add_swagger_documentation \
-        api_documentation: { desc: 'Swagger compatible API description' },
-        specific_api_documentation: { desc: 'Swagger compatible API description for specific API' }
-    end
-  end
-
-  subject do
-    api.routes.map do |route|
-      route.settings[:description]
-    end
-  end
-
-  it 'documents api' do
-    expect(subject).to eq(
-      [
-        { description: 'Swagger compatible API description' },
-        { description: 'Swagger compatible API description for specific API', params: {} }
-      ]
-    )
-  end
-end