aboutsummaryrefslogtreecommitdiffstats
path: root/railties/lib/rails/railtie.rb
blob: 3cf358d75f5cf61fd8680f3296069d42448a0fb4 (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
require 'rails/initializable'
require 'rails/configuration'

module Rails
  class Railtie
    autoload :Configurable,  "rails/railtie/configurable"
    autoload :Configuration, "rails/railtie/configuration"

    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

      def railtie_name(railtie_name = nil)
        @railtie_name ||= name.demodulize.underscore
        @railtie_name = railtie_name if railtie_name
        @railtie_name
      end

      def railtie_names
        subclasses.map { |p| p.railtie_name }
      end

      def subscriber(subscriber)
        Rails::Subscriber.add(railtie_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