chef 14.13.11-universal-mingw32 → 14.14.14-universal-mingw32

data/lib/chef/provider/dsc_resource.rb

@@ -1,209 +1,209 @@
-#
-# Author:: Adam Edwards (<adamed@chef.io>)
-#
-# Copyright:: Copyright 2014-2017, Chef Software Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-require "chef/util/powershell/cmdlet"
-require "chef/util/dsc/local_configuration_manager"
-require "chef/mixin/powershell_type_coercions"
-require "chef/util/dsc/resource_store"
-
-class Chef
-  class Provider
-    class DscResource < Chef::Provider
-      include Chef::Mixin::PowershellTypeCoercions
-      provides :dsc_resource
-      def initialize(new_resource, run_context)
-        super
-        @new_resource = new_resource
-        @module_name = new_resource.module_name
-        @module_version = new_resource.module_version
-        @reboot_resource = nil
-      end
-
-      def action_run
-        if ! test_resource
-          converge_by(generate_description) do
-            result = set_resource
-            reboot_if_required
-          end
-        end
-      end
-
-      def load_current_resource
-      end
-
-      def define_resource_requirements
-        requirements.assert(:run) do |a|
-          a.assertion { supports_dsc_invoke_resource? }
-          err = ["You must have PowerShell version >= 5.0.10018.0 to use dsc_resource."]
-          a.failure_message Chef::Exceptions::ProviderNotFound,
-            err
-          a.whyrun err + ["Assuming a previous resource installs PowerShell 5.0.10018.0 or higher."]
-          a.block_action!
-        end
-        requirements.assert(:run) do |a|
-          a.assertion { supports_refresh_mode_enabled? || dsc_refresh_mode_disabled? }
-          err = ["The LCM must have its RefreshMode set to Disabled for" \
-                 " PowerShell versions before 5.0.10586.0."]
-          a.failure_message Chef::Exceptions::ProviderNotFound, err.join(" ")
-          a.whyrun err + ["Assuming a previous resource sets the RefreshMode."]
-          a.block_action!
-        end
-        requirements.assert(:run) do |a|
-          a.assertion { module_usage_valid? }
-          err = ["module_name must be supplied along with module_version."]
-          a.failure_message Chef::Exceptions::DSCModuleNameMissing,
-            err
-          a.block_action!
-        end
-      end
-
-      protected
-
-      def local_configuration_manager
-        @local_configuration_manager ||= Chef::Util::DSC::LocalConfigurationManager.new(
-          node,
-          nil
-        )
-      end
-
-      def resource_store
-        Chef::Util::DSC::ResourceStore.instance
-      end
-
-      def supports_dsc_invoke_resource?
-        run_context && Chef::Platform.supports_dsc_invoke_resource?(node)
-      end
-
-      def dsc_refresh_mode_disabled?
-        Chef::Platform.dsc_refresh_mode_disabled?(node)
-      end
-
-      def supports_refresh_mode_enabled?
-        Chef::Platform.supports_refresh_mode_enabled?(node)
-      end
-
-      def module_usage_valid?
-        !(!@module_name && @module_version)
-      end
-
-      def generate_description
-        @converge_description
-      end
-
-      def dsc_resource_name
-        new_resource.resource.to_s
-      end
-
-      def module_name
-        @module_name ||= begin
-          found = resource_store.find(dsc_resource_name)
-          r = case found.length
-              when 0
-                raise Chef::Exceptions::ResourceNotFound,
-                  "Could not find #{dsc_resource_name}. Check to make "\
-                  "sure that it shows up when running Get-DscResource"
-              when 1
-                if found[0]["Module"].nil?
-                  "PSDesiredStateConfiguration" # default DSC module
-                else
-                  found[0]["Module"]["Name"]
-                end
-              else
-                raise Chef::Exceptions::MultipleDscResourcesFound, found
-              end
-        end
-      end
-
-      def test_resource
-        result = invoke_resource(:test)
-        add_dsc_verbose_log(result)
-        return_dsc_resource_result(result, "InDesiredState")
-      end
-
-      def set_resource
-        result = invoke_resource(:set)
-        add_dsc_verbose_log(result)
-        create_reboot_resource if return_dsc_resource_result(result, "RebootRequired")
-        result.return_value
-      end
-
-      def add_dsc_verbose_log(result)
-        # We really want this information from the verbose stream,
-        # however in some versions of WMF, Invoke-DscResource is not correctly
-        # writing to that stream and instead just dumping to stdout
-        verbose_output = result.stream(:verbose)
-        verbose_output = result.stdout if verbose_output.empty?
-
-        if @converge_description.nil? || @converge_description.empty?
-          @converge_description = verbose_output
-        else
-          @converge_description << "\n"
-          @converge_description << verbose_output
-        end
-      end
-
-      def module_info_object
-        @module_version.nil? ? module_name : "@{ModuleName='#{module_name}';ModuleVersion='#{@module_version}'}"
-      end
-
-      def invoke_resource(method, output_format = :object)
-        properties = translate_type(new_resource.properties)
-        switches = "-Method #{method} -Name #{new_resource.resource}"\
-                   " -Property #{properties} -Module #{module_info_object} -Verbose"
-        cmdlet = Chef::Util::Powershell::Cmdlet.new(
-          node,
-          "Invoke-DscResource #{switches}",
-          output_format
-        )
-        cmdlet.run!({}, { timeout: new_resource.timeout })
-      end
-
-      def return_dsc_resource_result(result, property_name)
-        if result.return_value.is_a?(Array)
-          # WMF Feb 2015 Preview
-          result.return_value[0][property_name]
-        else
-          # WMF April 2015 Preview
-          result.return_value[property_name]
-        end
-      end
-
-      def create_reboot_resource
-        @reboot_resource = Chef::Resource::Reboot.new(
-          "Reboot for #{new_resource.name}",
-          run_context
-        ).tap do |r|
-          r.reason("Reboot for #{new_resource.resource}.")
-        end
-      end
-
-      def reboot_if_required
-        reboot_action = new_resource.reboot_action
-        unless @reboot_resource.nil?
-          case reboot_action
-          when :nothing
-            logger.trace("A reboot was requested by the DSC resource, but reboot_action is :nothing.")
-            logger.trace("This dsc_resource will not reboot the node.")
-          else
-            logger.trace("Requesting node reboot with #{reboot_action}.")
-            @reboot_resource.run_action(reboot_action)
-          end
-        end
-      end
-    end
-  end
-end
+#
+# Author:: Adam Edwards (<adamed@chef.io>)
+#
+# Copyright:: Copyright 2014-2017, Chef Software Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+require "chef/util/powershell/cmdlet"
+require "chef/util/dsc/local_configuration_manager"
+require "chef/mixin/powershell_type_coercions"
+require "chef/util/dsc/resource_store"
+
+class Chef
+  class Provider
+    class DscResource < Chef::Provider
+      include Chef::Mixin::PowershellTypeCoercions
+      provides :dsc_resource
+      def initialize(new_resource, run_context)
+        super
+        @new_resource = new_resource
+        @module_name = new_resource.module_name
+        @module_version = new_resource.module_version
+        @reboot_resource = nil
+      end
+
+      def action_run
+        if ! test_resource
+          converge_by(generate_description) do
+            result = set_resource
+            reboot_if_required
+          end
+        end
+      end
+
+      def load_current_resource
+      end
+
+      def define_resource_requirements
+        requirements.assert(:run) do |a|
+          a.assertion { supports_dsc_invoke_resource? }
+          err = ["You must have PowerShell version >= 5.0.10018.0 to use dsc_resource."]
+          a.failure_message Chef::Exceptions::ProviderNotFound,
+            err
+          a.whyrun err + ["Assuming a previous resource installs PowerShell 5.0.10018.0 or higher."]
+          a.block_action!
+        end
+        requirements.assert(:run) do |a|
+          a.assertion { supports_refresh_mode_enabled? || dsc_refresh_mode_disabled? }
+          err = ["The LCM must have its RefreshMode set to Disabled for" \
+                 " PowerShell versions before 5.0.10586.0."]
+          a.failure_message Chef::Exceptions::ProviderNotFound, err.join(" ")
+          a.whyrun err + ["Assuming a previous resource sets the RefreshMode."]
+          a.block_action!
+        end
+        requirements.assert(:run) do |a|
+          a.assertion { module_usage_valid? }
+          err = ["module_name must be supplied along with module_version."]
+          a.failure_message Chef::Exceptions::DSCModuleNameMissing,
+            err
+          a.block_action!
+        end
+      end
+
+      protected
+
+      def local_configuration_manager
+        @local_configuration_manager ||= Chef::Util::DSC::LocalConfigurationManager.new(
+          node,
+          nil
+        )
+      end
+
+      def resource_store
+        Chef::Util::DSC::ResourceStore.instance
+      end
+
+      def supports_dsc_invoke_resource?
+        run_context && Chef::Platform.supports_dsc_invoke_resource?(node)
+      end
+
+      def dsc_refresh_mode_disabled?
+        Chef::Platform.dsc_refresh_mode_disabled?(node)
+      end
+
+      def supports_refresh_mode_enabled?
+        Chef::Platform.supports_refresh_mode_enabled?(node)
+      end
+
+      def module_usage_valid?
+        !(!@module_name && @module_version)
+      end
+
+      def generate_description
+        @converge_description
+      end
+
+      def dsc_resource_name
+        new_resource.resource.to_s
+      end
+
+      def module_name
+        @module_name ||= begin
+          found = resource_store.find(dsc_resource_name)
+          r = case found.length
+              when 0
+                raise Chef::Exceptions::ResourceNotFound,
+                  "Could not find #{dsc_resource_name}. Check to make "\
+                  "sure that it shows up when running Get-DscResource"
+              when 1
+                if found[0]["Module"].nil?
+                  "PSDesiredStateConfiguration" # default DSC module
+                else
+                  found[0]["Module"]["Name"]
+                end
+              else
+                raise Chef::Exceptions::MultipleDscResourcesFound, found
+              end
+        end
+      end
+
+      def test_resource
+        result = invoke_resource(:test)
+        add_dsc_verbose_log(result)
+        return_dsc_resource_result(result, "InDesiredState")
+      end
+
+      def set_resource
+        result = invoke_resource(:set)
+        add_dsc_verbose_log(result)
+        create_reboot_resource if return_dsc_resource_result(result, "RebootRequired")
+        result.return_value
+      end
+
+      def add_dsc_verbose_log(result)
+        # We really want this information from the verbose stream,
+        # however in some versions of WMF, Invoke-DscResource is not correctly
+        # writing to that stream and instead just dumping to stdout
+        verbose_output = result.stream(:verbose)
+        verbose_output = result.stdout if verbose_output.empty?
+
+        if @converge_description.nil? || @converge_description.empty?
+          @converge_description = verbose_output
+        else
+          @converge_description << "\n"
+          @converge_description << verbose_output
+        end
+      end
+
+      def module_info_object
+        @module_version.nil? ? module_name : "@{ModuleName='#{module_name}';ModuleVersion='#{@module_version}'}"
+      end
+
+      def invoke_resource(method, output_format = :object)
+        properties = translate_type(new_resource.properties)
+        switches = "-Method #{method} -Name #{new_resource.resource}"\
+                   " -Property #{properties} -Module #{module_info_object} -Verbose"
+        cmdlet = Chef::Util::Powershell::Cmdlet.new(
+          node,
+          "Invoke-DscResource #{switches}",
+          output_format
+        )
+        cmdlet.run!({}, { timeout: new_resource.timeout })
+      end
+
+      def return_dsc_resource_result(result, property_name)
+        if result.return_value.is_a?(Array)
+          # WMF Feb 2015 Preview
+          result.return_value[0][property_name]
+        else
+          # WMF April 2015 Preview
+          result.return_value[property_name]
+        end
+      end
+
+      def create_reboot_resource
+        @reboot_resource = Chef::Resource::Reboot.new(
+          "Reboot for #{new_resource.name}",
+          run_context
+        ).tap do |r|
+          r.reason("Reboot for #{new_resource.resource}.")
+        end
+      end
+
+      def reboot_if_required
+        reboot_action = new_resource.reboot_action
+        unless @reboot_resource.nil?
+          case reboot_action
+          when :nothing
+            logger.trace("A reboot was requested by the DSC resource, but reboot_action is :nothing.")
+            logger.trace("This dsc_resource will not reboot the node.")
+          else
+            logger.trace("Requesting node reboot with #{reboot_action}.")
+            @reboot_resource.run_action(reboot_action)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/chef/provider/dsc_script.rb

