testbench2robotframework 0.8.0a7__tar.gz → 0.9.0a1__tar.gz

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testbench2robotframework
-Version: 0.8.0a7
+Version: 0.9.0a1
 Summary: Robot Framework Code Generator from Keyword-Driven Tests in imbus TestBench 3.0 and newer
 Author-email: imbus AG <support@imbus.de>
 Requires-Python: >= 3.10

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/__init__.py

@@ -17,4 +17,4 @@ suites and enhancing the TestBench report with execution results from Robot Fram
 
 from .testbench2robotframework import testbench2robotframework  # noqa: F401
 
-__version__ = "0.8.0a7"
+__version__ = "0.9.0a1"

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/cli.py

@@ -119,6 +119,15 @@ def testbench2robotframework_cli():
     help="""TestBench root subdivision which's direct
          children correspond to Robot Framework libraries.""",
 )
+@click.option(
+    "--metadata",
+    multiple=True,
+    callback=parse_subdivision_mapping,
+    help="""Add extra metadata to the settings of the generated Robot Framework test suite. 
+        Provide entries as key:value pairs, where *key* is the metadata name and *value* is the corresponding value. 
+        Values may also be Python expressions. 
+        The special variable '$tcs' gives access to the TestBench Python model of the test case set.""",
+)
 @click.option(
     "--resource-regex",
     multiple=True,
@@ -157,6 +166,7 @@ def generate_tests(  # noqa: PLR0913
     resource_directory_regex: str,
     library_root: tuple[str],
     log_suite_numbering: bool,
+    metadata: dict[str, str],
     output_directory: Path,
     resource_directory: Path,
     resource_regex: tuple[str],
@@ -187,7 +197,7 @@ def generate_tests(  # noqa: PLR0913
         configuration["log-suite-numbering"] = True
     else:
         configuration["log-suite-numbering"] = configuration.get("log-suite-numbering", False)
-
+    configuration["metadata"] = metadata or configuration.get("metadata", {})
     configuration["compound-interaction-logging"] = (
         compound_interaction_logging or configuration.get("compound-interaction-logging", "GROUP")
     )

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/config.py

@@ -193,6 +193,7 @@ class Configuration:
     library_root: list[str]
     log_suite_numbering: bool
     loggingConfiguration: LoggingConfig
+    metadata: dict[str, str]
     output_directory: str
     phasePattern: str
     referenceBehaviour: ReferenceBehaviour
@@ -227,6 +228,7 @@ class Configuration:
                     "file":dictionary.get("file-logging", {})
                 }
             ),
+            metadata=dictionary.get("metadata", {}),
             compound_interaction_logging=CompoundInteractionLogging(dictionary.get("compound-interaction-logging", "GROUP").upper()),
             resource_directory=dictionary.get("resource-directory", "").replace(
                 "\\", "/"

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/model.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yml
-#   timestamp: 2025-08-04T13:02:46+00:00
+#   timestamp: 2025-11-07T10:20:17+00:00
 
 from __future__ import annotations
 
@@ -135,8 +135,8 @@ class SequencePhase(Enum):
 
 
 class InteractionCallType(Enum):
-    Check = 'Check'
     Flow = 'Flow'
+    Check = 'Check'
 
 
 class InteractionType(Enum):
@@ -237,6 +237,12 @@ class LoginSession:
     licenseWarning: Optional[LicenseWarning] = None
 
 
+@dataclass
+class ActiveUser:
+    login: str
+    contexts: List[str]
+
+
 @dataclass
 class TestLabel:
     key: str
@@ -268,6 +274,13 @@ class ProjectMember:
     roles: List[ProjectRole]
 
 
+@dataclass
+class UserInfo:
+    userKey: str
+    userLogin: str
+    userName: str
+
+
 @dataclass
 class ProjectSummary:
     key: str
@@ -567,7 +580,7 @@ class UserSummary:
 
 @dataclass
 class TestBenchVersions:
-    releaseVersion: str
+    version: str
     databaseVersion: str
     revision: str
 
@@ -627,6 +640,49 @@ class RequirementAssignment:
     repositoryId: str
 
 
+@dataclass
+class ReportItemsSummary:
+    testThemesCount: int
+    testCaseSetsCount: int
+    testCasesCount: int
+
+
+@dataclass
+class ServerLocation:
+    host: str
+    port: int
+
+
+@dataclass
+class ReportExportOptions:
+    pass
+
+
+@dataclass
+class ReportScope:
+    projectKey: str
+    tovKey: str
+    cycleKey: Optional[str] = None
+
+
+@dataclass
+class ReportCreation:
+    creator: UserInfo
+    startDate: str
+    endDate: str
+    scope: ReportScope
+    exportOptions: ReportExportOptions
+    summary: ReportItemsSummary
+
+
+@dataclass
+class ReportMetaInformation:
+    formatVersion: str
+    serverLocation: ServerLocation
+    reportCreation: ReportCreation
+    serverVersions: TestBenchVersions
+
+
 @dataclass
 class RequirementReference:
     key: str
@@ -765,17 +821,6 @@ class TestCaseExecutionDetails:
     tester: Optional[UserReference] = None
 
 
-@dataclass
-class TestCaseSetDetails:
-    key: str
-    numbering: str
-    uniqueID: str
-    name: str
-    spec: TestCaseSetSpecificationSummary
-    testCases: List[TestCaseSummary]
-    exec: Optional[TestCaseSetExecutionSummary] = None
-
-
 class KindOfDataType(Enum):
     Regular = 'Regular'
     Reference = 'Reference'
@@ -799,9 +844,22 @@ class ParameterDefinitionType(Enum):
     AtomicInstance = 'AtomicInstance'
 
 
+@dataclass
+class ParameterValue:
+    name: str
+    key: str
+    dtSequenceKeys: List[str]
+
+
+@dataclass
+class InstanceArrayValue:
+    name: str
+    isDefaultValue: bool
+
+
 class ParameterEvaluationType(Enum):
-    CallByReference = 'CallByReference'
     CallByValue = 'CallByValue'
+    CallByReference = 'CallByReference'
     CallByReferenceMandatory = 'CallByReferenceMandatory'
 
 
@@ -849,7 +907,7 @@ class FilterInfo:
 
 
 @dataclass
-class TovStructureOptions:
+class TovStructureOptions(ReportExportOptions):
     treeRootUID: Optional[str] = None
     suppressFilteredData: Optional[bool] = None
     suppressEmptyTestThemes: Optional[bool] = None
@@ -867,7 +925,7 @@ class CycleStructureOptions:
 
 
 @dataclass
-class CycleReportOptions:
+class CycleReportOptions(ReportExportOptions):
     treeRootUID: Optional[str] = None
     executionMode: Optional[ExecutionMode] = None
     suppressFilteredData: Optional[bool] = None
@@ -1008,6 +1066,13 @@ class ExecutionImportingFailure(ExecutionImportingResult):
     error: ActionFailure
 
 
+@dataclass
+class CheckedInElement:
+    elementName: str
+    newlyCheckedIn: bool
+    versionName: str
+
+
 @dataclass
 class TestCaseExecutionImportResult:
     key: str
@@ -1019,12 +1084,15 @@ class TestCaseExecutionImportResult:
 
 
 @dataclass
-class ExecutionImportOptions:
+class CheckInData:
+    comment: str
+    label: Optional[str] = None
+
+
+@dataclass
+class ExecutionImportSimulationOptions:
     fileName: str
     treeRootUID: Optional[str] = None
-    useExistingDefect: Optional[bool] = None
-    discardTesterInformation: Optional[bool] = None
-    defaultTester: Optional[str] = None
     filters: Optional[List[FilterInfo]] = None
 
 
@@ -1033,6 +1101,14 @@ class UploadedFile:
     fileName: str
 
 
+@dataclass
+class TestStructureElement:
+    key: str
+    uniqueID: str
+    name: str
+    executionKey: str
+
+
 @dataclass
 class TestThemeExecution:
     key: str
@@ -1063,6 +1139,12 @@ class TestObjectVersionCSVReportOptions:
     characterEncoding: Optional[str] = None
 
 
+@dataclass
+class JWTResponse:
+    accessToken: str
+    expiresAt: str
+
+
 @dataclass
 class TestCycleCSVReportOptions:
     reportRootUID: Optional[str] = None
@@ -1261,12 +1343,73 @@ class InteractionCallExecution:
     tester: Optional[UserReference] = None
 
 
+class Permission(Enum):
+    AccessSecuredData = 'AccessSecuredData'
+    DeleteUserAccount = 'DeleteUserAccount'
+    DeleteUserSession = 'DeleteUserSession'
+    DownloadReportFile = 'DownloadReportFile'
+    ImportExecutionResults = 'ImportExecutionResults'
+    ModifyGlobalTestLabels = 'ModifyGlobalTestLabels'
+    ModifyProjectDetails = 'ModifyProjectDetails'
+    ModifyProjectUDFs = 'ModifyProjectUDFs'
+    ModifySpecifications = 'ModifySpecifications'
+    ModifySpecManagementInfo = 'ModifySpecManagementInfo'
+    ModifySpecPriorityAndDueDate = 'ModifySpecPriorityAndDueDate'
+    ModifyTestElements = 'ModifyTestElements'
+    ModifyTestLabels = 'ModifyTestLabels'
+    ModifyUserData = 'ModifyUserData'
+    ModifyUserRolesInProject = 'ModifyUserRolesInProject'
+    PrivatizeGlobalTestLabels = 'PrivatizeGlobalTestLabels'
+    ReadActiveUsersList = 'ReadActiveUsersList'
+    ReadCompleteProjectsList = 'ReadCompleteProjectsList'
+    ReadCompleteUsersList = 'ReadCompleteUsersList'
+    ReadCycleReport = 'ReadCycleReport'
+    ReadCycleReportOverRMI = 'ReadCycleReportOverRMI'
+    ReadCycleRequirements = 'ReadCycleRequirements'
+    ReadDefectsMetricDistribution = 'ReadDefectsMetricDistribution'
+    ReadExecutionImportingJobDetails = 'ReadExecutionImportingJobDetails'
+    ReadInvisibleProjectContent = 'ReadInvisibleProjectContent'
+    ReadOwnProjectsList = 'ReadOwnProjectsList'
+    ReadOwnUserDetails = 'ReadOwnUserDetails'
+    ReadProjectDefectsAndTheirAssignments = 'ReadProjectDefectsAndTheirAssignments'
+    ReadProjectDetails = 'ReadProjectDetails'
+    ReadProjectExportOverRMI = 'ReadProjectExportOverRMI'
+    ReadProjectHierarchy = 'ReadProjectHierarchy'
+    ReadProjectMembers = 'ReadProjectMembers'
+    ReadProjectUDFs = 'ReadProjectUDFs'
+    ReadReportingJobDetails = 'ReadReportingJobDetails'
+    ReadTestCaseDetails = 'ReadTestCaseDetails'
+    ReadTestCaseSetDetails = 'ReadTestCaseSetDetails'
+    ReadTestElements = 'ReadTestElements'
+    ReadTestLabels = 'ReadTestLabels'
+    ReadTestThemeDetails = 'ReadTestThemeDetails'
+    ReadTestThemeStatusDistribution = 'ReadTestThemeStatusDistribution'
+    ReadTestThemeTree = 'ReadTestThemeTree'
+    ReadTovReport = 'ReadTovReport'
+    ReadTovReportOverRMI = 'ReadTovReportOverRMI'
+    ReadTovRequirements = 'ReadTovRequirements'
+    ReadUserDetails = 'ReadUserDetails'
+    ReadUserMemberships = 'ReadUserMemberships'
+    ReadUserSessions = 'ReadUserSessions'
+    RestrictProjectUDFs = 'RestrictProjectUDFs'
+    SynchronizeUsers = 'SynchronizeUsers'
+    UnlockForeignSpecs = 'UnlockForeignSpecs'
+    UnlockForeignTestElements = 'UnlockForeignTestElements'
+
+
 @dataclass
 class DefaultValue:
     name: str
     valueType: ArgumentValueType
 
 
+@dataclass
+class InteractionParameterForInsert:
+    name: str
+    dataTypeKey: Optional[str] = None
+    evaluationType: Optional[ParameterEvaluationType] = None
+
+
 @dataclass
 class ParameterDetails:
     key: str
@@ -1322,14 +1465,10 @@ class ReferenceAssignment:
 
 
 @dataclass
-class ParameterSummary:
-    definitionType: ParameterDefinitionType
-    key: str
+class RepresentativeValue:
     name: str
-    evaluationType: ParameterEvaluationType
     valueType: RepresentativeType
-    dataType: Optional[DataTypeSummary] = None
-    value: Optional[str] = None
+    isDefaultValue: bool
 
 
 @dataclass
@@ -1425,11 +1564,34 @@ class ExecutionImportingCompletion:
 class TestCaseSetExecutionImportResult:
     key: str
     executionKey: str
+    name: str
+    uid: str
     finished: bool
     testCases: List[TestCaseExecutionImportResult]
     error: Optional[ActionFailure] = None
 
 
+@dataclass
+class ExecutionImportOptions:
+    fileName: str
+    treeRootUID: Optional[str] = None
+    useExistingDefect: Optional[bool] = None
+    discardTesterInformation: Optional[bool] = None
+    defaultTester: Optional[str] = None
+    filters: Optional[List[FilterInfo]] = None
+    checkInData: Optional[CheckInData] = None
+
+
+@dataclass
+class JWTDataOptions:
+    permissions: List[Permission]
+    projectKey: Optional[str] = None
+    tovKey: Optional[str] = None
+    cycleKey: Optional[str] = None
+    subject: Optional[str] = None
+    expiresAfterSeconds: Optional[int] = None
+
+
 @dataclass
 class UDFPosition:
     after: Optional[AfterUDF] = None
@@ -1483,29 +1645,6 @@ class ImageInfo:
     value: ImageDetails
 
 
-@dataclass
-class InteractionCallSpecification:
-    key: str
-    interactionType: InteractionType
-    name: str
-    sequencePhase: SequencePhase
-    callType: InteractionCallType
-    comments: str
-    callParameters: List[ParameterSummary]
-    description: Optional[str] = None
-    interactionKey: Optional[str] = None
-    callingInteractionKey: Optional[str] = None
-
-
-@dataclass
-class InteractionCall:
-    sequenceID: str
-    numbering: str
-    spec: InteractionCallSpecification
-    parentID: Optional[str] = None
-    exec: Optional[InteractionCallExecution] = None
-
-
 @dataclass
 class InteractionDetails:
     key: str
@@ -1538,14 +1677,17 @@ class ProjectNode:
 
 
 @dataclass
-class TestCaseDetails:
-    uniqueID: str
-    spec: TestCaseSpecificationDetails
-    testSequence: List[InteractionCall]
-    parameters: List[ParameterSummary]
-    interactions: List[InteractionDetails]
-    exec: Optional[TestCaseExecutionDetails] = None
-    origin: Optional[TestCaseDetailsOrigin] = None
+class ParameterSummary:
+    definitionType: ParameterDefinitionType
+    key: str
+    name: str
+    evaluationType: ParameterEvaluationType
+    dataType: Optional[DataTypeSummary] = None
+    value: Optional[str] = None
+    valueType: Optional[RepresentativeType] = None
+    representativeValue: Optional[RepresentativeValue] = None
+    parameterValue: Optional[ParameterValue] = None
+    instanceArrayValue: Optional[InstanceArrayValue] = None
 
 
 @dataclass
@@ -1571,6 +1713,8 @@ class ExecutionImportingJob:
 @dataclass
 class ExecutionImportingSuccess(ExecutionImportingResult):
     testCaseSets: List[TestCaseSetExecutionImportResult]
+    checkedInTestStructureElements: List[TestStructureElement]
+    checkedInTestElements: List[CheckedInElement]
 
 
 @dataclass
@@ -1589,6 +1733,40 @@ class RichTextInfo:
     images: List[ImageInfo]
 
 
+@dataclass
+class InteractionCallSpecification:
+    key: str
+    name: str
+    sequencePhase: SequencePhase
+    callType: InteractionCallType
+    comments: str
+    callParameters: List[ParameterSummary]
+    interactionType: Optional[InteractionType] = None
+    description: Optional[str] = None
+    interactionKey: Optional[str] = None
+    callingInteractionKey: Optional[str] = None
+
+
+@dataclass
+class InteractionCall:
+    sequenceID: str
+    numbering: str
+    spec: InteractionCallSpecification
+    parentID: Optional[str] = None
+    exec: Optional[InteractionCallExecution] = None
+
+
+@dataclass
+class InteractionForInsert:
+    parentKey: str
+    name: str
+    parameters: List[InteractionParameterForInsert]
+    uid: Optional[str] = None
+    description: Optional[RichTextInfo] = None
+    advancedContent: Optional[AdvancedContent] = None
+    callType: Optional[InteractionCallType] = None
+
+
 @dataclass
 class InteractionDetailsForUpdate:
     name: Optional[str] = None
@@ -1642,6 +1820,31 @@ class TOVForUpdate:
     cloningVisibility: Optional[bool] = None
 
 
+@dataclass
+class TestCaseSetDetails:
+    key: str
+    numbering: str
+    uniqueID: str
+    name: str
+    spec: TestCaseSetSpecificationSummary
+    testCases: List[TestCaseSummary]
+    testSequence: List[InteractionCall]
+    parameters: List[ParameterDetails]
+    interactions: List[InteractionDetails]
+    exec: Optional[TestCaseSetExecutionSummary] = None
+
+
+@dataclass
+class TestCaseDetails:
+    uniqueID: str
+    spec: TestCaseSpecificationDetails
+    testSequence: List[InteractionCall]
+    parameters: List[ParameterSummary]
+    interactions: List[InteractionDetails]
+    exec: Optional[TestCaseExecutionDetails] = None
+    origin: Optional[TestCaseDetailsOrigin] = None
+
+
 @dataclass
 class CycleForUpdate:
     name: Optional[str] = None

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/result_writer.py

@@ -97,7 +97,7 @@ class ResultWriter(ResultVisitor):
         self.itb_test_case_catalog: dict[str, TestCaseDetails] = {}
         self.phase_pattern = config.phasePattern
         self.test_chain: list[TestCase] = []
-        self.main_protocol = from_dict(ExecutionImportingSuccess, {"testCaseSets": []})
+        self.main_protocol = from_dict(ExecutionImportingSuccess, {"testCaseSets": [], "checkedInTestStructureElements":[], "checkedInTestElements": []})
 
     def _create_artifact_storage(self):
         return ExecutionArtifactStorage(

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/testbench2rf.py

@@ -454,7 +454,17 @@ class RfTestCase:
         return cbr_parameters
 
     def _get_interaction_import_prefix(self, interaction: RFInteractionCall) -> str:
-        return (self.config.fully_qualified or False) * f"{interaction.import_prefix}."
+        for resource_regex in self.config.resource_regex:
+            if not interaction.import_prefix:
+                continue
+            resource_name_match = re.search(
+                resource_regex, interaction.import_prefix, flags=re.IGNORECASE
+            )
+            if resource_name_match:
+                return (
+                    self.config.fully_qualified or False
+                ) * f"{resource_name_match.group('resourceName').strip()}."
+        return ""
 
     def _get_interaction_indent(self, interaction: RFInteractionCall) -> str:
         return (
@@ -711,15 +721,19 @@ class RobotSuiteFileBuilder:
         resource_name_index = self._get_resource_path_index(resource)
         cropped_interaction_path = []
         if resource_dir_index is None:
-            return f"{resource_name}.resource"
-        cropped_interaction_path.extend(
-            splitted_interaction_path[resource_dir_index + 1 : resource_name_index]
-        )
-        resource_path = Path(
-            self.config.resource_directory,
-            *cropped_interaction_path,
-            f"{resource_name}.resource",
-        ).as_posix()
+            resource_path = Path(
+                self.config.resource_directory,
+                f"{resource_name}.resource",
+            ).as_posix()
+        else:
+            cropped_interaction_path.extend(
+                splitted_interaction_path[resource_dir_index + 1 : resource_name_index]
+            )
+            resource_path = Path(
+                self.config.resource_directory,
+                *cropped_interaction_path,
+                f"{resource_name}.resource",
+            ).as_posix()
         resource_path = self.config.subdivisionsMapping.resources.get(resource_name, resource_path)
         resource_path = re.sub(
             r"^{resourceDirectory}", self.config.resource_directory, resource_path
@@ -811,6 +825,21 @@ class RobotSuiteFileBuilder:
         setting_section.body.extend(self._create_rf_resource_imports(subdivisions))
         setting_section.body.extend(self._create_rf_unknown_imports(subdivisions))
         setting_section_meta_data = self.test_case_set.metadata
+        for md_name, md_expression in self.config.metadata.items():
+            from .utils import safe_eval
+            md_expression = re.sub(r"\$tcs", "tcs", md_expression)
+            try:
+                setting_section_meta_data[md_name] = safe_eval(
+                    md_expression, {"tcs": self.test_case_set.details}
+                )
+            except ValueError as ve:
+                logger.warning(
+                    f"Value '{md_expression}' from the custom metadata setting could not be evaluated: {ve}"
+                )
+            except Exception as e:
+                logger.error(
+                    f"Error while evaluating the custom metadata setting '{md_expression}': {e}"
+                )
         setting_section.body.extend(
             [
                 create_meta_data(metadata_name, metadata_value)

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/testbench2robotframework.py

@@ -15,6 +15,7 @@ def testbench2robotframework(testbench_report: str, config: dict):
     setup_logger(configuration)
     logger.debug("Configuration loaded.")
     testbench_report = Path(testbench_report)
+    temp_dir = None
     try:
         if is_zip_file(testbench_report):
             temp_dir = tempfile.TemporaryDirectory(dir=Path.cwd())
@@ -41,6 +42,6 @@ def testbench2robotframework(testbench_report: str, config: dict):
             return
         write_test_suites(test_suites, configuration)
     except Exception as exception:
-        if temp_dir:
+        if temp_dir is not None:
             temp_dir.cleanup()
         raise exception

{testbench2robotframework-0.8.0a7 → testbench2robotframework-0.9.0a1}/testbench2robotframework/utils.py

@@ -1,3 +1,4 @@
+import ast
 import re
 import shutil
 import sys
@@ -96,6 +97,57 @@ class PathResolver:
         return index.zfill(max_length)
 
 
+def safe_eval(expr: str, names: dict):
+    tree = ast.parse(expr, mode="eval")
+    allowed_nodes = (
+        ast.Expression,
+        ast.Call,
+        ast.Attribute,
+        ast.Load,
+        ast.Name,
+        ast.ListComp,
+        ast.GeneratorExp,
+        ast.comprehension,
+        ast.List,
+        ast.Tuple,
+        ast.Constant,
+        ast.Subscript,
+        ast.JoinedStr,
+        ast.FormattedValue,
+        ast.BinOp,
+        ast.UnaryOp,
+        ast.Compare,
+        ast.BoolOp,
+        ast.Eq,
+        ast.NotEq,
+        ast.Gt,
+        ast.Lt,
+        ast.GtE,
+        ast.LtE,
+        ast.In,
+        ast.And,
+        ast.Or,
+        ast.Not,
+        ast.Add,
+        ast.Sub,
+        ast.Mult,
+        ast.Div,
+        ast.Mod,
+        ast.Store,
+        ast.keyword,
+    )
+    for node in ast.walk(tree):
+        if not isinstance(node, allowed_nodes):
+            raise ValueError(f"Disallowed expression: {type(node).__name__}")
+        if isinstance(node, ast.Attribute) and node.attr.startswith("_"):
+            raise ValueError(f"Access to private attribute {node.attr} is not allowed")
+        if isinstance(node, ast.Name) and node.id == "__import__":
+            raise ValueError("Use of __import__ is forbidden")
+
+    code = compile(tree, "<safe_eval>", "eval")
+    return eval(code, {"__builtins__": {}}, names)
+
+
 def get_directory(json_report_path: Optional[str]) -> str:
     if json_report_path is None:
         return ""