ScriptCollection 3.5.152__py3-none-any.whl → 3.5.154__py3-none-any.whl

ScriptCollection/Executables.py

@@ -715,11 +715,14 @@ def UpdateImagesInDockerComposeFile() -> int:
     iu: ImageUpdater = ImageUpdater()
     parser = argparse.ArgumentParser()
     parser.add_argument('-f', '--file', required=False, default=None)
-    # TODO add option to specify ignored services and versionecholon
+    parser.add_argument('-v', '--versionecholon', required=False, default=VersionEcholon.Newest.name, dest="Possible values are: " + ", ".join([e.name for e in VersionEcholon]))
+    parser.add_argument("-s", "--servicename", required=True, default=None)
+    parser.add_argument("-u", "--updatertype", required=True, default=None)
     args = parser.parse_args()
     if args.file is None:
         args.file = os.path.join(os.getcwd(), "docker-compose.yml")
-    iu.update_all_services_in_docker_compose_file(args.file, VersionEcholon.LatestPatch, [])
+    versionecholonTyped = VersionEcholon[args.versionecholon]
+    iu.update_services_in_docker_compose_file(args.file, [args.servicename], versionecholonTyped, args.updatertype)
     return 0
 
 
@@ -748,3 +751,12 @@ def GenerateTaskfileFromWorkspacefile() -> int:
     t = TasksForCommonProjectStructure()
     t.generate_tasksfile_from_workspace_file(args.repositoryfolder)
     return 0
+
+
+def UpdateTimestampInFile() -> int:
+    parser = argparse.ArgumentParser(description="Update the timestamp in a comment in a file")
+    parser.add_argument('-f', '--file', required=True)
+    args = parser.parse_args()
+    sc = ScriptCollectionCore()
+    sc.update_timestamp_in_file(args.file)
+    return 0

ScriptCollection/GeneralUtilities.py

@@ -35,6 +35,7 @@ class VersionEcholon(Enum):
 
 class GeneralUtilities:
 
+    __datetime_format_with_offset: str = "%Y-%m-%d %H:%M:%S %z"
     __datetime_format: str = "%Y-%m-%dT%H:%M:%S"
     __date_format: str = "%Y-%m-%d"
 
@@ -133,6 +134,11 @@ class GeneralUtilities:
         value = datetime(year=value.year, month=value.month, day=value.day, hour=value.hour, minute=value.minute, second=value.second)
         return value.strftime(GeneralUtilities.__datetime_format)  # returns "2022-10-06T19:26:01" for example
 
+    @staticmethod
+    @check_arguments
+    def datetime_to_string_with_timezone(value: datetime) -> str:
+        return value.strftime(GeneralUtilities.__datetime_format_with_offset)  # returns "2025-08-21 15:30:00 +0200" for example
+
     @staticmethod
     @check_arguments
     def string_to_date(value: str) -> date:
@@ -352,13 +358,21 @@ class GeneralUtilities:
 
     @staticmethod
     @check_arguments
-    def datetime_to_string_for_logfile_name(datetime_object: datetime) -> str:
-        return datetime_object.strftime('%Y-%m-%d_%H-%M-%S')
+    def datetime_to_string_for_logfile_name(datetime_object: datetime, add_timezone_info_to_log: bool = True) -> str:
+        base_pattern: str = "%Y-%m-%d_%H-%M-%S"
+        if add_timezone_info_to_log:
+            return datetime_object.strftime(f'{base_pattern}_%z')
+        else:
+            return datetime_object.strftime(base_pattern)
 
     @staticmethod
     @check_arguments
-    def datetime_to_string_for_logfile_entry(datetime_object: datetime) -> str:
-        return datetime_object.strftime('%Y-%m-%d %H:%M:%S')
+    def datetime_to_string_for_logfile_entry(datetime_object: datetime, add_timezone_info_to_log: bool = True) -> str:
+        base_pattern: str = "%Y-%m-%d %H:%M:%S"
+        if add_timezone_info_to_log:
+            return datetime_object.strftime(f'{base_pattern} %z')
+        else:
+            return datetime_object.strftime(base_pattern)
 
     @staticmethod
     @check_arguments

