puppet 2.6.8 → 2.6.9

data/spec/unit/configurer/fact_handler_spec.rb

@@ -13,14 +13,6 @@ describe Puppet::Configurer::FactHandler do
     @facthandler = FactHandlerTester.new
   end
 
-  it "should have a method for downloading fact plugins" do
-    @facthandler.should respond_to(:download_fact_plugins)
-  end
-
-  it "should have a boolean method for determining whether fact plugins should be downloaded" do
-    @facthandler.should respond_to(:download_fact_plugins?)
-  end
-
   it "should download fact plugins when :factsync is true" do
     Puppet.settings.expects(:value).with(:factsync).returns true
     @facthandler.should be_download_fact_plugins
@@ -52,46 +44,60 @@ describe Puppet::Configurer::FactHandler do
     @facthandler.download_fact_plugins
   end
 
-  it "should warn about factsync deprecation when factsync is enabled" do
-    Puppet::Configurer::Downloader.stubs(:new).returns mock("downloader", :evaluate => nil)
+  describe "when finding facts" do
+    before :each do
+      @facthandler.stubs(:reload_facter)
+      Puppet::Node::Facts.terminus_class = :memory
+    end
 
-    @facthandler.expects(:download_fact_plugins?).returns true
-    Puppet.expects(:warning)
-    @facthandler.download_fact_plugins
-  end
+    it "should use the node name value to retrieve the facts" do
+      foo_facts = Puppet::Node::Facts.new('foo')
+      bar_facts = Puppet::Node::Facts.new('bar')
+      foo_facts.save
+      bar_facts.save
+      Puppet[:certname] = 'foo'
+      Puppet[:node_name_value] = 'bar'
 
-  it "should have a method for retrieving facts" do
-    @facthandler.should respond_to(:find_facts)
-  end
+      @facthandler.find_facts.should == bar_facts
+    end
 
-  it "should use the Facts class with the :certname to find the facts" do
-    Puppet.settings.expects(:value).with(:certname).returns "foo"
-    Puppet::Node::Facts.expects(:find).with("foo").returns "myfacts"
-    @facthandler.stubs(:reload_facter)
-    @facthandler.find_facts.should == "myfacts"
-  end
+    it "should set the facts name based on the node_name_fact" do
+      Puppet::Node::Facts.new(Puppet[:node_name_value], 'my_name_fact' => 'other_node_name').save
+      Puppet[:node_name_fact] = 'my_name_fact'
 
-  it "should reload Facter and find local facts when asked to find facts" do
-    @facthandler.expects(:reload_facter)
+      @facthandler.find_facts.name.should == 'other_node_name'
+    end
 
-    Puppet.settings.expects(:value).with(:certname).returns "myhost"
-    Puppet::Node::Facts.expects(:find).with("myhost")
+    it "should set the node_name_value based on the node_name_fact" do
+      Puppet::Node::Facts.new(Puppet[:node_name_value], 'my_name_fact' => 'other_node_name').save
+      Puppet[:node_name_fact] = 'my_name_fact'
 
-    @facthandler.find_facts
-  end
+      @facthandler.find_facts
 
-  it "should fail if finding facts fails" do
-    @facthandler.stubs(:reload_facter)
+      Puppet[:node_name_value].should == 'other_node_name'
+    end
 
-    Puppet.settings.stubs(:value).with(:trace).returns false
-    Puppet.settings.stubs(:value).with(:certname).returns "myhost"
-    Puppet::Node::Facts.expects(:find).raises RuntimeError
+    it "should reload Facter before finding facts" do
+      @facthandler.expects(:reload_facter)
 
-    lambda { @facthandler.find_facts }.should raise_error(Puppet::Error)
+      @facthandler.find_facts
+    end
+
+    it "should fail if finding facts fails" do
+      Puppet[:trace] = false
+      Puppet[:certname] = "myhost"
+      Puppet::Node::Facts.expects(:find).raises RuntimeError
+
+      lambda { @facthandler.find_facts }.should raise_error(Puppet::Error)
+    end
   end
 
-  it "should have a method to prepare the facts for uploading" do
-    @facthandler.should respond_to(:facts_for_uploading)
+  it "should warn about factsync deprecation when factsync is enabled" do
+    Puppet::Configurer::Downloader.stubs(:new).returns mock("downloader", :evaluate => nil)
+
+    @facthandler.expects(:download_fact_plugins?).returns true
+    Puppet.expects(:warning)
+    @facthandler.download_fact_plugins
   end
 
   # I couldn't get marshal to work for this, only yaml, so we hard-code yaml.

