Add Grape.deprecator since using ActiveSupport::Deprecation is deprec…

…ated

https://edgeguides.rubyonrails.org/7_1_release_notes.html#active-support-deprecations

Add railtie for Rails 7.1 app to include Grape.deprecator

.github/workflows/test.yml

@@ -24,7 +24,7 @@ jobs:
       fail-fast: false
       matrix:
         ruby: ['2.7', '3.0', '3.1', '3.2']
-        gemfile: [rack_2_0, rack_3_0, rails_6_0, rails_6_1, rails_7_0]
+        gemfile: [rack_2_0, rack_3_0, rails_6_0, rails_6_1, rails_7_0, rails_7_1]
         include:
           - ruby: '2.6'
             gemfile: rails_5_2
@@ -78,4 +78,4 @@ jobs:
       uses: coverallsapp/github-action@master
       with:
         github-token: ${{ secrets.github_token }}
-        parallel-finished: true
+        parallel-finished: true

gemfiles/rails_7_1.gemfile

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# This file was generated by Appraisal
+
+source 'https://rubygems.org'
+
+gem 'rails', '~> 7.1.0'
+
+group :development, :test do
+  gem 'bundler'
+  gem 'hashie'
+  gem 'rake'
+  gem 'rubocop', '1.50.2', require: false
+  gem 'rubocop-performance', '1.17.1', require: false
+  gem 'rubocop-rspec', '2.20.0', require: false
+end
+
+group :development do
+  gem 'appraisal'
+  gem 'benchmark-ips'
+  gem 'benchmark-memory'
+  gem 'guard'
+  gem 'guard-rspec'
+  gem 'guard-rubocop'
+end
+
+group :test do
+  gem 'cookiejar'
+  gem 'grape-entity', '~> 0.6'
+  gem 'mime-types'
+  gem 'rack-jsonp', require: 'rack/jsonp'
+  gem 'rack-test', '< 2.1'
+  gem 'rspec', '< 4'
+  gem 'ruby-grape-danger', '~> 0.2.0', require: false
+  gem 'simplecov', '~> 0.21.2'
+  gem 'simplecov-lcov', '~> 0.8.0'
+  gem 'test-prof', require: false
+end
+
+platforms :jruby do
+  gem 'racc'
+end
+
+gemspec path: '../'

lib/grape.rb

@@ -38,6 +38,10 @@ module Grape
   include ActiveSupport::Configurable
   extend ::ActiveSupport::Autoload
 
+  def self.deprecator
+    @deprecator ||= ActiveSupport::Deprecation.new('2.0', 'Grape')
+  end
+
   eager_autoload do
     autoload :API
     autoload :Endpoint
@@ -301,5 +305,8 @@ module Types
 require 'grape/util/lazy_value'
 require 'grape/util/lazy_block'
 require 'grape/util/endpoint_configuration'
-
 require 'grape/version'
+
+# https://api.rubyonrails.org/classes/ActiveSupport/Deprecation.html
+# adding Grape.deprecator to Rails App if any
+require 'grape/railtie' if defined?(Rails::Railtie) && ActiveSupport::VERSION::MAJOR == 7 && ActiveSupport::VERSION::MINOR.positive?

lib/grape/dsl/desc.rb

@@ -68,7 +68,7 @@ def desc(description, options = {}, &config_block)
           end
 
           config_class.configure(&config_block)
-          ActiveSupport::Deprecation.warn('Passing a options hash and a block to `desc` is deprecated. Move all hash options to block.') if options.any?
+          Grape.deprecator.warn('Passing a options hash and a block to `desc` is deprecated. Move all hash options to block.') if options.any?
           options = config_class.settings
         else
           options = options.merge(description: description)

lib/grape/dsl/inside_route.rb

@@ -280,13 +280,13 @@ def return_no_content
       # Deprecated method to send files to the client. Use `sendfile` or `stream`
       def file(value = nil)
         if value.is_a?(String)
-          ActiveSupport::Deprecation.warn('Use sendfile or stream to send files.')
+          Grape.deprecator.warn('Use sendfile or stream to send files.')
           sendfile(value)
         elsif !value.is_a?(NilClass)
-          ActiveSupport::Deprecation.warn('Use stream to use a Stream object.')
+          Grape.deprecator.warn('Use stream to use a Stream object.')
           stream(value)
         else
-          ActiveSupport::Deprecation.warn('Use sendfile or stream to send files.')
+          Grape.deprecator.warn('Use sendfile or stream to send files.')
           sendfile
         end
       end

lib/grape/exceptions/missing_group_type.rb

@@ -10,4 +10,4 @@ def initialize
   end
 end
 
-Grape::Exceptions::MissingGroupTypeError = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('Grape::Exceptions::MissingGroupTypeError', 'Grape::Exceptions::MissingGroupType')
+Grape::Exceptions::MissingGroupTypeError = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('Grape::Exceptions::MissingGroupTypeError', 'Grape::Exceptions::MissingGroupType', Grape.deprecator)

lib/grape/exceptions/unsupported_group_type.rb

@@ -10,4 +10,4 @@ def initialize
   end
 end
 
-Grape::Exceptions::UnsupportedGroupTypeError = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('Grape::Exceptions::UnsupportedGroupTypeError', 'Grape::Exceptions::UnsupportedGroupType')
+Grape::Exceptions::UnsupportedGroupTypeError = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('Grape::Exceptions::UnsupportedGroupTypeError', 'Grape::Exceptions::UnsupportedGroupType', Grape.deprecator)

