deprecate_soft 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f38db5179c81ba2e97d0a09bebeea87648eed96271b87a0089c3e444d122c9f5
-  data.tar.gz: fba061e831a26a0cf0be6bd99970cf84dd4130d3d93b6e53fbe01f5fa0b2846d
+  metadata.gz: 8b9799b61944284b4206b894196574252ccbcf7e550b127d7f45dfe524a943a5
+  data.tar.gz: 1474ec114cd60edcd85a7c975efb69121654f19ea0659ca4b13f577ca9370520
 SHA512:
-  metadata.gz: 5d5d5ed40760cb78b41399924db249e93c585eef04f2f5d370c2cbfcfcfd5ae1621cea064c1b681e3ab90a16f63b814afe48c50ed5c4f4d32144602e7288ee49
-  data.tar.gz: 0124ae4b6a825c3a5920b2bee96417e73a44b9c19f527797cc35e7c852e43b5867369b04c0167a2efa2728eed8b7e99c894e9d74464ca09b36a8aef3c98bce64
+  metadata.gz: fd8cd841c2c67e77b3b7aed65e4fe0405f19d296c727c051346ba139662c395c3542e2848ee5d9c09146653bd6bdc5fdfa3756fcb57f95412d29a355d729841f
+  data.tar.gz: 8662fc4dec07bfc90b334d3aa5127b5c9042af70168d3013e03045f35d19beec572ffb5f16dfc386e169e48e590c83c600c9c7d823b724a5ee48615a7045f5b7

data/.rubocop.yml

@@ -36,3 +36,6 @@ Style/Documentation:
 
 Style/RedundantSelf:
   Enabled: false
+
+Style/SingleLineMethods:
+  Enabled: false

data/CHANGELOG.md

@@ -1,7 +1,17 @@
 ## DepracateSoft Change Log
 
+## [1.1.0] - 2025-03-29
+ - simplify initialization
+ - added tests for corner cases:
+   - deprecate_soft called before method definition
+   - deprecate_soft called twice
+   - deprecate_soft for private methods
+   - before_hook or after_hook raise
+ - prevent double-wrapping methods
+ - ensure that methods run undisturbed, even if the before_hook or after_hook raise an exception
+
 ## [1.0.0] - 2025-03-24
  - Initial release
+
 ## [0.0.1] - 2025-03-22
  - pre-release
- 

data/README.md

@@ -1,7 +1,7 @@
 
 # DeprecateSoft
 
-DeprecateSoft is a lightweight and flexible Ruby gem designed to help you gracefully and safely deprecate methods.
+DeprecateSoft is a lightweight and flexible Ruby gem designed to help you gracefully and safely delete methods.
 
 It was inspired by the need to track deprecated method usage in large codebases before safely removing old code — with zero disruption and flexible metrics support.
 
@@ -11,6 +11,8 @@ It’s ideal for monitoring deprecated method usage across your application usin
 
 Once tracking confirms that a deprecated method is no longer in use, you can confidently delete it from your codebase.
 
+This mechanism has been **proven in large-scale production systems** to safely clean up legacy code — this gem reimagines that functionality to help you clean up your code with confidence.
+
 ---
 
 ## ✨ Features
@@ -19,9 +21,12 @@ Once tracking confirms that a deprecated method is no longer in use, you can con
 - Works with instance methods in any class or module
 - Works with class or module methods in any class or module
 - System-wide hook configuration (before and after)
-- No monkey-patching or global pollution
+- No monkey-patching or global pollution — unless you explicitly opt in via `GlobalMonkeyPatch`
 - Fully compatible with Rails or plain Ruby apps
 
