aboutsummaryrefslogtreecommitdiffstats
path: root/activesupport/lib/active_support/reloadable.rb
blob: 084bda1ee236d93fb0b22fd45e9a5401e45579d0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
require 'active_support/deprecation'

# A deprecated mechanism to mark a class reloadable.
# 
# Deprecated as of Rails 1.2.
# All autoloaded objects are now unloaded.
module Reloadable #:nodoc:
  class << self    
    def included(base) #nodoc:
      unless base.ancestors.include?(Reloadable::Subclasses) # Avoid double warning
        ActiveSupport::Deprecation.warn "Reloadable has been deprecated and has no effect.", caller
      end
      
      raise TypeError, "Only Classes can be Reloadable!" unless base.is_a? Class
      
      unless base.respond_to?(:reloadable?)
        class << base
          define_method(:reloadable?) do
            ActiveSupport::Deprecation.warn "Reloadable has been deprecated and reloadable? has no effect", caller
            true
          end
        end
      end
    end
    
    def reloadable_classes
      ActiveSupport::Deprecation.silence do
        included_in_classes.select { |klass| klass.reloadable? }
      end
    end
    deprecate :reloadable_classes
  end
  
  # Captures the common pattern where a base class should not be reloaded,
  # but its subclasses should be.
  # 
  # Deprecated as of Rails 1.2.
  # All autoloaded objects are now unloaded.
  module Subclasses #:nodoc:
    def self.included(base) #nodoc:
      base.send :include, Reloadable
      ActiveSupport::Deprecation.warn "Reloadable::Subclasses has been deprecated and has no effect.", caller
      (class << base; self; end).send(:define_method, :reloadable?) do
        ActiveSupport::Deprecation.warn "Reloadable has been deprecated and reloadable? has no effect", caller
        base != self
      end
    end
  end
  
  module Deprecated #:nodoc:
    def self.included(base)
      class << base
        define_method(:reloadable?) do
          ActiveSupport::Deprecation.warn "Reloadable has been deprecated and reloadable? has no effect", caller
          true # This might not have the desired effect, as AR::B.reloadable? => true.
        end
      end
    end
  end
end