grape 1.8.0 → 2.0.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: grape
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Michael Bleigh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-30 00:00:00.000000000 Z
+date: 2023-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -192,6 +192,7 @@ files:
 - lib/grape/parser/xml.rb
 - lib/grape/path.rb
 - lib/grape/presenters/presenter.rb
+- lib/grape/railtie.rb
 - lib/grape/request.rb
 - lib/grape/router.rb
 - lib/grape/router/attribute_translator.rb
@@ -252,132 +253,14 @@ files:
 - lib/grape/validations/validators/same_as_validator.rb
 - lib/grape/validations/validators/values_validator.rb
 - lib/grape/version.rb
-- spec/grape/api/custom_validations_spec.rb
-- spec/grape/api/deeply_included_options_spec.rb
-- spec/grape/api/defines_boolean_in_params_spec.rb
-- spec/grape/api/documentation_spec.rb
-- spec/grape/api/inherited_helpers_spec.rb
-- spec/grape/api/instance_spec.rb
-- spec/grape/api/invalid_format_spec.rb
-- spec/grape/api/namespace_parameters_in_route_spec.rb
-- spec/grape/api/nested_helpers_spec.rb
-- spec/grape/api/optional_parameters_in_route_spec.rb
-- spec/grape/api/parameters_modification_spec.rb
-- spec/grape/api/patch_method_helpers_spec.rb
-- spec/grape/api/recognize_path_spec.rb
-- spec/grape/api/required_parameters_in_route_spec.rb
-- spec/grape/api/required_parameters_with_invalid_method_spec.rb
-- spec/grape/api/routes_with_requirements_spec.rb
-- spec/grape/api/shared_helpers_exactly_one_of_spec.rb
-- spec/grape/api/shared_helpers_spec.rb
-- spec/grape/api_remount_spec.rb
-- spec/grape/api_spec.rb
-- spec/grape/dsl/callbacks_spec.rb
-- spec/grape/dsl/desc_spec.rb
-- spec/grape/dsl/headers_spec.rb
-- spec/grape/dsl/helpers_spec.rb
-- spec/grape/dsl/inside_route_spec.rb
-- spec/grape/dsl/logger_spec.rb
-- spec/grape/dsl/middleware_spec.rb
-- spec/grape/dsl/parameters_spec.rb
-- spec/grape/dsl/request_response_spec.rb
-- spec/grape/dsl/routing_spec.rb
-- spec/grape/dsl/settings_spec.rb
-- spec/grape/dsl/validations_spec.rb
-- spec/grape/endpoint/declared_spec.rb
-- spec/grape/endpoint_spec.rb
-- spec/grape/entity_spec.rb
-- spec/grape/exceptions/base_spec.rb
-- spec/grape/exceptions/body_parse_errors_spec.rb
-- spec/grape/exceptions/invalid_accept_header_spec.rb
-- spec/grape/exceptions/invalid_formatter_spec.rb
-- spec/grape/exceptions/invalid_response_spec.rb
-- spec/grape/exceptions/invalid_versioner_option_spec.rb
-- spec/grape/exceptions/missing_group_type_spec.rb
-- spec/grape/exceptions/missing_mime_type_spec.rb
-- spec/grape/exceptions/missing_option_spec.rb
-- spec/grape/exceptions/unknown_options_spec.rb
-- spec/grape/exceptions/unknown_validator_spec.rb
-- spec/grape/exceptions/unsupported_group_type_spec.rb
-- spec/grape/exceptions/validation_errors_spec.rb
-- spec/grape/exceptions/validation_spec.rb
-- spec/grape/extensions/param_builders/hash_spec.rb
-- spec/grape/extensions/param_builders/hash_with_indifferent_access_spec.rb
-- spec/grape/extensions/param_builders/hashie/mash_spec.rb
-- spec/grape/grape_spec.rb
-- spec/grape/integration/global_namespace_function_spec.rb
-- spec/grape/integration/rack_sendfile_spec.rb
-- spec/grape/integration/rack_spec.rb
-- spec/grape/loading_spec.rb
-- spec/grape/middleware/auth/base_spec.rb
-- spec/grape/middleware/auth/dsl_spec.rb
-- spec/grape/middleware/auth/strategies_spec.rb
-- spec/grape/middleware/base_spec.rb
-- spec/grape/middleware/error_spec.rb
-- spec/grape/middleware/exception_spec.rb
-- spec/grape/middleware/formatter_spec.rb
-- spec/grape/middleware/globals_spec.rb
-- spec/grape/middleware/stack_spec.rb
-- spec/grape/middleware/versioner/accept_version_header_spec.rb
-- spec/grape/middleware/versioner/header_spec.rb
-- spec/grape/middleware/versioner/param_spec.rb
-- spec/grape/middleware/versioner/path_spec.rb
-- spec/grape/middleware/versioner_spec.rb
-- spec/grape/named_api_spec.rb
-- spec/grape/parser_spec.rb
-- spec/grape/path_spec.rb
-- spec/grape/presenters/presenter_spec.rb
-- spec/grape/request_spec.rb
-- spec/grape/util/inheritable_setting_spec.rb
-- spec/grape/util/inheritable_values_spec.rb
-- spec/grape/util/reverse_stackable_values_spec.rb
-- spec/grape/util/stackable_values_spec.rb
-- spec/grape/util/strict_hash_configuration_spec.rb
-- spec/grape/validations/attributes_doc_spec.rb
-- spec/grape/validations/instance_behaivour_spec.rb
-- spec/grape/validations/multiple_attributes_iterator_spec.rb
-- spec/grape/validations/params_scope_spec.rb
-- spec/grape/validations/single_attribute_iterator_spec.rb
-- spec/grape/validations/types/array_coercer_spec.rb
-- spec/grape/validations/types/primitive_coercer_spec.rb
-- spec/grape/validations/types/set_coercer_spec.rb
-- spec/grape/validations/types_spec.rb
-- spec/grape/validations/validators/all_or_none_spec.rb
-- spec/grape/validations/validators/allow_blank_spec.rb
-- spec/grape/validations/validators/at_least_one_of_spec.rb
-- spec/grape/validations/validators/base_spec.rb
-- spec/grape/validations/validators/coerce_spec.rb
-- spec/grape/validations/validators/default_spec.rb
-- spec/grape/validations/validators/exactly_one_of_spec.rb
-- spec/grape/validations/validators/except_values_spec.rb
-- spec/grape/validations/validators/mutual_exclusion_spec.rb
-- spec/grape/validations/validators/presence_spec.rb
-- spec/grape/validations/validators/regexp_spec.rb
-- spec/grape/validations/validators/same_as_spec.rb
-- spec/grape/validations/validators/values_spec.rb
-- spec/grape/validations/validators/zh-CN.yml
-- spec/grape/validations_spec.rb
-- spec/integration/eager_load/eager_load_spec.rb
-- spec/integration/multi_json/json_spec.rb
-- spec/integration/multi_xml/xml_spec.rb
-- spec/shared/deprecated_class_examples.rb
-- spec/shared/versioning_examples.rb
-- spec/spec_helper.rb
-- spec/support/basic_auth_encode_helpers.rb
-- spec/support/chunks.rb
-- spec/support/content_type_helpers.rb
-- spec/support/endpoint_faker.rb
-- spec/support/file_streamer.rb
-- spec/support/integer_helpers.rb
-- spec/support/versioned_helpers.rb
 homepage: https://github.com/ruby-grape/grape
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/ruby-grape/grape/issues
-  changelog_uri: https://github.com/ruby-grape/grape/blob/v1.8.0/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/grape/1.8.0
-  source_code_uri: https://github.com/ruby-grape/grape/tree/v1.8.0
+  changelog_uri: https://github.com/ruby-grape/grape/blob/v2.0.0/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/grape/2.0.0
+  source_code_uri: https://github.com/ruby-grape/grape/tree/v2.0.0
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -393,126 +276,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.4.6
 signing_key:
 specification_version: 4
 summary: A simple Ruby framework for building REST-like APIs.
