robotframework-robotlog2rqm 1.4.2__py3-none-any.whl → 1.6.0__py3-none-any.whl

RobotLog2RQM/CRQM.py

@@ -308,9 +308,9 @@ Disconnect from RQM.
       """
       self.session.close()
 
-   def config(self, plan_id, build_name=None, config_name=None,
+   def config(self, plan_id=None, build_name=None, config_name=None,
               createmissing=False, updatetestcase=False, suite_id=None,
-              stream=None, baseline=None, naming_convention=None):
+              stream=None, baseline=None, naming_convention=None, fetch_team_areas=True):
       """
 Configure RQMClient with testplan ID, build, configuration, createmissing, ...
 
@@ -322,7 +322,7 @@ Configure RQMClient with testplan ID, build, configuration, createmissing, ...
 
 *  ``plan_id``
 
-   / *Condition*: required / *Type*: str /
+   / *Condition*: optional / *Type*: str /
 
    Testplan ID of RQM project for importing result(s).
 
@@ -352,12 +352,36 @@ Configure RQMClient with testplan ID, build, configuration, createmissing, ...
 
    If `True`, the information of testcase on RQM will be updated bases on robot testfile.
 
-*  ``suite_id (optional)``
+*  ``suite_id``
 
    / *Condition*: optional / *Type*: str / *Default*: None /
 
    Testsuite ID of RQM project for importing result(s).
 
+*  ``stream``
+
+   / *Condition*: optional / *Type*: str / *Default*: None /
+
+   Project stream which is enabled in Configuration Management (CM).
+
+*  ``baseline``
+
+   / *Condition*: optional / *Type*: str / *Default*: None /
+
+   Project baseline which is enabled in Configuration Management (CM).
+
+*  ``naming_convention``
+
+   / *Condition*: optional / *Type*: dict / *Default*: None /
+
+   Naming convention for the creating new resources (testcase, TCER, ...).
+
+*  ``fetch_team_areas``
+
+   / *Condition*: optional / *Type*: bool / *Default*: True /
+
+   If `True`, fetch team-areas information for further process.
+
 **Returns:**
 
 (*no returns*)
@@ -411,12 +435,13 @@ Configure RQMClient with testplan ID, build, configuration, createmissing, ...
                raise Exception("Get all baselines failed. Reason: %s"%res['message'])
 
          # Verify testplan ID
-         res_plan = self.getResourceByID('testplan', plan_id)
-         if res_plan.status_code != 200:
-            raise Exception('Testplan with ID %s is not existing!'%str(plan_id))
+         if plan_id != None:
+            res_plan = self.getResourceByID('testplan', plan_id)
+            if res_plan.status_code != 200:
+               raise Exception('Testplan with ID %s is not existing!'%str(plan_id))
 
-         oTestplan = get_xml_tree(BytesIO(str(res_plan.text).encode()), bdtd_validation=False)
-         self.testplan.name  = oTestplan.find('ns4:title', oTestplan.getroot().nsmap).text
+            oTestplan = get_xml_tree(BytesIO(str(res_plan.text).encode()), bdtd_validation=False)
+            self.testplan.name  = oTestplan.find('ns4:title', oTestplan.getroot().nsmap).text
 
          # Verify and create build version if required
          if build_name != None:
@@ -453,7 +478,8 @@ Configure RQMClient with testplan ID, build, configuration, createmissing, ...
             self.testsuite.name  = oTestsuite.find('ns4:title', oTestsuite.getroot().nsmap).text
 
          # get all team-areas for testcase template
-         self.getAllTeamAreas()
+         if fetch_team_areas:
+            self.getAllTeamAreas()
 
 
       except Exception as error:
@@ -680,6 +706,54 @@ Return the name for given resource bases on the naming convention
       except:
          raise Exception(f"Failed to generate name for {resource} '{name}'")
 
+   def __parse_test_artifact(self, xml_data):
+      """
+Parse XML test case response and extract its data.
+
+**Arguments:**
+
+*  ``xml_data``
+
+   / *Condition*: required / *Type*: str /
+
+   The response text from request to get test case as xml string.
+
+**Returns:**
+
+* / *Type*: dict /
+
+  The dictionary which contains the parsed data from given xml.
+
+  .. code:: python
+
+      {
+         'id': ...,
+         'name': ...,
+         'url': ...,
+         ...
+      }
+
+      """
+      test_tree = get_xml_tree(BytesIO(str(xml_data).encode()), bdtd_validation=False)
+      nsmap = test_tree.getroot().nsmap
+
+      test_name = test_tree.find('ns4:title', test_tree.getroot().nsmap)
+      test_web_id = test_tree.find('ns2:webId', test_tree.getroot().nsmap)
+      test_url = test_tree.find('ns4:identifier', test_tree.getroot().nsmap)
+      test_category = test_tree.findall('ns2:category', test_tree.getroot().nsmap)
+      test_custom_attr = test_tree.findall('.//ns2:customAttribute', test_tree.getroot().nsmap)
+      test_data = {'id': test_web_id.text,
+                                    'name': test_name.text if test_name is not None else '',
+                                    'url': test_url.text}
+      for item in test_category:
+         test_data[item.attrib.get('term')] = item.attrib.get('value')
+      for attr in test_custom_attr:
+         try:
+            test_data[attr.find("ns2:name", nsmap).text] = attr.find("ns2:value", nsmap).text
+         except:
+            pass
+
+      return test_data
    #
    #  Methods to get resources
    #