data/spec/unit/configurer_spec.rb

@@ -10,6 +10,7 @@ describe Puppet::Configurer do
   before do
     Puppet.settings.stubs(:use).returns(true)
     @agent = Puppet::Configurer.new
+    Puppet::Util::Storage.stubs(:store)
   end
 
   it "should include the Plugin Handler module" do
@@ -35,16 +36,16 @@ describe Puppet::Configurer do
 
     it "should execute any pre-run command provided via the 'prerun_command' setting" do
       Puppet.settings[:prerun_command] = "/my/command"
-      Puppet::Util.expects(:execute).with { |args| args[0] == "/my/command" }
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
       @agent.execute_prerun_command
     end
 
     it "should fail if the command fails" do
       Puppet.settings[:prerun_command] = "/my/command"
-      Puppet::Util.expects(:execute).raises Puppet::ExecutionFailure
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
-      lambda { @agent.execute_prerun_command }.should raise_error(Puppet::Configurer::CommandHookError)
+      @agent.execute_prerun_command.should be_false
     end
   end
 
@@ -58,469 +59,545 @@ describe Puppet::Configurer do
 
     it "should execute any post-run command provided via the 'postrun_command' setting" do
       Puppet.settings[:postrun_command] = "/my/command"
-      Puppet::Util.expects(:execute).with { |args| args[0] == "/my/command" }
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
       @agent.execute_postrun_command
     end
 
     it "should fail if the command fails" do
       Puppet.settings[:postrun_command] = "/my/command"
-      Puppet::Util.expects(:execute).raises Puppet::ExecutionFailure
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
-      lambda { @agent.execute_postrun_command }.should raise_error(Puppet::Configurer::CommandHookError)
+      @agent.execute_postrun_command.should be_false
     end
   end
-end
 
-describe Puppet::Configurer, "when executing a catalog run" do
-  before do
-    Puppet.settings.stubs(:use).returns(true)
-    @agent = Puppet::Configurer.new
-    @agent.stubs(:prepare)
-    @agent.stubs(:facts_for_uploading).returns({})
-    @catalog = Puppet::Resource::Catalog.new
-    @catalog.stubs(:apply)
-    @agent.stubs(:retrieve_catalog).returns @catalog
-    @agent.stubs(:save_last_run_summary)
-
-    Puppet::Util::Log.stubs(:newdestination)
-    Puppet::Util::Log.stubs(:close)
-  end
+  describe "when executing a catalog run" do
+    before do
+      Puppet.settings.stubs(:use).returns(true)
+      @agent.stubs(:prepare)
+      Puppet::Node::Facts.terminus_class = :memory
+      @facts = Puppet::Node::Facts.new(Puppet[:node_name_value])
+      @facts.save
+
+      @catalog = Puppet::Resource::Catalog.new
+      @catalog.stubs(:to_ral).returns(@catalog)
+      Puppet::Resource::Catalog.terminus_class = :rest
+      Puppet::Resource::Catalog.stubs(:find).returns(@catalog)
+      @agent.stubs(:send_report)
+      @agent.stubs(:save_last_run_summary)
+
+      Puppet::Util::Log.stubs(:close)
+    end
 
-  it "should prepare for the run" do
-    @agent.expects(:prepare)
+    it "should prepare for the run" do
+      @agent.expects(:prepare)
 
-    @agent.run
-  end
+      @agent.run
+    end
 
-  it "should initialize a transaction report if one is not provided" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns report
+    it "should initialize a transaction report if one is not provided" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns report
 
-    @agent.run
-  end
+      @agent.run
+    end
 
-  it "should pass the new report to the catalog" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.stubs(:new).returns report
-    @catalog.expects(:apply).with{|options| options[:report] == report}
+    it "should respect node_name_fact when setting the host on a report" do
+      Puppet[:node_name_fact] = 'my_name_fact'
+      @facts.values = {'my_name_fact' => 'node_name_from_fact'}
 
-    @agent.run
-  end
+      @agent.run.host.should == 'node_name_from_fact'
+    end
 
-  it "should use the provided report if it was passed one" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).never
-    @catalog.expects(:apply).with{|options| options[:report] == report}
+    it "should pass the new report to the catalog" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.stubs(:new).returns report
+      @catalog.expects(:apply).with{|options| options[:report] == report}
 
-    @agent.run(:report => report)
-  end
+      @agent.run
+    end
 
-  it "should set the report as a log destination" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns report
+    it "should use the provided report if it was passed one" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).never
+      @catalog.expects(:apply).with{|options| options[:report] == report}
 
-    Puppet::Util::Log.expects(:newdestination).with(report)
+      @agent.run(:report => report)
+    end
 
-    @agent.run
-  end
+    it "should set the report as a log destination" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns report
 
-  it "should retrieve the catalog" do
-    @agent.expects(:retrieve_catalog)
+      Puppet::Util::Log.expects(:newdestination).with(report)
+      Puppet::Util::Log.expects(:close).with(report)
+      Puppet::Util::Log.expects(:close).with([])
 
-    @agent.run
-  end
+      @agent.run
+    end
 
-  it "should log a failure and do nothing if no catalog can be retrieved" do
-    @agent.expects(:retrieve_catalog).returns nil
+    it "should retrieve the catalog" do
+      @agent.expects(:retrieve_catalog)
 
-    Puppet.expects(:err).with "Could not retrieve catalog; skipping run"
+      @agent.run
+    end
 
-    @agent.run
-  end
+    it "should log a failure and do nothing if no catalog can be retrieved" do
+      @agent.expects(:retrieve_catalog).returns nil
 
-  it "should apply the catalog with all options to :run" do
-    @agent.expects(:retrieve_catalog).returns @catalog
+      Puppet.expects(:err).with "Could not retrieve catalog; skipping run"
 
-    @catalog.expects(:apply).with { |args| args[:one] == true }
-    @agent.run :one => true
-  end
+      @agent.run
+    end
 
-  it "should accept a catalog and use it instead of retrieving a different one" do
-    @agent.expects(:retrieve_catalog).never
+    it "should apply the catalog with all options to :run" do
+      @agent.expects(:retrieve_catalog).returns @catalog
 
-    @catalog.expects(:apply)
-    @agent.run :one => true, :catalog => @catalog
-  end
+      @catalog.expects(:apply).with { |args| args[:one] == true }
+      @agent.run :one => true
+    end
 
-  it "should benchmark how long it takes to apply the catalog" do
-    @agent.expects(:benchmark).with(:notice, "Finished catalog run")
+    it "should accept a catalog and use it instead of retrieving a different one" do
+      @agent.expects(:retrieve_catalog).never
 
-    @agent.expects(:retrieve_catalog).returns @catalog
+      @catalog.expects(:apply)
+      @agent.run :one => true, :catalog => @catalog
+    end
 
-    @catalog.expects(:apply).never # because we're not yielding
-    @agent.run
-  end
+    it "should benchmark how long it takes to apply the catalog" do
+      @agent.expects(:benchmark).with(:notice, "Finished catalog run")
 
-  it "should execute post-run hooks after the run" do
-    @agent.expects(:execute_postrun_command)
+      @agent.expects(:retrieve_catalog).returns @catalog
 
-    @agent.run
-  end
+      @catalog.expects(:apply).never # because we're not yielding
+      @agent.run
+    end
 
-  it "should send the report" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns(report)
-    @agent.expects(:send_report).with { |r, trans| r == report }
+    it "should execute post-run hooks after the run" do
+      @agent.expects(:execute_postrun_command)
 
-    @agent.run
-  end
+      @agent.run
+    end
 
-  it "should send the transaction report with a reference to the transaction if a run was actually made" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns(report)
+    it "should send the report" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
+      @agent.expects(:send_report).with(report)
 
-    trans = stub 'transaction'
-    @catalog.expects(:apply).returns trans
+      @agent.run
+    end
 
-    @agent.expects(:send_report).with { |r, t| t == trans }
+    it "should send the transaction report even if the catalog could not be retrieved" do
+      @agent.expects(:retrieve_catalog).returns nil
 
-    @agent.run :catalog => @catalog
-  end
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
+      @agent.expects(:send_report)
 
-  it "should send the transaction report even if the catalog could not be retrieved" do
-    @agent.expects(:retrieve_catalog).returns nil
+      @agent.run
+    end
 
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns(report)
-    @agent.expects(:send_report)
+    it "should send the transaction report even if there is a failure" do
+      @agent.expects(:retrieve_catalog).raises "whatever"
 