-test_files:
-- spec/spec_helper.rb
-- spec/integration/eager_load/eager_load_spec.rb
-- spec/integration/multi_xml/xml_spec.rb
-- spec/integration/multi_json/json_spec.rb
-- spec/shared/versioning_examples.rb
-- spec/shared/deprecated_class_examples.rb
-- spec/support/basic_auth_encode_helpers.rb
-- spec/support/endpoint_faker.rb
-- spec/support/chunks.rb
-- spec/support/file_streamer.rb
-- spec/support/versioned_helpers.rb
-- spec/support/content_type_helpers.rb
-- spec/support/integer_helpers.rb
-- spec/grape/middleware/error_spec.rb
-- spec/grape/middleware/globals_spec.rb
-- spec/grape/middleware/formatter_spec.rb
-- spec/grape/middleware/auth/strategies_spec.rb
-- spec/grape/middleware/auth/dsl_spec.rb
-- spec/grape/middleware/auth/base_spec.rb
-- spec/grape/middleware/stack_spec.rb
-- spec/grape/middleware/exception_spec.rb
-- spec/grape/middleware/versioner_spec.rb
-- spec/grape/middleware/versioner/accept_version_header_spec.rb
-- spec/grape/middleware/versioner/header_spec.rb
-- spec/grape/middleware/versioner/path_spec.rb
-- spec/grape/middleware/versioner/param_spec.rb
-- spec/grape/middleware/base_spec.rb
-- spec/grape/loading_spec.rb
-- spec/grape/endpoint_spec.rb
-- spec/grape/api_spec.rb
-- spec/grape/util/reverse_stackable_values_spec.rb
-- spec/grape/util/stackable_values_spec.rb
-- spec/grape/util/inheritable_setting_spec.rb
-- spec/grape/util/strict_hash_configuration_spec.rb
-- spec/grape/util/inheritable_values_spec.rb
-- spec/grape/integration/rack_spec.rb
-- spec/grape/integration/rack_sendfile_spec.rb
-- spec/grape/integration/global_namespace_function_spec.rb
-- spec/grape/validations_spec.rb
-- spec/grape/entity_spec.rb
-- spec/grape/exceptions/missing_group_type_spec.rb
-- spec/grape/exceptions/unsupported_group_type_spec.rb
-- spec/grape/exceptions/validation_spec.rb
-- spec/grape/exceptions/invalid_accept_header_spec.rb
-- spec/grape/exceptions/missing_option_spec.rb
-- spec/grape/exceptions/invalid_response_spec.rb
-- spec/grape/exceptions/body_parse_errors_spec.rb
-- spec/grape/exceptions/invalid_formatter_spec.rb
-- spec/grape/exceptions/missing_mime_type_spec.rb
-- spec/grape/exceptions/unknown_options_spec.rb
-- spec/grape/exceptions/validation_errors_spec.rb
-- spec/grape/exceptions/unknown_validator_spec.rb
-- spec/grape/exceptions/invalid_versioner_option_spec.rb
-- spec/grape/exceptions/base_spec.rb
-- spec/grape/presenters/presenter_spec.rb
-- spec/grape/validations/single_attribute_iterator_spec.rb
-- spec/grape/validations/types/primitive_coercer_spec.rb
-- spec/grape/validations/types/set_coercer_spec.rb
-- spec/grape/validations/types/array_coercer_spec.rb
-- spec/grape/validations/attributes_doc_spec.rb
-- spec/grape/validations/params_scope_spec.rb
-- spec/grape/validations/instance_behaivour_spec.rb
-- spec/grape/validations/multiple_attributes_iterator_spec.rb
-- spec/grape/validations/types_spec.rb
-- spec/grape/validations/validators/regexp_spec.rb
-- spec/grape/validations/validators/mutual_exclusion_spec.rb
-- spec/grape/validations/validators/exactly_one_of_spec.rb
-- spec/grape/validations/validators/except_values_spec.rb
-- spec/grape/validations/validators/presence_spec.rb
-- spec/grape/validations/validators/all_or_none_spec.rb
-- spec/grape/validations/validators/allow_blank_spec.rb
-- spec/grape/validations/validators/same_as_spec.rb
-- spec/grape/validations/validators/default_spec.rb
-- spec/grape/validations/validators/values_spec.rb
-- spec/grape/validations/validators/at_least_one_of_spec.rb
-- spec/grape/validations/validators/coerce_spec.rb
-- spec/grape/validations/validators/zh-CN.yml
-- spec/grape/validations/validators/base_spec.rb
-- spec/grape/extensions/param_builders/hashie/mash_spec.rb
-- spec/grape/extensions/param_builders/hash_spec.rb
-- spec/grape/extensions/param_builders/hash_with_indifferent_access_spec.rb
-- spec/grape/parser_spec.rb
-- spec/grape/request_spec.rb
-- spec/grape/endpoint/declared_spec.rb
-- spec/grape/api/parameters_modification_spec.rb
-- spec/grape/api/patch_method_helpers_spec.rb
-- spec/grape/api/required_parameters_with_invalid_method_spec.rb
-- spec/grape/api/nested_helpers_spec.rb
-- spec/grape/api/defines_boolean_in_params_spec.rb
-- spec/grape/api/invalid_format_spec.rb
-- spec/grape/api/required_parameters_in_route_spec.rb
-- spec/grape/api/instance_spec.rb
-- spec/grape/api/namespace_parameters_in_route_spec.rb
-- spec/grape/api/recognize_path_spec.rb
-- spec/grape/api/shared_helpers_exactly_one_of_spec.rb
-- spec/grape/api/inherited_helpers_spec.rb
-- spec/grape/api/shared_helpers_spec.rb
-- spec/grape/api/deeply_included_options_spec.rb
-- spec/grape/api/routes_with_requirements_spec.rb
-- spec/grape/api/custom_validations_spec.rb
-- spec/grape/api/optional_parameters_in_route_spec.rb
-- spec/grape/api/documentation_spec.rb
-- spec/grape/grape_spec.rb
-- spec/grape/api_remount_spec.rb
-- spec/grape/named_api_spec.rb
-- spec/grape/dsl/request_response_spec.rb
-- spec/grape/dsl/desc_spec.rb
-- spec/grape/dsl/logger_spec.rb
-- spec/grape/dsl/validations_spec.rb
-- spec/grape/dsl/parameters_spec.rb
-- spec/grape/dsl/helpers_spec.rb
-- spec/grape/dsl/middleware_spec.rb
-- spec/grape/dsl/headers_spec.rb
-- spec/grape/dsl/callbacks_spec.rb
-- spec/grape/dsl/settings_spec.rb
-- spec/grape/dsl/routing_spec.rb
-- spec/grape/dsl/inside_route_spec.rb
-- spec/grape/path_spec.rb
+test_files: []

