deprecations 2.2.0 → 2.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c5899644bd44226740f7c81c5b404d0bc942bbf256ecc47f540295bebab351a
-  data.tar.gz: d5bfacd79de9a17bf16d8c6c95c29b0e1cc538bc975b188d73a515a0726aaf92
+  metadata.gz: 976d65184fd1442180e364ecd885aabf9202877f1bb7d11c1315eed9fe30b5ee
+  data.tar.gz: bf4ad1bc538b49878a6268321883d1d89a3cc3fe0627ef8c2d37200972c22ad2
 SHA512:
-  metadata.gz: 0af667f71e7e2c2484114c00301cb44e1007ef7eae467fe3cdf6f00fa5011441078b29732a3f6a83a51a32af6409ba8ae772df1bb2b6bc1744768eed125d24da
-  data.tar.gz: 0d2f21c5421992fd44110ae87fda1325eb16c946c692308fd3a51c5bbe86db86789905fbd4d71d325b152cbe1c9116ea796c04a08db100a2f6adff5ea1d47d4a
+  metadata.gz: 29383bc82baad099e0597f6efb0c4a0e2d4bb7f87e2235c19e1ebd58e0611c287aa7b1f478c1e75fc942f43bd2078cfb09f80f90df72ab4d184012e2dee8a51d
+  data.tar.gz: 0636b27fc0c83e46df73364b669b6c59f0c2e844e424807a990ee45d8bf1957b93db289d744d63013b099317f8f23618aa92b979c468a200712608956bd220a7

data/lib/deprecations/behavior.rb

@@ -1,11 +1,13 @@
+# frozen_string_literal: true
+
 module Deprecations
   class << self
     def behavior
       BEHAVIOR.key(@behavior) || @behavior
     end
 
-    def behavior=(behavior)
-      @behavior = as_behavior(behavior)
+    def behavior=(value)
+      @behavior = as_behavior(value)
     end
 
     def with_behavior(behavior)
@@ -58,6 +60,6 @@ module Deprecations
       end
     end
 
-    BEHAVIOR = {silence: proc {}, raise: Raise, warn: Warn}.freeze
+    BEHAVIOR = { silence: proc {}, raise: Raise, warn: Warn }.freeze
   end
 end

data/lib/deprecations/extension.rb

@@ -13,7 +13,11 @@ module Deprecations
       private
 
       def __method(method_name)
-        instance_method(method_name) rescue nil
+        begin
+          instance_method(method_name)
+        rescue StandardError
+          nil
+        end
       end
 
       def __method_deprecated!(method, alternative, outdated)
@@ -21,16 +25,23 @@ module Deprecations
         undef_method(method.name)
         define_method(method.name) do |*a, &b|
           decorated = Class === self ? "#{self}." : "#{defining_context}#"
-          alternative = "#{decorated}#{alternative.name}" if UnboundMethod === alternative
-          Deprecations.call("#{decorated}#{::Kernel.__method__}", alternative, outdated)
+          alternative = "#{decorated}#{alternative.name}" if UnboundMethod ===
+            alternative
+          Deprecations.call(
+            "#{decorated}#{::Kernel.__method__}",
+            alternative,
+            outdated
+          )
           method.bind(self).call(*a, &b)
         end
       end
 
       def __method_checked(method_name)
-        __method(method_name) or raise(
-          NameError, "undefined method `#{method_name}` for class `#{self}`"
-        )
+        __method(method_name) or
+          raise(
+            NameError,
+            "undefined method `#{method_name}` for class `#{self}`"
+          )
       end
 
       def __method_alternative(alternative)
@@ -58,9 +69,15 @@ module Deprecations
       include Helper
 
       def deprecated(method_name, alternative = nil, outdated = nil)
-        m = __method(method_name) or return singleton_class.send(
-          :deprecated, method_name, alternative, outdated
-        )
+        m = __method(method_name) or
+          return(
+            singleton_class.send(
+              :deprecated,
+              method_name,
+              alternative,
+              outdated
+            )
+          )
         __method_deprecated!(m, __method_alternative(alternative), outdated)
       end
 

data/lib/deprecations/version.rb

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

data/lib/deprecations.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Deprecations
   require_relative 'deprecations/version'
   require_relative 'deprecations/extension'

metadata

