Salome HOME
Merge branch 'nct/jan21' of https://codev-tuleap.cea.fr/plugins/git/salome/sat into...
[tools/sat.git] / commands / test.py
index 1c1aa7afe6a806d6eb4ed21aacd21d7aab38f9e6..62fd7fef5cc6d55e793a4955b2dc6bde2f4ebc72 100644 (file)
@@ -23,6 +23,15 @@ import subprocess
 import datetime
 import gzip
 
+# Compatibility python 2/3 for input function
+# input stays input for python 3 and input = raw_input for python 2
+try:
+    input = raw_input
+except NameError:
+    pass
+
+verbose = False
+
 try:
     from hashlib import sha1
 except ImportError:
@@ -35,29 +44,31 @@ from src.xmlManager import add_simple_node
 # Define all possible option for the test command :  sat test <options>
 parser = src.options.Options()
 parser.add_option('b', 'base', 'string', 'base',
-    _("Indicate the name of the test base to use.\n\tThis name has to be "
-      "registered in your application and in a project.\n\tA path to a test "
-      "base can also be used."))
+    _("""Optional: The name of the test base to use."
+          This name has to be registered in your application and in a project.
+          A path to a test base can also be used."""))
 parser.add_option('l', 'launcher', 'string', 'launcher',
-    _("Use this option to specify the path to a SALOME launcher to use to "
-      "launch the test scripts of the test base."))
+    _("""Optional: Specify the path to a SALOME launcher
+          used to launch the test scripts of the test base."""))
 parser.add_option('g', 'grid', 'list', 'grids',
-    _('Indicate which grid(s) to test (subdirectory of the test base).'))
-parser.add_option('s', 'session', 'list', 'sessions',
-    _('Indicate which session(s) to test (subdirectory of the grid).'))
+    _('Optional: Which grid(s) to test (subdirectory of the test base).'))
+parser.add_option('s', 'session', 'list2', 'sessions',
+    _('Optional: Which session(s) to test (subdirectory of the grid).'))
 parser.add_option('', 'display', 'string', 'display',
-    _("Set the display where to launch SALOME."
-"\tIf value is NO then option --show-desktop=0 will be used to launch SALOME."))
-
+    _("""Optional: Set the display where to launch SALOME.
+          If value is NO then option --show-desktop=0 will be used to launch SALOME."""))
+parser.add_option('', 'keep', 'boolean', 'keeptempdir',
+                  _('Optional: keep temporary big tests directories.'))
 def description():
     '''method that is called when salomeTools is called with --help option.
     
     :return: The text to display for the test command description.
     :rtype: str
     '''
-    return _("The test command runs a test base on a SALOME installation.")     
+    return _("The test command runs a test base on a SALOME installation.\n\n"
+             "example:\nsat test SALOME-master --grid GEOM --session light")     
 