-    @agent.run
-  end
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
+      @agent.expects(:send_report)
 
-  it "should send the transaction report even if there is a failure" do
-    @agent.expects(:retrieve_catalog).raises "whatever"
+      @agent.run.should be_nil
+    end
 
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns(report)
-    @agent.expects(:send_report)
+    it "should remove the report as a log destination when the run is finished" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-    lambda { @agent.run }.should raise_error
-  end
+      Puppet::Util::Log.expects(:close).with(report)
 
-  it "should remove the report as a log destination when the run is finished" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns(report)
+      @agent.run
+    end
 
-    Puppet::Util::Log.expects(:close).with(report)
+    it "should return the report as the result of the run" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-    @agent.run
-  end
+      @agent.run.should equal(report)
+    end
 
-  it "should return the report as the result of the run" do
-    report = Puppet::Transaction::Report.new("apply")
-    Puppet::Transaction::Report.expects(:new).returns(report)
+    it "should send the transaction report even if the pre-run command fails" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-    @agent.run.should equal(report)
-  end
-end
+      Puppet.settings[:prerun_command] = "/my/command"
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
+      @agent.expects(:send_report)
 
-describe Puppet::Configurer, "when sending a report" do
-  include PuppetSpec::Files
+      @agent.run.should be_nil
+    end
 
-  before do
-    Puppet.settings.stubs(:use).returns(true)
-    @configurer = Puppet::Configurer.new
-    Puppet[:lastrunfile] = tmpfile('last_run_file')
+    it "should include the pre-run command failure in the report" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-    @report = Puppet::Transaction::Report.new("apply")
-    @trans = stub 'transaction'
-  end
+      Puppet.settings[:prerun_command] = "/my/command"
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
-  it "should finalize the report" do
-    @report.expects(:finalize_report)
-    @configurer.send_report(@report, @trans)
-  end
+      report.expects(:<<).with { |log| log.message.start_with?("Could not run command from prerun_command") }
 
-  it "should print a report summary if configured to do so" do
-    Puppet.settings[:summarize] = true
+      @agent.run.should be_nil
+    end
 
-    @report.expects(:summary).returns "stuff"
+    it "should send the transaction report even if the post-run command fails" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-    @configurer.expects(:puts).with("stuff")
-    @configurer.send_report(@report, nil)
-  end
+      Puppet.settings[:postrun_command] = "/my/command"
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
+      @agent.expects(:send_report)
 
-  it "should not print a report summary if not configured to do so" do
-    Puppet.settings[:summarize] = false
+      @agent.run.should be_nil
+    end
 
-    @configurer.expects(:puts).never
-    @configurer.send_report(@report, nil)
-  end
+    it "should include the post-run command failure in the report" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-  it "should save the report if reporting is enabled" do
-    Puppet.settings[:report] = true
+      Puppet.settings[:postrun_command] = "/my/command"
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
-    @report.expects(:save)
-    @configurer.send_report(@report, nil)
-  end
+      report.expects(:<<).with { |log| log.message.start_with?("Could not run command from postrun_command") }
 
-  it "should not save the report if reporting is disabled" do
-    Puppet.settings[:report] = false
+      @agent.run.should be_nil
+    end
 
-    @report.expects(:save).never
-    @configurer.send_report(@report, nil)
-  end
+    it "should execute post-run command even if the pre-run command fails" do
+      Puppet.settings[:prerun_command] = "/my/precommand"
+      Puppet.settings[:postrun_command] = "/my/postcommand"
+      Puppet::Util.expects(:execute).with(["/my/precommand"]).raises(Puppet::ExecutionFailure, "Failed")
+      Puppet::Util.expects(:execute).with(["/my/postcommand"])
 
-  it "should save the last run summary if reporting is enabled" do
-    Puppet.settings[:report] = true
+      @agent.run.should be_nil
+    end
 
-    @configurer.expects(:save_last_run_summary).with(@report)
-    @configurer.send_report(@report, nil)
-  end
+    it "should finalize the report" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-  it "should save the last run summary if reporting is disabled" do
-    Puppet.settings[:report] = false
+      report.expects(:finalize_report)
+      @agent.run
+    end
 
-    @configurer.expects(:save_last_run_summary).with(@report)
-    @configurer.send_report(@report, nil)
-  end
+    it "should not apply the catalog if the pre-run command fails" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-  it "should log but not fail if saving the report fails" do
-    Puppet.settings[:report] = true
+      Puppet.settings[:prerun_command] = "/my/command"
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
-    @report.expects(:save).raises "whatever"
+      @catalog.expects(:apply).never()
+      @agent.expects(:send_report)
 
-    Puppet.expects(:err)
-    lambda { @configurer.send_report(@report, nil) }.should_not raise_error
-  end
-end
+      @agent.run.should be_nil
+    end
 
-describe Puppet::Configurer, "when saving the summary report file" do
-  before do
-    Puppet.settings.stubs(:use).returns(true)
-    @configurer = Puppet::Configurer.new
+    it "should apply the catalog, send the report, and return nil if the post-run command fails" do
+      report = Puppet::Transaction::Report.new("apply")
+      Puppet::Transaction::Report.expects(:new).returns(report)
 
-    @report = stub 'report'
-    @trans = stub 'transaction'
-    @lastrunfd = stub 'lastrunfd'
-    Puppet::Util::FileLocking.stubs(:writelock).yields(@lastrunfd)
-  end
+      Puppet.settings[:postrun_command] = "/my/command"
+      Puppet::Util.expects(:execute).with(["/my/command"]).raises(Puppet::ExecutionFailure, "Failed")
 
-  it "should write the raw summary to the lastrunfile setting value" do
-    Puppet::Util::FileLocking.expects(:writelock).with(Puppet[:lastrunfile], 0660)
-    @configurer.save_last_run_summary(@report)
-  end
+      @catalog.expects(:apply)
+      @agent.expects(:send_report)
 
-  it "should write the raw summary as yaml" do
-    @report.expects(:raw_summary).returns("summary")
-    @lastrunfd.expects(:print).with(YAML.dump("summary"))
-    @configurer.save_last_run_summary(@report)
-  end
+      @agent.run.should be_nil
+    end
 
-  it "should log but not fail if saving the last run summary fails" do
-    Puppet::Util::FileLocking.expects(:writelock).raises "exception"
-    Puppet.expects(:err)
-    lambda { @configurer.save_last_run_summary(@report) }.should_not raise_error
+    describe "when not using a REST terminus for catalogs" do
+      it "should not pass any facts when retrieving the catalog" do
+        Puppet::Resource::Catalog.terminus_class = :compiler
+        @agent.expects(:facts_for_uploading).never
+        Puppet::Resource::Catalog.expects(:find).with { |name, options|
+          options[:facts].nil?
+        }.returns @catalog
+
+        @agent.run
+      end
+    end
+
+    describe "when using a REST terminus for catalogs" do
+      it "should pass the prepared facts and the facts format as arguments when retrieving the catalog" do
+        Puppet::Resource::Catalog.terminus_class = :rest
+        @agent.expects(:facts_for_uploading).returns(:facts => "myfacts", :facts_format => :foo)
+        Puppet::Resource::Catalog.expects(:find).with { |name, options|
+          options[:facts] == "myfacts" and options[:facts_format] == :foo
+        }.returns @catalog
+
+        @agent.run
+      end
+    end
   end
 
-end
+  describe "when sending a report" do
+    include PuppetSpec::Files
 
-describe Puppet::Configurer, "when retrieving a catalog" do
-  before do
-    Puppet.settings.stubs(:use).returns(true)
-    @agent = Puppet::Configurer.new
-    @agent.stubs(:facts_for_uploading).returns({})
+    before do
+      Puppet.settings.stubs(:use).returns(true)
+      @configurer = Puppet::Configurer.new
+      Puppet[:lastrunfile] = tmpfile('last_run_file')
 
-    @catalog = Puppet::Resource::Catalog.new
+      @report = Puppet::Transaction::Report.new("apply")
+    end
 
-    # this is the default when using a Configurer instance
-    Puppet::Resource::Catalog.indirection.stubs(:terminus_class).returns :rest
+    it "should print a report summary if configured to do so" do
+      Puppet.settings[:summarize] = true
 
-    @agent.stubs(:convert_catalog).returns @catalog
-  end
+      @report.expects(:summary).returns "stuff"
 
-  describe "and configured to only retrieve a catalog from the cache" do
-    before do
-      Puppet.settings[:use_cached_catalog] = true
+      @configurer.expects(:puts).with("stuff")
+      @configurer.send_report(@report)
     end
 
