deprecations 2.6.0 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a9290e6b74cd3d108623f9b726b6f71b02a5108feb534114fb2d63160dfbfab
-  data.tar.gz: 9a554fb7d11c6d6e9c741f43c846c1d140705be8621540683ab94b3bb2bdc0bd
+  metadata.gz: d4cdbe0575ac1d02430ffc3e88c32688824d9ba47dbaaf3bc67608174a24e319
+  data.tar.gz: 22c9ed6e63fcdd3b6eb5fa287326e87e1bd7598a033748b7869d139c6c56be35
 SHA512:
-  metadata.gz: 66817f08bf5641c9c09404615a1290ec8fe037751e8f0157b91fb7d577f2f24c1818febc6920fc36216e2386cbf40e47d275f048a12fd31a0f20cdfe5129f075
-  data.tar.gz: a57b529946baec215bdb4998151a7dc695166eb629dbbc232a6296a24b31eb60f45a84fb68d82f67632bb256293536197b11328e8901d2a25d0ef3b19219e4fe
+  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
 
@@ -93,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.6.0'
+  VERSION = '2.7.0'
 end

data/lib/deprecations.rb

@@ -13,8 +13,7 @@ module Deprecations
     def with_behavior(behavior)
       current_behavior = @behavior
       @behavior = as_behavior(behavior)
-      raise(ArgumentError, 'block expected') unless block_given?
-      yield
+      yield if block_given?
     ensure
       @behavior = current_behavior
     end
@@ -44,125 +43,131 @@ module Deprecations
       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
+  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
+  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 Warn
+    extend WarnMessage
 
-    module Deprecated
-      extend WarnMessage
-      def self.call(*args)
-        ::Kernel.warn(message(*args), uplevel: 3, category: :deprecated)
-      end
+    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
+  BEHAVIOR = {
+    silence: proc {},
+    raise: Raise,
+    warn: Warn,
+    deprecated: Deprecated
+  }.freeze
 
-    module ClassMethods
-      private
+  module ClassMethods
+    private
 
-      def deprecated(name, alt = nil, outdated = nil)
-        alias_name = "__deprecated__singleton_method__#{name}__"
-        return if private_method_defined?(alias_name)
+    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
-          alias_method(alias_name, name)
+          alt = instance_method(alt)
         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
+      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
+  module InstanceMethods
+    private
 
-      def deprecated(name, alt = nil, outdated = nil)
-        alias_name = "__deprecated__instance_method__#{name}__"
-        return if private_method_defined?(alias_name)
+    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
-          alias_method(alias_name, name)
+          alt = instance_method(alt)
         rescue NameError => e
-          ::Deprecations.__send__(:name_error, e)
-          return singleton_class.__send__(:deprecated, name, alt, outdated)
+          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
+      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
-        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
+        ::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
+    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
-
-    Module.extend(ClassMethods)
-    Module.include(InstanceMethods)
   end
 
+  Module.extend(ClassMethods)
+  Module.include(InstanceMethods)
+
+  autoload :VERSION, "#{__dir__}/deprecations/version.rb"
+
+  private_constant(*(constants - %i[Error VERSION]))
+
   self.behavior = :warn
 end

metadata

@@ -1,46 +1,48 @@
 --- !ruby/object:Gem::Specification
 name: deprecations
 version: !ruby/object:Gem::Version
-  version: 2.6.0
+  version: 2.7.0
 platform: ruby
 authors:
 - Mike Blumtritt
 bindir: bin
 cert_chain: []
-date: 2025-01-30 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.
+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/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'
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Deprecation support for your project.
 test_files: []