3 # Copyright (c) 2016 ZTE Corp and others.
5 # All rights reserved. This program and the accompanying materials
6 # are made available under the terms of the Apache License, Version 2.0
7 # which accompanies this distribution, and is available at
8 # http://www.apache.org/licenses/LICENSE-2.0
10 """Define the parent classes of all Xtesting Features.
12 Feature is considered as TestCase offered by Third-party. It offers
13 helpers to run any python method or any bash command.
23 from xtesting.core import testcase
25 __author__ = ("Serena Feng <feng.xiaowei@zte.com.cn>, "
26 "Cedric Ollivier <cedric.ollivier@orange.com>")
29 class Feature(testcase.TestCase, metaclass=abc.ABCMeta):
30 """Base model for single feature."""
32 __logger = logging.getLogger(__name__)
35 def execute(self, **kwargs):
36 """Execute the Python method.
38 The subclasses must override the default implementation which
41 The new implementation must return 0 if success or anything
45 kwargs: Arbitrary keyword arguments.
48 def run(self, **kwargs):
51 It allows executing any Python method by calling execute().
53 It sets the following attributes required to push the results
60 It doesn't fulfill details when pushing the results to the DB.
63 kwargs: Arbitrary keyword arguments.
66 TestCase.EX_OK if execute() returns 0,
67 TestCase.EX_RUN_ERROR otherwise.
69 self.start_time = time.time()
70 exit_code = testcase.TestCase.EX_RUN_ERROR
73 if self.execute(**kwargs) == 0:
74 exit_code = testcase.TestCase.EX_OK
76 except Exception: # pylint: disable=broad-except
77 self.__logger.exception("%s FAILED", self.project_name)
78 self.stop_time = time.time()
82 class BashFeature(Feature):
83 """Class designed to run any bash command."""
85 __logger = logging.getLogger(__name__)
87 def __init__(self, **kwargs):
88 super().__init__(**kwargs)
89 self.result_file = f"{self.res_dir}/{self.case_name}.log"
91 def execute(self, **kwargs):
92 """Execute the cmd passed as arg
95 kwargs: Arbitrary keyword arguments.
98 process return code if no exception,
103 console = kwargs["console"] if "console" in kwargs else False
104 # For some tests, we may need to force stop after N sec
105 max_duration = kwargs.get("max_duration")
106 if not os.path.isdir(self.res_dir):
107 os.makedirs(self.res_dir)
108 with open(self.result_file, 'w', encoding='utf-8') as f_stdout:
109 self.__logger.info("Calling %s", cmd)
110 with subprocess.Popen(
111 cmd, shell=True, stdout=subprocess.PIPE,
112 stderr=subprocess.STDOUT) as process:
113 for line in iter(process.stdout.readline, b''):
115 sys.stdout.write(line.decode("utf-8"))
116 f_stdout.write(line.decode("utf-8"))
118 process.wait(timeout=max_duration)
119 except subprocess.TimeoutExpired:
122 "Killing process after %d second(s).",
125 with open(self.result_file, 'r', encoding='utf-8') as f_stdin:
126 self.__logger.debug("$ %s\n%s", cmd, f_stdin.read().rstrip())
127 return process.returncode
129 self.__logger.error("Please give cmd as arg. kwargs: %s", kwargs)