-    it "should first look in the cache for a catalog" do
-      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns @catalog
-      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.never
+    it "should not print a report summary if not configured to do so" do
+      Puppet.settings[:summarize] = false
 
-      @agent.retrieve_catalog.should == @catalog
+      @configurer.expects(:puts).never
+      @configurer.send_report(@report)
     end
 
-    it "should compile a new catalog if none is found in the cache" do
-      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns nil
-      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns @catalog
+    it "should save the report if reporting is enabled" do
+      Puppet.settings[:report] = true
 
-      @agent.retrieve_catalog.should == @catalog
+      @report.expects(:save)
+      @configurer.send_report(@report)
     end
-  end
 
-  describe "when not using a REST terminus for catalogs" do
-    it "should not pass any facts when retrieving the catalog" do
-      @agent.expects(:facts_for_uploading).never
-      Puppet::Resource::Catalog.expects(:find).with { |name, options|
-        options[:facts].nil?
-      }.returns @catalog
+    it "should not save the report if reporting is disabled" do
+      Puppet.settings[:report] = false
 
-      @agent.retrieve_catalog
+      @report.expects(:save).never
+      @configurer.send_report(@report)
     end
-  end
 
-  describe "when using a REST terminus for catalogs" do
-    it "should pass the prepared facts and the facts format as arguments when retrieving the catalog" do
-      @agent.expects(:facts_for_uploading).returns(:facts => "myfacts", :facts_format => :foo)
-      Puppet::Resource::Catalog.expects(:find).with { |name, options|
-        options[:facts] == "myfacts" and options[:facts_format] == :foo
-      }.returns @catalog
+    it "should save the last run summary if reporting is enabled" do
+      Puppet.settings[:report] = true
 
-      @agent.retrieve_catalog
+      @configurer.expects(:save_last_run_summary).with(@report)
+      @configurer.send_report(@report)
     end
-  end
 
-  it "should use the Catalog class to get its catalog" do
-    Puppet::Resource::Catalog.expects(:find).returns @catalog
+    it "should save the last run summary if reporting is disabled" do
+      Puppet.settings[:report] = false
 
-    @agent.retrieve_catalog
-  end
+      @configurer.expects(:save_last_run_summary).with(@report)
+      @configurer.send_report(@report)
+    end
 
-  it "should use its certname to retrieve the catalog" do
-    Facter.stubs(:value).returns "eh"
-    Puppet.settings[:certname] = "myhost.domain.com"
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| name == "myhost.domain.com" }.returns @catalog
+    it "should log but not fail if saving the report fails" do
+      Puppet.settings[:report] = true
 
-    @agent.retrieve_catalog
+      @report.expects(:save).raises "whatever"
+
+      Puppet.expects(:err)
+      lambda { @configurer.send_report(@report) }.should_not raise_error
+    end
   end
 
-  it "should default to returning a catalog retrieved directly from the server, skipping the cache" do
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns @catalog
+  describe "when saving the summary report file" do
+    before do
+      Puppet.settings.stubs(:use).returns(true)
+      @configurer = Puppet::Configurer.new
 
-    @agent.retrieve_catalog.should == @catalog
-  end
+      @report = stub 'report'
+      @trans = stub 'transaction'
+      @lastrunfd = stub 'lastrunfd'
+      Puppet::Util::FileLocking.stubs(:writelock).yields(@lastrunfd)
+    end
 
-  it "should log and return the cached catalog when no catalog can be retrieved from the server" do
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns nil
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns @catalog
+    it "should write the raw summary to the lastrunfile setting value" do
+      Puppet::Util::FileLocking.expects(:writelock).with(Puppet[:lastrunfile], 0660)
+      @configurer.save_last_run_summary(@report)
+    end
 
-    Puppet.expects(:notice)
+    it "should write the raw summary as yaml" do
+      @report.expects(:raw_summary).returns("summary")
+      @lastrunfd.expects(:print).with(YAML.dump("summary"))
+      @configurer.save_last_run_summary(@report)
+    end
+
+    it "should log but not fail if saving the last run summary fails" do
+      Puppet::Util::FileLocking.expects(:writelock).raises "exception"
+      Puppet.expects(:err)
+      lambda { @configurer.save_last_run_summary(@report) }.should_not raise_error
+    end
 
-    @agent.retrieve_catalog.should == @catalog
   end
 