@@ -849,6 +923,91 @@ Example:
       else:
          raise Exception(f"Could not get 'team-areas' of project '{self.projectname}'.")
 
+   def getTestArtifactsFromResource(self, resource_type, resource_id, artifact_types):
+      """
+Get all test cases and test suites associated with a given test plan.
+
+**Arguments:**
+
+*  ``resource_type``
+
+   / *Condition*: required / *Type*: str /
+
+   The RQM test resource (`testplan` or `testsuite`) to get test artifact(s).
+
+*  ``resource_id``
+
+   / *Condition*: required / *Type*: str /
+
+   The RQM test plan/suite to get test artifact(s).
+
+*  ``artifact_types``
+
+   / *Condition*: required / *Type*: list /
+
+   List of artifact types (`testcase`, `testsuite`) for fetching.
+
+**Returns:**
+
+* / *Type*: dict /
+
+  A dictionary containing fetched artifacts:
+
+  .. code:: python
+
+     {
+        'testcase': [{'id': ..., 'name': ..., 'url': ...}, ...],
+        'testsuite': [{'id': ..., 'name': ..., 'url': ...}, ...]
+     }
+      """
+      ALLOW_RESOURCE_TYPES = ['testplan', 'testsuite']
+      ALLOW_ARTIFACT_TYPES = ['testcase', 'testsuite']
+      result = {}
+
+      if resource_type not in ALLOW_RESOURCE_TYPES:
+         raise ValueError(
+            f"Unsupported resource type '{resource_type}'. "
+            f"Please use one of the following: {', '.join(ALLOW_RESOURCE_TYPES)}."
+         )
+
+      if isinstance(artifact_types, str):
+         artifact_types = [artifact_types]
+      elif not isinstance(artifact_types, (list, tuple)):
+         raise TypeError(
+               f"Invalid type for 'artifact_types': expected str or list, got {type(artifact_types).__name__}."
+         )
+
+      for item in artifact_types:
+         artifact_type = item.lower()
+         if artifact_type not in ALLOW_ARTIFACT_TYPES:
+            raise ValueError(
+               f"Unsupported artifact type '{artifact_type}'. "
+               f"Please use one of the following: {', '.join(ALLOW_ARTIFACT_TYPES)}."
+            )
+         result[artifact_type] = []
+
+      res = self.getResourceByID(resource_type, resource_id)
+      if res.status_code != 200:
+         raise Exception(f"Failed to get {resource_type} {resource_id}: {res.reason}")
+
+      oTree = get_xml_tree(BytesIO(str(res.text).encode()), bdtd_validation=False)
+      root = oTree.getroot()
+      nsmap = root.nsmap
+
+      for item in artifact_types:
+         artifact_type = item.lower()
+         # Find all linked test artifact
+         for oTest in root.findall(f'.//ns2:{artifact_type}', nsmap):
+            href = oTest.attrib.get('href')
+            if href:
+               test_id = href.split('/')[-1]
+               # Get testcase/testsuite by ID
+               test_res = self.getResourceByID(artifact_type, test_id)
+               if test_res.status_code == 200:
+                  test_data = self.__parse_test_artifact(test_res.text)
+                  result[artifact_type].append(test_data)
+
+      return result
 
    #
    #  Methods to create XML template for resources

RobotLog2RQM/logger.py

