aboutsummaryrefslogtreecommitdiffstats
path: root/railties/test/plugin_loader_test.rb
blob: c647d7b478b1668f0b82e263f71ad165d4ced559 (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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
require 'plugin_test_helper'

$:.unshift File.dirname(__FILE__) + "/../../actionpack/lib"
$:.unshift File.dirname(__FILE__) + "/../../actionmailer/lib"
require 'action_controller'
require 'action_mailer'

# Mocks out the configuration
module Rails
  def self.configuration
    Rails::Configuration.new
  end
end

class TestPluginLoader < Test::Unit::TestCase
  ORIGINAL_LOAD_PATH = $LOAD_PATH.dup

  def setup
    reset_load_path!

    @configuration     = Rails::Configuration.new
    @configuration.plugin_paths << plugin_fixture_root_path
    @initializer       = Rails::Initializer.new(@configuration)
    @valid_plugin_path = plugin_fixture_path('default/stubby')
    @empty_plugin_path = plugin_fixture_path('default/empty')

    @failure_tip = "It's likely someone has added a new plugin fixture without updating this list"

    @loader = Rails::Plugin::Loader.new(@initializer)
  end

  def test_should_locate_plugins_by_asking_each_locator_specifed_in_configuration_for_its_plugins_result
    locator_1 = stub(:plugins => [:a, :b, :c])
    locator_2 = stub(:plugins => [:d, :e, :f])
    locator_class_1 = stub(:new => locator_1)
    locator_class_2 = stub(:new => locator_2)
    @configuration.plugin_locators = [locator_class_1, locator_class_2]
    assert_equal [:a, :b, :c, :d, :e, :f], @loader.send(:locate_plugins)
  end

  def test_should_memoize_the_result_of_locate_plugins_as_all_plugins
    plugin_list = [:a, :b, :c]
    @loader.expects(:locate_plugins).once.returns(plugin_list)
    assert_equal plugin_list, @loader.all_plugins
    assert_equal plugin_list, @loader.all_plugins # ensuring that locate_plugins isn't called again
  end

  def test_should_return_empty_array_if_configuration_plugins_is_empty
    @configuration.plugins = []
    assert_equal [], @loader.plugins
  end

  def test_should_find_all_availble_plugins_and_return_as_all_plugins
    assert_plugins [ :engine, :stubby, :plugin_with_no_lib_dir, :gemlike, :acts_as_chunky_bacon, :a], @loader.all_plugins.reverse, @failure_tip
  end

  def test_should_return_all_plugins_as_plugins_when_registered_plugin_list_is_untouched
    assert_plugins [:a, :acts_as_chunky_bacon, :engine, :gemlike, :plugin_with_no_lib_dir, :stubby], @loader.plugins, @failure_tip
  end

  def test_should_return_all_plugins_as_plugins_when_registered_plugin_list_is_nil
    @configuration.plugins = nil
    assert_plugins [:a, :acts_as_chunky_bacon, :engine, :gemlike, :plugin_with_no_lib_dir, :stubby], @loader.plugins, @failure_tip
  end

  def test_should_return_specific_plugins_named_in_config_plugins_array_if_set
    plugin_names = [:acts_as_chunky_bacon, :stubby]
    only_load_the_following_plugins! plugin_names
    assert_plugins plugin_names, @loader.plugins
  end

  def test_should_respect_the_order_of_plugins_given_in_configuration
    plugin_names = [:stubby, :acts_as_chunky_bacon]
    only_load_the_following_plugins! plugin_names
    assert_plugins plugin_names, @loader.plugins
  end

  def test_should_load_all_plugins_in_natural_order_when_all_is_used
    only_load_the_following_plugins! [:all]
    assert_plugins [:a, :acts_as_chunky_bacon, :engine, :gemlike, :plugin_with_no_lib_dir, :stubby], @loader.plugins, @failure_tip
  end

  def test_should_load_specified_plugins_in_order_and_then_all_remaining_plugins_when_all_is_used
    only_load_the_following_plugins! [:stubby, :acts_as_chunky_bacon, :all]
    assert_plugins [:stubby, :acts_as_chunky_bacon, :a, :engine, :gemlike, :plugin_with_no_lib_dir], @loader.plugins, @failure_tip
  end

  def test_should_be_able_to_specify_loading_of_plugins_loaded_after_all
    only_load_the_following_plugins!  [:stubby, :all, :acts_as_chunky_bacon]
    assert_plugins [:stubby, :a, :engine, :gemlike, :plugin_with_no_lib_dir, :acts_as_chunky_bacon], @loader.plugins, @failure_tip
  end

  def test_should_accept_plugin_names_given_as_strings
    only_load_the_following_plugins! ['stubby', 'acts_as_chunky_bacon', :a, :plugin_with_no_lib_dir]
    assert_plugins [:stubby, :acts_as_chunky_bacon, :a, :plugin_with_no_lib_dir], @loader.plugins, @failure_tip
  end

  def test_should_add_plugin_load_paths_to_global_LOAD_PATH_array
    only_load_the_following_plugins! [:stubby, :acts_as_chunky_bacon]
    stubbed_application_lib_index_in_LOAD_PATHS = 4
    @loader.stubs(:application_lib_index).returns(stubbed_application_lib_index_in_LOAD_PATHS)

    @loader.add_plugin_load_paths

    assert $LOAD_PATH.index(File.join(plugin_fixture_path('default/stubby'), 'lib')) >= stubbed_application_lib_index_in_LOAD_PATHS
    assert $LOAD_PATH.index(File.join(plugin_fixture_path('default/acts/acts_as_chunky_bacon'), 'lib')) >= stubbed_application_lib_index_in_LOAD_PATHS
  end

  def test_should_add_plugin_load_paths_to_Dependencies_load_paths
    only_load_the_following_plugins! [:stubby, :acts_as_chunky_bacon]

    @loader.add_plugin_load_paths

    assert ActiveSupport::Dependencies.load_paths.include?(File.join(plugin_fixture_path('default/stubby'), 'lib'))
    assert ActiveSupport::Dependencies.load_paths.include?(File.join(plugin_fixture_path('default/acts/acts_as_chunky_bacon'), 'lib'))
  end

  def test_should_add_engine_load_paths_to_Dependencies_load_paths
    only_load_the_following_plugins! [:engine]

    @loader.add_plugin_load_paths

    %w( models controllers metal helpers ).each do |app_part|
      assert ActiveSupport::Dependencies.load_paths.include?(
        File.join(plugin_fixture_path('engines/engine'), 'app', app_part)
      ), "Couldn't find #{app_part} in load path"
    end
  end
  
  def test_engine_controllers_and_action_mailers_should_have_their_view_path_set_when_loaded
    only_load_the_following_plugins!([ :engine ])

    @loader.send :add_engine_view_paths
    
    assert_equal [ File.join(plugin_fixture_path('engines/engine'), 'app', 'views') ], ActionController::Base.view_paths.map { |p| p.to_s }
    assert_equal [ File.join(plugin_fixture_path('engines/engine'), 'app', 'views') ], ActionMailer::Base.view_paths.map { |p| p.to_s }
  end
  
  def test_should_add_plugin_load_paths_to_Dependencies_load_once_paths
    only_load_the_following_plugins! [:stubby, :acts_as_chunky_bacon]

    @loader.add_plugin_load_paths

    assert ActiveSupport::Dependencies.load_once_paths.include?(File.join(plugin_fixture_path('default/stubby'), 'lib'))
    assert ActiveSupport::Dependencies.load_once_paths.include?(File.join(plugin_fixture_path('default/acts/acts_as_chunky_bacon'), 'lib'))
  end

  def test_should_add_all_load_paths_from_a_plugin_to_LOAD_PATH_array
    plugin_load_paths = ["a", "b"]
    plugin = stub(:load_paths => plugin_load_paths)
    @loader.stubs(:plugins).returns([plugin])

    @loader.add_plugin_load_paths

    plugin_load_paths.each { |path| assert $LOAD_PATH.include?(path) }
  end


  private
    def reset_load_path!
      $LOAD_PATH.clear
      ORIGINAL_LOAD_PATH.each { |path| $LOAD_PATH << path }
    end
end