ScriptCollection/ImageUpdater.py

@@ -132,6 +132,11 @@ class ConcreteImageUpdater:
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         raise NotImplementedError
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        raise NotImplementedError
+
 
 class ConcreteImageUpdaterForNginx(ConcreteImageUpdater):
 
@@ -154,6 +159,11 @@ class ConcreteImageUpdaterForNginx(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag)
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "Nginx"
+
 
 class ConcreteImageUpdaterForWordpress(ConcreteImageUpdater):
 
@@ -176,6 +186,11 @@ class ConcreteImageUpdaterForWordpress(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag)
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "Wordpress"
+
 
 class ConcreteImageUpdaterForGitLab(ConcreteImageUpdater):
 
@@ -195,6 +210,11 @@ class ConcreteImageUpdaterForGitLab(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         raise NotImplementedError
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "GitLab"
+
 
 class ConcreteImageUpdaterForRegistry(ConcreteImageUpdater):
 
@@ -218,6 +238,11 @@ class ConcreteImageUpdaterForRegistry(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag)
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "Registry"
+
 
 class ConcreteImageUpdaterForPrometheus(ConcreteImageUpdater):
 
@@ -240,6 +265,11 @@ class ConcreteImageUpdaterForPrometheus(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag[1:])
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "Prometheus"
+
 
 class ConcreteImageUpdaterForPrometheusBlackboxExporter(ConcreteImageUpdater):
 
@@ -262,6 +292,11 @@ class ConcreteImageUpdaterForPrometheusBlackboxExporter(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag[1:])
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "PrometheusBlackboxExporter"
+
 
 class ConcreteImageUpdaterForPrometheusNginxExporter(ConcreteImageUpdater):
 
@@ -284,6 +319,11 @@ class ConcreteImageUpdaterForPrometheusNginxExporter(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag[1:])
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "NginxPrometheusExporter"
+
 
 class ConcreteImageUpdaterForPrometheusNodeExporter(ConcreteImageUpdater):
 
@@ -306,6 +346,11 @@ class ConcreteImageUpdaterForPrometheusNodeExporter(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag[1:])
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "PrometheusNodeExporter"
+
 
 class ConcreteImageUpdaterForKeycloak(ConcreteImageUpdater):
 
@@ -325,6 +370,11 @@ class ConcreteImageUpdaterForKeycloak(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         raise NotImplementedError
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "KeyCloak"
+
 
 class ConcreteImageUpdaterForMariaDB(ConcreteImageUpdater):
 
@@ -347,6 +397,11 @@ class ConcreteImageUpdaterForMariaDB(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag)
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "MariaDB"
+
 
 class ConcreteImageUpdaterForPostgreSQL(ConcreteImageUpdater):
 
@@ -369,6 +424,11 @@ class ConcreteImageUpdaterForPostgreSQL(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag+".0")
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "PostgreSQL"
+
 
 class ConcreteImageUpdaterForAdminer(ConcreteImageUpdater):
 
@@ -391,6 +451,65 @@ class ConcreteImageUpdaterForAdminer(ConcreteImageUpdater):
     def get_version_from_tag(self, image: str, tag: str) -> Version:
         return ve.parse(tag)
 
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "Adminer"
+
+
+class ConcreteImageUpdaterForGeneric(ConcreteImageUpdater):
+
+    @GeneralUtilities.check_arguments
+    def version_to_tag(self,  version: Version) -> str:
+        return f"{version.major}.{version.minor}.{version.micro}"
+
+    @GeneralUtilities.check_arguments
+    def get_latest_version_of_image(self,  image: str, version_echolon: VersionEcholon, current_version: Version) -> Version:
+        versions = ImageUpdaterHelper.get_versions_in_docker_hub(image, ".", "^\\d+\\.\\d+\\.\\d+$", 999)
+        newer_versions = ImageUpdaterHelper.filter_for_newer_versions(current_version, versions)
+        result = ImageUpdaterHelper.filter_considering_echolon(newer_versions, current_version, version_echolon)
+        return result
+
+    @GeneralUtilities.check_arguments
+    def get_supported_images(self) -> list[str]:
+        return [".*"]
+
+    @GeneralUtilities.check_arguments
+    def get_version_from_tag(self, image: str, tag: str) -> Version:
+        return ve.parse(tag)
+
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "Generic"
+
+
+class ConcreteImageUpdaterForGenericV(ConcreteImageUpdater):
+
+    @GeneralUtilities.check_arguments
+    def version_to_tag(self,  version: Version) -> str:
+        return f"v{version.major}.{version.minor}.{version.micro}"
+
+    @GeneralUtilities.check_arguments
+    def get_latest_version_of_image(self,  image: str, version_echolon: VersionEcholon, current_version: Version) -> Version:
+        versions = ImageUpdaterHelper.get_versions_in_docker_hub(image, ".", "^v\\d+\\.\\d+\\.\\d+$", 999)
+        newer_versions = ImageUpdaterHelper.filter_for_newer_versions(current_version, versions)
+        result = ImageUpdaterHelper.filter_considering_echolon(newer_versions, current_version, version_echolon)
+        return result
+
+    @GeneralUtilities.check_arguments
+    def get_supported_images(self) -> list[str]:
+        return [".*"]
+
+    @GeneralUtilities.check_arguments
+    def get_version_from_tag(self, image: str, tag: str) -> Version:
+        return ve.parse(tag[1:])
+
+    @abstractmethod
+    @GeneralUtilities.check_arguments
+    def get_name(self, image: str, tag: str) -> str:
+        return "GenericV"
+
 
 class ImageUpdater:
 
@@ -434,16 +553,16 @@ class ImageUpdater:
         return newer_version_available
 
     @GeneralUtilities.check_arguments
-    def update_all_services_in_docker_compose_file(self, dockercompose_file: str, version_echolon: VersionEcholon, except_services: list[str] = []):
+    def update_all_services_in_docker_compose_file(self, dockercompose_file: str, version_echolon: VersionEcholon, except_services: list[str] = [], updatertype: str = None):
         all_services = self.get_services_from_docker_compose_file(dockercompose_file)
         services_to_update = [service for service in all_services if service not in except_services]
-        self.update_services_in_docker_compose_file(dockercompose_file, services_to_update, version_echolon)
+        self.update_services_in_docker_compose_file(dockercompose_file, services_to_update, version_echolon, updatertype)
 
     @GeneralUtilities.check_arguments
-    def update_services_in_docker_compose_file(self, dockercompose_file: str, service_names: list[str], version_echolon: VersionEcholon):
+    def update_services_in_docker_compose_file(self, dockercompose_file: str, service_names: list[str], version_echolon: VersionEcholon, updatertype: str = None):
         for service_name in service_names:
             if self.service_has_image_information(dockercompose_file, service_name):
-                self.update_service_in_docker_compose_file(dockercompose_file, service_name, version_echolon)
+                self.update_service_in_docker_compose_file(dockercompose_file, service_name, version_echolon, updatertype)
 
     @GeneralUtilities.check_arguments
     def service_has_image_information(self, dockercompose_file: str, service_name: str) -> bool:
@@ -454,9 +573,9 @@ class ImageUpdater:
             return image is not None
 
     @GeneralUtilities.check_arguments
-    def update_service_in_docker_compose_file(self, dockercompose_file: str, service_name: str, version_echolon: VersionEcholon):
+    def update_service_in_docker_compose_file(self, dockercompose_file: str, service_name: str, version_echolon: VersionEcholon, updatertype: str = None):
         imagename, existing_tag, existing_version = self.get_current_version_of_service_from_docker_compose_file(dockercompose_file, service_name)  # pylint:disable=unused-variable
-        result = self.get_latest_version_of_image(imagename, version_echolon, existing_version)
+        result = self.get_latest_version_of_image(imagename, version_echolon, existing_version, updatertype)
         newest_version = result[0]
         newest_tag = result[1]
         # TODO write info to console if there is a newwer version available if versionecoholon==latest would have been chosen
@@ -495,20 +614,35 @@ class ImageUpdater:
                 raise ValueError(f"Service '{service_name}' in '{dockercompose_file}'")
 
     @GeneralUtilities.check_arguments
-    def __get_updater_for_image(self,  image: str) -> str:
+    def __get_updater_for_image(self,  image: str) -> ConcreteImageUpdater:
         for updater in self.updater:
-            if image in updater.get_supported_images():
-                return updater
+            for supported_image_regex in updater.get_supported_images():
+                r = re.compile("^"+supported_image_regex+"$")
+                if r.match(supported_image_regex):
+                    return updater
         raise ValueError(f"No updater available for image '{image}'")
 
+    @GeneralUtilities.check_arguments
+    def __get_updater_by_name(self,  updater_name: str) -> ConcreteImageUpdater:
+        for updater in self.updater:
+            if updater.get_name() == updater_name:
+                return updater
+        raise ValueError(f"No updater available with name '{updater_name}'")
+
     @GeneralUtilities.check_arguments
     def get_docker_version_from_tag(self,  image: str, tag: str) -> Version:
-        updater: ImageUpdater = self.__get_updater_for_image(image)
+        updater: ConcreteImageUpdater = self.__get_updater_for_image(image)
         return updater.get_version_from_tag(image, tag)
 
     @GeneralUtilities.check_arguments
-    def get_latest_version_of_image(self,  image: str, version_echolon: VersionEcholon, current_version: Version) -> tuple[Version, str]:
-        updater: ImageUpdater = self.__get_updater_for_image(image)
+    def get_latest_version_of_image(self,  image: str, version_echolon: VersionEcholon, current_version: Version, updatertype: str = None) -> tuple[Version, str]:
+
+        updater: ConcreteImageUpdater = None
+        if updatertype is None:
+            self.__get_updater_for_image(image)
+        else:
+            self.__get_updater_by_name(updatertype)
+
         newest_version: Version = updater.get_latest_version_of_image(image, version_echolon, current_version)
         newest_tag: str = updater.version_to_tag(newest_version)
         return (newest_version, newest_tag)

ScriptCollection/SCLog.py

@@ -1,6 +1,6 @@
 
 from enum import Enum
-from datetime import datetime,  timezone
+from datetime import datetime
 from .GeneralUtilities import GeneralUtilities
 
 
@@ -22,7 +22,6 @@ class SCLog:
     add_overhead_to_console: bool
     add_overhead_to_logfile: bool
     print_as_color: bool
-    zone_of_time: timezone = None
 
     def __init__(self, log_file: str = None, loglevel: LogLevel = None, print_as_color: bool = True):
         self.log_file = log_file
@@ -69,13 +68,9 @@ class SCLog:
         if loglevel == LogLevel.Diagnostic:
             part3 = f"Diagnostic: {message}"
 
-        moment: datetime = None
-        if self.zone_of_time is None:
-            moment = datetime.now()
-        else:
-            moment = datetime.now(self.zone_of_time)
+        moment: datetime = datetime.now(datetime.now().astimezone().tzinfo)
 
-        part1 = f"[{GeneralUtilities.datetime_to_string_for_logfile_entry(moment)}] ["
+        part1 = f"[{GeneralUtilities.datetime_to_string_for_logfile_entry(moment, True)}] ["
         if loglevel == LogLevel.Information:
             part2 = f"Information"
         elif loglevel == LogLevel.Error:

ScriptCollection/ScriptCollectionCore.py

@@ -1,3 +1,4 @@
+import traceback
 from datetime import timedelta, datetime
 import json
 import binascii
@@ -34,7 +35,7 @@ from .ProgramRunnerPopen import ProgramRunnerPopen
 from .ProgramRunnerEpew import ProgramRunnerEpew, CustomEpewArgument
 from .SCLog import SCLog, LogLevel
 
-version = "3.5.152"
+version = "3.5.154"
 __version__ = version
 
 
@@ -2355,8 +2356,10 @@ TXDX
         GeneralUtilities.write_text_to_file(file, ET.tostring(element, encoding="unicode"), encoding)
 
     @GeneralUtilities.check_arguments
-    def install_requirementstxt_file(self, requirements_txt_file: str, folder: str, verbosity: int):
-        self.run_program_argsasarray("pip", ["install", "-r", requirements_txt_file], folder, verbosity=verbosity)
+    def install_requirementstxt_file(self, requirements_txt_file: str, verbosity: int):
+        folder:str=os.path.dirname(requirements_txt_file)
+        filename:str=os.path.basename(requirements_txt_file)
+        self.run_program_argsasarray("pip", ["install", "-r", filename], folder, verbosity=verbosity)
 
     @GeneralUtilities.check_arguments
     def ocr_analysis_of_folder(self, folder: str, serviceaddress: str, extensions: list[str], languages: list[str]) -> list[str]:  # Returns a list of changed files due to ocr-analysis.
@@ -2436,3 +2439,28 @@ OCR-content:
             if has_staged_changes:
                 changed_ocr_file_relative_path = os.path.relpath(changed_ocr_file, folder)
                 self.run_program_argsasarray("git", ["add", changed_ocr_file_relative_path], folder)
+
+    @GeneralUtilities.check_arguments
+    def update_timestamp_in_file(self, target_file: str) -> None:
+        lines = GeneralUtilities.read_lines_from_file(target_file)
+        new_lines = []
+        prefix: str = "# last update: "
+        for line in lines:
+            if line.startswith(prefix):
+                new_lines.append(prefix+GeneralUtilities.datetime_to_string_with_timezone(datetime.now()))
+            else:
+                new_lines.append(line)
+        GeneralUtilities.write_lines_to_file(target_file, new_lines)
+
+    def do_and_log_task(self, name_of_task: str, task):
+        try:
+            self.log.log(f"Start action \"{name_of_task}\".", LogLevel.Information)
+            result = task()
+            if result is None:
+                result = 0
+            return result
+        except Exception as e:
+            self.log.log_exception(f"Error while running action \"{name_of_task}\".", e, traceback)
+            return 1
+        finally:
+            self.log.log(f"Finished action \"{name_of_task}\".", LogLevel.Information)

ScriptCollection/TasksForCommonProjectStructure.py

@@ -1376,8 +1376,8 @@ class TasksForCommonProjectStructure:
         return project_version
 
     @GeneralUtilities.check_arguments
-    def standardized_tasks_build_for_docker_project(self, build_script_file: str, target_environment_type: str, verbosity: int, commandline_arguments: list[str]) -> None:
-        self.standardized_tasks_build_for_docker_project_with_additional_build_arguments(build_script_file, target_environment_type, verbosity, commandline_arguments, dict[str, str]())
+    def standardized_tasks_build_for_docker_project(self, build_script_file: str, target_environment_type: str, verbosity: int, commandline_arguments: list[str], custom_arguments: dict[str, str] = None) -> None:
+        self.standardized_tasks_build_for_docker_project_with_additional_build_arguments(build_script_file, target_environment_type, verbosity, commandline_arguments, custom_arguments)
         self.generate_sbom_for_docker_image(build_script_file, verbosity, commandline_arguments)
 
     @GeneralUtilities.check_arguments
@@ -1416,9 +1416,10 @@ class TasksForCommonProjectStructure:
         codeunit_file = os.path.join(codeunit_folder, f"{codeunitname}.codeunit.xml")
         codeunitversion = self.get_version_of_codeunit(codeunit_file)
         args = ["image", "build", "--pull", "--force-rm", "--progress=plain", "--build-arg", f"TargetEnvironmentType={target_environment_type}", "--build-arg", f"CodeUnitName={codeunitname}", "--build-arg", f"CodeUnitVersion={codeunitversion}", "--build-arg", f"CodeUnitOwnerName={self.get_codeunit_owner_name(codeunit_file)}", "--build-arg", f"CodeUnitOwnerEMailAddress={self.get_codeunit_owner_emailaddress(codeunit_file)}"]
-        for custom_argument_key, custom_argument_value in custom_arguments.items():
-            args.append("--build-arg")
-            args.append(f"{custom_argument_key}={custom_argument_value}")
+        if custom_arguments is not None:
+            for custom_argument_key, custom_argument_value in custom_arguments.items():
+                args.append("--build-arg")
+                args.append(f"{custom_argument_key}={custom_argument_value}")
         args = args+["--tag", f"{codeunitname_lower}:latest", "--tag", f"{codeunitname_lower}:{codeunitversion}", "--file", f"{codeunitname}/Dockerfile"]
         if not use_cache:
             args.append("--no-cache")
@@ -2428,11 +2429,13 @@ class TasksForCommonProjectStructure:
                     relative_script_file = task["command"]
 
                     relative_script_file = "."
+                    cwd: str = None
                     if "options" in task:
                         options = task["options"]
                         if "cwd" in options:
-                            cwd: str = options["cwd"]
+                            cwd = options["cwd"]
                             cwd = cwd.replace("${workspaceFolder}", ".")
+                            cwd = cwd.replace("\\", "\\\\").replace('"', '\\"')  # escape backslashes and double quotes for YAML
                             relative_script_file = cwd
                     if len(relative_script_file) == 0:
                         relative_script_file = "."
@@ -2450,15 +2453,16 @@ class TasksForCommonProjectStructure:
                     if append_cli_args_at_end:
                         command_with_args = f"{command_with_args} {{{{.CLI_ARGS}}}}"
 
-                    cwd_literal = cwd.replace("\\", "\\\\").replace('"', '\\"')  # escape backslashes and double quotes for YAML
                     description_literal = description.replace("\\", "\\\\").replace('"', '\\"')  # escape backslashes and double quotes for YAML
+                    command_with_args = command_with_args.replace("\\", "\\\\").replace('"', '\\"')  # escape backslashes and double quotes for YAML
 
                     lines.append(f"  {name}:")
                     lines.append(f'    desc: "{description_literal}"')
                     lines.append('    silent: true')
-                    lines.append(f'    dir: "{cwd_literal}"')
+                    if cwd is not None:
+                        lines.append(f'    dir: "{cwd}"')
                     lines.append("    cmds:")
-                    lines.append(f"      - {command_with_args}")
+                    lines.append(f'      - "{command_with_args}"')
                     lines.append('    aliases:')
                     lines.append(f'      - {name.lower()}')
                     if "aliases" in task:
@@ -2649,6 +2653,7 @@ class TasksForCommonProjectStructure:
 
     @GeneralUtilities.check_arguments
     def build_specific_codeunits(self, repository_folder: str, codeunits: list[str], verbosity: int = 1, target_environmenttype: str = "QualityCheck", additional_arguments_file: str = None, is_pre_merge: bool = False, export_target_directory: str = None, assume_dependent_codeunits_are_already_built: bool = True, commandline_arguments: list[str] = [], do_git_clean_when_no_changes: bool = False, note: str = None, check_for_new_files: bool = True) -> None:
+        now_begin: datetime = datetime.now()
         codeunits_list = "{"+", ".join(["a", "b"])+"}"
         if verbosity > 2:
             GeneralUtilities.write_message_to_stdout(f"Start building codeunits ({codeunits_list}) in repository '{repository_folder}'...")
@@ -2672,7 +2677,7 @@ class TasksForCommonProjectStructure:
         sorted_codeunits = [codeunit for codeunit in sorted_codeunits if codeunit in codeunits]
         project_version = self.get_version_of_project(repository_folder)
 
-        message = f"Build codeunits in product {repository_name}..."
+        message = f"Build codeunits in product {repository_name}... (Started: {GeneralUtilities.datetime_to_string(now_begin)})"
         if note is not None:
             message = f"{message} ({note})"
         GeneralUtilities.write_message_to_stdout(message)
@@ -2714,7 +2719,8 @@ class TasksForCommonProjectStructure:
                 archive_file = os.path.join(os.getcwd(), f"{filename_without_extension}.zip")
                 shutil.move(archive_file, target_folder)
 
-        message2 = f"Finished build codeunits in product {repository_name}."
+        now_end: datetime = datetime.now()
+        message2 = f"Finished build codeunits in product {repository_name}. (Finished: {GeneralUtilities.datetime_to_string(now_end)})"
         if note is not None:
             message2 = f"{message2} ({note})"
         GeneralUtilities.write_message_to_stdout(message2)
@@ -3466,9 +3472,9 @@ class TasksForCommonProjectStructure:
         iu.update_all_services_in_docker_compose_file(dockercomposefile, VersionEcholon.LatestPatchOrLatestMinor, excluded)
         iu.check_for_newest_version(dockercomposefile, excluded)
 
-
     @GeneralUtilities.check_arguments
     def clone_repository_as_resource(self, local_repository_folder: str, remote_repository_link: str, resource_name: str, repository_subname: str = None) -> None:
+        GeneralUtilities.write_message_to_stdout(f'Clone resource {resource_name}...')
         resrepo_commit_id_folder: str = os.path.join(local_repository_folder, "Other", "Resources", f"{resource_name}Version")
         resrepo_commit_id_file: str = os.path.join(resrepo_commit_id_folder, f"{resource_name}Version.txt")
         latest_version: str = GeneralUtilities.read_text_from_file(resrepo_commit_id_file)

{scriptcollection-3.5.152.dist-info → scriptcollection-3.5.154.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ScriptCollection
-Version: 3.5.152
+Version: 3.5.154
 Summary: The ScriptCollection is the place for reusable scripts.
 Home-page: https://github.com/anionDev/ScriptCollection
 Author: Marius Göcke
@@ -23,12 +23,12 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: build>=1.3.0
-Requires-Dist: coverage>=7.10.2
+Requires-Dist: coverage>=7.10.5
 Requires-Dist: cyclonedx-bom>=7.0.0
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: keyboard>=0.13.5
 Requires-Dist: lcov-cobertura>=2.1.1
-Requires-Dist: lxml>=6.0.0
+Requires-Dist: lxml>=6.0.1
 Requires-Dist: ntplib>=0.4.0
 Requires-Dist: Pillow>=11.3.0
 Requires-Dist: psutil>=7.0.0
@@ -36,7 +36,7 @@ Requires-Dist: pycdlib>=1.14.0
 Requires-Dist: Pygments>=2.19.2
 Requires-Dist: pylint>=3.3.8
 Requires-Dist: pyOpenSSL>=25.1.0
-Requires-Dist: PyPDF>=5.9.0
+Requires-Dist: PyPDF>=6.0.0
 Requires-Dist: pytest>=8.4.1
 Requires-Dist: PyYAML>=6.0.2
 Requires-Dist: qrcode>=8.2

scriptcollection-3.5.154.dist-info/RECORD

@@ -0,0 +1,17 @@
+ScriptCollection/CertificateUpdater.py,sha256=OAxrG21k_o3W3niOOGNSZzUPJlvolOWc1lRB2dMhc3g,9212
+ScriptCollection/Executables.py,sha256=BojgHGBYn5QqpsdIgn8r8raxb8bE_BUyb-fZ_rCEN0A,37050
+ScriptCollection/GeneralUtilities.py,sha256=t8xp0s10V-MrWYQQiMx0ae3LLTM8G2wPyyWXqeIteXQ,48023
+ScriptCollection/ImageUpdater.py,sha256=qTe3yoqzQJY7LZdXBbjbWvrsSQaeHy1VwmOxaRzU2ig,29305
+ScriptCollection/ProcessesRunner.py,sha256=3mu4ZxzZleQo0Op6o9EYTCFiJfb6kx5ov2YfZfT89mU,1395
+ScriptCollection/ProgramRunnerBase.py,sha256=2kMIAqdc65UjBAddOZkzy_aFx9h5roZ5a4bQNM6RV6Y,2480
+ScriptCollection/ProgramRunnerEpew.py,sha256=4pjEd0r9Fcz3TTDv0MdTSd5KkigYXcWUVI1X43regfU,6477
+ScriptCollection/ProgramRunnerPopen.py,sha256=BPY7-ZMIlqT7JOKz8qlB5c0laF2Js-ijzqk09GxZC48,3821
+ScriptCollection/SCLog.py,sha256=49NlLEmK_f-icw_uEPq9U3qv-oBTMRcIqSg3jaO8VsA,4360
+ScriptCollection/ScriptCollectionCore.py,sha256=vzMtn001WIBWKPgJak1J42iZjpTDrKIgw4Q3ab50AcY,139260
+ScriptCollection/TasksForCommonProjectStructure.py,sha256=6m8Mu_G_ydkFn2twYrbf9Kt7YoWZjJnuUztJbl4bZPU,247230
+ScriptCollection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+scriptcollection-3.5.154.dist-info/METADATA,sha256=heYQXlbf-hXoNwkR2mPredjwCtwMg1Ybs18Ji-8_JxE,7689
+scriptcollection-3.5.154.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+scriptcollection-3.5.154.dist-info/entry_points.txt,sha256=yZlEK0r5Ie7xrSLdlWZgFqzLZiIctsIAUJvDCgrYBRo,4193
+scriptcollection-3.5.154.dist-info/top_level.txt,sha256=hY2hOVH0V0Ce51WB76zKkIWTUNwMUdHo4XDkR2vYVwg,17
+scriptcollection-3.5.154.dist-info/RECORD,,

{scriptcollection-3.5.152.dist-info → scriptcollection-3.5.154.dist-info}/entry_points.txt

@@ -56,4 +56,5 @@ scshowmissingfiles = ScriptCollection.Executables:ShowMissingFiles
 scsigncertificate = ScriptCollection.Executables:SignCertificate
 scupdateimagesindockercomposefile = ScriptCollection.Executables:UpdateImagesInDockerComposeFile
 scupdatenugetpackagesincsharpproject = ScriptCollection.Executables:UpdateNugetpackagesInCsharpProject
+scupdatetimestampinfile = ScriptCollection.Executables:UpdateTimestampInFile
 scuploadfile = ScriptCollection.Executables:UploadFile

scriptcollection-3.5.152.dist-info/RECORD

@@ -1,17 +0,0 @@
-ScriptCollection/CertificateUpdater.py,sha256=OAxrG21k_o3W3niOOGNSZzUPJlvolOWc1lRB2dMhc3g,9212
-ScriptCollection/Executables.py,sha256=eX94RLNBarpWoZKeDo02gcP_qzmJDZcIx8XBZFVCFNc,36396
-ScriptCollection/GeneralUtilities.py,sha256=PKdzq382RYVSWeSG_6z6FiHu-SiTOi2BavJKvP-0slU,47308
-ScriptCollection/ImageUpdater.py,sha256=3B5pgAMnyne3ZogWz-suqglZGIB9FAKyWn31P9E1ST0,24491
-ScriptCollection/ProcessesRunner.py,sha256=3mu4ZxzZleQo0Op6o9EYTCFiJfb6kx5ov2YfZfT89mU,1395
-ScriptCollection/ProgramRunnerBase.py,sha256=2kMIAqdc65UjBAddOZkzy_aFx9h5roZ5a4bQNM6RV6Y,2480
-ScriptCollection/ProgramRunnerEpew.py,sha256=4pjEd0r9Fcz3TTDv0MdTSd5KkigYXcWUVI1X43regfU,6477
-ScriptCollection/ProgramRunnerPopen.py,sha256=BPY7-ZMIlqT7JOKz8qlB5c0laF2Js-ijzqk09GxZC48,3821
-ScriptCollection/SCLog.py,sha256=GJ44S6VaBVwX5Dd6MIrdZn6I0dpaaYKVq9w-N0nMXlo,4496
-ScriptCollection/ScriptCollectionCore.py,sha256=cOswEDwCQ4ndqIz-X0M2lGQD1WBtKLXvjd5aXtyoxUo,138093
-ScriptCollection/TasksForCommonProjectStructure.py,sha256=_QNBZo_48y6UIGKpeepkrCHNvkCpO6MHB2kakgLBe4k,246625
-ScriptCollection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scriptcollection-3.5.152.dist-info/METADATA,sha256=W5nkU3X26V-6tgI3aFnpzsaaVPOFHYcHQ1iQW2U_ILg,7689
-scriptcollection-3.5.152.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-scriptcollection-3.5.152.dist-info/entry_points.txt,sha256=AvmVO9iyWImExpvzL3YYQ9AOEiUIN9guPRRG_W_VNWY,4116
-scriptcollection-3.5.152.dist-info/top_level.txt,sha256=hY2hOVH0V0Ce51WB76zKkIWTUNwMUdHo4XDkR2vYVwg,17
-scriptcollection-3.5.152.dist-info/RECORD,,