data/spec/grape/api/custom_validations_spec.rb

@@ -1,213 +0,0 @@
-# frozen_string_literal: true
-
-require 'shared/deprecated_class_examples'
-
-describe Grape::Validations do
-  describe 'Grape::Validations::Base' do
-    let(:deprecated_class) do
-      Class.new(Grape::Validations::Base)
-    end
-
-    it_behaves_like 'deprecated class'
-  end
-
-  describe 'using a custom length validator' do
-    subject do
-      Class.new(Grape::API) do
-        params do
-          requires :text, default_length: 140
-        end
-        get do
-          'bacon'
-        end
-      end
-    end
-
-    let(:default_length_validator) do
-      Class.new(Grape::Validations::Validators::Base) do
-        def validate_param!(attr_name, params)
-          @option = params[:max].to_i if params.key?(:max)
-          return if params[attr_name].length <= @option
-
-          raise Grape::Exceptions::Validation.new(params: [@scope.full_name(attr_name)], message: "must be at the most #{@option} characters long")
-        end
-      end
-    end
-    let(:app) { Rack::Builder.new(subject) }
-
-    before do
-      described_class.register_validator('default_length', default_length_validator)
-    end
-
-    after do
-      described_class.deregister_validator('default_length')
-    end
-
-    it 'under 140 characters' do
-      get '/', text: 'abc'
-      expect(last_response.status).to eq 200
-      expect(last_response.body).to eq 'bacon'
-    end
-
-    it 'over 140 characters' do
-      get '/', text: 'a' * 141
-      expect(last_response.status).to eq 400
-      expect(last_response.body).to eq 'text must be at the most 140 characters long'
-    end
-
-    it 'specified in the query string' do
-      get '/', text: 'a' * 141, max: 141
-      expect(last_response.status).to eq 200
-      expect(last_response.body).to eq 'bacon'
-    end
-  end
-
-  describe 'using a custom body-only validator' do
-    subject do
-      Class.new(Grape::API) do
-        params do
-          requires :text, in_body: true
-        end
-        get do
-          'bacon'
-        end
-      end
-    end
-
-    let(:in_body_validator) do
-      Class.new(Grape::Validations::Validators::PresenceValidator) do
-        def validate(request)
-          validate!(request.env['api.request.body'])
-        end
-      end
-    end
-    let(:app) { Rack::Builder.new(subject) }
-
-    before do
-      described_class.register_validator('in_body', in_body_validator)
-    end
-
-    after do
-      described_class.deregister_validator('in_body')
-    end
-
-    it 'allows field in body' do
-      get '/', text: 'abc'
-      expect(last_response.status).to eq 200
-      expect(last_response.body).to eq 'bacon'
-    end
-
-    it 'ignores field in query' do
-      get '/', nil, text: 'abc'
-      expect(last_response.status).to eq 400
-      expect(last_response.body).to eq 'text is missing'
-    end
-  end
-
-  describe 'using a custom validator with message_key' do
-    subject do
-      Class.new(Grape::API) do
-        params do
-          requires :text, with_message_key: true
-        end
-        get do
-          'bacon'
-        end
-      end
-    end
-
-    let(:message_key_validator) do
-      Class.new(Grape::Validations::Validators::PresenceValidator) do
-        def validate_param!(attr_name, _params)
-          raise Grape::Exceptions::Validation.new(params: [@scope.full_name(attr_name)], message: :presence)
-        end
-      end
-    end
-    let(:app) { Rack::Builder.new(subject) }
-
-    before do
-      described_class.register_validator('with_message_key', message_key_validator)
-    end
-
-    after do
-      described_class.deregister_validator('with_message_key')
-    end
-
-    it 'fails with message' do
-      get '/', text: 'foobar'
-      expect(last_response.status).to eq 400
-      expect(last_response.body).to eq 'text is missing'
-    end
-  end
-
-  describe 'using a custom request/param validator' do
-    subject do
-      Class.new(Grape::API) do
-        params do
-          optional :admin_field, type: String, admin: true
-          optional :non_admin_field, type: String
-          optional :admin_false_field, type: String, admin: false
-        end
-        get do
-          'bacon'
-        end
-      end
-    end
-
-    let(:admin_validator) do
-      Class.new(Grape::Validations::Validators::Base) do
-        def validate(request)
-          # return if the param we are checking was not in request
-          # @attrs is a list containing the attribute we are currently validating
-          return unless request.params.key? @attrs.first
-          # check if admin flag is set to true
-          return unless @option
-          # check if user is admin or not
-          # as an example get a token from request and check if it's admin or not
-          raise Grape::Exceptions::Validation.new(params: @attrs, message: 'Can not set Admin only field.') unless request.headers['X-Access-Token'] == 'admin'
-        end
-      end
-    end
-    let(:app) { Rack::Builder.new(subject) }
-
-    before do
-      described_class.register_validator('admin', admin_validator)
-    end
-
-    after do
-      described_class.deregister_validator('admin')
-    end
-
-    it 'fail when non-admin user sets an admin field' do
-      get '/', admin_field: 'tester', non_admin_field: 'toaster'
-      expect(last_response.status).to eq 400
-      expect(last_response.body).to include 'Can not set Admin only field.'
-    end
-
-    it 'does not fail when we send non-admin fields only' do
-      get '/', non_admin_field: 'toaster'
-      expect(last_response.status).to eq 200
-      expect(last_response.body).to eq 'bacon'
-    end
-
-    it 'does not fail when we send non-admin and admin=false fields only' do
-      get '/', non_admin_field: 'toaster', admin_false_field: 'test'
-      expect(last_response.status).to eq 200
-      expect(last_response.body).to eq 'bacon'
-    end
-
-    it 'does not fail when we send admin fields and we are admin' do
-      header 'X-Access-Token', 'admin'
-      get '/', admin_field: 'tester', non_admin_field: 'toaster', admin_false_field: 'test'
-      expect(last_response.status).to eq 200
-      expect(last_response.body).to eq 'bacon'
-    end
-
-    it 'fails when we send admin fields and we are not admin' do
-      header 'X-Access-Token', 'user'
-      get '/', admin_field: 'tester', non_admin_field: 'toaster', admin_false_field: 'test'
-      expect(last_response.status).to eq 400
-      expect(last_response.body).to include 'Can not set Admin only field.'
-    end
-  end
-end

