require_relative '../../spec_helper' require_relative 'fixtures/classes' # These specs only illustrate the basic autoload cases # and where toplevel autoload behaves differently from # Module#autoload. See those specs for more examples. autoload :KSAutoloadA, "autoload_a.rb" autoload :KSAutoloadB, fixture(__FILE__, "autoload_b.rb") autoload :KSAutoloadCallsRequire, "main_autoload_not_exist.rb" def check_autoload(const) autoload? const end describe "Kernel#autoload" do before :each do @loaded_features = $".dup end after :each do $".replace @loaded_features end it "is a private method" do Kernel.should have_private_instance_method(:autoload) end it "registers a file to load the first time the named constant is accessed" do Object.autoload?(:KSAutoloadA).should == "autoload_a.rb" end it "registers a file to load the first time the named constant is accessed" do check_autoload(:KSAutoloadA).should == "autoload_a.rb" end it "sets the autoload constant in Object's constant table" do Object.should have_constant(:KSAutoloadA) end it "loads the file when the constant is accessed" do KSAutoloadB.loaded.should == :ksautoload_b end it "calls main.require(path) to load the file" do main = TOPLEVEL_BINDING.eval("self") main.should_receive(:require).with("main_autoload_not_exist.rb") # The constant won't be defined since require is mocked to do nothing -> { KSAutoloadCallsRequire }.should raise_error(NameError) end it "can autoload in instance_eval" do Object.new.instance_eval do autoload :KSAutoloadD, fixture(__FILE__, "autoload_d.rb") KSAutoloadD.loaded.should == :ksautoload_d end end describe "when Object is frozen" do it "raises a #{frozen_error_class} before defining the constant" do ruby_exe(fixture(__FILE__, "autoload_frozen.rb")).should == "#{frozen_error_class} - nil" end end describe "when called from included module's method" do before :all do @path = fixture(__FILE__, "autoload_from_included_module.rb") KernelSpecs::AutoloadMethodIncluder.new.setup_autoload(@path) end it "setups the autoload on the included module" do KernelSpecs::AutoloadMethod.autoload?(:AutoloadFromIncludedModule).should == @path end it "the autoload is reachable from the class too" do KernelSpecs::AutoloadMethodIncluder.autoload?(:AutoloadFromIncludedModule).should == @path end it "the autoload relative to the included module works" do KernelSpecs::AutoloadMethod::AutoloadFromIncludedModule.loaded.should == :autoload_from_included_module end end end describe "Kernel#autoload?" do it "is a private method" do Kernel.should have_private_instance_method(:autoload?) end it "returns the name of the file that will be autoloaded" do check_autoload(:KSAutoloadA).should == "autoload_a.rb" end it "returns nil if no file has been registered for a constant" do check_autoload(:Manualload).should be_nil end end Kernel.autoload :KSAutoloadBB, "no_autoload.rb" describe "Kernel.autoload" do before :all do @non_existent = fixture __FILE__, "no_autoload.rb" end before :each do @loaded_features = $".dup ScratchPad.clear end after :each do $".replace @loaded_features end it "registers a file to load the first time the toplevel constant is accessed" do Kernel.autoload :KSAutoloadAA, @non_existent Kernel.autoload?(:KSAutoloadAA).should == @non_existent end it "sets the autoload constant in Object's constant table" do Object.should have_constant(:KSAutoloadBB) end it "calls #to_path on non-String filenames" do p = mock('path') p.should_receive(:to_path).and_return @non_existent Kernel.autoload :KSAutoloadAA, p end describe "when called from included module's method" do before :all do @path = fixture(__FILE__, "autoload_from_included_module2.rb") KernelSpecs::AutoloadMethodIncluder2.new.setup_autoload(@path) end it "setups the autoload on the included module" do KernelSpecs::AutoloadMethod2.autoload?(:AutoloadFromIncludedModule2).should == @path end it "the autoload is reachable from the class too" do KernelSpecs::AutoloadMethodIncluder2.autoload?(:AutoloadFromIncludedModule2).should == @path end it "the autoload relative to the included module works" do KernelSpecs::AutoloadMethod2::AutoloadFromIncludedModule2.loaded.should == :autoload_from_included_module2 end end end describe "Kernel.autoload?" do it "returns the name of the file that will be autoloaded" do Kernel.autoload :KSAutoload, "autoload.rb" Kernel.autoload?(:KSAutoload).should == "autoload.rb" end it "returns nil if no file has been registered for a constant" do Kernel.autoload?(:Manualload).should be_nil end end