-  it "should not look in the cache for a catalog if one is returned from the server" do
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns @catalog
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.never
+  describe "when retrieving a catalog" do
+    before do
+      Puppet.settings.stubs(:use).returns(true)
+      @agent.stubs(:facts_for_uploading).returns({})
 
-    @agent.retrieve_catalog.should == @catalog
-  end
+      @catalog = Puppet::Resource::Catalog.new
 
-  it "should return the cached catalog when retrieving the remote catalog throws an exception" do
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.raises "eh"
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns @catalog
+      # this is the default when using a Configurer instance
+      Puppet::Resource::Catalog.indirection.stubs(:terminus_class).returns :rest
 
-    @agent.retrieve_catalog.should == @catalog
-  end
+      @agent.stubs(:convert_catalog).returns @catalog
+    end
 
-  it "should log and return nil if no catalog can be retrieved from the server and :usecacheonfailure is disabled" do
-    Puppet.stubs(:[])
-    Puppet.expects(:[]).with(:usecacheonfailure).returns false
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns nil
+    describe "and configured to only retrieve a catalog from the cache" do
+      before do
+        Puppet.settings[:use_cached_catalog] = true
+      end
 
-    Puppet.expects(:warning)
+      it "should first look in the cache for a catalog" do
+        Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns @catalog
+        Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.never
 
-    @agent.retrieve_catalog.should be_nil
-  end
+        @agent.retrieve_catalog({}).should == @catalog
+      end
 
-  it "should return nil if no cached catalog is available and no catalog can be retrieved from the server" do
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns nil
-    Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns nil
+      it "should compile a new catalog if none is found in the cache" do
+        Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns nil
+        Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns @catalog
 
-    @agent.retrieve_catalog.should be_nil
-  end
+        @agent.retrieve_catalog({}).should == @catalog
+      end
+    end
 
-  it "should convert the catalog before returning" do
-    Puppet::Resource::Catalog.stubs(:find).returns @catalog
+    it "should use the Catalog class to get its catalog" do
+      Puppet::Resource::Catalog.expects(:find).returns @catalog
 
-    @agent.expects(:convert_catalog).with { |cat, dur| cat == @catalog }.returns "converted catalog"
-    @agent.retrieve_catalog.should == "converted catalog"
-  end
+      @agent.retrieve_catalog({})
+    end
 
-  it "should return nil if there is an error while retrieving the catalog" do
-    Puppet::Resource::Catalog.expects(:find).at_least_once.raises "eh"
+    it "should use its node_name_value to retrieve the catalog" do
+      Facter.stubs(:value).returns "eh"
+      Puppet.settings[:node_name_value] = "myhost.domain.com"
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| name == "myhost.domain.com" }.returns @catalog
 
-    @agent.retrieve_catalog.should be_nil
-  end
-end
+      @agent.retrieve_catalog({})
+    end
 
-describe Puppet::Configurer, "when converting the catalog" do
-  before do
-    Puppet.settings.stubs(:use).returns(true)
-    @agent = Puppet::Configurer.new
+    it "should default to returning a catalog retrieved directly from the server, skipping the cache" do
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns @catalog
 
-    @catalog = Puppet::Resource::Catalog.new
-    @oldcatalog = stub 'old_catalog', :to_ral => @catalog
-  end
+      @agent.retrieve_catalog({}).should == @catalog
+    end
 
-  it "should convert the catalog to a RAL-formed catalog" do
-    @oldcatalog.expects(:to_ral).returns @catalog
+    it "should log and return the cached catalog when no catalog can be retrieved from the server" do
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns nil
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns @catalog
 
-    @agent.convert_catalog(@oldcatalog, 10).should equal(@catalog)
-  end
+      Puppet.expects(:notice)
 
-  it "should finalize the catalog" do
-    @catalog.expects(:finalize)
+      @agent.retrieve_catalog({}).should == @catalog
+    end
 
-    @agent.convert_catalog(@oldcatalog, 10)
-  end
+    it "should not look in the cache for a catalog if one is returned from the server" do
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns @catalog
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.never
 
-  it "should record the passed retrieval time with the RAL catalog" do
-    @catalog.expects(:retrieval_duration=).with 10
+      @agent.retrieve_catalog({}).should == @catalog
+    end
 
