Sha256: 419963c4364eb2b310feb2b2a2af87bfc815afd6bc408a6f47ec70c1f1a1d066

Contents?: true

Size: 1.12 KB

Versions: 25

Compression:

Stored size: 1.12 KB

Contents

# frozen_string_literal: true

class Module
  #   deprecate :foo, deprecator: MyLib.deprecator
  #   deprecate :foo, bar: "warning!", deprecator: MyLib.deprecator
  #
  # A deprecator is typically an instance of ActiveSupport::Deprecation, but you can also pass any object that responds
  # to <tt>deprecation_warning(deprecated_method_name, message, caller_backtrace)</tt> where you can implement your
  # custom warning behavior.
  #
  #   class MyLib::Deprecator
  #     def deprecation_warning(deprecated_method_name, message, caller_backtrace = nil)
  #       message = "#{deprecated_method_name} is deprecated and will be removed from MyLibrary | #{message}"
  #       Kernel.warn message
  #     end
  #   end
  def deprecate(*method_names, deprecator:, **options)
    if deprecator.is_a?(ActiveSupport::Deprecation)
      deprecator.deprecate_methods(self, *method_names, **options)
    elsif deprecator
      # we just need any instance to call deprecate_methods, but the deprecation will be emitted by deprecator
      ActiveSupport.deprecator.deprecate_methods(self, *method_names, **options, deprecator: deprecator)
    end
  end
end

Version data entries

25 entries across 25 versions & 3 rubygems

Version Path
activesupport-8.0.2 lib/active_support/core_ext/module/deprecation.rb
tailscale_middleware-0.0.3 vendor/cache/ruby/3.4.0/gems/activesupport-8.0.1/lib/active_support/core_ext/module/deprecation.rb
activesupport-8.0.1 lib/active_support/core_ext/module/deprecation.rb
activesupport-8.0.0.1 lib/active_support/core_ext/module/deprecation.rb
activesupport-7.2.2.1 lib/active_support/core_ext/module/deprecation.rb
activesupport-8.0.0 lib/active_support/core_ext/module/deprecation.rb
activesupport-7.2.2 lib/active_support/core_ext/module/deprecation.rb
activesupport-8.0.0.rc2 lib/active_support/core_ext/module/deprecation.rb
activesupport-7.2.1.2 lib/active_support/core_ext/module/deprecation.rb
activesupport-8.0.0.rc1 lib/active_support/core_ext/module/deprecation.rb
activesupport-7.2.1.1 lib/active_support/core_ext/module/deprecation.rb
activesupport-8.0.0.beta1 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha9 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha8 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha7 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha4 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha3 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha2 lib/active_support/core_ext/module/deprecation.rb
omg-activesupport-8.0.0.alpha1 lib/active_support/core_ext/module/deprecation.rb
activesupport-7.2.1 lib/active_support/core_ext/module/deprecation.rb