@@ -1,84 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: deprecations
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.2
 platform: ruby
 authors:
 - Mike Blumtritt
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-10-19 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.10'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.10'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 10.1.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 10.1.1
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.0
+date: 2022-07-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: mike.blumtritt@invision.de
+email:
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
 files:
-- ".gitignore"
 - README.md
-- deprecations.gemspec
-- gems.rb
 - lib/deprecations.rb
 - lib/deprecations/behavior.rb
 - lib/deprecations/extension.rb
 - lib/deprecations/version.rb
-- rakefile.rb
-- spec/deprecations/behavior_spec.rb
-- spec/deprecations/version_spec.rb
-- spec/deprecations_spec.rb
-- spec/spec_helper.rb
 homepage: https://github.com/mblumtritt/deprecations
 licenses: []
 metadata:
-  issue_tracker: https://github.com/mblumtritt/deprecations/issues
-post_install_message: 
+  source_code_uri: https://github.com/mblumtritt/deprecations
+  bug_tracker_uri: https://github.com/mblumtritt/deprecations/issues
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -91,15 +42,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.10.0
+      version: '0'
 requirements: []
-rubyforge_project: deprecations
-rubygems_version: 2.7.7
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Deprecation support for your project.
-test_files:
-- spec/deprecations/behavior_spec.rb
-- spec/deprecations/version_spec.rb
-- spec/deprecations_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/.gitignore

@@ -1,5 +0,0 @@
-tmp/
-local/
-diea/
-pkg/
-gems.locked

data/deprecations.gemspec

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require_relative './lib/deprecations/version'
-
-Gem::Specification.new do |spec|
-  spec.name = spec.rubyforge_project = 'deprecations'
-  spec.version = Deprecations::VERSION
-  spec.summary = 'Deprecation support for your project.'
-  spec.description = <<~DESCRIPTION
-    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.email = 'mike.blumtritt@invision.de'
-  spec.homepage = 'https://github.com/mblumtritt/deprecations'
-  spec.metadata = {'issue_tracker' => 'https://github.com/mblumtritt/deprecations/issues'}
-
-  spec.add_development_dependency 'bundler', '>= 1.10'
-  spec.add_development_dependency 'rake', '>= 10.1.1'
-  spec.add_development_dependency 'rspec', '>= 3.0.0'
-
-  spec.platform = Gem::Platform::RUBY
-  spec.required_ruby_version = '>= 2.0.0'
-  spec.required_rubygems_version = Gem::Requirement.new('>= 1.10.0')
-
-  spec.require_paths = %w[lib]
-
-  all_files = %x(git ls-files -z).split(0.chr)
-  spec.test_files = all_files.grep(%r{^(spec|test)/})
-  spec.files = all_files - spec.test_files
-
-  spec.extra_rdoc_files = %w[README.md]
-end

data/gems.rb

@@ -1 +0,0 @@
-source('https://rubygems.org'){ gemspec }

data/rakefile.rb

@@ -1,12 +0,0 @@
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new(:test) do |t|
-  t.pattern = ['spec/*_spec.rb', 'spec/**/*/*_spec.rb']
-  t.rspec_opts = '-w'
-  t.verbose = Rake.application.options.trace
-end
-
-task :default do
-  exec "#{$0} --task"
-end

data/spec/deprecations/behavior_spec.rb