-    @agent.convert_catalog(@oldcatalog, 10)
-  end
+    it "should return the cached catalog when retrieving the remote catalog throws an exception" do
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.raises "eh"
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns @catalog
 
-  it "should write the RAL catalog's class file" do
-    @catalog.expects(:write_class_file)
+      @agent.retrieve_catalog({}).should == @catalog
+    end
 
-    @agent.convert_catalog(@oldcatalog, 10)
-  end
-end
+    it "should log and return nil if no catalog can be retrieved from the server and :usecacheonfailure is disabled" do
+      Puppet.stubs(:[])
+      Puppet.expects(:[]).with(:usecacheonfailure).returns false
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns nil
 
-describe Puppet::Configurer, "when preparing for a run" do
-  before do
-    Puppet.settings.stubs(:use).returns(true)
-    @agent = Puppet::Configurer.new
-    @agent.stubs(:dostorage)
-    @agent.stubs(:download_fact_plugins)
-    @agent.stubs(:download_plugins)
-    @agent.stubs(:execute_prerun_command)
-    @facts = {"one" => "two", "three" => "four"}
-  end
+      Puppet.expects(:warning)
 
-  it "should initialize the metadata store" do
-    @agent.class.stubs(:facts).returns(@facts)
-    @agent.expects(:dostorage)
-    @agent.prepare({})
-  end
+      @agent.retrieve_catalog({}).should be_nil
+    end
 
-  it "should download fact plugins" do
-    @agent.expects(:download_fact_plugins)
+    it "should return nil if no cached catalog is available and no catalog can be retrieved from the server" do
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_cache] == true }.returns nil
+      Puppet::Resource::Catalog.expects(:find).with { |name, options| options[:ignore_terminus] == true }.returns nil
 
-    @agent.prepare({})
+      @agent.retrieve_catalog({}).should be_nil
+    end
+
+    it "should convert the catalog before returning" do
+      Puppet::Resource::Catalog.stubs(:find).returns @catalog
+
+      @agent.expects(:convert_catalog).with { |cat, dur| cat == @catalog }.returns "converted catalog"
+      @agent.retrieve_catalog({}).should == "converted catalog"
+    end
+
+    it "should return nil if there is an error while retrieving the catalog" do
+      Puppet::Resource::Catalog.expects(:find).at_least_once.raises "eh"
+
+      @agent.retrieve_catalog({}).should be_nil
+    end
   end
 
-  it "should download plugins" do
-    @agent.expects(:download_plugins)
+  describe "when converting the catalog" do
+    before do
+      Puppet.settings.stubs(:use).returns(true)
+
+      @catalog = Puppet::Resource::Catalog.new
+      @oldcatalog = stub 'old_catalog', :to_ral => @catalog
+    end
+
+    it "should convert the catalog to a RAL-formed catalog" do
+      @oldcatalog.expects(:to_ral).returns @catalog
+
+      @agent.convert_catalog(@oldcatalog, 10).should equal(@catalog)
+    end
+
+    it "should finalize the catalog" do
+      @catalog.expects(:finalize)
+
+      @agent.convert_catalog(@oldcatalog, 10)
+    end
 
-    @agent.prepare({})
+    it "should record the passed retrieval time with the RAL catalog" do
+      @catalog.expects(:retrieval_duration=).with 10
+
+      @agent.convert_catalog(@oldcatalog, 10)
+    end
+
+    it "should write the RAL catalog's class file" do
+      @catalog.expects(:write_class_file)
+
+      @agent.convert_catalog(@oldcatalog, 10)
+    end
   end
 
-  it "should perform the pre-run commands" do
-    @agent.expects(:execute_prerun_command)
-    @agent.prepare({})
+  describe "when preparing for a run" do
+    before do
+      Puppet.settings.stubs(:use).returns(true)
+      @agent.stubs(:dostorage)
+      @agent.stubs(:download_fact_plugins)
+      @agent.stubs(:download_plugins)
+      @facts = {"one" => "two", "three" => "four"}
+    end
+
+    it "should initialize the metadata store" do
+      @agent.class.stubs(:facts).returns(@facts)
+      @agent.expects(:dostorage)
+      @agent.prepare({})
+    end
+
+    it "should download fact plugins" do
+      @agent.expects(:download_fact_plugins)
+
+      @agent.prepare({})
+    end
+
+    it "should download plugins" do
+      @agent.expects(:download_plugins)
+
+      @agent.prepare({})
+    end
   end
 end