aboutsummaryrefslogtreecommitdiffstats
path: root/railties/lib/rails/railtie.rb
blob: 208b017348bb0b56a30781445a01d10975cdd720 (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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
module Rails
  class Railtie
    autoload :Configurable, "rails/railtie/configurable"

    include Initializable

    ABSTRACT_RAILTIES = %w(Rails::Plugin Rails::Engine Rails::Application)

    class << self
      def subclasses
        @subclasses ||= []
      end

      def inherited(base)
        unless abstract_railtie?(base)
          base.send(:include, self::Configurable) if add_configurable?(base)
          subclasses << base
        end
      end

      # TODO This should be called railtie_name and engine_name
      def plugin_name(plugin_name = nil)
        @plugin_name ||= name.demodulize.underscore
        @plugin_name = plugin_name if plugin_name
        @plugin_name
      end

      # TODO Deprecate me
      def plugins
        subclasses
      end

      # TODO Deprecate me
      def plugin_names
        plugins.map { |p| p.plugin_name }
      end

      def subscriber(subscriber)
        Rails::Subscriber.add(plugin_name, subscriber)
      end

      def rake_tasks(&blk)
        @rake_tasks ||= []
        @rake_tasks << blk if blk
        @rake_tasks
      end

      def generators(&blk)
        @generators ||= []
        @generators << blk if blk
        @generators
      end

    protected

      def abstract_railtie?(base)
        ABSTRACT_RAILTIES.include?(base.name)
      end

      # Just add configurable behavior if a Configurable module is defined
      # and the class is a direct child from self. This is required to avoid
      # application or plugins getting class configuration method from Railties
      # and/or Engines.
      def add_configurable?(base)
        defined?(self::Configurable) && base.ancestors[1] == self
      end
    end

    def rake_tasks
      self.class.rake_tasks
    end

    def generators
      self.class.generators
    end

    def load_tasks
      rake_tasks.each { |blk| blk.call }
    end

    def load_generators
      generators.each { |blk| blk.call }
    end
  end
end