Module: Wisco::ExecScript

Defined in:
lib/wisco/exec_script.rb

Overview

Evaluates an execute_*.rb script and returns the value of its last expression. The script is eval'd inside a binding that exposes helpers (call_method, call_pick_list, connection) so the script can build dynamic input that varies per run.

Defined Under Namespace

Classes: InvalidReturn, ScriptHost

Constant Summary collapse

SENTINEL_REGEX = 
/\A\s*#\s*WISCO_SKIP\b/.freeze

Class Method Summary collapse

Class Method Details

.evaluate(script_path:, connector_full_path:, target_dir:, connection_name: 'default') ⇒ Object

Evaluates the script at script_path and returns the value of its last expression. Raises StandardError subclasses on:

- syntax / runtime errors in the script
- invalid return value (must be a Hash or Array)

connector_full_path — absolute path to connector.rb (used to build the SDK Connector for helper invocations). target_dir — connector project root (used to find settings.yaml(.enc) + master.key). connection_name — connection key inside settings.yaml; defaults to 'default'.



37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/wisco/exec_script.rb', line 37

def evaluate(script_path:, connector_full_path:, target_dir:, connection_name: 'default')
  host   = ScriptHost.new(connector_full_path, target_dir, connection_name)
  source = File.read(script_path)
  result = host.instance_eval(source, script_path, 1)

  unless result.is_a?(Hash) || result.is_a?(Array)
    raise InvalidReturn,
          "Script must return a Hash (for actions/triggers) or Array/Hash (for methods/pick_lists). " \
          "Got: #{result.class}"
  end

  result
end

.sentinel?(path) ⇒ Boolean

Returns true if the file's first non-blank line is a # WISCO_SKIP comment, in which case the script should be skipped by wisco exec.

Returns:

  • (Boolean) 


16
17
18
19
20
21
22
23
24
25
 
# File 'lib/wisco/exec_script.rb', line 16

def sentinel?(path)
  File.foreach(path) do |line|
    stripped = line.strip
    next if stripped.empty?
    return SENTINEL_REGEX.match?(line)
  end
  false
rescue StandardError
  false
end