-def parse_option(args, config):
+def parse_option_old(args, config):
     """ Parse the options and do some verifications about it
     
     :param args List: The list of arguments of the command
@@ -71,8 +82,8 @@ def parse_option(args, config):
         options.launcher = ""
     elif not os.path.isabs(options.launcher):
         if not src.config_has_application(config):
-            raise src.SatException(_("An application is required to use a "
-                                     "relative path with option --appli"))
+            msg = _("An application is required to use a relative path with option --appli")
+            raise src.SatException(msg)
         options.launcher = os.path.join(config.APPLICATION.workdir,
                                         options.launcher)
 
@@ -82,12 +93,45 @@ def parse_option(args, config):
 
     return (options, args)
 
+
+def parse_option(args, config):
+    """ Parse the options and do some verifications about it
+
+    :param args List: The list of arguments of the command
+    :param config Config: The global configuration
+    :return: the options of the current command launch and the full arguments
+    :rtype: Tuple (options, args)
+    """
+    (options, args) = parser.parse_args(args)
+
+    if not options.launcher:
+        options.launcher = ""
+        return (options, args)
+
+    if not os.path.isabs(options.launcher):
+        if not src.config_has_application(config):
+            msg = _("An application is required to use a relative path with option --appli")
+            raise src.SatException(msg)
+        else:
+            options.launcher = os.path.join(config.APPLICATION.workdir, options.launcher)
+            if not os.path.exists(options.launcher):
+                raise src.SatException(_("Launcher not found: %s") %  options.launcher)
+
+    # absolute path
+    launcher = os.path.realpath(os.path.expandvars(options.launcher))
+    if os.path.exists(launcher):
+        options.launcher = launcher
+        return (options, args)
+
+    raise src.SatException(_("Launcher not found: %s") %  options.launcher)
+
+
 def ask_a_path():
     """ 
     """
-    path = raw_input("enter a path where to save the result: ")
+    path = input("enter a path where to save the result: ")
     if path == "":
-        result = raw_input("the result will be not save. Are you sure to "
+        result = input("the result will be not save. Are you sure to "
                            "continue ? [y/n] ")
         if result == "y":
             return path
@@ -95,7 +139,7 @@ def ask_a_path():
             return ask_a_path()
 
     elif os.path.exists(path):
-        result = raw_input("Warning, the content of %s will be deleted. Are you"
+        result = input("Warning, the content of %s will be deleted. Are you"
                            " sure to continue ? [y/n] " % path)
         if result == "y":
             return path
@@ -161,8 +205,8 @@ def move_test_results(in_dir, what, out_dir, logger):
             os.makedirs(outtestbase)
             #logger.write("  copy testbase %s\n" % testbase, 5)
 
-            for grid_ in [m for m in os.listdir(intestbase) if os.path.isdir(
-                                                os.path.join(intestbase, m))]:
+            for grid_ in [m for m in os.listdir(intestbase) \
+                            if os.path.isdir(os.path.join(intestbase, m))]:
                 # ignore source configuration directories
                 if grid_[:4] == '.git' or grid_ == 'CVS':
                     continue
@@ -223,76 +267,215 @@ def check_remote_machine(machine_name, logger):
     else:
         logger.write(src.printcolors.printcSuccess(src.OK_STATUS) + "\n\n", 4)
 
+def findOrCreateNode(parentNode, nameNodeToFind):
+    found = parentNode.find(nameNodeToFind)
+    if found is None:
+      created = add_simple_node(parentNode, nameNodeToFind)
+      return created
+    else:
+      return found
+
+def purgeEmptyNodes(root):
+    """
+    recursive remove node.text and node.tail if empty node
+    as nothing else than whitespace(s) and RCLF(s)
+
+    | this is comes from
+    | 1) pretty print file xml -> creates indentation(s) in text and tail
+    | 2) and reload parse file xml
+    """
+    # print("root", root.tag, root.text)
+    text = root.text
+    tail = root.tail
+    if text is not None:
+      if text.replace(" ", "").replace("\n", "") == "":
+        # print("purgeEmptyNodes text %s" % root.tag)
+        root.text = None
+    if tail is not None:
+      if tail.replace(" ", "").replace("\n", "") == "":
+        # print("purgeEmptyNodes tail %s" % root.tag)
+        root.tail = None
+    for node in root:
+      purgeEmptyNodes(node)
+    return
+
 ##
 # Creates the XML report for a product.
-def create_test_report(config, dest_path, stylesheet, xmlname=""):
+def create_test_report(config,
+                       xml_history_path,
+                       dest_path,
+                       retcode,
+                       xmlname=""):
+    # get the date and hour of the launching of the command, in order to keep
+    # history
+    date_hour = config.VARS.datehour
+    
+    # Get some information to put in the xml file
     application_name = config.VARS.application
     withappli = src.config_has_application(config)
+    
+    first_time = False
+    if not os.path.exists(xml_history_path):
+        print("Log file creation %s" % xml_history_path)
+        first_time = True
+        root = etree.Element("salome")
+        prod_node = etree.Element("product", name=application_name, build=xmlname)
+        root.append(prod_node)
+    else:
+        print("Log file modification %s" % xml_history_path)
+        root = etree.parse(xml_history_path).getroot()
+        purgeEmptyNodes(root)
+        prod_node = root.find("product")
 
-    root = etree.Element("salome")
-    prod_node = etree.Element("product", name=application_name, build=xmlname)
-    root.append(prod_node)
 
-    if withappli:
+    prod_node.attrib["history_file"] = os.path.basename(xml_history_path)
+    prod_node.attrib["global_res"] = str(retcode)
 
-        add_simple_node(prod_node, "version_to_download",
-                        config.APPLICATION.name)
-        
+    if withappli:
+        if not first_time:
+            for node in (prod_node.findall("version_to_download") + 
+                         prod_node.findall("out_dir")):
+                prod_node.remove(node)
+                
+        add_simple_node(prod_node, "version_to_download", config.APPLICATION.name)
         add_simple_node(prod_node, "out_dir", config.APPLICATION.workdir)
 
     # add environment
+    if not first_time:
+        for node in prod_node.findall("exec"):
+            prod_node.remove(node)
+        
     exec_node = add_simple_node(prod_node, "exec")
     exec_node.append(etree.Element("env", name="Host", value=config.VARS.node))
-    exec_node.append(etree.Element("env", name="Architecture",
-                                   value=config.VARS.dist))
-    exec_node.append(etree.Element("env", name="Number of processors",
-                                   value=str(config.VARS.nb_proc)))    
-    exec_node.append(etree.Element("env", name="Begin date",
-                                   value=src.parse_date(config.VARS.datehour)))
-    exec_node.append(etree.Element("env", name="Command",
-                                   value=config.VARS.command))
-    exec_node.append(etree.Element("env", name="sat version",
-                                   value=config.INTERNAL.sat_version))
+    exec_node.append(etree.Element("env", name="Architecture", value=config.VARS.dist))
+    exec_node.append(etree.Element("env", name="Number of processors", value=str(config.VARS.nb_proc)))
+    exec_node.append(etree.Element("env", name="Begin date", value=src.parse_date(date_hour)))
+    exec_node.append(etree.Element("env", name="Command", value=config.VARS.command))
+    exec_node.append(etree.Element("env", name="sat version", value=config.INTERNAL.sat_version))
 
     if 'TESTS' in config:
-        tests = add_simple_node(prod_node, "tests")
-        known_errors = add_simple_node(prod_node, "known_errors")
-        new_errors = add_simple_node(prod_node, "new_errors")
-        amend = add_simple_node(prod_node, "amend")
+        tests = findOrCreateNode(prod_node, "tests")
+        known_errors = findOrCreateNode(prod_node, "known_errors")
+        new_errors = findOrCreateNode(prod_node, "new_errors")
+        amend = findOrCreateNode(prod_node, "amend")
+        
         tt = {}
         for test in config.TESTS:
-            if not tt.has_key(test.testbase):
+            if not test.testbase in tt:
                 tt[test.testbase] = [test]
             else:
                 tt[test.testbase].append(test)
-
+        
         for testbase in tt.keys():
-            gn = add_simple_node(tests, "testbase")
+            if verbose: print("---- create_test_report %s %s" % (testbase, first_time))
+            gn = findOrCreateNode(tests, "testbase")
+
+            # initialize all grids and session to "not executed"
+            for mn in gn.findall("grid"):
+                mn.attrib["executed_last_time"] = "no"
+                for tyn in mn.findall("session"):
+                    tyn.attrib["executed_last_time"] = "no"
+                    for test_node in tyn.findall('test'):
+                        for node in test_node.getchildren():
+                            if node.tag != "history":
+                                test_node.remove(node)
+
+                        attribs_to_pop = []
+                        for attribute in test_node.attrib:
+                            if (attribute != "script" and
+                                                    attribute != "res"):
+                                attribs_to_pop.append(attribute)
+                        for attribute in attribs_to_pop:
+                            test_node.attrib.pop(attribute)
+            
             gn.attrib['name'] = testbase
             nb, nb_pass, nb_failed, nb_timeout, nb_not_run = 0, 0, 0, 0, 0
             grids = {}
             sessions = {}
             for test in tt[testbase]:
-                #print test.grid
-                if not grids.has_key(test.grid):
-                    mn = add_simple_node(gn, "grid")
-                    mn.attrib['name'] = test.grid
+                if not (test.grid in grids):
+                    if first_time:
+                        mn = add_simple_node(gn, "grid")
+                        mn.attrib['name'] = test.grid
+                    else:
+                        l_mn = gn.findall("grid")
+                        mn = None
+                        for grid_node in l_mn:
+                            if grid_node.attrib['name'] == test.grid:
+                                mn = grid_node
+                                break
+                        if mn == None:
+                            mn = add_simple_node(gn, "grid")
+                            mn.attrib['name'] = test.grid
+                    
                     grids[test.grid] = mn
-
-                if not sessions.has_key("%s/%s" % (test.grid, test.session)):
-                    tyn = add_simple_node(mn, "session")
-                    tyn.attrib['name'] = test.session
+                
+                mn.attrib["executed_last_time"] = "yes"
+                
+                if not "%s/%s" % (test.grid, test.session) in sessions:
+                    if first_time:
+                        tyn = add_simple_node(mn, "session")
+                        tyn.attrib['name'] = test.session
+                    else:
+                        l_tyn = mn.findall("session")
+                        tyn = None
+                        for session_node in l_tyn:
+                            if session_node.attrib['name'] == test.session:
+                                tyn = session_node
+                                break
+                        if tyn == None:
+                            tyn = add_simple_node(mn, "session")
+                            tyn.attrib['name'] = test.session
+                        
                     sessions["%s/%s" % (test.grid, test.session)] = tyn
 
+                tyn.attrib["executed_last_time"] = "yes"
+
                 for script in test.script:
-                    tn = add_simple_node(sessions[
-                                    "%s/%s" % (test.grid, test.session)], "test")
-                    tn.attrib['session'] = test.session
-                    tn.attrib['script'] = script.name
+                    if first_time:
+                        tn = add_simple_node(sessions[
+                                           "%s/%s" % (test.grid, test.session)],
+                                             "test")
+                        tn.attrib['session'] = test.session
+                        tn.attrib['script'] = script.name
+                        hn = add_simple_node(tn, "history")
+                    else:
+                        l_tn = sessions["%s/%s" % (test.grid, test.session)].findall(
+                                                                         "test")
+                        tn = None
+                        for test_node in l_tn:
+                            if test_node.attrib['script'] == script['name']:
+                                tn = test_node
+                                break
+                        
+                        if tn == None:
+                            tn = add_simple_node(sessions[
+                                           "%s/%s" % (test.grid, test.session)],
+                                             "test")
+                            tn.attrib['session'] = test.session
+                            tn.attrib['script'] = script.name
+                            hn = add_simple_node(tn, "history")
+                        else:
+                            # Get or create the history node for the current test
+                            if len(tn.findall("history")) == 0:
+                                hn = add_simple_node(tn, "history")
+                            else:
+                                hn = tn.find("history")
+                            # Put the last test data into the history
+                            if 'res' in tn.attrib:
+                                attributes = {"date_hour" : date_hour,
+                                              "res" : tn.attrib['res'] }
+                                add_simple_node(hn,
+                                                "previous_test",
+                                                attrib=attributes)
+                            for node in tn:
+                                if node.tag != "history":
+                                    tn.remove(node)
+                    
                     if 'callback' in script:
                         try:
                             cnode = add_simple_node(tn, "callback")
-                            if src.architecture.is_windows():
+                            if True:  # bug xml mal forme colorisation  src.architecture.is_windows():
                                 import string
                                 cnode.text = filter(
                                                 lambda x: x in string.printable,
@@ -372,22 +555,55 @@ def create_test_report(config, dest_path, stylesheet, xmlname=""):
             gn.attrib['failed'] = str(nb_failed)
             gn.attrib['timeout'] = str(nb_timeout)
             gn.attrib['not_run'] = str(nb_not_run)
-
+            
+            # Remove the res attribute of all tests that were not launched 
+            # this time
+            for mn in gn.findall("grid"):
+                if mn.attrib["executed_last_time"] == "no":
+                    for tyn in mn.findall("session"):
+                        if tyn.attrib["executed_last_time"] == "no":
+                            for test_node in tyn.findall('test'):
+                                if "res" in test_node.attrib:
+                                    test_node.attrib.pop("res")          
+    
     if len(xmlname) == 0:
         xmlname = application_name
     if not xmlname.endswith(".xml"):
         xmlname += ".xml"
 
-    src.xmlManager.write_report(os.path.join(dest_path, xmlname),
-                                root,
-                                stylesheet)
+    src.xmlManager.write_report(os.path.join(dest_path, xmlname), root, "test.xsl")
+    src.xmlManager.write_report(xml_history_path, root, "test_history.xsl")
     return src.OK_STATUS
 
+def generate_history_xml_path(config, test_base):
+    """Generate the name of the xml file that contain the history of the tests
+       on the machine with the current APPLICATION and the current test base.
+    
+    :param config Config: The global configuration
+    :param test_base Str: The test base name (or path)
+    :return: the full path of the history xml file
+    :rtype: Str
+    """
+    history_xml_name = ""
+    if "APPLICATION" in config:
+        history_xml_name += config.APPLICATION.name
+        history_xml_name += "-" 
+    history_xml_name += config.VARS.dist
+    history_xml_name += "-"
+    test_base_name = test_base
+    if os.path.exists(test_base):
+        test_base_name = os.path.basename(test_base)
+    history_xml_name += test_base_name
+    history_xml_name += ".xml"
+    log_dir = src.get_log_path(config)
+    return os.path.join(log_dir, "TEST", history_xml_name)
+
 def run(args, runner, logger):
     '''method that is called when salomeTools is called with test parameter.
     '''
     (options, args) = parse_option(args, runner.cfg)
 
+    # the test base is specified either by the application, or by the --base option
     with_application = False
     if runner.cfg.VARS.application != 'None':
         logger.write(_('Running tests on application %s\n') % 
@@ -398,6 +614,7 @@ def run(args, runner, logger):
         raise src.SatException(_('A test base is required. Use the --base '
                                  'option'))
 
+    # the launcher is specified either by the application, or by the --launcher option
     if with_application:
         # check if environment is loaded
         if 'KERNEL_ROOT_DIR' in os.environ:
@@ -419,25 +636,29 @@ def run(args, runner, logger):
     show_desktop = (options.display and options.display.upper() == "NO")
     if options.display and options.display != "NO":
         remote_name = options.display.split(':')[0]
-        if remote_name != "":
+        if remote_name != "" and (not src.architecture.is_windows()):
             check_remote_machine(remote_name, logger)
         # if explicitly set use user choice
         os.environ['DISPLAY'] = options.display
     elif 'DISPLAY' not in os.environ:
         # if no display set
-        if ('display' in runner.cfg.SITE.test and 
-                                        len(runner.cfg.SITE.test.display) > 0):
+        if ('test' in runner.cfg.LOCAL and
+                'display' in runner.cfg.LOCAL.test and 
+                len(runner.cfg.LOCAL.test.display) > 0):
             # use default value for test tool
-            os.environ['DISPLAY'] = runner.cfg.SITE.test.display
+            os.environ['DISPLAY'] = runner.cfg.LOCAL.test.display
         else:
             os.environ['DISPLAY'] = "localhost:0.0"
 
     # initialization
     #################
     if with_application:
-        tmp_dir = runner.cfg.SITE.test.tmp_dir_with_application
+        tmp_dir = os.path.join(runner.cfg.VARS.tmp_root,
+                               runner.cfg.APPLICATION.name,
+                               "test")
     else:
-        tmp_dir = runner.cfg.SITE.test.tmp_dir
+        tmp_dir = os.path.join(runner.cfg.VARS.tmp_root,
+                               "test")
 
     # remove previous tmp dir
     if os.access(tmp_dir, os.F_OK):
@@ -465,15 +686,15 @@ def run(args, runner, logger):
     content = "\n".join(lines)
 
     # create hash from context information
-    dirname = sha1(content.encode()).hexdigest()
+    # CVW TODO or not dirname = datetime.datetime.now().strftime("%y%m%d_%H%M%S_") + sha1(content.encode()).hexdigest()[0:8]
+    dirname = sha1(content.encode()).hexdigest()[0:8] # only 8 firsts probably good
     base_dir = os.path.join(tmp_dir, dirname)
     os.makedirs(base_dir)
     os.environ['TT_TMP_RESULT'] = base_dir
 
     # create env_info file
-    f = open(os.path.join(base_dir, 'env_info.py'), "w")
-    f.write(content)
-    f.close()
+    with open(os.path.join(base_dir, 'env_info.py'), "w") as f:
+        f.write(content)
 
     # create working dir and bases dir
     working_dir = os.path.join(base_dir, 'WORK')
@@ -498,7 +719,7 @@ def run(args, runner, logger):
 
     src.printcolors.print_value(logger, _('Display'), os.environ['DISPLAY'], 2)
     src.printcolors.print_value(logger, _('Timeout'),
-                                runner.cfg.SITE.test.timeout, 2)
+                                src.test_module.DEFAULT_TIMEOUT, 2)
     src.printcolors.print_value(logger, _("Working dir"), base_dir, 3)
 
     # create the test object
@@ -524,22 +745,35 @@ def run(args, runner, logger):
     logger.write("\n", 2, False)
     
     logger.write(_("\nGenerate the specific test log\n"), 5)
-    out_dir = os.path.join(runner.cfg.USER.log_dir, "TEST")
+    log_dir = src.get_log_path(runner.cfg)
+    out_dir = os.path.join(log_dir, "TEST")
     src.ensure_path_exists(out_dir)
-    name_xml_board = logger.logFileName.split(".")[0] + "board" + ".xml"
+    name_xml_board = logger.logFileName.split(".")[0] + "_board.xml"
+    historic_xml_path = generate_history_xml_path(runner.cfg, test_base)
+    
     create_test_report(runner.cfg,
+                       historic_xml_path,
                        out_dir,
-                       "test.xsl",
+                       retcode,
                        xmlname = name_xml_board)
     xml_board_path = os.path.join(out_dir, name_xml_board)
+
     logger.l_logFiles.append(xml_board_path)
     logger.add_link(os.path.join("TEST", name_xml_board),
                     "board",
                     retcode,
                     "Click on the link to get the detailed test results")
-    
-    if retcode != 0:
-        retcode = 1
-    
+    logger.write("\nTests board file %s\n" % xml_board_path, 1)
+
+    # Add the historic files into the log files list of the command
+    logger.l_logFiles.append(historic_xml_path)
+
+    if not options.keeptempdir:
+      logger.write("Removing the temporary directory: rm -rf %s\n" % test_runner.tmp_working_dir, 5)
+      if os.path.exists(test_runner.tmp_working_dir):
+        shutil.rmtree(test_runner.tmp_working_dir)
+    else:
+      logger.write("NOT Removing the temporary directory: rm -rf %s\n" % test_runner.tmp_working_dir, 5)
+
     return retcode