+---
+## 📖 Blog Posts
+- [Safely Delete Old Ruby Code with deprecate_soft](https://medium.com/@tilo-sloboda/safely-delete-old-code-with-deprecate-soft-89e819b41d52)
 ---
 
 ## 🚀 Installation
@@ -38,6 +43,62 @@ Then run:
 bundle install
 ```
 
+And add your initializer file.
+
+---
+
+## 🧩 Usage
+
+Declare `deprecate_soft` **after** the method definition.
+
+### For Instance Methods:
+
+```ruby
+class MyService
+  include DeprecateSoft
+
+  def deprecated_method(a, b)
+    puts "doing something with #{a} and #{b}"
+  end
+
+  deprecate_soft :deprecated_method, "Use #new_method instead"
+end
+
+MyService.new.deprecated_method(1, 2) # will exercise the tracking hooks
+```
+
+### For Class Methods:
+
+```ruby
+class MyService
+  extend DeprecateSoft
+
+  def self.deprecated_method(a, b)
+    puts "doing something with #{a} and #{b}"
+  end
+
+  deprecate_soft :deprecated_method, "will be removed"
+end
+
+MyService.deprecated_method(1, 2) # will exercise the tracking hooks
+
+```
+
+---
+
+## 🔐 What It Does Under the Hood
+
+When you call `deprecate_soft :method_name, "reason"`:
+
+1. It renames the original method to `__method_name_deprecated`.
+2. It defines a new method with the original name that:
+   - Calls the configured `before_hook` (if set)
+   - Delegates to the original method
+   - Calls the configured `after_hook` (if set)
+3. The optional `message` with the reason can help identifying alternatives.
+
+This ensures consistent tracking, clean method resolution, and avoids accidental bypassing.
+
 ---
 
 ## ⚙️ Configuration
@@ -96,7 +157,7 @@ end
 
 This setup ensures you can plug in **any tracking backend** you like — without polluting the global namespace.
 
-### 🔧 Customizing Method Name Wrapping
+### 🔧 Optional: Customizing Method Name Wrapping
 
 When `deprecate_soft` wraps a method, it renames the original method internally to preserve its behavior. You can customize how that internal method is named by configuring a `prefix` and `suffix`.
 
@@ -137,61 +198,6 @@ This gives you full control over how deprecated methods are renamed internally.
 
 These names are never called directly — they're used internally to wrap and preserve the original method logic.
 
-
----
-
-## 🧩 Usage
-
-🚨 Always declare `deprecate_soft` **after** the method definition!
-
-### For Instance Methods:
-
-```ruby
-class MyService
-  include DeprecateSoft
-
-  def deprecated_method(a, b)
-    puts "doing something with #{a} and #{b}"
-  end
-
-  deprecate_soft :deprecated_method, "Use #new_method instead"
-end
-
-MyService.new.deprecated_method(1, 2) # will exercise the tracking hooks
-```
-
-### For Class Methods:
-
-```ruby
-class MyService
-  extend DeprecateSoft
-
-  def self.deprecated_method(a, b)
-    puts "doing something with #{a} and #{b}"
-  end
-
-  deprecate_soft :deprecated_method, "will be removed"
-end
-
-MyService.deprecated_method(1, 2) # will exercise the tracking hooks
-
-```
-
----
-
-## 🔐 What It Does Under the Hood
-
-When you call `deprecate_soft :method_name, "reason"`:
-
-1. It renames the original method to `__method_name_deprecated`.
-2. It defines a new method with the original name that:
-   - Calls the configured `before_hook` (if set)
-   - Delegates to the original method
-   - Calls the configured `after_hook` (if set)
-3. The optional `message` with the reason can help identifying alternatives.
-
-This ensures consistent tracking, clean method resolution, and avoids accidental bypassing.
-
 ---
 
 ## 🧪 Example Hook Logic
@@ -273,6 +279,36 @@ Klass#legacy_method:caller:app/jobs/cleanup_job.rb:88 → 4
 
 💡 Now you not only know that the method is still used -- you know where from, and how often -- so you can fix your code.
 
+--- 
+
+## 💪 Optional: Global Monkey Patching
+
+For large projects, it can be beneficial to enable deprecate_soft across the entire codebase without having to explicitly `include DeprecateSoft` or e`xtend DeprecateSoft` in each class or module.
+
+To do this, you can globally monkey-patch `Module` by including `DeprecateSoft::GlobalMonkeyPatch`. This is **entirely optional and not enabled by default**.
+
+Add the following to your `config/initializers/deprecate_soft.rb` initializer:
+
+```ruby
+# config/initializers/deprecate_soft.rb
+
+require "deprecate_soft"
+require "deprecate_soft/global_monkey_patch"
+
+# ... 
+
+class Module
+  include DeprecateSoft::GlobalMonkeyPatch
+end
+
+DeprecateSoft.configure do |config|
+  #
+  # ...  
+  #
+end
+
+```
+
 ---
 
 ## 🛡 Best Practices
@@ -280,7 +316,7 @@ Klass#legacy_method:caller:app/jobs/cleanup_job.rb:88 → 4
 - Use `deprecate_soft` for methods you plan to remove but want to confirm they are no longer used.
 - Integrate with your observability platform for tracking.
 - Review usage stats before deleting deprecated methods from your code.
-- 🚨 Always declare `deprecate_soft` **after** the method definition! 🚨
+- Always declare `deprecate_soft` **after** the method definition.
 
 ---
 
@@ -289,7 +325,6 @@ Klass#legacy_method:caller:app/jobs/cleanup_job.rb:88 → 4
 - Make sure hooks do not raise or interfere with production behavior.
 - Only use non-blocking, low-latency methods for tracking!
 - Currently assumes Ruby 2.5+ (for `&.` and keyword args support).
-- Currently keeps the visibility of the renamed original method the same (does not make it private).
 
 ---
 
@@ -297,9 +332,9 @@ Klass#legacy_method:caller:app/jobs/cleanup_job.rb:88 → 4
 
 Feel free to open issues or pull requests if you'd like to:
 
-- Add support for class methods
+- Request new features
 - Add Railtie for automatic setup
-- Add built-in backends (e.g. Redis, StatsD)
+- Add support for other backends
 
 ---
 

data/lib/deprecate_soft/method_wrapper.rb

@@ -6,27 +6,55 @@ module DeprecateSoft
       hidden_method_name = "#{DeprecateSoft.prefix}#{method_name}_#{DeprecateSoft.suffix}"
 
       if is_class_method
-        original_method = context.method(method_name)
+        target = context.singleton_class
+
+        return if target.method_defined?(hidden_method_name) || target.private_method_defined?(hidden_method_name)
 
-        context.singleton_class.define_method(hidden_method_name, original_method)
+        original_method = context.method(method_name)
+        target.define_method(hidden_method_name, original_method)
 
-        context.singleton_class.define_method(method_name) do |*args, &block|
+        target.define_method(method_name) do |*args, &block|
           full_name = "#{self.name}.#{method_name}"
-          DeprecateSoft.before_hook&.call(full_name, message, args: args) if defined?(DeprecateSoft.before_hook)
+
+          begin
+            DeprecateSoft.before_hook&.call(full_name, message, args: args)
+          rescue StandardError => e
+            warn "DeprecateSoft.before_hook error: #{e.class} - #{e.message}"
+          end
+
           result = send(hidden_method_name, *args, &block)
-          DeprecateSoft.after_hook&.call(full_name, message, result: result) if defined?(DeprecateSoft.after_hook)
+
+          begin
+            DeprecateSoft.after_hook&.call(full_name, message, result: result)
+          rescue StandardError => e
+            warn "DeprecateSoft.after_hook error: #{e.class} - #{e.message}"
+          end
+
           result
         end
       else
-        original_method = context.instance_method(method_name)
+        return if context.method_defined?(hidden_method_name) || context.private_method_defined?(hidden_method_name)
 
+        original_method = context.instance_method(method_name)
         context.define_method(hidden_method_name, original_method)
 
         context.define_method(method_name) do |*args, &block|
           full_name = "#{self.class}##{method_name}"
-          DeprecateSoft.before_hook&.call(full_name, message, args: args) if defined?(DeprecateSoft.before_hook)
+
+          begin
+            DeprecateSoft.before_hook&.call(full_name, message, args: args)
+          rescue StandardError => e
+            warn "DeprecateSoft.before_hook error: #{e.class} - #{e.message}"
+          end
+
           result = send(hidden_method_name, *args, &block)
-          DeprecateSoft.after_hook&.call(full_name, message, result: result) if defined?(DeprecateSoft.after_hook)
+
+          begin
+            DeprecateSoft.after_hook&.call(full_name, message, result: result)
+          rescue StandardError => e
+            warn "DeprecateSoft.after_hook error: #{e.class} - #{e.message}"
+          end
+
           result
         end
       end

data/lib/deprecate_soft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeprecateSoft
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/lib/deprecate_soft.rb

@@ -5,6 +5,20 @@ require_relative 'deprecate_soft/version'
 require_relative 'deprecate_soft/method_wrapper'
 
 module DeprecateSoft
+  def configure_base(base)
+    base.extend(ClassMethods)
+    base.extend(InstanceMethods)
+  end
+  module_function :configure_base
+
+  def included(base)
+    configure_base(base)
+  end
+
+  def extended(base)
+    configure_base(base)
+  end
+
   class << self
     attr_accessor :before_hook, :after_hook
     attr_writer :prefix, :suffix
@@ -20,14 +34,6 @@ module DeprecateSoft
     def configure
       yield self
     end
-
-    def included(base)
-      base.extend InstanceMethods
-    end
-
-    def extended(base)
-      base.extend ClassMethods
-    end
   end
 
   module InstanceMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: deprecate_soft
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Tilo Sloboda
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-03-25 00:00:00.000000000 Z
+date: 2025-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dogstatsd-ruby
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement