如何在Ruby中將類標記爲已棄用？

Question

在Ruby中（甚至更多：Rails），它是easy to mark methods as deprecated。

但是，我怎樣才能將整個班級標記爲已棄用？我想提出只要使用一類的警告：

class BillingMethod 
end 

BillingMethod.new #=> DEPRECATION WARNING: the class BillingMethod is deprecated. Use PaymentMethod instead. 

或當它在繼承被使用：

class Sofort < BillingMethod 
end 

Sofort.new #=> DEPRECATION WARNING: the class BillingMethod is deprecated. Use PaymentMethod instead. 

或者，在嵌套類適用於：

class BillingMethod::Sofort < BillingMethod 
end 

BillingMethod::Sofort.new #=> DEPRECATION WARNING: the class BillingMethod is deprecated. Use PaymentMethod instead. 

我會認爲一個class_eval - 塊將是堅持這種警告的地方。那是正確的地方嗎？還是有更好的方法？

Answer 1

您可以使用const_missing棄用常數，並推而廣之，類。

const_missing在未定義的常量被引用時被調用。

module MyModule 

    class PaymentMethod 
    # ... 
    end 

    def self.const_missing(const_name) 
    super unless const_name == :BillingMethod 
    warn "DEPRECATION WARNING: the class MyModule::BillingMethod is deprecated. Use MyModule::PaymentMethod instead." 
    PaymentMethod 
    end 
end 

這使得現有的代碼引用MyModule::BillingMethod繼續工作，並警告他們使用淘汰類的用戶。

這是迄今爲止我見過的最好的棄用類目的。

Answer 2

爲什麼不能做這種方式：

def initialize(*args) 
    warn "DEPRECATION WARNING: ..." 
    super 
end 

Answer 3

你可能想看看Deprecate這是Ruby的標準庫的一部分：

class BillingMethod 
    extend Gem::Deprecate 

    class << self 
    deprecate :new, "PaymentMethod.new", 2016, 4 
    end 

    # Will be removed April 2016, use `PaymentMethod.new` instead 
    def initialize 
    #... 
    end 
end 

使用deprecated方法會導致這樣的警告：

BillingMethod.new 
# => NOTE: BillingMethod#new is deprecated; use PaymentMethod.new instead. It will be removed on or after 2016-04-01. 
# => BillingMethod#new called from file_name.rb:32.