pyxecm 3.0.1__py3-none-any.whl → 3.1.0__py3-none-any.whl

pyxecm_customizer/browser_automation.py

@@ -90,8 +90,8 @@ except ModuleNotFoundError:
 # "wait until" strategy.
 DEFAULT_WAIT_UNTIL_STRATEGY = "networkidle"
 
-REQUEST_TIMEOUT = 30
-REQUEST_RETRY_DELAY = 2
+REQUEST_TIMEOUT = 30.0
+REQUEST_RETRY_DELAY = 2.0
 REQUEST_MAX_RETRIES = 3
 
 
@@ -182,7 +182,7 @@ class BrowserAutomation:
             self.screenshot_names,
             "screenshots",
         )
-        self.logger.debug("Creating Screenshot directory... -> %s", self.screenshot_directory)
+        self.logger.debug("Creating screenshot directory... -> %s", self.screenshot_directory)
         if self.take_screenshots and not os.path.exists(self.screenshot_directory):
             os.makedirs(self.screenshot_directory)
 
@@ -194,21 +194,21 @@ class BrowserAutomation:
             self.logger.info("Using HTTP proxy -> %s", os.getenv("HTTP_PROXY"))
 
         browser = browser or os.getenv("BROWSER", "webkit")
-        self.logger.info("Using Browser -> '%s'...", browser)
+        self.logger.info("Using browser -> '%s'...", browser)
 
         if not self.setup_playwright(browser=browser):
             self.logger.error("Failed to initialize Playwright browser automation!")
             return
 
-        self.logger.info("Creating Browser Context...")
+        self.logger.info("Creating browser context...")
         self.context: BrowserContext = self.browser.new_context(
             accept_downloads=True,
         )
 
-        self.logger.info("Creating Page...")
+        self.logger.info("Creating page...")
         self.page: Page = self.context.new_page()
         self.main_page = self.page
-        self.logger.info("Browser Automation initialized.")
+        self.logger.info("Browser automation initialized.")
 
     # end method definition
 
@@ -217,7 +217,12 @@ class BrowserAutomation:
 
         Args:
             browser (str):
-                Name of the browser engine.
+                Name of the browser engine. Supported:
+                * chromium
+                * chrome
+                * msedge
+                * webkit
+                * firefox
 
         Returns:
             bool:
@@ -232,6 +237,9 @@ class BrowserAutomation:
             self.logger.error("Failed to start Playwright!")
             return False
 
+        result = True
+
+        # Install and launch the selected browser in Playwright:
         match browser:
             case "chromium":
                 try:
@@ -239,10 +247,11 @@ class BrowserAutomation:
                         headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
                     )
                 except Exception:
-                    self.install_browser(browser=browser)
-                    self.browser: Browser = self.playwright.chromium.launch(
-                        headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
-                    )
+                    result = self.install_browser(browser=browser)
+                    if result:
+                        self.browser: Browser = self.playwright.chromium.launch(
+                            headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
+                        )
 
             case "chrome":
                 try:
@@ -253,13 +262,14 @@ class BrowserAutomation:
                         proxy=self.proxy,
                     )
                 except Exception:
-                    self.install_browser(browser=browser)
-                    self.browser: Browser = self.playwright.chromium.launch(
-                        channel="chrome",
-                        headless=self.headless,
-                        slow_mo=100 if not self.headless else None,
-                        proxy=self.proxy,
-                    )
+                    result = self.install_browser(browser=browser)
+                    if result:
+                        self.browser: Browser = self.playwright.chromium.launch(
+                            channel="chrome",
+                            headless=self.headless,
+                            slow_mo=100 if not self.headless else None,
+                            proxy=self.proxy,
+                        )
 
             case "msedge":
                 try:
@@ -270,13 +280,14 @@ class BrowserAutomation:
                         proxy=self.proxy,
                     )
                 except Exception:
-                    self.install_browser(browser=browser)
-                    self.browser: Browser = self.playwright.chromium.launch(
-                        channel="msedge",
-                        headless=self.headless,
-                        slow_mo=100 if not self.headless else None,
-                        proxy=self.proxy,
-                    )
+                    result = self.install_browser(browser=browser)
+                    if result:
+                        self.browser: Browser = self.playwright.chromium.launch(
+                            channel="msedge",
+                            headless=self.headless,
+                            slow_mo=100 if not self.headless else None,
+                            proxy=self.proxy,
+                        )
 
             case "webkit":
                 try:
@@ -284,10 +295,11 @@ class BrowserAutomation:
                         headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
                     )
                 except Exception:
-                    self.install_browser(browser=browser)
-                    self.browser: Browser = self.playwright.webkit.launch(
-                        headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
-                    )
+                    result = self.install_browser(browser=browser)
+                    if result:
+                        self.browser: Browser = self.playwright.webkit.launch(
+                            headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
+                        )
 
             case "firefox":
                 try:
@@ -295,16 +307,30 @@ class BrowserAutomation:
                         headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
                     )
                 except Exception:
-                    self.install_browser(browser=browser)
-                    self.browser: Browser = self.playwright.firefox.launch(
-                        headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
-                    )
-        return True
+                    result = self.install_browser(browser=browser)
+                    if result:
+                        self.browser: Browser = self.playwright.firefox.launch(
+                            headless=self.headless, slow_mo=100 if not self.headless else None, proxy=self.proxy
+                        )
+            case _:
+                self.logger.error("Unknown browser -> '%s'. Cannot install and launch it.", browser)
+                result = False
+
+        return result
 
     # end method definition
 
     def install_browser(self, browser: str) -> bool:
-        """Check if browser is already installed if not install it."""
+        """Install a browser with a provided name in Playwright.
+
+        Args:
+            browser (str):
+                Name of the browser to be installed.
+
+        Returns:
+            bool: True = installation successful, False = installation failed.
+
+        """
 
         self.logger.info("Installing Browser -> '%s'...", browser)
         process = subprocess.Popen(
@@ -314,12 +340,13 @@ class BrowserAutomation:
             shell=False,
         )
         output, error = process.communicate()
-        if process.returncode == 0:
-            self.logger.info("Installation completed successfullly.")
+        if process.returncode == 0:  # 0 = success
+            self.logger.info("Successfuly completed installation of browser -> '%s'.", browser)
             self.logger.debug(output.decode())
         else:
-            self.logger.error("Installation failed with -> %s", error.decode())
+            self.logger.error("Installation of browser -> '%s' failed! Error -> %s", browser, error.decode())
             self.logger.error(output.decode())
+            return False
 
         return True
 
@@ -634,6 +661,7 @@ class BrowserAutomation:
         wait_state: str = "visible",
         exact_match: bool | None = None,
         regex: bool = False,
+        occurrence: int = 1,
         iframe: str | None = None,
         repeat_reload: int | None = None,
         repeat_reload_delay: int = 60,
@@ -657,6 +685,9 @@ class BrowserAutomation:
                 If an exact matching is required. Default is None (not set).
             regex (bool, optional):
                 Should the name be interpreted as a regular expression?
+            occurrence (int, optional):
+                If multiple elements match the selector, this defines which one to return.
+                Default is 1 (the first one).
             iframe (str | None):
                 Is the element in an iFrame? Then provide the name of the iframe with this parameter.
             repeat_reload (int | None):
