Class: EtchExternalSource

Inherits:

Object

• Object
• EtchExternalSource

Defined in:

lib/etch.rb

Constant Summary

@@load_path_org =

Save the original $LOAD_PATH ($:) to be restored later.

$LOAD_PATH.clone

Instance Method Summary

• #initialize(file, original_file, facts, groups, local_requests, sourcebase, commandsbase, sitelibbase, dlogger) ⇒ EtchExternalSource constructor

  A new instance of EtchExternalSource.

• #process_template(template) ⇒ Object

  This method processes an ERB template (as specified via a <template> entry in a config.xml file) and returns the results.

• #run_script(script) ⇒ Object

  This method runs a etch script (as specified via a <script> entry in a config.xml file) and returns any output that the script puts in the @contents variable.

Constructor Details

#initialize(file, original_file, facts, groups, local_requests, sourcebase, commandsbase, sitelibbase, dlogger) ⇒ EtchExternalSource

Returns a new instance of EtchExternalSource.

# File 'lib/etch.rb', line 2006

def initialize(file, original_file, facts, groups, local_requests, sourcebase, commandsbase, sitelibbase, dlogger)
  # The external source is going to be processed within the same Ruby
  # instance as etch.  We want to make it clear what variables we are
  # intentionally exposing to external sources, essentially this
  # defines the "API" for those external sources.
  @file = file
  @original_file = original_file
  @facts = facts
  @groups = groups
  # In the olden days all local requests were XML snippits that the etch client
  # smashed into a single XML document to send over the wire.  This supports
  # scripts expecting the old interface.
  @local_requests = nil
  if local_requests
    @local_requests = "<requests>\n#{local_requests.join('')}\n</requests>"
  end
  # And this is a new interface where we just pass them as an array
  @local_requests_array = local_requests || []
  @sourcebase = sourcebase
  @commandsbase = commandsbase
  @sitelibbase = sitelibbase
  @dlogger = dlogger
end

Instance Method Details

#process_template(template) ⇒ Object

This method processes an ERB template (as specified via a <template> entry in a config.xml file) and returns the results.

# File 'lib/etch.rb', line 2032

def process_template(template)
  @dlogger.debug "Processing template #{template} for file #{@file}"
  # The '-' arg allows folks to use <% -%> or <%- -%> to instruct ERB to
  # not insert a newline for that line, which helps avoid a bunch of blank
  # lines in the processed file where there was code in the template.
  erb = ERB.new(IO.read(template), nil, '-')
  # The binding arg ties the template's namespace to this point in the
  # code, thus ensuring that all of the variables above (@file, etc.)
  # are visible to the template code.
  begin
    erb.result(binding)
  rescue Exception => e
    # Help the user figure out where the exception occurred, otherwise they
    # just get told it happened here, which isn't very helpful.
    raise Etch.wrap_exception(e, "Exception while processing template #{template} for file #{@file}:\n" + e.message)
  ensure
    restore_globals
  end
end

#run_script(script) ⇒ Object

This method runs a etch script (as specified via a <script> entry in a config.xml file) and returns any output that the script puts in the @contents variable.

# File 'lib/etch.rb', line 2055

def run_script(script)
  @dlogger.debug "Processing script #{script} for file #{@file}"
  @contents = ''
  begin
    run_script_stage2(script)
  rescue Exception => e
    if e.kind_of?(SystemExit)
      # The user might call exit within a script.  We want the scripts
      # to act as much like a real script as possible, so ignore those.
    else
      # Help the user figure out where the exception occurred, otherwise they
      # just get told it happened here in eval, which isn't very helpful.
      raise Etch.wrap_exception(e, "Exception while processing script #{script} for file #{@file}:\n" + e.message)
    end
  ensure
    restore_globals
  end
  @contents
end