deprecations 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9973f05a62830c682760b9becfce855fa3e25d2bfdb40a0516846b5e3e27297f
-  data.tar.gz: 77b6ca73354da20235e652895d30513dc4f3ab47dd3bd73658eeb250d2cac52c
+  metadata.gz: 8a9290e6b74cd3d108623f9b726b6f71b02a5108feb534114fb2d63160dfbfab
+  data.tar.gz: 9a554fb7d11c6d6e9c741f43c846c1d140705be8621540683ab94b3bb2bdc0bd
 SHA512:
-  metadata.gz: 190ddcd1b3f3f750d83579d369f02b12fc03f6fdd4a21a05b5d58a3d830d72b49c696bebbd8e27e431458a0224162a00bc1fa79f59851b608b5f9547b7e111ca
-  data.tar.gz: 14e17835fd8c727d3a30db5f22673918373969a4b687c494e67abe6b83e9f8e72ee0c6dcab98b63bca8e08926506e98c076e89a59acd9ae457787b42a01cd91b
+  metadata.gz: 66817f08bf5641c9c09404615a1290ec8fe037751e8f0157b91fb7d577f2f24c1818febc6920fc36216e2386cbf40e47d275f048a12fd31a0f20cdfe5129f075
+  data.tar.gz: a57b529946baec215bdb4998151a7dc695166eb629dbbc232a6296a24b31eb60f45a84fb68d82f67632bb256293536197b11328e8901d2a25d0ef3b19219e4fe

data/README.md

@@ -70,9 +70,10 @@ Deprecations.behavior = :raise
 
 There are 3 pre-defined behaviors:
 
-- `:raise` will raise an `DeprecationException` when a deprecated method is called
+- `:raise` will raise an `Deprecations::Exception` when a deprecated method is called
 - `:silence` will do nothing (ignore the deprecation)
 - `:warn` will print a warning (default behavior)
+- `:deprecated` will print a warning when Ruby's warning category 'deprecated' is enabled
 
 Besides this you can implement your own:
 

data/lib/deprecations/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Deprecations
-  VERSION = '2.5.0'
+  VERSION = '2.6.0'
 end

data/lib/deprecations.rb

@@ -1,18 +1,168 @@
 # frozen_string_literal: true
 
 module Deprecations
-  require_relative 'deprecations/behavior'
-  require_relative 'deprecations/extension'
-  require_relative 'deprecations/version'
-
   Error = Class.new(ScriptError)
 
-  def self.call(subject, alternative, outdated)
-    @behavior.call(subject, alternative, outdated)
-    self
+  class << self
+    def behavior = BEHAVIOR.key(@behavior) || @behavior
+
+    def behavior=(value)
+      @behavior = as_behavior(value)
+    end
+
+    def with_behavior(behavior)
+      current_behavior = @behavior
+      @behavior = as_behavior(behavior)
+      raise(ArgumentError, 'block expected') unless block_given?
+      yield
+    ensure
+      @behavior = current_behavior
+    end
+
+    alias set_behavior with_behavior
+
+    def call(subject, alternative, outdated)
+      @behavior.call(subject, alternative, outdated)
+      self
+    end
+
+    private
+
+    def as_behavior(arg)
+      return arg if defined?(arg.call)
+      BEHAVIOR.fetch(arg) do
+        raise(
+          ArgumentError,
+          "invalid parameter - behavior has to be #{
+            BEHAVIOR.keys.map(&:inspect).join(' | ')
+          } or need to respond to `#call`"
+        )
+      end
+    end
+
+    def name_error(exc)
+      exc.set_backtrace(exc.backtrace.drop_while { _1.start_with?(__FILE__) })
+      exc
+    end
+
+    module Raise
+      def self.call(subject, alternative, _outdated)
+        error =
+          Error.new(
+            "`#{subject}` is deprecated#{
+              " - use #{alternative} instead" if alternative
+            }"
+          )
+        error.set_backtrace(caller(3))
+        raise(error)
+      end
+    end
+
+    module WarnMessage
+      def message(subject, alternative, outdated)
+        "`#{subject}` is deprecated#{
+          outdated ? " and will be outdated #{outdated}." : '.'
+        }#{" Please use `#{alternative}` instead." if alternative}"
+      end
+    end
+
+    module Warn
+      extend WarnMessage
+      def self.call(*args) = ::Kernel.warn(message(*args), uplevel: 3)
+    end
+
+    module Deprecated
+      extend WarnMessage
+      def self.call(*args)
+        ::Kernel.warn(message(*args), uplevel: 3, category: :deprecated)
+      end
+    end
+
+    BEHAVIOR = {
+      silence: proc {},
+      raise: Raise,
+      warn: Warn,
+      deprecated: Deprecated
+    }.freeze
+
+    module ClassMethods
+      private
+
+      def deprecated(name, alt = nil, outdated = nil)
+        alias_name = "__deprecated__singleton_method__#{name}__"
+        return if private_method_defined?(alias_name)
+        begin
+          alias_method(alias_name, name)
+        rescue NameError => e
+          raise ::Deprecations.__send__(:name_error, e)
+        end
+        private(alias_name)
+        if alt.is_a?(Symbol)
+          begin
+            alt = instance_method(alt)
+          rescue NameError => e
+            raise ::Deprecations.__send__(:name_error, e)
+          end
+        end
+        define_method(name) do |*args, **kw_args, &b|
+          ::Deprecations.call(
+            "#{self}.#{::Kernel.__method__}",
+            (alt.is_a?(UnboundMethod) ? "#{self}.#{alt.name}" : alt),
+            outdated
+          )
+          __send__(alias_name, *args, **kw_args, &b)
+        end
+      end
+    end
+
+    module InstanceMethods
+      private
+
+      def deprecated(name, alt = nil, outdated = nil)
+        alias_name = "__deprecated__instance_method__#{name}__"
+        return if private_method_defined?(alias_name)
+        begin
+          alias_method(alias_name, name)
+        rescue NameError => e
+          ::Deprecations.__send__(:name_error, e)
+          return singleton_class.__send__(:deprecated, name, alt, outdated)
+        end
+        private(alias_name)
+        if alt.is_a?(Symbol)
+          begin
+            alt = instance_method(alt)
+          rescue NameError => e
+            raise ::Deprecations.__send__(:name_error, e)
+          end
+        end
+        define_method(name) do |*args, **kw_args, &b|
+          pref =
+            if defined?(self.class.name)
+              self.class.name
+            else
+              ::Kernel.instance_method(:class).bind(self).call
+            end
+          ::Deprecations.call(
+            "#{pref}##{::Kernel.__method__}",
+            (alt.is_a?(UnboundMethod) ? "#{pref}##{alt.name}" : alt),
+            outdated
+          )
+          __send__(alias_name, *args, **kw_args, &b)
+        end
+      end
+
+      def deprecated!(alternative = nil, outdated = nil)
+        org = method(:new)
+        define_singleton_method(:new) do |*args, **kw_args, &b|
+          ::Deprecations.call(name, alternative, outdated)
+          org.call(*args, **kw_args, &b)
+        end
+      end
+    end
+
+    Module.extend(ClassMethods)
+    Module.include(InstanceMethods)
   end
 
   self.behavior = :warn
 end
-
-DeprecationError = Deprecations::Error

metadata

@@ -1,19 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: deprecations
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Mike Blumtritt
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-22 00:00:00.000000000 Z
+date: 2025-01-30 00:00:00.000000000 Z
 dependencies: []
 description: |
   This gem provides transparent declaration of deprecated methods and classes.
   It's easy, small, has no dependencies and no overhead.
-email:
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -21,8 +19,6 @@ extra_rdoc_files:
 files:
 - README.md
 - lib/deprecations.rb
-- lib/deprecations/behavior.rb
-- lib/deprecations/extension.rb
 - lib/deprecations/version.rb
 homepage: https://github.com/mblumtritt/deprecations
 licenses: []
@@ -30,7 +26,6 @@ metadata:
   source_code_uri: https://github.com/mblumtritt/deprecations
   bug_tracker_uri: https://github.com/mblumtritt/deprecations/issues
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -38,15 +33,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.1
-signing_key:
+rubygems_version: 3.6.3
 specification_version: 4
 summary: Deprecation support for your project.
 test_files: []

data/lib/deprecations/behavior.rb

@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-module Deprecations
-  class << self
-    def behavior
-      BEHAVIOR.key(@behavior) || @behavior
-    end
-
-    def behavior=(value)
-      @behavior = as_behavior(value)
-    end
-
-    def with_behavior(behavior)
-      behavior = as_behavior(behavior)
-      raise(ArgumentError, 'block expected') unless block_given?
-      current_behavior = @behavior
-      @behavior = behavior
-      yield
-    ensure
-      @behavior = current_behavior if current_behavior
-    end
-
-    alias set_behavior with_behavior
-
-    private
-
-    def as_behavior(arg)
-      return arg if defined?(arg.call)
-      BEHAVIOR.fetch(arg) do
-        raise(
-          ArgumentError,
-          'invalid parameter - behavior has to be ' \
-            "#{valid_behaviors} or need to respond to `#call`"
-        )
-      end
-    end
-
-    def valid_behaviors
-      BEHAVIOR.keys.map(&:inspect).join(' | ')
-    end
-
-    module Raise
-      def self.call(subject, alternative, _outdated)
-        raise(
-          Error
-            .new(
-              "`#{subject}` is deprecated#{
-                " - use #{alternative} instead" if alternative
-              }"
-            )
-            .tap { |error| error.set_backtrace(caller(3)) }
-        )
-      end
-    end
-
-    module Warn
-      def self.call(subject, alternative, outdated)
-        ::Kernel.warn(
-          "`#{subject}` is deprecated#{
-            outdated ? " and will be outdated #{outdated}." : '.'
-          }#{" Please use `#{alternative}` instead." if alternative}",
-          uplevel: 3
-        )
-      end
-    end
-
-    BEHAVIOR = { silence: proc {}, raise: Raise, warn: Warn }.freeze
-  end
-end

data/lib/deprecations/extension.rb

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-module Deprecations
-  private_class_method def self.infect(mod)
-    mod.extend(ClassMethods)
-    mod.__send__(:include, InstanceMethods)
-  end
-
-  module ClassMethods
-    private
-
-    def deprecated(method_name, alternative = nil, outdated = nil)
-      alias_name = "__deprecated__singleton_method__#{method_name}__"
-      return if private_method_defined?(alias_name)
-      alias_method(alias_name, method_name)
-      private(alias_name)
-      alternative = instance_method(alternative) if alternative.is_a?(Symbol)
-      define_method(method_name) do |*args, **kw_args, &b|
-        Deprecations.call(
-          "#{self}.#{::Kernel.__method__}",
-          if alternative.is_a?(UnboundMethod)
-            "#{self}.#{alternative.name}"
-          else
-            alternative
-          end,
-          outdated
-        )
-        __send__(alias_name, *args, **kw_args, &b)
-      end
-    end
-  end
-
-  module InstanceMethods
-    private
-
-    def deprecated(method_name, alternative = nil, outdated = nil)
-      alias_name = "__deprecated__instance_method__#{method_name}__"
-      return if private_method_defined?(alias_name)
-      alias_method(alias_name, method_name)
-      private(alias_name)
-      alternative = instance_method(alternative) if alternative.is_a?(Symbol)
-      define_method(method_name) do |*args, **kw_args, &b|
-        pref =
-          if defined?(self.class.name)
-            self.class.name
-          else
-            Kernel.instance_method(:class).bind(self).call
-          end
-        Deprecations.call(
-          "#{pref}##{::Kernel.__method__}",
-          if alternative.is_a?(UnboundMethod)
-            "#{pref}##{alternative.name}"
-          else
-            alternative
-          end,
-          outdated
-        )
-        __send__(alias_name, *args, **kw_args, &b)
-      end
-    rescue NameError
-      raise if private_method_defined?(alias_name)
-      singleton_class.__send__(:deprecated, method_name, alternative, outdated)
-    end
-
-    def deprecated!(alternative = nil, outdated = nil)
-      org = method(:new)
-      define_singleton_method(:new) do |*args, **kw_args, &b|
-        Deprecations.call(name, alternative, outdated)
-        org.call(*args, **kw_args, &b)
-      end
-    rescue NameError
-      nil
-    end
-  end
-
-  infect(Module)
-end