data/spec/grape/api/deeply_included_options_spec.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-module DeeplyIncludedOptionsSpec
-  module Defaults
-    extend ActiveSupport::Concern
-    included do
-      format :json
-    end
-  end
-
-  module Admin
-    module Defaults
-      extend ActiveSupport::Concern
-      include DeeplyIncludedOptionsSpec::Defaults
-    end
-
-    class Users < Grape::API
-      include DeeplyIncludedOptionsSpec::Admin::Defaults
-
-      resource :users do
-        get do
-          status 200
-        end
-      end
-    end
-  end
-
-  class Main < Grape::API
-    mount DeeplyIncludedOptionsSpec::Admin::Users
-  end
-end
-
-describe Grape::API do
-  subject { DeeplyIncludedOptionsSpec::Main }
-
-  def app
-    subject
-  end
-
-  it 'works for unspecified format' do
-    get '/users'
-    expect(last_response.status).to be 200
-    expect(last_response.content_type).to eql 'application/json'
-  end
-
-  it 'works for specified format' do
-    get '/users.json'
-    expect(last_response.status).to be 200
-    expect(last_response.content_type).to eql 'application/json'
-  end
-
-  it "doesn't work for format different than specified" do
-    get '/users.txt'
-    expect(last_response.status).to be 404
-  end
-end