@@ -1,97 +0,0 @@
-require 'spec_helper'
-
-RSpec.describe Deprecations do
-  context 'behavior' do
-
-    it 'is possible to configure the behavior with a pre-defined value' do
-      %i(silence raise warn).each do |behavior|
-        Deprecations.behavior = behavior
-        expect(Deprecations.behavior).to be(behavior)
-      end
-    end
-
-    it 'is possible to configure a custom behavior' do
-      custom = proc do |*args|
-        FantasticLogger.log(*args)
-      end
-      Deprecations.behavior = custom
-      expect(Deprecations.behavior).to be(custom)
-    end
-
-    context 'standard behavior :silence' do
-      before do
-        Deprecations.behavior = :silence
-      end
-
-      it 'does simply nothing' do
-        expect(subject.call(*%w(should be silent))).to be(subject)
-      end
-    end
-
-    context 'standard behavior :warn' do
-      before do
-        Deprecations.behavior = :warn
-      end
-      after do
-        Deprecations.call('Bad#method', 'Bad#alternative', 'after next version')
-      end
-
-      it 'warns about the deprecation' do
-        expect(Kernel).to receive(:warn).once.with(/.*/, uplevel: 3)
-      end
-
-      it 'points to the deprecated method' do
-        expect(Kernel).to receive(:warn).once.with(/Bad#method.*deprecated/, uplevel: 3)
-      end
-
-      it 'suggests the alternative method' do
-        expect(Kernel).to receive(:warn).once.with(/Bad#alternative.*instead/, uplevel: 3)
-      end
-
-      it 'contains information about when it will not longer supported' do
-        expect(Kernel).to receive(:warn).once.with(/outdated after next version/, uplevel: 3)
-      end
-    end
-
-    context 'standard behavior :raise' do
-      before do
-        Deprecations.behavior = :raise
-      end
-      subject{ Deprecations.call('Bad#method', 'Bad#alternative', 'after next version') }
-
-      it 'raises a Deprecations::Error' do
-        expect{ subject }.to raise_error(Deprecations::Error)
-      end
-
-      it 'points to the deprecated method' do
-        expect{ subject }.to raise_error(Deprecations::Error, /Bad#method.*deprecated/)
-      end
-
-      it 'suggests the alternative method' do
-        expect{ subject }.to raise_error(Deprecations::Error, /Bad#alternative.*instead/)
-      end
-    end
-
-    context 'change behavior temporary' do
-      let(:sample_class) do
-        Class.new(BasicObject) do
-          deprecated!
-        end
-      end
-
-      before do
-        Deprecations.behavior = :raise
-      end
-
-      after do
-        Deprecations.with_behavior(:warn) do
-          sample_class.new.__id__
-        end
-      end
-
-      it 'is possible to temporary use a different behavior' do
-        expect(Kernel).to receive(:warn).once
-      end
-    end
-  end
-end

data/spec/deprecations/version_spec.rb

@@ -1,7 +0,0 @@
-require 'spec_helper'
-
-RSpec.describe 'Deprecations::VERSION' do
-  it 'has format <major>.<minor>.<build>' do
-    expect(Deprecations::VERSION).to match(/^\d{1,2}\.\d{1,2}\.\d{1,3}/)
-  end
-end

data/spec/deprecations_spec.rb

@@ -1,235 +0,0 @@
-require 'spec_helper'
-
-RSpec.describe Deprecations do
-  context 'policy' do
-    before do
-      Deprecations.behavior = :silence
-    end
-
-    context 'parameter forwarding' do
-
-      context 'when an instance method is marked as deprecated' do
-        subject do
-          Class.new(BasicObject) do
-            def foo(*args)
-              {foo: args}
-            end
-            deprecated :foo
-          end
-        end
-
-        it 'forwards all parameters and returns the original method`s result' do
-          result = subject.new.foo(:arg1, :arg2, 42)
-          expect(result).to eq(foo: [:arg1, :arg2, 42])
-        end
-      end
-
-      context 'when a class method is marked as deprecated' do
-        subject do
-          Class.new(BasicObject) do
-            def self.foo(*args)
-              {foo: args}
-            end
-            deprecated :foo
-          end
-        end
-
-        it 'forwards all parameters and returns the original method`s result' do
-          result = subject.foo(:arg1, :arg2, 42)
-          expect(result).to eq(foo: [:arg1, :arg2, 42])
-        end
-      end
-
-      context 'when a class is marked as deprecated' do
-        subject do
-          Class.new(BasicObject) do
-            attr_reader :parameters
-            def initialize(*parameters)
-              @parameters = parameters
-            end
-            deprecated!
-          end
-        end
-
-        it 'forwards all parameters to the initializer and returns the original method`s result' do
-          expect(subject.new(:arg1, :arg2, 42).parameters).to eq([:arg1, :arg2, 42])
-        end
-      end
-
-    end
-
-    context 'block forwarding' do
-
-      context 'when an instance method is marked as deprecated' do
-        subject do
-          Class.new(BasicObject) do
-            def foo(arg)
-              yield(arg)
-            end
-            deprecated :foo
-          end
-        end
-
-        it 'forwards a given Proc to the original method' do
-          result = subject.new.foo(41) do |arg|
-            {my_blocks_result: arg + 1}
-          end
-          expect(result).to eq(my_blocks_result: 42)
-        end
-      end
-
-      context 'when a class method is marked as deprecated' do
-        subject do
-          Class.new(BasicObject) do
-            def self.foo(arg)
-              yield(arg)
-            end
-            deprecated :foo
-          end
-        end
-
-        it 'forwards a given Proc to the original method' do
-          result = subject.foo(665) do |arg|
-            {my_blocks_result: arg + 1}
-          end
-          expect(result).to eq(my_blocks_result: 666)
-        end
-      end
-
-      context 'when a class is marked as deprecated' do
-        subject do
-          Class.new(BasicObject) do
-            attr_reader :value
-            def initialize(arg)
-              @value = yield(arg)
-            end
-            deprecated!
-          end
-        end
-
-        it 'forwards a given Proc to the initializer' do
-          instance = subject.new(41) do |arg|
-            {my_blocks_result: arg + 1}
-          end
-          expect(instance.value).to eq(my_blocks_result: 42)
-        end
-      end
-
-    end
-
-  end
-
-  context 'handling' do
-
-    context 'when a method is marked as deprecated' do
-
-      context 'when an alternative method and a comment are present ' do
-        subject do
-          Class.new(BasicObject) do
-            def foo
-            end
-            def bar
-            end
-            deprecated :foo, :bar, 'next version'
-          end
-        end
-
-        after do
-          subject.new.foo
-        end
-
-        it 'calls the handler with correct subject' do
-          expect(Deprecations).to receive(:call)
-            .once
-            .with("#{subject}#foo", anything, anything)
-        end
-        it 'calls the handler with correct alternative method' do
-          expect(Deprecations).to receive(:call)
-            .once
-            .with(anything, "#{subject}#bar", anything)
-        end
-        it 'calls the handler with a comment' do
-          expect(Deprecations).to receive(:call)
-            .once
-            .with(anything, anything, 'next version')
-        end
-      end
-
-      context 'when no alternative method and no comment are present' do
-        subject do
-          Class.new(BasicObject) do
-            def bar
-            end
-            deprecated :bar
-          end
-        end
-
-        after do
-          subject.new.bar
-        end
-
-        it 'calls handler without an alternative method' do
-          expect(Deprecations).to receive(:call).once.with(anything, nil, anything)
-        end
-        it 'calls handler without a comment' do
-          expect(Deprecations).to receive(:call).once.with(anything, anything, nil)
-        end
-      end
-
-    end
-
-    context 'when a class is anonymous defined' do
-      module Samples
-        AnonymousDefined = Class.new(::BasicObject) do
-          def clean; end
-          def clear; end
-          deprecated :clean, :clear
-
-          def self.create; end
-          def self.make; end
-          deprecated :create, :make
-        end
-      end
-
-      it 'uses correct decorated instance method names' do
-        expect(Deprecations).to receive(:call).once.with(
-          'Samples::AnonymousDefined#clean',
-          'Samples::AnonymousDefined#clear',
-          nil
-        )
-        Samples::AnonymousDefined.new.clean
-      end
-
-      it 'uses correct decorated singleton method names' do
-        expect(Deprecations).to receive(:call).once.with(
-          'Samples::AnonymousDefined.create',
-          'Samples::AnonymousDefined.make',
-          nil
-        )
-        Samples::AnonymousDefined.create
-      end
-    end
-
-    context 'when a sub-class is used' do
-      module Samples
-        class Parent < ::BasicObject
-          def clean; end
-          def clear; end
-          deprecated :clean, :clear
-        end
-
-        class Child < Parent; end
-      end
-
-      it 'uses correct decorated method names' do
-        expect(Deprecations).to receive(:call).once.with(
-          'Samples::Parent#clean',
-          'Samples::Parent#clear',
-          nil
-        )
-        Samples::Child.new.clean
-      end
-    end
-
-  end
-end

data/spec/spec_helper.rb

@@ -1,8 +0,0 @@
-RSpec.configure do |config|
-  config.raise_errors_for_deprecations!
-  config.disable_monkey_patching!
-  config.expose_dsl_globally = false
-  config.expect_with(:rspec){ |c| c.syntax = :expect }
-  config.mock_with(:rspec){ |c| c.syntax = :expect }
-end
-require 'deprecations'