@@ -674,17 +705,19 @@ class BrowserAutomation:
 
         """
 
-        failure_message = "Cannot find page element with selector -> '{}' ({}){}{}".format(
+        failure_message = "Cannot find page element with selector -> '{}' ({}){}{}{}".format(
             selector,
             selector_type,
             " and role type -> '{}'".format(role_type) if role_type else "",
             " in iframe -> '{}'".format(iframe) if iframe else "",
+            ", occurrence -> {}".format(occurrence) if occurrence > 1 else "",
         )
-        success_message = "Found page element with selector -> '{}' ('{}'){}{}".format(
+        success_message = "Found page element with selector -> '{}' ('{}'){}{}{}".format(
             selector,
             selector_type,
             " and role type -> '{}'".format(role_type) if role_type else "",
             " in iframe -> '{}'".format(iframe) if iframe else "",
+            ", occurrence -> {}".format(occurrence) if occurrence > 1 else "",
         )
 
         def do_find() -> Locator | None:
@@ -709,8 +742,13 @@ class BrowserAutomation:
             # are not yet loaded:
 
             try:
+                index = occurrence - 1  # convert to 0-based index
+                if index < 0:  # basic validation
+                    self.logger.error("Occurrence must be >= 1")
+                    return None
                 self.logger.debug(
-                    "Wait for locator to find element with selector -> '%s' (%s%s%s) and state -> '%s'%s...",
+                    "Wait for locator to find %selement with selector -> '%s' (%s%s%s) and state -> '%s'%s...",
+                    "occurrence #{} of ".format(occurrence) if occurrence > 1 else "",
                     selector,
                     "selector type -> '{}'".format(selector_type),
                     ", role type -> '{}'".format(role_type) if role_type else "",
@@ -718,7 +756,9 @@ class BrowserAutomation:
                     wait_state,
                     " in iframe -> '{}'".format(iframe) if iframe else "",
                 )
-                locator = locator.first
+
+                locator = locator.first if occurrence == 1 else locator.nth(index)
+                # Wait for the element to be in the desired state:
                 locator.wait_for(state=wait_state)
             except PlaywrightError as pe:
                 if show_error and repeat_reload is None:
@@ -763,6 +803,7 @@ class BrowserAutomation:
         selector: str,
         selector_type: str = "id",
         role_type: str | None = None,
+        occurrence: int = 1,
         scroll_to_element: bool = True,
         desired_checkbox_state: bool | None = None,
         is_navigation_trigger: bool = False,
@@ -793,6 +834,9 @@ class BrowserAutomation:
             role_type (str | None, optional):
                 ARIA role when using selector_type="role", e.g., "button", "textbox".
                 If irrelevant then None should be passed for role_type.
+            occurrence (int, optional):
+                If multiple elements match the selector, this defines which one to return.
+                Default is 1 (the first one).
             scroll_to_element (bool, optional):
                 Scroll the element into view.
             desired_checkbox_state (bool | None, optional):
@@ -879,6 +923,7 @@ class BrowserAutomation:
             role_type=role_type,
             exact_match=exact_match,
             regex=regex,
+            occurrence=occurrence,
             iframe=iframe,
             repeat_reload=repeat_reload,
             repeat_reload_delay=repeat_reload_delay,
@@ -977,6 +1022,7 @@ class BrowserAutomation:
         value: str | bool,
         selector_type: str = "id",
         role_type: str | None = None,
+        occurrence: int = 1,
         is_sensitive: bool = False,
         press_enter: bool = False,
         exact_match: bool | None = None,
@@ -998,6 +1044,9 @@ class BrowserAutomation:
             role_type (str | None, optional):
                 ARIA role when using selector_type="role", e.g., "button", "textbox".
                 If irrelevant then None should be passed for role_type.
+            occurrence (int, optional):
+                If multiple elements match the selector, this defines which one to return.
+                Default is 1 (the first one).
             is_sensitive (bool, optional):
                 True for suppressing sensitive information in logging.
             press_enter (bool, optional):
@@ -1028,6 +1077,7 @@ class BrowserAutomation:
             role_type=role_type,
             exact_match=exact_match,
             regex=regex,
+            occurrence=occurrence,
             iframe=iframe,
             show_error=True,
         )
@@ -1263,7 +1313,7 @@ class BrowserAutomation:
             return (None, 0)
 
         self.logger.info(
-            "Check if at least %d element%s found by selector -> %s (%s%s)%s%s%s...",
+            "Check if at least %d element%s found by selector -> '%s' (%s%s)%s%s%s...",
             min_count,
             "s are" if min_count > 1 else " is",
             selector,
@@ -1467,7 +1517,7 @@ class BrowserAutomation:
             return False
 
         if "Verify" in title:
-            self.logger.error("Site is asking for a Verification Token. You may need to whitelist your IP!")
+            self.logger.error("Site is asking for a verification token. You may need to whitelist your IP!")
             return False
         if "Login" in title:
             self.logger.error("Authentication failed. You may have given the wrong password!")
@@ -1502,11 +1552,11 @@ class BrowserAutomation:
     def end_session(self) -> None:
         """End the browser session and close the browser."""
 
-        self.logger.info("Close Browser Page...")
+        self.logger.info("Close browser page...")
         self.page.close()
-        self.logger.info("Close Browser Context...")
+        self.logger.info("Close browser context...")
         self.context.close()
-        self.logger.info("Close Browser...")
+        self.logger.info("Close browser...")
         self.browser.close()
         self.logged_in = False
         self.logger.info("Stop Playwright instance...")

pyxecm_customizer/customizer.py

@@ -200,7 +200,7 @@ class Customizer:
             # of unsetting 2 checkboxes on that config page - we reset these checkboxes
             # with the settings file "O365Settings.xml"):
             file_path = os.path.join(tempfile.gettempdir(), "ot.xecm.teams.zip")
-            response = self.otcs_frontend_object.download_config_file(
+            _ = self.otcs_frontend_object.download_config_file(
                 otcs_url_suffix="/cs/cs?func=officegroups.DownloadTeamsPackage",
                 file_path=file_path,
             )
@@ -257,7 +257,7 @@ class Customizer:
                 # by its wrong name in the customizer automation. This can
                 # happen if the app is installed manually or the environment
                 # variable is set to a wrong name.
-                app_catalog_name = m365_object.get_result_value(response, "displayName")
+                app_catalog_name = m365_object.get_result_value(response=response, key="displayName")
                 if app_catalog_name != self.settings.m365.teams_app_name:
                     self.logger.warning(
                         "The Extended ECM app name -> '%s' in the M365 Teams catalog does not match the defined app name -> '%s'!",
@@ -624,14 +624,14 @@ class Customizer:
         )
         if not otcs_frontend_scale:
             self.logger.error(
-                "Cannot find Kubernetes Stateful Set -> '%s' for OTCS Frontends!",
+                "Cannot find Kubernetes stateful set -> '%s' for OTCS Frontends!",
                 self.settings.k8s.sts_otcs_frontend,
             )
             sys.exit()
 
         self.settings.k8s.sts_otcs_frontend_replicas = otcs_frontend_scale.spec.replicas
         self.logger.info(
-            "Stateful Set -> '%s' has -> %s replicas",
+            "Stateful set -> '%s' has -> %s replicas",
             self.settings.k8s.sts_otcs_frontend,
             self.settings.k8s.sts_otcs_frontend_replicas,
         )
@@ -642,16 +642,17 @@ class Customizer:
         )
         if not otcs_backend_scale:
             self.logger.error(
-                "Cannot find Kubernetes Stateful Set -> '%s' for OTCS Backends!",
+                "Cannot find Kubernetes stateful set -> '%s' for OTCS Backends!",
                 self.settings.k8s.sts_otcs_admin,
             )
             sys.exit()
 
         self.settings.k8s.sts_otcs_admin_replicas = otcs_backend_scale.spec.replicas
         self.logger.info(
-            "Stateful Set -> '%s' has -> %s replicas",
+            "Stateful set -> '%s' has -> %s replica%s",
             self.settings.k8s.sts_otcs_admin,
             self.settings.k8s.sts_otcs_admin_replicas,
+            "s" if self.settings.k8s.sts_otcs_admin_replicas > 1 else "",
         )
 
         return k8s_object
@@ -782,7 +783,7 @@ class Customizer:
         if not response:
             self.logger.error("Failed to enable OTAC certificate for OTCS!")
         else:
-            self.logger.info("Successfully enabled OTAC certificate for OTCS!")
+            self.logger.info("Successfully enabled OTAC certificate for OTCS.")
 
         # is there a known server configured for Archive Center (to sync content with)
         if otac_object and self.settings.otac.known_server != "":
@@ -918,7 +919,9 @@ class Customizer:
         otcs_resource_id = otcs_resource["resourceID"]
         otcs_object.set_resource_id(resource_id=otcs_resource_id)
         self.logger.info(
-            "OTCS has resource ID -> '%s' for resource name -> '%s'", otcs_resource_id, self.settings.otcs.resource_name
+            "OTCS has resource -> '%s' (%s) in OTDS.",
+            self.settings.otcs.resource_name,
+            otcs_resource_id,
         )
 
         if "OTCS_RESSOURCE_ID" not in self.settings.placeholder_values:
@@ -1257,7 +1260,7 @@ class Customizer:
         )
         while otcs_partition is None:
             self.logger.warning(
-                "OTDS user partition for Content Server with name -> '%s' does not exist yet. Waiting...",
+                "OTDS user partition -> '%s' for Content Server does not exist yet. Waiting...",
                 self.settings.otcs.partition,
             )
 
@@ -1350,24 +1353,27 @@ class Customizer:
         )
         if not otcs_da_scale:
             self.logger.warning(
-                "Cannot find Kubernetes Stateful Set -> '%s' for OTCS DA!",
+                "Cannot find Kubernetes stateful set -> '%s' for OTCS DA!",
                 self.settings.k8s.sts_otcs_da,
             )
             self.settings.k8s.sts_otcs_da_replicas = 0
         else:
             self.settings.k8s.sts_otcs_da_replicas = otcs_da_scale.spec.replicas
 
+        if not self.settings.k8s.sts_otcs_da_replicas:
+            self.settings.k8s.sts_otcs_da_replicas = 0
+
         # Restart all da:
         for x in range(self.settings.k8s.sts_otcs_da_replicas):
             pod_name = self.settings.k8s.sts_otcs_da + "-" + str(x)
 
-            self.logger.info("Deactivate Liveness probe for pod -> '%s'", pod_name)
+            self.logger.info("Deactivate liveness probe for pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "touch /tmp/keepalive"],
                 container="otcs-da-container",
             )
-            self.logger.info("Restarting OTCS in pod -> '%s'", pod_name)
+            self.logger.info("Restarting OTCS in pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "/opt/opentext/cs/stop_csserver"],
@@ -1385,24 +1391,27 @@ class Customizer:
         )
         if not otcs_frontend_scale:
             self.logger.error(
-                "Cannot find Kubernetes Stateful Set -> '%s' for OTCS Frontends!",
+                "Cannot find Kubernetes stateful set -> '%s' for OTCS frontends!",
                 self.settings.k8s.sts_otcs_frontend,
             )
             self.settings.k8s.sts_otcs_frontend_replicas = 0
         else:
             self.settings.k8s.sts_otcs_frontend_replicas = otcs_frontend_scale.spec.replicas
 
+        if not self.settings.k8s.sts_otcs_frontend_replicas:
+            self.settings.k8s.sts_otcs_frontend_replicas = 0
+
         # Restart all frontends:
         for x in range(self.settings.k8s.sts_otcs_frontend_replicas):
             pod_name = self.settings.k8s.sts_otcs_frontend + "-" + str(x)
 
-            self.logger.info("Deactivate Liveness probe for pod -> '%s'", pod_name)
+            self.logger.info("Deactivate liveness probe for pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "touch /tmp/keepalive"],
                 container="otcs-frontend-container",
             )
-            self.logger.info("Restarting OTCS in pod -> '%s'", pod_name)
+            self.logger.info("Restarting OTCS in pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "/opt/opentext/cs/stop_csserver"],
@@ -1418,13 +1427,13 @@ class Customizer:
         for x in range(self.settings.k8s.sts_otcs_admin_replicas):
             pod_name = self.settings.k8s.sts_otcs_admin + "-" + str(x)
 
-            self.logger.info("Deactivate Liveness probe for pod -> '%s'", pod_name)
+            self.logger.info("Deactivate liveness probe for pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "touch /tmp/keepalive"],
                 container="otcs-admin-container",
             )
-            self.logger.info("Restarting OTCS in pod -> '%s'", pod_name)
+            self.logger.info("Restarting OTCS in pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "/opt/opentext/cs/stop_csserver"],
@@ -1438,7 +1447,7 @@ class Customizer:
 
         # Reauthenticate at frontend:
         self.logger.info(
-            "Re-Authenticating to OTCS frontend after restart of frontend pods...",
+            "Re-authenticating to OTCS frontend after restart of frontend pods...",
         )
         otcs_cookie = frontend.authenticate(revalidate=True)
         while otcs_cookie is None:
@@ -1449,7 +1458,7 @@ class Customizer:
 
         # Reauthenticate at backend:
         self.logger.info(
-            "Re-Authenticating to OTCS backend after restart of backend pods...",
+            "Re-authenticating to OTCS backend after restart of backend pods...",
         )
         otcs_cookie = backend.authenticate(revalidate=True)
         while otcs_cookie is None:
@@ -1458,11 +1467,11 @@ class Customizer:
             otcs_cookie = backend.authenticate(revalidate=True)
         self.logger.info("OTCS backend is ready again.")
 
-        # Reactivate Liveness probes in all pods:
+        # Reactivate Kubernetes liveness probes in all pods:
         for x in range(self.settings.k8s.sts_otcs_frontend_replicas):
             pod_name = self.settings.k8s.sts_otcs_frontend + "-" + str(x)
 
-            self.logger.info("Reactivate Liveness probe for pod -> '%s'", pod_name)
+            self.logger.info("Reactivate liveness probe for pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "rm /tmp/keepalive"],
@@ -1472,7 +1481,7 @@ class Customizer:
         for x in range(self.settings.k8s.sts_otcs_admin_replicas):
             pod_name = self.settings.k8s.sts_otcs_admin + "-" + str(x)
 
-            self.logger.info("Reactivate Liveness probe for pod -> '%s'", pod_name)
+            self.logger.info("Reactivate liveness probe for pod -> '%s'...", pod_name)
             self.k8s_object.exec_pod_command(
                 pod_name,
                 ["/bin/sh", "-c", "rm /tmp/keepalive"],
@@ -1522,7 +1531,7 @@ class Customizer:
     # end method definition
 
     def restart_otawp_pod(self) -> None:
-        """Delete the AppWorks Platform Pod to make Kubernetes restart it."""
+        """Delete the AppWorks Platform pod to make Kubernetes restart it."""
 
         self.k8s_object.delete_pod(self.settings.k8s.sts_otawp + "-0")
 
@@ -1899,6 +1908,15 @@ class Customizer:
 
                 # Upload payload file for later review to Enterprise Workspace
                 if self.settings.otcs.upload_config_files:
+                    # Wait until OTCS is ready to accept uploads. Parallel running
+                    # payload processing might be in the process of restarting OTCS:
+                    while not self.otcs_backend_object.is_ready():
+                        self.logger.info(
+                            "OTCS is not ready. Cannot upload payload file -> '%s' to OTCS. Waiting 30 seconds and retry...",
+                            os.path.basename(cust_payload),
+                        )
+                        time.sleep(30)
+
                     self.log_header("Upload Payload file to OpenText Content Management")
                     response = self.otcs_backend_object.get_node_from_nickname(
                         nickname=self.settings.cust_target_folder_nickname,
@@ -1908,7 +1926,7 @@ class Customizer:
                         key="id",
                     )
                     if not target_folder_id:
-                        target_folder_id = 2000  # use Enterprise Workspace as fallback
+                        target_folder_id = 2004  # use Enterprise Workspace as fallback
                     # Write YAML file with upadated payload (including IDs, etc.).
                     # We need to write to a temporary location as initial location is read-only:
                     payload_file = os.path.basename(cust_payload)
@@ -2017,7 +2035,7 @@ class Customizer:
                 key="id",
             )
             if not target_folder_id:
-                target_folder_id = 2000  # use Enterprise Workspace as fallback
+                target_folder_id = 2004  # use Enterprise Workspace as fallback
             # Check if the log file has been uploaded before.
             # This can happen if we re-run the python container:
             # In this case we add a version to the existing document: