deprecations 2.5.0 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9973f05a62830c682760b9becfce855fa3e25d2bfdb40a0516846b5e3e27297f
-  data.tar.gz: 77b6ca73354da20235e652895d30513dc4f3ab47dd3bd73658eeb250d2cac52c
+  metadata.gz: d4cdbe0575ac1d02430ffc3e88c32688824d9ba47dbaaf3bc67608174a24e319
+  data.tar.gz: 22c9ed6e63fcdd3b6eb5fa287326e87e1bd7598a033748b7869d139c6c56be35
 SHA512:
-  metadata.gz: 190ddcd1b3f3f750d83579d369f02b12fc03f6fdd4a21a05b5d58a3d830d72b49c696bebbd8e27e431458a0224162a00bc1fa79f59851b608b5f9547b7e111ca
-  data.tar.gz: 14e17835fd8c727d3a30db5f22673918373969a4b687c494e67abe6b83e9f8e72ee0c6dcab98b63bca8e08926506e98c076e89a59acd9ae457787b42a01cd91b
+  metadata.gz: 2a7c9d6706072053a2c4fade7a96c7aa4c86c986d77cb71bbad346778b6c041fcc9a4e3cc1e57750bd081341f353e7c2069e5c16df8af81a8f5f9df682040f45
+  data.tar.gz: 1f8658e34eefb696079867af2e71534758ca0af650484d84b4249e797094d42e33587374764037b25daca616a97a2ebdbb8554e34ac3f95bcb5618d38f64d6a9

data/README.md

@@ -2,27 +2,8 @@
 
 This gem provides transparent declaration of deprecated methods and classes. It's easy, small, has no dependencies and no overhead.
 
-## Installation
-
-The simplest way to install Deprecations gem is to use [Bundler](http://gembundler.com/).
-
-Add Deprecations to your `Gemfile`:
-
-```ruby
-gem 'deprecations'
-```
-
-and install it by running Bundler:
-
-```shell
-$ bundle add deprecations
-```
-
-To install the gem globally use:
-
-```shell
-$ gem install deprecations
-```
+- Gem: [rubygems.org](https://rubygems.org/gems/deprecations)
+- Source: [codeberg.org](https://codeberg.org/mblumtritt/deprecations)
 
 ## Usage
 
@@ -70,9 +51,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:
 
@@ -92,3 +74,23 @@ Deprecations.with_behavior(:silent) { MyDeprecatedClass.new.do_some_magic }
 ```
 
 Please have a look at the [specs](https://github.com/mblumtritt/deprecations/blob/master/spec/deprecations_spec.rb) for detailed information and more samples.
+
+## Installation
+
+You can install the gem in your system with
+
+```shell
+gem install deprecations
+```
+
+or you can use [Bundler](http://gembundler.com/) to add Terminal.rb to your own project:
+
+```shell
+bundle add deprecations
+```
+
+After that you only need one line of code to have everything together
+
+```ruby
+require 'deprecations'
+```

data/deprecations.gemspec

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'lib/deprecations/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'deprecations'
+  spec.version = Deprecations::VERSION
+  spec.summary = 'Deprecation support for your project.'
+  spec.description = <<~DESCRIPTION.tr("\n", ' ')
+    This gem provides transparent declaration of deprecated methods and classes.
+    It's easy, small, has no dependencies and no overhead.
+  DESCRIPTION
+
+  spec.author = 'Mike Blumtritt'
+  spec.licenses = %w[MIT Ruby]
+  spec.homepage = 'https://codeberg.org/mblumtritt/deprecations'
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['bug_tracker_uri'] = "#{spec.homepage}/issues"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.required_ruby_version = '> 3.0'
+
+  spec.files = Dir['lib/**/*.rb']
+  spec.files += %w[deprecations.gemspec]
+  spec.extra_rdoc_files = %w[README.md]
+end

data/lib/deprecations/version.rb

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

data/lib/deprecations.rb

@@ -1,18 +1,173 @@
 # 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)
+      yield if block_given?
+    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
+  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)
+
+  autoload :VERSION, "#{__dir__}/deprecations/version.rb"
+
+  private_constant(*(constants - %i[Error VERSION]))
+
   self.behavior = :warn
 end
-
-DeprecationError = Deprecations::Error

metadata

@@ -1,52 +1,48 @@
 --- !ruby/object:Gem::Specification
 name: deprecations
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.7.0
 platform: ruby
 authors:
 - Mike Blumtritt
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-22 00:00:00.000000000 Z
+date: 1980-01-02 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:
+description: 'This gem provides transparent declaration of deprecated methods and
+  classes. It''s easy, small, has no dependencies and no overhead. '
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
 files:
 - README.md
+- deprecations.gemspec
 - lib/deprecations.rb
-- lib/deprecations/behavior.rb
-- lib/deprecations/extension.rb
 - lib/deprecations/version.rb
-homepage: https://github.com/mblumtritt/deprecations
-licenses: []
+homepage: https://codeberg.org/mblumtritt/deprecations
+licenses:
+- MIT
+- Ruby
 metadata:
-  source_code_uri: https://github.com/mblumtritt/deprecations
-  bug_tracker_uri: https://github.com/mblumtritt/deprecations/issues
+  source_code_uri: https://codeberg.org/mblumtritt/deprecations
+  bug_tracker_uri: https://codeberg.org/mblumtritt/deprecations/issues
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: '3.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.9
 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