data/spec/grape/api/defines_boolean_in_params_spec.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-describe Grape::API::Instance do
-  describe 'boolean constant' do
-    module DefinesBooleanInstanceSpec
-      class API < Grape::API
-        params do
-          requires :message, type: Boolean
-        end
-        post :echo do
-          { class: params[:message].class.name, value: params[:message] }
-        end
-      end
-    end
-
-    def app
-      DefinesBooleanInstanceSpec::API
-    end
-
-    let(:expected_body) do
-      { class: 'TrueClass', value: true }.to_s
-    end
-
-    it 'sets Boolean as a type' do
-      post '/echo?message=true'
-      expect(last_response.status).to eq(201)
-      expect(last_response.body).to eq expected_body
-    end
-
-    context 'Params endpoint type' do
-      subject { DefinesBooleanInstanceSpec::API.new.router.map['POST'].first.options[:params]['message'][:type] }
-
-      it 'params type is a boolean' do
-        expect(subject).to eq 'Grape::API::Boolean'
-      end
-    end
-  end
-end

data/spec/grape/api/documentation_spec.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-
-describe Grape::API do
-  subject { Class.new(described_class) }
-
-  let(:app) { subject }
-
-  context 'an endpoint with documentation' do
-    it 'documents parameters' do
-      subject.params do
-        requires 'price', type: Float, desc: 'Sales price'
-      end
-      subject.get '/'
-
-      expect(subject.routes.first.params['price']).to eq(required: true,
-                                                         type: 'Float',
-                                                         desc: 'Sales price')
-    end
-
-    it 'allows documentation with a hash' do
-      documentation = { example: 'Joe' }
-
-      subject.params do
-        requires 'first_name', documentation: documentation
-      end
-      subject.get '/'
-
-      expect(subject.routes.first.params['first_name'][:documentation]).to eq(documentation)
-    end
-  end
-
-  context 'an endpoint without documentation' do
-    before do
-      subject.do_not_document!
-
-      subject.params do
-        requires :city, type: String, desc: 'Should be ignored'
-        optional :postal_code, type: Integer
-      end
-      subject.post '/' do
-        declared(params).to_json
-      end
-    end
-
-    it 'does not document parameters for the endpoint' do
-      expect(subject.routes.first.params).to eq({})
-    end
-
-    it 'still declares params internally' do
-      data = { city: 'Berlin', postal_code: 10_115 }
-
-      post '/', data
-
-      expect(last_response.body).to eq(data.to_json)
-    end
-  end
-end