@@ -1,185 +1,185 @@
-#
-# Author:: Adam Edwards (<adamed@chef.io>)
-#
-# Copyright:: Copyright 2014-2017, Chef Software Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-
-require "chef/util/powershell/cmdlet"
-require "chef/util/dsc/configuration_generator"
-require "chef/util/dsc/local_configuration_manager"
-require "chef/util/path_helper"
-
-class Chef
-  class Provider
-    class DscScript < Chef::Provider
-
-      provides :dsc_script
-
-      def initialize(dsc_resource, run_context)
-        super(dsc_resource, run_context)
-        @dsc_resource = dsc_resource
-        @resource_converged = false
-        @operations = {
-          set: Proc.new do |config_manager, document, shellout_flags|
-            config_manager.set_configuration(document, shellout_flags)
-          end,
-          test: Proc.new do |config_manager, document, shellout_flags|
-            config_manager.test_configuration(document, shellout_flags)
-          end }
-      end
-
-      def action_run
-        if ! @resource_converged
-          converge_by(generate_description) do
-            run_configuration(:set)
-            logger.info("DSC resource configuration completed successfully")
-          end
-        end
-      end
-
-      def load_current_resource
-        if supports_dsc?
-          @dsc_resources_info = run_configuration(:test)
-          @resource_converged = @dsc_resources_info.all? do |resource|
-            !resource.changes_state?
-          end
-        end
-      end
-
-      def define_resource_requirements
-        requirements.assert(:run) do |a|
-          err = [
-            "Could not find PowerShell DSC support on the system",
-            powershell_info_str,
-            "PowerShell 4.0 or higher was not detected on your system and is required to use the dsc_script resource.",
-          ]
-          a.assertion { supports_dsc? }
-          a.failure_message Chef::Exceptions::ProviderNotFound, err.join(" ")
-          a.whyrun err + ["Assuming a previous resource installs PowerShell 4.0 or higher."]
-          a.block_action!
-        end
-      end
-
-      protected
-
-      def supports_dsc?
-        run_context && Chef::Platform.supports_dsc?(node)
-      end
-
-      def run_configuration(operation)
-        config_directory = ::Dir.mktmpdir("chef-dsc-script")
-        configuration_data_path = get_configuration_data_path(config_directory)
-        configuration_flags = get_augmented_configuration_flags(configuration_data_path)
-
-        config_manager = Chef::Util::DSC::LocalConfigurationManager.new(@run_context.node, config_directory)
-
-        shellout_flags = {
-          cwd: @dsc_resource.cwd,
-          environment: @dsc_resource.environment,
-          timeout: @dsc_resource.timeout,
-        }
-
-        begin
-          configuration_document = generate_configuration_document(config_directory, configuration_flags)
-          @operations[operation].call(config_manager, configuration_document, shellout_flags)
-        rescue Exception => e
-          logger.error("DSC operation failed: #{e.message}")
-          raise e
-        ensure
-          ::FileUtils.rm_rf(config_directory)
-        end
-      end
-
-      def get_augmented_configuration_flags(configuration_data_path)
-        updated_flags = @dsc_resource.flags.nil? ? {} : @dsc_resource.flags.dup
-        if configuration_data_path
-          Chef::Util::PathHelper.validate_path(configuration_data_path)
-          updated_flags[:configurationdata] = configuration_data_path
-        end
-        updated_flags
-      end
-
-      def generate_configuration_document(config_directory, configuration_flags)
-        shellout_flags = {
-          cwd: @dsc_resource.cwd,
-          environment: @dsc_resource.environment,
-          timeout: @dsc_resource.timeout,
-        }
-
-        generator = Chef::Util::DSC::ConfigurationGenerator.new(@run_context.node, config_directory)
-
-        if @dsc_resource.command
-          generator.configuration_document_from_script_path(@dsc_resource.command, configuration_name, configuration_flags, shellout_flags)
-        else
-          # If code is also not provided, we mimic what the other script resources do (execute nothing)
-          logger.warn("Neither code or command were provided for dsc_resource[#{@dsc_resource.name}].") unless @dsc_resource.code
-          generator.configuration_document_from_script_code(@dsc_resource.code || "", configuration_flags, @dsc_resource.imports, shellout_flags)
-        end
-      end
-
-      def get_configuration_data_path(config_directory)
-        if @dsc_resource.configuration_data_script
-          @dsc_resource.configuration_data_script
-        elsif @dsc_resource.configuration_data
-          configuration_data_path = "#{config_directory}/chef_dsc_config_data.psd1"
-          ::File.open(configuration_data_path, "wt") do |script|
-            script.write(@dsc_resource.configuration_data)
-          end
-          configuration_data_path
-        end
-      end
-
-      def configuration_name
-        @dsc_resource.configuration_name || @dsc_resource.name
-      end
-
-      def configuration_friendly_name
-        if @dsc_resource.code
-          @dsc_resource.name
-        else
-          configuration_name
-        end
-      end
-
-      private
-
-      def generate_description
-        ["converge DSC configuration '#{configuration_friendly_name}'"] +
-          @dsc_resources_info.map do |resource|
-            if resource.changes_state?
-              # We ignore the last log message because it only contains the time it took, which looks weird
-              cleaned_messages = resource.change_log[0..-2].map { |c| c.sub(/^#{Regexp.escape(resource.name)}/, "").strip }
-              unless cleaned_messages.empty?
-                "converge DSC resource #{resource.name} by #{cleaned_messages.find_all { |c| c != '' }.join("\n")}"
-              else
-                "converge DSC resource #{resource.name}"
-              end
-            else
-              # This is needed because a dsc script can have resources that are both converged and not
-              "converge DSC resource #{resource.name} by doing nothing because it is already converged"
-            end
-          end
-      end
-
-      def powershell_info_str
-        if run_context && run_context.node[:languages] && run_context.node[:languages][:powershell]
-          install_info = "PowerShell #{run_context.node[:languages][:powershell][:version]} was found on the system."
-        else
-          install_info = "PowerShell was not found."
-        end
-      end
-    end
-  end
-end
+#
+# Author:: Adam Edwards (<adamed@chef.io>)
+#
+# Copyright:: Copyright 2014-2017, Chef Software Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require "chef/util/powershell/cmdlet"
+require "chef/util/dsc/configuration_generator"
+require "chef/util/dsc/local_configuration_manager"
+require "chef/util/path_helper"
+
+class Chef
+  class Provider
+    class DscScript < Chef::Provider
+
+      provides :dsc_script
+
+      def initialize(dsc_resource, run_context)
+        super(dsc_resource, run_context)
+        @dsc_resource = dsc_resource
+        @resource_converged = false
+        @operations = {
+          set: Proc.new do |config_manager, document, shellout_flags|
+            config_manager.set_configuration(document, shellout_flags)
+          end,
+          test: Proc.new do |config_manager, document, shellout_flags|
+            config_manager.test_configuration(document, shellout_flags)
+          end }
+      end
+
+      def action_run
+        if ! @resource_converged
+          converge_by(generate_description) do
+            run_configuration(:set)
+            logger.info("DSC resource configuration completed successfully")
+          end
+        end
+      end
+
+      def load_current_resource
+        if supports_dsc?
+          @dsc_resources_info = run_configuration(:test)
+          @resource_converged = @dsc_resources_info.all? do |resource|
+            !resource.changes_state?
+          end
+        end
+      end
+
+      def define_resource_requirements
+        requirements.assert(:run) do |a|
+          err = [
+            "Could not find PowerShell DSC support on the system",
+            powershell_info_str,
+            "PowerShell 4.0 or higher was not detected on your system and is required to use the dsc_script resource.",
+          ]
+          a.assertion { supports_dsc? }
+          a.failure_message Chef::Exceptions::ProviderNotFound, err.join(" ")
+          a.whyrun err + ["Assuming a previous resource installs PowerShell 4.0 or higher."]
+          a.block_action!
+        end
+      end
+
+      protected
+
+      def supports_dsc?
+        run_context && Chef::Platform.supports_dsc?(node)
+      end
+
+      def run_configuration(operation)
+        config_directory = ::Dir.mktmpdir("chef-dsc-script")
+        configuration_data_path = get_configuration_data_path(config_directory)
+        configuration_flags = get_augmented_configuration_flags(configuration_data_path)
+
+        config_manager = Chef::Util::DSC::LocalConfigurationManager.new(@run_context.node, config_directory)
+
+        shellout_flags = {
+          cwd: @dsc_resource.cwd,
+          environment: @dsc_resource.environment,
+          timeout: @dsc_resource.timeout,
+        }
+
+        begin
+          configuration_document = generate_configuration_document(config_directory, configuration_flags)
+          @operations[operation].call(config_manager, configuration_document, shellout_flags)
+        rescue Exception => e
+          logger.error("DSC operation failed: #{e.message}")
+          raise e
+        ensure
+          ::FileUtils.rm_rf(config_directory)
+        end
+      end
+
+      def get_augmented_configuration_flags(configuration_data_path)
+        updated_flags = @dsc_resource.flags.nil? ? {} : @dsc_resource.flags.dup
+        if configuration_data_path
+          Chef::Util::PathHelper.validate_path(configuration_data_path)
+          updated_flags[:configurationdata] = configuration_data_path
+        end
+        updated_flags
+      end
+
+      def generate_configuration_document(config_directory, configuration_flags)
+        shellout_flags = {
+          cwd: @dsc_resource.cwd,
+          environment: @dsc_resource.environment,
+          timeout: @dsc_resource.timeout,
+        }
+
+        generator = Chef::Util::DSC::ConfigurationGenerator.new(@run_context.node, config_directory)
+
+        if @dsc_resource.command
+          generator.configuration_document_from_script_path(@dsc_resource.command, configuration_name, configuration_flags, shellout_flags)
+        else
+          # If code is also not provided, we mimic what the other script resources do (execute nothing)
+          logger.warn("Neither code or command were provided for dsc_resource[#{@dsc_resource.name}].") unless @dsc_resource.code
+          generator.configuration_document_from_script_code(@dsc_resource.code || "", configuration_flags, @dsc_resource.imports, shellout_flags)
+        end
+      end
+
+      def get_configuration_data_path(config_directory)
+        if @dsc_resource.configuration_data_script
+          @dsc_resource.configuration_data_script
+        elsif @dsc_resource.configuration_data
+          configuration_data_path = "#{config_directory}/chef_dsc_config_data.psd1"
+          ::File.open(configuration_data_path, "wt") do |script|
+            script.write(@dsc_resource.configuration_data)
+          end
+          configuration_data_path
+        end
+      end
+
+      def configuration_name
+        @dsc_resource.configuration_name || @dsc_resource.name
+      end
+
+      def configuration_friendly_name
+        if @dsc_resource.code
+          @dsc_resource.name
+        else
+          configuration_name
+        end
+      end
+
+      private
+
+      def generate_description
+        ["converge DSC configuration '#{configuration_friendly_name}'"] +
+          @dsc_resources_info.map do |resource|
+            if resource.changes_state?
+              # We ignore the last log message because it only contains the time it took, which looks weird
+              cleaned_messages = resource.change_log[0..-2].map { |c| c.sub(/^#{Regexp.escape(resource.name)}/, "").strip }
+              unless cleaned_messages.empty?
+                "converge DSC resource #{resource.name} by #{cleaned_messages.find_all { |c| c != '' }.join("\n")}"
+              else
+                "converge DSC resource #{resource.name}"
+              end
+            else
+              # This is needed because a dsc script can have resources that are both converged and not
+              "converge DSC resource #{resource.name} by doing nothing because it is already converged"
+            end
+          end
+      end
+
+      def powershell_info_str
+        if run_context && run_context.node[:languages] && run_context.node[:languages][:powershell]
+          install_info = "PowerShell #{run_context.node[:languages][:powershell][:version]} was found on the system."
+        else
+          install_info = "PowerShell was not found."
+        end
+      end
+    end
+  end
+end