lib/grape/railtie.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Grape
+  class Railtie < ::Rails::Railtie
+    initializer 'grape.deprecator' do |app|
+      app.deprecators[:grape] = Grape.deprecator
+    end
+  end
+end

lib/grape/router/route.rb

@@ -84,7 +84,7 @@ def warn_route_methods(name, location, expected = nil)
         path, line = *location.scan(SOURCE_LOCATION_REGEXP).first
         path = File.realpath(path) if Pathname.new(path).relative?
         expected ||= name
-        ActiveSupport::Deprecation.warn("#{path}:#{line}: The route_xxx methods such as route_#{name} have been deprecated, please use #{expected}.")
+        Grape.deprecator.warn("#{path}:#{line}: The route_xxx methods such as route_#{name} have been deprecated, please use #{expected}.")
       end
     end
   end

lib/grape/validations/validators/base.rb

@@ -85,7 +85,7 @@ def fail_fast?
 
 Grape::Validations::Base = Class.new(Grape::Validations::Validators::Base) do
   def self.inherited(*)
-    ActiveSupport::Deprecation.warn 'Grape::Validations::Base is deprecated! Use Grape::Validations::Validators::Base instead.'
+    Grape.deprecator.warn 'Grape::Validations::Base is deprecated! Use Grape::Validations::Validators::Base instead.'
     super
   end
 end

lib/grape/validations/validators/values_validator.rb

@@ -10,11 +10,11 @@ def initialize(attrs, options, required, scope, **opts)
             @values = options[:value]
             @proc = options[:proc]
 
-            ActiveSupport::Deprecation.warn('The values validator except option is deprecated. Use the except validator instead.') if @excepts
+            Grape.deprecator.warn('The values validator except option is deprecated. Use the except validator instead.') if @excepts
 
             raise ArgumentError, 'proc must be a Proc' if @proc && !@proc.is_a?(Proc)
 
-            ActiveSupport::Deprecation.warn('The values validator proc option is deprecated. The lambda expression can now be assigned directly to values.') if @proc
+            Grape.deprecator.warn('The values validator proc option is deprecated. The lambda expression can now be assigned directly to values.') if @proc
           else
             @excepts = nil
             @values = nil

spec/grape/dsl/desc_spec.rb

@@ -83,7 +83,7 @@
     end
 
     it 'can be set with options and a block' do
-      expect(ActiveSupport::Deprecation).to receive(:warn).with('Passing a options hash and a block to `desc` is deprecated. Move all hash options to block.')
+      expect(Grape.deprecator).to receive(:warn).with('Passing a options hash and a block to `desc` is deprecated. Move all hash options to block.')
 
       desc_text = 'The description'
       detail_text = 'more details'

spec/grape/dsl/inside_route_spec.rb

@@ -208,7 +208,7 @@ def initialize
         let(:file_path) { '/some/file/path' }
 
         it 'emits a warning that this method is deprecated' do
-          expect(ActiveSupport::Deprecation).to receive(:warn).with(/Use sendfile or stream/)
+          expect(Grape.deprecator).to receive(:warn).with(/Use sendfile or stream/)
 
           subject.file file_path
         end
@@ -224,7 +224,7 @@ def initialize
         let(:file_object) { double('StreamerObject', each: nil) }
 
         it 'emits a warning that this method is deprecated' do
-          expect(ActiveSupport::Deprecation).to receive(:warn).with(/Use stream to use a Stream object/)
+          expect(Grape.deprecator).to receive(:warn).with(/Use stream to use a Stream object/)
 
           subject.file file_object
         end
@@ -239,7 +239,7 @@ def initialize
 
     describe 'get' do
       it 'emits a warning that this method is deprecated' do
-        expect(ActiveSupport::Deprecation).to receive(:warn).with(/Use sendfile or stream/)
+        expect(Grape.deprecator).to receive(:warn).with(/Use sendfile or stream/)
 
         subject.file
       end
@@ -269,7 +269,7 @@ def initialize
         end
 
         it 'sends no deprecation warnings' do
-          expect(ActiveSupport::Deprecation).not_to receive(:warn)
+          expect(Grape.deprecator).not_to receive(:warn)
 
           subject.sendfile file_path
         end
@@ -330,7 +330,7 @@ def initialize
         end
 
         it 'emits no deprecation warnings' do
-          expect(ActiveSupport::Deprecation).not_to receive(:warn)
+          expect(Grape.deprecator).not_to receive(:warn)
 
           subject.stream file_path
         end
@@ -380,7 +380,7 @@ def initialize
         end
 
         it 'emits no deprecation warnings' do
-          expect(ActiveSupport::Deprecation).not_to receive(:warn)
+          expect(Grape.deprecator).not_to receive(:warn)
 
           subject.stream stream_object
         end

spec/shared/deprecated_class_examples.rb

@@ -4,10 +4,10 @@
   subject { deprecated_class.new }
 
   around do |example|
-    old_deprec_behavior = ActiveSupport::Deprecation.behavior
-    ActiveSupport::Deprecation.behavior = :raise
+    old_deprec_behavior = Grape.deprecator.behavior
+    Grape.deprecator.behavior = :raise
     example.run
-    ActiveSupport::Deprecation.behavior = old_deprec_behavior
+    Grape.deprecator.behavior = old_deprec_behavior
   end
 
   it 'raises an ActiveSupport::DeprecationException' do