@@ -0,0 +1,180 @@
+#  Copyright 2020-2023 Robert Bosch GmbH
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+# ******************************************************************************
+#
+# File: logging.py
+#
+# Initially created by Tran Duy Ngoan(RBVH/EMC51) / October 2025
+#
+# Logging class
+#
+# History:
+#
+# 2025-10-20:
+#  - initial version
+#
+# ******************************************************************************
+import sys
+import colorama as col
+import os
+
+class Logger():
+   """
+Logger class for logging message.
+   """
+   output_logfile = None
+   output_console = True
+   color_normal   = col.Fore.WHITE + col.Style.NORMAL
+   color_error    = col.Fore.RED + col.Style.BRIGHT
+   color_warn     = col.Fore.YELLOW + col.Style.BRIGHT
+   color_reset    = col.Style.RESET_ALL + col.Fore.RESET + col.Back.RESET
+   prefix_warn    = "WARN: "
+   prefix_error   = "ERROR: "
+   prefix_fatalerror = "FATAL ERROR: "
+   prefix_all = ""
+   dryrun = False
+
+   @classmethod
+   def config(cls, output_console=True, output_logfile=None, dryrun=False):
+      """
+Configure Logger class.
+
+**Arguments:**
+
+*  ``output_console``
+
+   / *Condition*: optional / *Type*: bool / *Default*: True /
+
+   Write message to console output.
+
+*  ``output_logfile``
+
+   / *Condition*: optional / *Type*: str / *Default*: None /
+
+   Path to log file output.
+
+*  ``dryrun``
+
+   / *Condition*: optional / *Type*: bool / *Default*: True /
+
+   If set, a prefix as 'dryrun' is added for all messages.
+
+**Returns:**
+
+(*no returns*)
+      """
+      cls.output_console = output_console
+      cls.output_logfile = output_logfile
+      cls.dryrun = dryrun
+      if cls.dryrun:
+         cls.prefix_all = cls.color_warn + "DRYRUN  " + cls.color_reset
+
+   @classmethod
+   def log(cls, msg='', color=None, indent=0):
+      """
+Write log message to console/file output.
+
+**Arguments:**
+
+*  ``msg``
+
+   / *Condition*: optional / *Type*: str / *Default*: '' /
+
+   Message which is written to output.
+
+*  ``color``
+
+   / *Condition*: optional / *Type*: str / *Default*: None /
+
+   Color style for the message.
+
+*  ``indent``
+
+   / *Condition*: optional / *Type*: int / *Default*: 0 /
+
+   Offset indent.
+
+**Returns:**
+
+(*no returns*)
+      """
+      if color is None:
+         color = cls.color_normal
+      if cls.output_console:
+         print(cls.prefix_all + cls.color_reset + color + " "*indent + msg + cls.color_reset)
+      if cls.output_logfile is not None and os.path.isfile(cls.output_logfile):
+         with open(cls.output_logfile, 'a') as f:
+            f.write(" "*indent + msg)
+      return
+
+   @classmethod
+   def log_warning(cls, msg, indent=0):
+      """
+Write warning message to console/file output.
+
+**Arguments:**
+
+*  ``msg``
+
+   / *Condition*: required / *Type*: str /
+
+   Warning message which is written to output.
+
+*  ``indent``
+
+   / *Condition*: optional / *Type*: int / *Default*: 0 /
+
+   Offset indent.
+
+**Returns:**
+
+(*no returns*)
+      """
+      cls.log(cls.prefix_warn+str(msg), cls.color_warn, indent)
+
+   @classmethod
+   def log_error(cls, msg, fatal_error=False, indent=0):
+      """
+Write error message to console/file output.
+
+*  ``msg``
+
+   / *Condition*: required / *Type*: str /
+
+   Error message which is written to output.
+
+*  ``fatal_error``
+
+   / *Condition*: optional / *Type*: bool / *Default*: False /
+
+   If set, tool will terminate after logging error message.
+
+*  ``indent``
+
+   / *Condition*: optional / *Type*: int / *Default*: 0 /
+
+   Offset indent.
+
+**Returns:**
+
+(*no returns*)
+      """
+      prefix = cls.prefix_error
+      if fatal_error:
+         prefix = cls.prefix_fatalerror
+
+      cls.log(prefix+str(msg), cls.color_error, indent)
+      if fatal_error:
+         cls.log(f"{sys.argv[0]} has been stopped!", cls.color_error)
+         exit(1)

RobotLog2RQM/robotlog2rqm.py

@@ -15,7 +15,7 @@
 #
 # File: robotlog2rqm.py
 #
-# Initialy created by Tran Duy Ngoan(RBVH/ECM11) / January 2021
+# Initially created by Tran Duy Ngoan(RBVH/ECM11) / January 2021
 #
 # This tool is used to parse the robot framework results output.xml
 # then import them into RQM - IBM Rational Quality Manager
@@ -31,13 +31,12 @@ import json
 import re
 import argparse
 import os
-import sys
 import datetime
-import colorama as col
 
 from robot.api import ExecutionResult
 from RobotLog2RQM.CRQM import CRQMClient
 from RobotLog2RQM.version import VERSION, VERSION_DATE
+from RobotLog2RQM.logger import Logger
 
 DRESULT_MAPPING = {
    "PASS":  "Passed",
@@ -74,160 +73,6 @@ NAMING_CONVENTION_SCHEMA = {
    "suiteresult" : str
 }
 
-#
-#  Logger class
-#
-########################################################################
-class Logger():
-   """
-Logger class for logging message.
-   """
-   output_logfile = None
-   output_console = True
-   color_normal   = col.Fore.WHITE + col.Style.NORMAL
-   color_error    = col.Fore.RED + col.Style.BRIGHT
-   color_warn     = col.Fore.YELLOW + col.Style.BRIGHT
-   color_reset    = col.Style.RESET_ALL + col.Fore.RESET + col.Back.RESET
-   prefix_warn    = "WARN: "
-   prefix_error   = "ERROR: "
-   prefix_fatalerror = "FATAL ERROR: "
-   prefix_all = ""
-   dryrun = False
-
-   @classmethod
-   def config(cls, output_console=True, output_logfile=None, dryrun=False):
-      """
-Configure Logger class.
-
-**Arguments:**
-
-*  ``output_console``
-
-   / *Condition*: optional / *Type*: bool / *Default*: True /
-
-   Write message to console output.
-
-*  ``output_logfile``
-
-   / *Condition*: optional / *Type*: str / *Default*: None /
-
-   Path to log file output.
-
-*  ``dryrun``
-
-   / *Condition*: optional / *Type*: bool / *Default*: True /
-
-   If set, a prefix as 'dryrun' is added for all messages.
-
-**Returns:**
-
-(*no returns*)
-      """
-      cls.output_console = output_console
-      cls.output_logfile = output_logfile
-      cls.dryrun = dryrun
-      if cls.dryrun:
-         cls.prefix_all = cls.color_warn + "DRYRUN  " + cls.color_reset
-
-   @classmethod
-   def log(cls, msg='', color=None, indent=0):
-      """
-Write log message to console/file output.
-
-**Arguments:**
-
-*  ``msg``
-
-   / *Condition*: optional / *Type*: str / *Default*: '' /
-
-   Message which is written to output.
-
-*  ``color``
-
-   / *Condition*: optional / *Type*: str / *Default*: None /
-
-   Color style for the message.
-
-*  ``indent``
-
-   / *Condition*: optional / *Type*: int / *Default*: 0 /
-
-   Offset indent.
-
-**Returns:**
-
-(*no returns*)
-      """
-      if color==None:
-         color = cls.color_normal
-      if cls.output_console:
-         print(cls.prefix_all + cls.color_reset + color + " "*indent + msg + cls.color_reset)
-      if cls.output_logfile!=None and os.path.isfile(cls.output_logfile):
-         with open(cls.output_logfile, 'a') as f:
-            f.write(" "*indent + msg)
-      return
-
-   @classmethod
-   def log_warning(cls, msg, indent=0):
-      """
-Write warning message to console/file output.
-
-**Arguments:**
-
-*  ``msg``
-
-   / *Condition*: required / *Type*: str /
-
-   Warning message which is written to output.
-
-*  ``indent``
-
-   / *Condition*: optional / *Type*: int / *Default*: 0 /
-
-   Offset indent.
-
-**Returns:**
-
-(*no returns*)
-      """
-      cls.log(cls.prefix_warn+str(msg), cls.color_warn, indent)
-
-   @classmethod
-   def log_error(cls, msg, fatal_error=False, indent=0):
-      """
-Write error message to console/file output.
-
-*  ``msg``
-
-   / *Condition*: required / *Type*: str /
-
-   Error message which is written to output.
-
-*  ``fatal_error``
-
-   / *Condition*: optional / *Type*: bool / *Default*: False /
-
-   If set, tool will terminate after logging error message.
-
-*  ``indent``
-
-   / *Condition*: optional / *Type*: int / *Default*: 0 /
-
-   Offset indent.
-
-**Returns:**
-
-(*no returns*)
-      """
-      prefix = cls.prefix_error
-      if fatal_error:
-         prefix = cls.prefix_fatalerror
-
-      cls.log(prefix+str(msg), cls.color_error, indent)
-      if fatal_error:
-         cls.log(f"{sys.argv[0]} has been stopped!", cls.color_error)
-         exit(1)
-
 
 def get_from_tags(lTags, reInfo):
    """
@@ -380,7 +225,7 @@ Default schema supports below information:
          # TESTCASE_NAME is not available for non-testcase relevant resources
          # TESTSUITE_NAME is not available for `buildrecord` and `configuration` resources
          # Warning user for using wrong place holders
-         oMatch = re.search(".*\{(.*)\}.*", dConfig[key])
+         oMatch = re.search(r".*\{(.*)\}.*", dConfig[key])
          if oMatch:
             if oMatch.group(1) not in CRQMClient.SUPPORTED_PLACEHOLDER:
                Logger.log_warning(f"Place holder '{{{oMatch.group(1)}}}' is not supported, it will not be replaced when generating {key} resource")

RobotLog2RQM/rqmtool.py

@@ -0,0 +1,392 @@
+#  Copyright 2020-2023 Robert Bosch GmbH
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+# ******************************************************************************
+#
+# File: rqmtool.py
+#
+# Initially created by Tran Duy Ngoan(RBVH/EMC51) / October 2025
+#
+# This tool is used to fetch RQM resources
+#
+# History:
+#
+# 2025-10-20:
+#  - initial version
+#
+# ******************************************************************************
+
+import argparse
+import os
+import csv
+import json
+
+from RobotLog2RQM.CRQM import CRQMClient
+from RobotLog2RQM.logger import Logger
+from RobotLog2RQM.version import VERSION, VERSION_DATE
+
+OUTPUT_FORMATS = ['json', 'csv']
+ARTIFACT_TYPES = ['testcase', 'testsuite']
+
+def __process_commandline():
+   """
+Process provided argument(s) from command line.
+
+**Arguments:**
+
+(*no arguments*)
+
+**Returns:**
+
+   / *Type*: `ArgumentParser` object /
+
+   ArgumentParser object.
+   """
+   parser = argparse.ArgumentParser(
+      prog="RQMTool",
+      description="Fetch RQM resources."
+   )
+
+   parser.add_argument(
+      '-v', '--version',
+      action='version',
+      version=f'v{VERSION} ({VERSION_DATE})',
+      help='Version of the RQMTool.'
+   )
+   parser.add_argument(
+      "--host",
+      required=True,
+      help="RQM server URL."
+   )
+   parser.add_argument(
+      "--project",
+      required=True,
+      help="RQM project."
+   )
+   parser.add_argument(
+      "--user",
+      required=True,
+      help="RQM username."
+   )
+   parser.add_argument(
+      "--password",
+      required=True,
+      help="RQM password."
+   )
+   # exclusive group to provdve only --testsuite or --testplan
+   group = parser.add_mutually_exclusive_group(required=True)
+   group.add_argument(
+      "--testplan",
+      help="RQM testplan ID."
+   )
+   group.add_argument(
+      "--testsuite",
+      help="RQM testsuite ID."
+   )
+   parser.add_argument(
+      "--stream",
+      type=str,
+      help="project stream. Note, requires Configuration Management (CM) to be enabled for the project area."
+   )
+   parser.add_argument(
+      '--baseline',
+      type=str,
+      help='project baseline. Note, requires Configuration Management (CM), or Baselines Only to be enabled for the project area.'
+   )
+   parser.add_argument(
+      "--dryrun",
+      action="store_true",
+      help='if set, then verify all input arguments (includes RQM authentication) and show what would be done.')
+   parser.add_argument(
+      "--format",
+      default="csv",
+      choices=OUTPUT_FORMATS,
+      help="Output format (csv or json). Default is csv.")
+   parser.add_argument(
+      "--types",
+      default="testcase,testsuite",
+      help="Comma-separated list of artifact types to fetch. Allowed: testcase, testsuite.")
+   parser.add_argument(
+      "--output-dir",
+      default=".",
+      help="Directory to save output files.")
+   parser.add_argument(
+      "--basename",
+      default="testplan_export",
+      help="Base name for output files.")
+   return parser.parse_args()
+
+def __validate_arguments(arguments):
+   """
+Validate and normalize command line arguments.
+
+**Arguments:**
+
+*  ``arguments``
+
+   / *Condition*: required / *Type*: `ArgumentParser` object  /
+
+   Parsed arguments from __process_commandline().
+
+**Returns:**
+
+*  ``arguments``
+
+   / *Type*: `ArgumentParser` object /
+
+   ArgumentParser object.
+   """
+   artifact_types = arguments.types
+   if isinstance(artifact_types, str):
+      artifact_types = [x.strip().lower() for x in artifact_types.split(',')]
+   elif isinstance(artifact_types, (list, tuple)):
+      artifact_types = [x.lower() for x in artifact_types]
+   else:
+      raise TypeError(f"Invalid type for '--types': {type(artifact_types).__name__}, expected str or list.")
+
+   for t in artifact_types:
+      if t not in ARTIFACT_TYPES:
+         raise ValueError(
+               f"Invalid artifact type '{t}'. Allowed: {', '.join(ARTIFACT_TYPES)}."
+         )
+   arguments.types = artifact_types
+
+   return arguments
+
+def write_json_file(file_name, data):
+   """
+Write data to a JSON file.
+
+**Arguments:**
+
+*  ``file_name``
+
+   / *Condition*: required / *Type*: str /
+
+   Path of the JSON file to write.
+
+*  ``data``
+
+   / *Condition*: required / *Type*: dict /
+
+   Data to export.
+
+**Returns:**
+
+(*no returns*)
+   """
+   with open(file_name, 'w', encoding='utf-8') as f:
+      json.dump(data, f, indent=2, ensure_ascii=False)
+   Logger.log(f"Exported data to: {file_name}")
+
+def write_csv_file(file_name, data, artifact_type):
+   """
+Write data to a CSV file for a specific artifact type.
+
+**Arguments:**
+
+*  ``file_name``
+
+   / *Condition*: required / *Type*: str /
+
+   Path of the CSV file to write.
+
+*  ``data``
+
+   / *Condition*: required / *Type*: dict /
+
+   Data dictionary containing artifacts.
+
+* ``artifact_type``
+
+   / *Condition*: required / *Type*: str /
+
+   Artifact type (`testcase` or `testsuite`) to export.
+
+**Returns:**
+
+(*no returns*)
+   """
+   artifact_data = data.get(artifact_type, [])
+   if not artifact_data:
+      Logger.log_warning(f"No data for '{artifact_type}', skipping CSV export.")
+      return
+
+   fieldnames = list(data[artifact_type][0].keys()) if data[artifact_type] else ["id", "name"]
+   with open(file_name, mode="w", newline='', encoding="utf-8") as f:
+      writer = csv.DictWriter(f, fieldnames=fieldnames)
+      writer.writeheader()
+      for row in data[artifact_type]:
+         writer.writerow(row)
+   Logger.log(f"Exported {artifact_type} to: {file_name}")
+
+def write_output_file(data, output_dir=".", basename="testplan_export", extension="csv", artifact_types=None):
+   """
+Write data to output files (JSON or CSV) according to specified options.
+
+**Arguments:**
+
+*  ``data``
+
+   / *Condition*: required / *Type*: dict /
+
+   Data dictionary containing artifacts.
+
+*  ``output_dir``
+
+   / *Condition*: optional / *Type*: str /
+
+   Directory to save output files. Default is current directory.
+
+*  ``basename``
+
+   / *Condition*: optional / *Type*: str /
+
+   Base name for output files. Default is "testplan_export".
+
+*  ``extension``
+
+   / *Condition*: optional / *Type*: str /
+
+   Output format: `json` or `csv`. Default is `csv`.
+
+*  ``artifact_types``
+
+   / *Condition*: optional / *Type*: list /
+
+   Artifact types to export. Default is all supported types.
+
+**Returns:**
+
+(*no returns*)
+   """
+   if extension == 'json':
+      file_name = os.path.join(output_dir, f"{basename}.json")
+      write_json_file(file_name, data)
+   else:
+      # CSV export: one file per artifact_type
+      for artifact_type in (artifact_types or ARTIFACT_TYPES):
+         file_name = os.path.join(output_dir, f"{basename}_{artifact_type}s.csv")
+         write_csv_file(file_name, data, artifact_type)
+
+def normalize_custom_attributes(data, artifact_types):
+   """
+Ensure all artifacts across projects have consistent keys.
+Missing custom attributes will be filled with empty strings.
+
+**Arguments:**
+
+*  ``data``
+
+   / *Condition*: required / *Type*: dict /
+
+   Dictionary containing artifact data fetched from RQM, where each key represents
+   an artifact type (e.g., ``testcase``, ``testsuite``) and the value is a list
+   of dictionaries holding artifact details.
+
+*  ``artifact_types``
+
+   / *Condition*: required / *Type*: list /
+
+   List of artifact types to process (e.g., ``['testcase', 'testsuite']``).
+   Each type key in ``data`` will be normalized to ensure all items have the same set of attributes.
+
+**Returns:**
+
+*  ``data``
+
+   / *Type*: dict /
+
+   Normalized dictionary with consistent keys across all artifacts.
+   Any missing custom attributes are added with an empty string ("") as value.
+   """
+   for artifact_type in artifact_types:
+      artifacts = data.get(artifact_type, [])
+      if not artifacts:
+         continue
+
+      # Collect all keys (standard + custom attributes)
+      all_keys = set()
+      for item in artifacts:
+         all_keys.update(item.keys())
+
+      # Fill missing attributes with empty string
+      for item in artifacts:
+         for key in all_keys:
+               if key not in item:
+                  item[key] = ""
+
+   return data
+
+
+def RQMTool():
+   """
+Main entry point for RQMTool CLI.
+
+**Arguments:**
+
+(*no arguments*)
+
+**Returns:**
+
+(*no returns*)
+   """
+   args = __process_commandline()
+   __validate_arguments(args)
+   Logger.config(dryrun=args.dryrun)
+
+   RQMClient = CRQMClient(args.user, args.password, args.project, args.host)
+   try:
+      bSuccess = RQMClient.login()
+      RQMClient.config(stream=args.stream, baseline=args.baseline)
+      if bSuccess:
+         Logger.log()
+         Logger.log(f"Login RQM as user '{args.user}' successfully!")
+      else:
+         Logger.log_error("Could not login to RQM: 'Unknown reason'.")
+   except Exception as reason:
+      Logger.log_error(f"Could not login to RQM: '{str(reason)}'.")
+
+   if not args.dryrun:
+      if args.testplan:
+         artifact_types = args.types
+         basename_with_id = f"{args.basename}_{args.testplan}"
+         test_data = RQMClient.getTestArtifactsFromResource('testplan', args.testplan, args.types)
+         test_data = normalize_custom_attributes(test_data, artifact_types)
+      elif args.testsuite:
+         artifact_types = ['testcase']
+         if args.basename == "testplan_export":
+            basename_with_id = f"testsuite_export_{args.testsuite}"
+         else:
+            basename_with_id = f"{args.basename}_{args.testsuite}"
+         test_data = RQMClient.getTestArtifactsFromResource('testsuite', args.testsuite, artifact_types)
+         test_data = normalize_custom_attributes(test_data, artifact_types)
+
+      write_output_file(
+         test_data,
+         output_dir=args.output_dir,
+         basename=basename_with_id,
+         extension=args.format,
+         artifact_types=artifact_types
+      )
+
+      for artifact_type in artifact_types:
+         items = test_data.get(artifact_type, [])
+         Logger.log(f"Found {len(items)} {artifact_type}(s)")
+         cnt = 1
+         for item in items:
+            Logger.log(f"{cnt:>3}. {item['id']} - {item['name']}", indent=2)
+            cnt += 1
+
+if __name__ == "__main__":
+   RQMTool()

RobotLog2RQM/version.py

@@ -18,5 +18,5 @@
 #
 # Version and date of RobotLog2RQM
 #
-VERSION      = "1.4.2"
-VERSION_DATE = "18.02.2025"
+VERSION      = "1.6.0"
+VERSION_DATE = "10.11.2025"

{robotframework_robotlog2rqm-1.4.2.dist-info → robotframework_robotlog2rqm-1.6.0.dist-info}/METADATA

@@ -1,12 +1,10 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: robotframework-robotlog2rqm
-Version: 1.4.2
+Version: 1.6.0
 Summary: Imports robot result(s) to IBM Rational Quality Manager (RQM)
 Home-page: https://github.com/test-fullautomation/robotframework-robotlog2rqm
 Author: Tran Duy Ngoan
 Author-email: Ngoan.TranDuy@vn.bosch.com
-License: UNKNOWN
-Platform: UNKNOWN
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
@@ -20,6 +18,16 @@ Requires-Dist: lxml
 Requires-Dist: requests
 Requires-Dist: colorama
 Requires-Dist: robotframework
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # RobotLog2RQM Description
 
@@ -129,15 +137,15 @@ Use below command to get tools\'s usage:
 
 The usage should be showed as below:
 
-    usage: RobotLog2RQM (RobotXMLResult to RQM importer) [-h] [-v] [--testsuite TESTSUITE] [--recursive] 
-                [--createmissing] [--updatetestcase] [--dryrun] [--stream STREAM] [--baseline BASELINE] 
+    usage: RobotLog2RQM (RobotXMLResult to RQM importer) [-h] [-v] [--testsuite TESTSUITE] [--recursive]
+                [--createmissing] [--updatetestcase] [--dryrun] [--stream STREAM] [--baseline BASELINE]
                 resultxmlfile host project user password testplan
 
-    RobotLog2RQM imports XML result files (default: output.xml) generated by the 
+    RobotLog2RQM imports XML result files (default: output.xml) generated by the
     Robot Framework into an IBM Rational Quality Manager.
 
     positional arguments:
-    resultxmlfile         absolute or relative path to the xml result file 
+    resultxmlfile         absolute or relative path to the xml result file
                           or directory of result files to be imported.
     host                  RQM host url.
     project               project on RQM.
@@ -149,19 +157,19 @@ The usage should be showed as below:
     -h, --help            show this help message and exit
     -v, --version         Version of the RobotLog2RQM importer.
     --testsuite TESTSUITE
-                            testsuite ID for this execution. If 'new', then create a new 
+                            testsuite ID for this execution. If 'new', then create a new
                             testsuite for this execution.
-    --recursive           if set, then the path is searched recursively for 
+    --recursive           if set, then the path is searched recursively for
                           log files to be imported.
-    --createmissing       if set, then all testcases without tcid are created 
+    --createmissing       if set, then all testcases without tcid are created
                           when importing.
-    --updatetestcase      if set, then testcase information on RQM will be updated 
+    --updatetestcase      if set, then testcase information on RQM will be updated
                           bases on robot testfile.
-    --dryrun              if set, then verify all input arguments 
+    --dryrun              if set, then verify all input arguments
                           (includes RQM authentication) and show what would be done.
-    --stream STREAM       project stream. Note, requires Configuration Management (CM) 
+    --stream STREAM       project stream. Note, requires Configuration Management (CM)
                           to be enabled for the project area.
-    --baseline BASELINE   project baseline. Note, requires Configuration Management (CM), 
+    --baseline BASELINE   project baseline. Note, requires Configuration Management (CM),
                           or Baselines Only to be enabled for the project area.
 
 The below command is simple usage witth all required arguments to import
@@ -213,6 +221,58 @@ Then, open RQM with your favourite browser and you will see that the
 test case execution records and their results are imported in the given
 testplan ID.
 
+# RQMTool Submodule
+
+The package now includes a submodule **RQMTool** which provides a
+standalone CLI to fetch test cases and test suites from IBM RQM test
+plans.
+
+RQMTool is accessible as a Python module:
+
+    python -m RobotLog2RQM.rqmtool --host <RQM_SERVER_URL> --project <PROJECT_AREA> \
+                                   --user <USERNAME> --password <PASSWORD> \
+                                   --testplan <TESTPLAN_ID> [--types <artifact_types>] \
+                                   [--format <csv|json>] [--output-dir <DIR>] \
+                                   [--basename <BASENAME>] [--dryrun]
+
+Main features:
+
+-   Fetches selected artifact types ([testcase]{.title-ref} or
+    [testsuite]{.title-ref}) from a given test plan.
+-   Supports CSV or JSON export, with automatic filenames including the
+    test plan ID.
+
+## How to use RQMTool
+
+RQMTool requires RQM information (host URL, project, credentials) and a
+test plan ID. Use the [-h]{.title-ref} argument to see full usage:
+
+    python -m RobotLog2RQM.rqmtool -h
+
+This will display all available command line options for RQMTool, such
+as:
+
+-   [\--types]{.title-ref} : artifact types to fetch
+    ([testcase]{.title-ref}, [testsuite]{.title-ref}). Default: both.
+-   \`\--format\`: output format, either [csv]{.title-ref} or
+    [json]{.title-ref}.
+-   \`\--output-dir\`: directory to save exported files.
+-   \`\--basename\`: base name for output files.
+-   \`\--dryrun\`: validate inputs and RQM login without fetching data.
+
+## Example
+
+Fetch all test cases and test suites from test plan ID 720 and export to
+CSV:
+
+    python -m RobotLog2RQM.rqmtool --host https://sample-rqm-host.com \
+                                   --project ROBFW-AIO \
+                                   --user test_user \
+                                   --password test_pw \
+                                   --testplan 720 \
+                                   --types testcase,testsuite \
+                                   --format csv
+
 ### Sourcecode Documentation
 
 To understand more detail about the tool\'s features and how Robot test
@@ -260,5 +320,3 @@ distributed under the License is distributed on an \"AS IS\" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-
-

robotframework_robotlog2rqm-1.6.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+RobotLog2RQM/CRQM.py,sha256=NxFbIKvTOepkdNmv0V9aQCaU2jSGhuHO707XTglMF_A,69357
+RobotLog2RQM/RobotLog2RQM.pdf,sha256=--VWUBLqZOtfQXy9O8N28MvOT7VMRPg9fSAQXl8coK0,358016
+RobotLog2RQM/__init__.py,sha256=YKDTJjDsnQkr5X-gjjO8opwKUVKm6kc8sIUpURYMk48,596
+RobotLog2RQM/__main__.py,sha256=JabttEncy80antJWeGVmjoXyiF1DyXxkxdW4xLuHzT0,681
+RobotLog2RQM/logger.py,sha256=FnZZqssOcrF5yK6wxkgifScoQcFGrqrvzLvXWY3V-9A,4252
+RobotLog2RQM/robotlog2rqm.py,sha256=zX8ibJqeQTPwtRF6zX-qHtT1d6jj1EI90vpaUL77FEM,30161
+RobotLog2RQM/rqmtool.py,sha256=s-rTI1MBby0SfQIBP-WRx5_frdtQBss86I9i04MBuy4,10564
+RobotLog2RQM/version.py,sha256=3E-s2UEJ2s5J5UVh1TPTW-T21mrSzBfY_KjCv-v7VQk,916
+RobotLog2RQM/RQM_templates/buildrecord.xml,sha256=uGot7pNOjPR8do0JsJi0Lz3OCU9NMhODRd428QgvHh4,1498
+RobotLog2RQM/RQM_templates/configuration.xml,sha256=NrFDv51fuGhgeMiZuRhQ5q_UJ0u_pWzdxisIF5AJs74,1378
+RobotLog2RQM/RQM_templates/executionresult.xml,sha256=WTp4qDk29peBc0ll6GHVXX_kF_YBsOVjy9vBzoz7_2k,2160
+RobotLog2RQM/RQM_templates/executionworkitem.xml,sha256=3GYO-nvXcG-HDQZnDzGwYZSQOWAUNckT3_GUa8Ze2Eo,1511
+RobotLog2RQM/RQM_templates/suiteexecutionrecord.xml,sha256=9GAs2WqZMkFJSNEZULm9BJvQy02dl_2JMecpQPHGTPA,1389
+RobotLog2RQM/RQM_templates/testcase.xml,sha256=zovFKj-37QHn2S8mMA_9RnAJ3zBmDJkJj31yelsnFFI,2167
+RobotLog2RQM/RQM_templates/testsuite.xml,sha256=r2ijEsyPoE7qzCtUxgIHDOEcqUveDN4SMf9HSE9b0ZU,1326
+RobotLog2RQM/RQM_templates/testsuitelog.xml,sha256=l-NlaCyk6Ben76PElXKOHfMlEvyQ-e9MOZ6-F9HvwDQ,1920
+robotframework_robotlog2rqm-1.6.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+robotframework_robotlog2rqm-1.6.0.dist-info/METADATA,sha256=k834p4eH88hGgfxhwifUu7ms7TXY83tJCty1uIS8WCA,12028
+robotframework_robotlog2rqm-1.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+robotframework_robotlog2rqm-1.6.0.dist-info/entry_points.txt,sha256=yLoNhxm2lfj3FxMx3Orct8db4qkPLII8u241GAH6BB0,111
+robotframework_robotlog2rqm-1.6.0.dist-info/top_level.txt,sha256=jb_Gt6W44FoOLtGfBe7RzqCLaquhihkEWvSI1zjXDHc,13
+robotframework_robotlog2rqm-1.6.0.dist-info/RECORD,,

{robotframework_robotlog2rqm-1.4.2.dist-info → robotframework_robotlog2rqm-1.6.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.45.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{robotframework_robotlog2rqm-1.4.2.dist-info → robotframework_robotlog2rqm-1.6.0.dist-info}/entry_points.txt

@@ -1,3 +1,3 @@
 [console_scripts]
+RQMTool = RobotLog2RQM.rqmtool:RQMTool
 RobotLog2RQM = RobotLog2RQM.robotlog2rqm:RobotLog2RQM
-

robotframework_robotlog2rqm-1.4.2.dist-info/RECORD

@@ -1,20 +0,0 @@
-RobotLog2RQM/CRQM.py,sha256=sL7IsFOhzRVvV2n_g2PFDjL3Ej8YChUl3PDTv3LCIN0,64363
-RobotLog2RQM/RobotLog2RQM.pdf,sha256=utfSCdhRtw6mtljc-WMaG4GqRn7yggyZNcOeCota40Y,337295
-RobotLog2RQM/__init__.py,sha256=YKDTJjDsnQkr5X-gjjO8opwKUVKm6kc8sIUpURYMk48,596
-RobotLog2RQM/__main__.py,sha256=JabttEncy80antJWeGVmjoXyiF1DyXxkxdW4xLuHzT0,681
-RobotLog2RQM/robotlog2rqm.py,sha256=Q35lrrDDv3skXJO6IH9hRRoU0Ua0kSKOuBdpNeF_v5s,33531
-RobotLog2RQM/version.py,sha256=XS3UlCLUKUcaTFjKhJ6Pj4bN04WACmWEz7cmWTadZ1A,916
-RobotLog2RQM/RQM_templates/buildrecord.xml,sha256=uGot7pNOjPR8do0JsJi0Lz3OCU9NMhODRd428QgvHh4,1498
-RobotLog2RQM/RQM_templates/configuration.xml,sha256=NrFDv51fuGhgeMiZuRhQ5q_UJ0u_pWzdxisIF5AJs74,1378
-RobotLog2RQM/RQM_templates/executionresult.xml,sha256=WTp4qDk29peBc0ll6GHVXX_kF_YBsOVjy9vBzoz7_2k,2160
-RobotLog2RQM/RQM_templates/executionworkitem.xml,sha256=3GYO-nvXcG-HDQZnDzGwYZSQOWAUNckT3_GUa8Ze2Eo,1511
-RobotLog2RQM/RQM_templates/suiteexecutionrecord.xml,sha256=9GAs2WqZMkFJSNEZULm9BJvQy02dl_2JMecpQPHGTPA,1389
-RobotLog2RQM/RQM_templates/testcase.xml,sha256=zovFKj-37QHn2S8mMA_9RnAJ3zBmDJkJj31yelsnFFI,2167
-RobotLog2RQM/RQM_templates/testsuite.xml,sha256=r2ijEsyPoE7qzCtUxgIHDOEcqUveDN4SMf9HSE9b0ZU,1326
-RobotLog2RQM/RQM_templates/testsuitelog.xml,sha256=l-NlaCyk6Ben76PElXKOHfMlEvyQ-e9MOZ6-F9HvwDQ,1920
-robotframework_robotlog2rqm-1.4.2.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-robotframework_robotlog2rqm-1.4.2.dist-info/METADATA,sha256=JEeig_C3ceOdSoP9UauelzVEHm6l6S7gvd8S6Us8zO4,9863
-robotframework_robotlog2rqm-1.4.2.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-robotframework_robotlog2rqm-1.4.2.dist-info/entry_points.txt,sha256=-Xug2kDJW2LtcSADEVPtCwa337twCy2iGh5aK7xApHA,73
-robotframework_robotlog2rqm-1.4.2.dist-info/top_level.txt,sha256=jb_Gt6W44FoOLtGfBe7RzqCLaquhihkEWvSI1zjXDHc,13
-robotframework_robotlog2rqm-1.4.2.dist-info/RECORD,,