When designing the definition it is often very desirable to be able to auto generate the ecf script s. This allows for a lot of experimentation with suite definition structure without the chore of continually keeping the scripts in sync.
The following Python code shows that it is possible to test any suite definition without having to create any ecf script s.
The ecf script files are auto generated. Hence if the suite definition contains event, meter or label, the auto generate feature will create scripts with correct child command s to communicate with the server.
The scripts assumes that ecflow_client is accessible on $PATH.
To use, copy the contents into a file, say test_bench.py
test_bench.py --help
If the server is running locally the typical usage might be:
test_bench.py my_test.def --port 4141
#!/usr/bin/env python2.7
#////////1/////////2/////////3/////////4/////////5/////////6/////////7/////////8
# Name :
# Author : Avi
# Revision : $Revision: #10 $
#
# Copyright 2009-2012 ECMWF.
# This software is licensed under the terms of the Apache Licence version 2.0
# which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
# In applying this licence, ECMWF does not waive the privileges and immunities
# granted to it by virtue of its status as an intergovernmental organisation
# nor does it submit to any jurisdiction.
#////////1/////////2/////////3/////////4/////////5/////////6/////////7/////////8
# =============================================================================
# Code for testing *any* definition
# Since any ad hoc definition will reference local directories in the
# ECF_ variables, we need to remove them and inject our own.
#
# This script is re-runnable, and hence will delete suites in the server
# matching those in the input definition. Hence it is best to use this
# script with a *test* server to avoid accidentally deleting existing suites
# of the same name.
# =============================================================================
import ecflow
import os # for getenv
import shutil # used to remove directory tree
import argparse # for argument parsing
def delete_variables_affecting_job_generation(node):
"""delete customer related ECF variables, these will point to directories
that don't exist. Its ok we will regenerate our own local ones"""
var = node.find_variable("ECF_HOME")
if not var.empty() :
node.delete_variable("ECF_HOME")
var = node.find_variable("ECF_FILES")
if not var.empty() :
node.delete_variable("ECF_FILES")
var = node.find_variable("ECF_INCLUDE")
if not var.empty() :
node.delete_variable("ECF_INCLUDE")
var = node.find_variable("ECF_JOB_CMD")
if not var.empty() :
node.delete_variable("ECF_JOB_CMD")
var = node.find_variable("ECF_KILL_CMD")
if not var.empty() :
node.delete_variable("ECF_KILL_CMD")
var = node.find_variable("ECF_STATUS_CMD")
if not var.empty() :
node.delete_variable("ECF_STATUS_CMD")
var = node.find_variable("ECF_OUT")
if not var.empty() :
node.delete_variable("ECF_OUT")
def traverse_container(node_container):
"""Recursively traverse definition node hierarchy and delete
the variables that affect job generation.
"""
delete_variables_affecting_job_generation(node_container)
for node in node_container.nodes:
delete_variables_affecting_job_generation(node)
if not isinstance(node, ecflow.Task):
traverse_container(node)
if __name__ == "__main__":
DESC = """Will allow any definition to be loaded and played on the server
This is done by:
o Remove existing ECF_ variables that affect job generation.
i.e variables that refer to customer specific directories are removed
o Allows ECF_HOME to specified, defaults to ./CUSTOMER/ECF_HOME
o Generates the scripts(.ecf files) automatically based on the definition.
i.e if a task has events,meters,labels then the client request for these are
automatically injected in the generated .ecf script files
o Will clear out existing data both on disk and on the server to allow
multiple re-runs of this script. ** If this is an issue please use
a test server **
o All suites are put into a suspended state. This allows the GUI to resume them
o The server is restarted and suites are begun
This programs assumes that ecflow module is accessible.
"""
PARSER = argparse.ArgumentParser(description=DESC,
formatter_class=argparse.RawDescriptionHelpFormatter)
PARSER.add_argument('defs_file',
help="The definition file")
PARSER.add_argument('--host', default="localhost",
help="The name of the host machine, defaults to 'localhost'")
PARSER.add_argument('--port', default="3141",
help="The port on the host, defaults to 3141")
PARSER.add_argument('--path', default="/",
help="replace only the node path in the suite")
PARSER.add_argument('--ecf_home', default="CUSTOMER/ECF_HOME",
help="Directory to be used for generated scripts(ECF_HOME), defaults to ./CUSTOMER/ECF_HOME")
PARSER.add_argument('--verbose', nargs='?', default=False, const=True, type=bool,
help="Show verbose output")
ARGS = PARSER.parse_args()
ARGS.defs_file = os.path.expandvars(ARGS.defs_file) # expand references to any environment variables
print ARGS
# If running on local work space, use /Pyext/test/data/CUSTOMER/ECF_HOME as ecf_home
if not ARGS.ecf_home:
if os.getenv("WK") == None:
print "No ecf_home specified. Please specify a writable directory"
exit(1)
ARGS.ecf_home = os.getenv("WK") + "/Pyext/test/data/CUSTOMER/ECF_HOME"
if ARGS.verbose:
print "Workspace is defined"
print "using /Client/bin/gcc\-4.5/debug/ecflow_client"
if ARGS.verbose:
print "Using ECF_HOME=" + ARGS.ecf_home
if ARGS.verbose:
print "\nloading the definition from the input arguments(" + ARGS.defs_file + ")\n"
try:
DEFS = ecflow.Defs(ARGS.defs_file)
except RuntimeError, ex:
print " ecflow.Defs(" + ARGS.defs_file + ") failed:\n" + str(ex)
exit(1)
if ARGS.verbose:
print "remove test data associated with the DEFS, so we start fresh, Allows rerun"
for suite in DEFS.suites:
dir_to_remove = ARGS.ecf_home + suite.get_abs_node_path()
if ARGS.verbose:
print " Deleting directory: " + dir_to_remove + "\n"
shutil.rmtree(dir_to_remove, True)
if ARGS.verbose:
print "remove remote reference to ECF_HOME and ECF_INCLUDE, since we inject or own\n"
for suite in DEFS.suites:
traverse_container(suite)
if ARGS.verbose:
print "add variables required for script generation, for all suites\n"
DEFS.add_variable("ECF_HOME", ARGS.ecf_home)
if os.getenv("WK") != None:
DEFS.add_variable("ECF_CLIENT_EXE_PATH", os.getenv("WK") + "/Client/bin/gcc\-4.5/debug/ecflow_client")
DEFS.add_variable("SLEEP", "10") # not strictly required since default is 1 second
DEFS.add_variable("ECF_INCLUDE", ARGS.ecf_home + "/includes")
if ARGS.verbose:
print "Place all suites into suspended state, so they can be started by the GUI\n"
for suite in DEFS.suites:
suite.add_defstatus(ecflow.DState.suspended)
# ecflow.PrintStyle.set_style(ecflow.Style.STATE)
if ARGS.verbose:
print DEFS
if ARGS.verbose:
print "Generating script files(.ecf) from the definition"
DEFS.generate_scripts()
if ARGS.verbose:
print "\nchecking script file generation, pre-processing & variable substitution\n"
JOB_CTRL = ecflow.JobCreationCtrl()
DEFS.check_job_creation(JOB_CTRL)
assert len(JOB_CTRL.get_error_msg()) == 0, JOB_CTRL.get_error_msg()
# ===========================================================================
CL = ecflow.Client(ARGS.host, ARGS.port)
try:
if ARGS.verbose:
print "check server " + ARGS.host + ":" + ARGS.port + " is running"
CL.ping()
if ARGS.verbose:
print "Server is already running. re-start the server"
CL.restart_server()
if ARGS.verbose:
print "Remove suites associated with this DEFS, allows rerun *******************************************"
for suite in DEFS.suites:
try:
CL.delete(suite.get_abs_node_path(), True)
except RuntimeError, ex:
pass # For first run this will fail, hence ignore
if ARGS.verbose:
print "Load the definition into " + ARGS.host + ":" + ARGS.port
if ARGS.path == "/":
CL.load(DEFS)
else:
CL.replace(ARGS.path, DEFS)
if ARGS.verbose:
print "Begin all suites. They should be suspended."
print "Loaded suites:"
for suite in DEFS.suites:
CL.begin_suite(suite.name())
print " " + suite.name()
print "into server " + ARGS.host \
+ ":" + ARGS.port + ", please view the playable suites in the GUI"
except RuntimeError, ex:
print "Error: " + str(ex)