ScriptCollection 3.5.10__py3-none-any.whl → 3.5.12__py3-none-any.whl

ScriptCollection/GeneralUtilities.py

@@ -1,869 +1,869 @@
-import codecs
-import platform
-import inspect
-import ctypes
-import hashlib
-import re
-import os
-import shutil
-import urllib
-import stat
-import secrets
-import string as strin
-import sys
-import traceback
-import warnings
-import functools
-from datetime import datetime, timedelta, date
-from os import listdir
-from os.path import isfile, join, isdir
-from pathlib import Path
-from shutil import copyfile
-import typing
-from defusedxml.minidom import parse
-from OpenSSL import crypto
-
-
-class GeneralUtilities:
-
-    __datetime_format: str = "%Y-%m-%dT%H:%M:%S"
-    __date_format: str = "%Y-%m-%d"
-
-    @staticmethod
-    def get_modest_dark_url() -> str:
-        return "https://aniondev.github.io/CDN/ScriptCollectionDesigns/ModestDark/Style.css"
-
-    @staticmethod
-    def is_generic(t: typing.Type):
-        return hasattr(t, "__origin__")
-
-    @staticmethod
-    def check_arguments(function):
-        def __check_function(*args, **named_args):
-            parameters: list = inspect.getfullargspec(function)[0].copy()
-            arguments: list = list(tuple(args)).copy()
-            if "self" in parameters:
-                parameters.remove("self")
-                arguments.pop(0)
-            for index, argument in enumerate(arguments):
-                if argument is not None:  # Check type of None is not possible. None is always a valid argument-value
-                    if parameters[index] in function.__annotations__:  # Check if a type-hint for parameter exist. If not, no parameter-type available for argument-type-check
-                        # Check type of arguments if the type is a generic type seems to be impossible.
-                        if not GeneralUtilities.is_generic(function.__annotations__[parameters[index]]):
-                            if not isinstance(argument, function.__annotations__[parameters[index]]):
-                                raise TypeError(f"Argument with index {index} for function {function.__name__} ('{str(argument)}') is not of type { function.__annotations__[parameters[index]]} but has type "+str(type(argument)))
-            for index, named_argument in enumerate(named_args):
-                if named_args[named_argument] is not None:
-                    if parameters[index] in function.__annotations__:
-                        if not GeneralUtilities.is_generic(function.__annotations__.get(named_argument)):
-                            if not isinstance(named_args[named_argument], function.__annotations__.get(named_argument)):
-                                raise TypeError(f"Argument with name {named_argument} for function {function.__name__} ('{str(named_args[named_argument])}') is not of type { function.__annotations__.get(named_argument)}")
-            return function(*args, **named_args)
-        __check_function.__doc__ = function.__doc__
-        return __check_function
-
-    @staticmethod
-    def deprecated(func):
-        @functools.wraps(func)
-        def new_func(*args, **kwargs):
-            warnings.simplefilter('always', DeprecationWarning)
-            warnings.warn(f"Call to deprecated function {func.__name__}",                        category=DeprecationWarning,                        stacklevel=2)
-            warnings.simplefilter('default', DeprecationWarning)
-            return func(*args, **kwargs)
-        return new_func
-
-    @staticmethod
-    @check_arguments
-    def args_array_surround_with_quotes_if_required(arguments: list[str]) -> list[str]:
-        result = []
-        for argument in arguments:
-            if " " in argument and not (argument.startswith('"') and argument.endswith('"')):
-                result.append(f'"{argument}"')
-            else:
-                result.append(argument)
-        return result
-
-    @staticmethod
-    @check_arguments
-    def string_to_lines(string: str, add_empty_lines: bool = True, adapt_lines: bool = True) -> list[str]:
-        result = list()
-        if (string is not None):
-            lines = list()
-            if ("\n" in string):
-                lines = string.split("\n")
-            else:
-                lines.append(string)
-        for rawline in lines:
-            if adapt_lines:
-                line = rawline.replace("\r", "").strip()
-            else:
-                line = rawline
-            if GeneralUtilities.string_is_none_or_whitespace(line):
-                if add_empty_lines:
-                    result.append(line)
-            else:
-                result.append(line)
-        return result
-
-    @staticmethod
-    @check_arguments
-    def string_to_datetime(value: str) -> datetime:
-        return datetime.strptime(value, GeneralUtilities.__datetime_format)  # value ="2022-10-06T19:26:01" for example
-
-    @staticmethod
-    @check_arguments
-    def datetime_to_string(value: datetime) -> str:
-        return value.strftime(GeneralUtilities.__datetime_format)  # returns "2022-10-06T19:26:01" for example
-
-    @staticmethod
-    @check_arguments
-    def string_to_date(value: str) -> date:
-        splitted = value.split("-")
-        return date(int(splitted[0]), int(splitted[1]), int(splitted[2]))  # value ="2022-10-06" for example
-
-    @staticmethod
-    @check_arguments
-    def date_to_string(value: date) -> str:
-        return value.strftime(GeneralUtilities.__date_format)  # returns "2022-10-06" for example
-
-    @staticmethod
-    @check_arguments
-    def copy_content_of_folder(source_directory: str, target_directory: str, overwrite_existing_files=False) -> None:
-        GeneralUtilities.__copy_or_move_content_of_folder(source_directory, target_directory, overwrite_existing_files, False)
-
-    @staticmethod
-    @check_arguments
-    def move_content_of_folder(source_directory: str, target_directory: str, overwrite_existing_files=False) -> None:
-        GeneralUtilities.__copy_or_move_content_of_folder(source_directory, target_directory, overwrite_existing_files, True)
-
-    @staticmethod
-    @check_arguments
-    def __copy_or_move_content_of_folder(source_directory: str, target_directory: str, overwrite_existing_files, remove_source: bool) -> None:
-        srcDirFull = GeneralUtilities.resolve_relative_path_from_current_working_directory(source_directory)
-        dstDirFull = GeneralUtilities.resolve_relative_path_from_current_working_directory(target_directory)
-        if (os.path.isdir(source_directory)):
-            GeneralUtilities.ensure_directory_exists(target_directory)
-            for file in GeneralUtilities.get_direct_files_of_folder(srcDirFull):
-                filename = os.path.basename(file)
-                targetfile = os.path.join(dstDirFull, filename)
-                if (os.path.isfile(targetfile)):
-                    if overwrite_existing_files:
-                        GeneralUtilities.ensure_file_does_not_exist(targetfile)
-                    else:
-                        raise ValueError(f"Targetfile {targetfile} does already exist")
-                if remove_source:
-                    shutil.move(file, dstDirFull)
-                else:
-                    shutil.copy(file, dstDirFull)
-            for sub_folder in GeneralUtilities.get_direct_folders_of_folder(srcDirFull):
-                foldername = os.path.basename(sub_folder)
-                sub_target = os.path.join(dstDirFull, foldername)
-                GeneralUtilities.__copy_or_move_content_of_folder(sub_folder, sub_target, overwrite_existing_files, remove_source)
-                if remove_source:
-                    GeneralUtilities.ensure_directory_does_not_exist(sub_folder)
-        else:
-            raise ValueError(f"Folder '{source_directory}' does not exist")
-
-    @staticmethod
-    @check_arguments
-    def replace_regex_each_line_of_file(file: str, replace_from_regex: str, replace_to_regex: str, encoding="utf-8", verbose: bool = False) -> None:
-        """This function iterates over each line in the file and replaces it by the line which applied regex.
-        Note: The lines will be taken from open(...).readlines(). So the lines may contain '\\n' or '\\r\\n' for example."""
-        if verbose:
-            GeneralUtilities.write_message_to_stdout(f"Replace '{replace_from_regex}' to '{replace_to_regex}' in '{file}'")
-        with open(file, encoding=encoding, mode="r") as f:
-            lines = f.readlines()
-            replaced_lines = []
-            for line in lines:
-                replaced_line = re.sub(replace_from_regex, replace_to_regex, line)
-                replaced_lines.append(replaced_line)
-        with open(file, encoding=encoding, mode="w") as f:
-            f.writelines(replaced_lines)
-
-    @staticmethod
-    @check_arguments
-    def replace_regex_in_file(file: str, replace_from_regex: str, replace_to_regex: str, encoding="utf-8") -> None:
-        with open(file, encoding=encoding, mode="r") as f:
-            content = f.read()
-            content = re.sub(replace_from_regex, replace_to_regex, content)
-        with open(file, encoding=encoding, mode="w") as f:
-            f.write(content)
-
-    @staticmethod
-    @check_arguments
-    def replace_xmltag_in_file(file: str, tag: str, new_value: str, encoding="utf-8") -> None:
-        GeneralUtilities.replace_regex_in_file(file, f"<{tag}>.*</{tag}>", f"<{tag}>{new_value}</{tag}>", encoding)
-
-    @staticmethod
-    @check_arguments
-    def update_version_in_csproj_file(file: str, target_version: str) -> None:
-        GeneralUtilities.replace_xmltag_in_file(file, "Version", target_version)
-        GeneralUtilities.replace_xmltag_in_file(file, "AssemblyVersion", target_version + ".0")
-        GeneralUtilities.replace_xmltag_in_file(file, "FileVersion", target_version + ".0")
-
-    @staticmethod
-    @check_arguments
-    def replace_underscores_in_text(text: str, replacements: dict) -> str:
-        changed = True
-        while changed:
-            changed = False
-            for key, value in replacements.items():
-                previousValue = text
-                text = text.replace(f"__{key}__", value)
-                if (not text == previousValue):
-                    changed = True
-        return text
-
-    @staticmethod
-    @check_arguments
-    def replace_underscores_in_file(file: str, replacements: dict, encoding: str = "utf-8"):
-        text = GeneralUtilities.read_text_from_file(file, encoding)
-        text = GeneralUtilities.replace_underscores_in_text(text, replacements)
-        GeneralUtilities.write_text_to_file(file, text, encoding)
-
-    @staticmethod
-    @check_arguments
-    def reconfigure_standrd_input_and_outputs():
-        sys.stdin.reconfigure(encoding='utf-8')
-        sys.stderr.reconfigure(encoding='utf-8')
-        sys.stdout.reconfigure(encoding='utf-8')
-
-    @staticmethod
-    @check_arguments
-    def write_message_to_stdout(message: str):
-        for line in GeneralUtilities.string_to_lines(message):
-            sys.stdout.write(GeneralUtilities.str_none_safe(line)+"\n")
-            sys.stdout.flush()
-
-    @staticmethod
-    @check_arguments
-    def write_message_to_stderr(message: str):
-        sys.stderr.write(GeneralUtilities.str_none_safe(message)+"\n")
-        sys.stderr.flush()
-
-    @staticmethod
-    @check_arguments
-    def get_advanced_errormessage_for_os_error(os_error: OSError) -> str:
-        if GeneralUtilities.string_has_content(os_error.filename2):
-            secondpath = f" {os_error.filename2}"
-        else:
-            secondpath = ""
-        return f"Related path(s): {os_error.filename}{secondpath}"
-
-    @staticmethod
-    @check_arguments
-    def write_exception_to_stderr(exception: Exception, extra_message: str = None):
-        GeneralUtilities.write_exception_to_stderr_with_traceback(exception, None, extra_message)
-
-    @staticmethod
-    @check_arguments
-    def write_exception_to_stderr_with_traceback(exception: Exception, current_traceback=None, extra_message: str = None):
-        GeneralUtilities.write_message_to_stderr("Exception(")
-        GeneralUtilities.write_message_to_stderr("Type: " + str(type(exception)))
-        GeneralUtilities.write_message_to_stderr("Message: " + str(exception))
-        if extra_message is not None:
-            GeneralUtilities.write_message_to_stderr("Extra-message: " + str(extra_message))
-        if isinstance(exception, OSError):
-            GeneralUtilities.write_message_to_stderr(GeneralUtilities.get_advanced_errormessage_for_os_error(exception))
-        if current_traceback is not None:
-            GeneralUtilities.write_message_to_stderr("Traceback: " + current_traceback.format_exc())
-        GeneralUtilities.write_message_to_stderr(")")
-
-    @staticmethod
-    @check_arguments
-    def string_has_content(string: str) -> bool:
-        if string is None:
-            return False
-        else:
-            return len(string) > 0
-
-    @staticmethod
-    @check_arguments
-    def datetime_to_string_for_logfile_name(datetime_object: datetime) -> str:
-        return datetime_object.strftime('%Y-%m-%d_%H-%M-%S')
-
-    @staticmethod
-    @check_arguments
-    def datetime_to_string_for_logfile_entry(datetime_object: datetime) -> str:
-        return datetime_object.strftime('%Y-%m-%d %H:%M:%S')
-
-    @staticmethod
-    @check_arguments
-    def string_has_nonwhitespace_content(string: str) -> bool:
-        if string is None:
-            return False
-        else:
-            return len(string.strip()) > 0
-
-    @staticmethod
-    @check_arguments
-    def string_is_none_or_empty(argument: str) -> bool:
-        if argument is None:
-            return True
-        type_of_argument = type(argument)
-        if type_of_argument == str:
-            return argument == ""
-        else:
-            raise ValueError(f"expected string-variable in argument of string_is_none_or_empty but the type was '{str(type_of_argument)}'")
-
-    @staticmethod
-    @check_arguments
-    def string_is_none_or_whitespace(string: str) -> bool:
-        if GeneralUtilities.string_is_none_or_empty(string):
-            return True
-        else:
-            return string.strip() == ""
-
-    @staticmethod
-    @check_arguments
-    def strip_new_line_character(value: str) -> str:
-        while not GeneralUtilities.__strip_new_line_character_helper_value_is_ok(value):
-            value = GeneralUtilities.__strip_new_line_character_helper_normalize_value(value)
-        return value
-
-    @staticmethod
-    @check_arguments
-    def __strip_new_line_character_helper_value_is_ok(value: str) -> bool:
-        if value.startswith("\r") or value.endswith("\r"):
-            return False
-        if value.startswith("\n") or value.endswith("\n"):
-            return False
-        return True
-
-    @staticmethod
-    @check_arguments
-    def __strip_new_line_character_helper_normalize_value(value: str) -> str:
-        return value.strip('\n').strip('\r')
-
-    @staticmethod
-    @check_arguments
-    def file_ends_with_newline(file: str) -> bool:
-        with open(file, "rb") as file_object:
-            return GeneralUtilities.ends_with_newline_character(file_object.read())
-
-    @staticmethod
-    @check_arguments
-    def ends_with_newline_character(content: bytes) -> bool:
-        return content.endswith(b'\x0a')
-
-    @staticmethod
-    @check_arguments
-    def __get_new_line_character_if_required(file: str) -> bool:
-        content = GeneralUtilities.read_binary_from_file(file)
-        if len(content) == 0:
-            return ""
-        else:
-            if GeneralUtilities.ends_with_newline_character(content):
-                return ""
-            else:
-                return "\n"
-
-    @staticmethod
-    @check_arguments
-    def append_line_to_file(file: str, line: str, encoding: str = "utf-8") -> None:
-        line = GeneralUtilities.__get_new_line_character_if_required(file)+line
-        GeneralUtilities.append_to_file(file, line, encoding)
-
-    @staticmethod
-    @check_arguments
-    def append_to_file(file: str, content: str, encoding: str = "utf-8") -> None:
-        with open(file, "a", encoding=encoding) as fileObject:
-            fileObject.write(content)
-
-    @staticmethod
-    @check_arguments
-    def ensure_directory_exists(path: str) -> None:
-        if not os.path.isdir(path):
-            os.makedirs(path)
-
-    @staticmethod
-    @check_arguments
-    def ensure_file_exists(path: str) -> None:
-        if (not os.path.isfile(path)):
-            with open(path, "a+", encoding="utf-8"):
-                pass
-
-    @staticmethod
-    @check_arguments
-    def __remove_readonly(func, path, _):
-        os.chmod(path, stat.S_IWRITE)
-        func(path)
-
-    @staticmethod
-    @check_arguments
-    def rmtree(directory: str) -> None:
-        shutil.rmtree(directory, onerror=GeneralUtilities.__remove_readonly)
-
-    @staticmethod
-    @check_arguments
-    def ensure_directory_does_not_exist(path: str) -> None:
-        if (os.path.isdir(path)):
-            for root, dirs, files in os.walk(path, topdown=False):
-                for name in files:
-                    filename = os.path.join(root, name)
-                    os.chmod(filename, stat.S_IWUSR)
-                    os.remove(filename)
-                for name in dirs:
-                    GeneralUtilities.rmtree(os.path.join(root, name))
-            GeneralUtilities.rmtree(path)
-
-    @staticmethod
-    @check_arguments
-    def ensure_folder_exists_and_is_empty(path: str) -> None:
-        GeneralUtilities.ensure_directory_exists(path)
-        for filename in os.listdir(path):
-            file_path = os.path.join(path, filename)
-            if os.path.isfile(file_path):
-                os.remove(file_path)
-            if os.path.islink(file_path):
-                os.unlink(file_path)
-            elif os.path.isdir(file_path):
-                shutil.rmtree(file_path)
-
-    @staticmethod
-    @check_arguments
-    def ensure_file_does_not_exist(path: str) -> None:
-        if (os.path.isfile(path)):
-            os.remove(path)
-
-    @staticmethod
-    @check_arguments
-    def format_xml_file(filepath: str) -> None:
-        GeneralUtilities.format_xml_file_with_encoding(filepath, "utf-8")
-
-    @staticmethod
-    @check_arguments
-    def format_xml_file_with_encoding(filepath: str, encoding: str) -> None:
-        with codecs.open(filepath, 'r', encoding=encoding) as file:
-            text = file.read()
-        text = parse(text).toprettyxml()
-        with codecs.open(filepath, 'w', encoding=encoding) as file:
-            file.write(text)
-
-    @staticmethod
-    @check_arguments
-    def get_clusters_and_sectors_of_disk(diskpath: str) -> None:
-        sectorsPerCluster = ctypes.c_ulonglong(0)
-        bytesPerSector = ctypes.c_ulonglong(0)
-        rootPathName = ctypes.c_wchar_p(diskpath)
-        ctypes.windll.kernel32.GetDiskFreeSpaceW(rootPathName, ctypes.pointer(sectorsPerCluster), ctypes.pointer(bytesPerSector), None, None)
-        return (sectorsPerCluster.value, bytesPerSector.value)
-
-    @staticmethod
-    @check_arguments
-    def ensure_path_is_not_quoted(path: str) -> str:
-        if (path.startswith("\"") and path.endswith("\"")) or (path.startswith("'") and path.endswith("'")):
-            path = path[1:]
-            path = path[:-1]
-            return path
-        else:
-            return path
-
-    @staticmethod
-    @check_arguments
-    def get_missing_files(folderA: str, folderB: str) -> list:
-        folderA_length = len(folderA)
-        result = []
-        for fileA in GeneralUtilities.absolute_file_paths(folderA):
-            file = fileA[folderA_length:]
-            fileB = folderB + file
-            if not os.path.isfile(fileB):
-                result.append(fileB)
-        return result
-
-    @staticmethod
-    @check_arguments
-    def write_lines_to_file(file: str, lines: list, encoding="utf-8") -> None:
-        lines = [GeneralUtilities.strip_new_line_character(line) for line in lines]
-        content = os.linesep.join(lines)
-        GeneralUtilities.write_text_to_file(file, content, encoding)
-
-    @staticmethod
-    @check_arguments
-    def write_text_to_file(file: str, content: str, encoding="utf-8") -> None:
-        GeneralUtilities.write_binary_to_file(file, bytes(bytearray(content, encoding)))
-
-    @staticmethod
-    @check_arguments
-    def write_binary_to_file(file: str, content: bytes) -> None:
-        with open(file, "wb") as file_object:
-            file_object.write(content)
-
-    @staticmethod
-    @check_arguments
-    def read_lines_from_file(file: str, encoding="utf-8") -> list[str]:
-        return [GeneralUtilities.strip_new_line_character(line) for line in GeneralUtilities.read_text_from_file(file, encoding).split('\n')]
-
-    @staticmethod
-    @check_arguments
-    def read_text_from_file(file: str, encoding="utf-8") -> str:
-        return GeneralUtilities.bytes_to_string(GeneralUtilities.read_binary_from_file(file), encoding)
-
-    @staticmethod
-    @check_arguments
-    def read_binary_from_file(file: str) -> bytes:
-        with open(file, "rb") as file_object:
-            return file_object.read()
-
-    @staticmethod
-    @check_arguments
-    def timedelta_to_simple_string(delta: timedelta) -> str:
-        return (datetime(1970, 1, 1, 0, 0, 0) + delta).strftime('%H:%M:%S')
-
-    @staticmethod
-    @check_arguments
-    def resolve_relative_path_from_current_working_directory(path: str) -> str:
-        return GeneralUtilities.resolve_relative_path(path, os.getcwd())
-
-    @staticmethod
-    @check_arguments
-    def resolve_relative_path(path: str, base_path: str):
-        if (os.path.isabs(path)):
-            return path
-        else:
-            return str(Path(os.path.join(base_path, path)).resolve())
-
-    @staticmethod
-    @check_arguments
-    def get_metadata_for_file_for_clone_folder_structure(file: str) -> str:
-        size = os.path.getsize(file)
-        last_modified_timestamp = os.path.getmtime(file)
-        hash_value = GeneralUtilities.get_sha256_of_file(file)
-        last_access_timestamp = os.path.getatime(file)
-        return f'{{"size":"{size}","sha256":"{hash_value}","mtime":"{last_modified_timestamp}","atime":"{last_access_timestamp}"}}'
-
-    @staticmethod
-    @check_arguments
-    def clone_folder_structure(source: str, target: str, copy_only_metadata: bool):
-        source = GeneralUtilities.resolve_relative_path(source, os.getcwd())
-        target = GeneralUtilities.resolve_relative_path(target, os.getcwd())
-        length_of_source = len(source)
-        for source_file in GeneralUtilities.absolute_file_paths(source):
-            target_file = target+source_file[length_of_source:]
-            GeneralUtilities.ensure_directory_exists(os.path.dirname(target_file))
-            if copy_only_metadata:
-                with open(target_file, 'w', encoding='utf8') as f:
-                    f.write(GeneralUtilities.get_metadata_for_file_for_clone_folder_structure(source_file))
-            else:
-                copyfile(source_file, target_file)
-
-    @staticmethod
-    @check_arguments
-    def current_user_has_elevated_privileges() -> bool:
-        try:
-            return os.getuid() == 0
-        except AttributeError:
-            return ctypes.windll.shell32.IsUserAnAdmin() == 1
-
-    @staticmethod
-    @check_arguments
-    def ensure_elevated_privileges() -> None:
-        if (not GeneralUtilities.current_user_has_elevated_privileges()):
-            raise ValueError("Not enough privileges.")
-
-    @staticmethod
-    @check_arguments
-    def rename_names_of_all_files_and_folders(folder: str, replace_from: str, replace_to: str, replace_only_full_match=False):
-        for file in GeneralUtilities.get_direct_files_of_folder(folder):
-            GeneralUtilities.replace_in_filename(file, replace_from, replace_to, replace_only_full_match)
-        for sub_folder in GeneralUtilities.get_direct_folders_of_folder(folder):
-            GeneralUtilities.rename_names_of_all_files_and_folders(sub_folder, replace_from, replace_to, replace_only_full_match)
-        GeneralUtilities.replace_in_foldername(folder, replace_from, replace_to, replace_only_full_match)
-
-    @staticmethod
-    @check_arguments
-    def get_direct_files_of_folder(folder: str) -> list[str]:
-        result = [os.path.join(folder, f) for f in listdir(folder) if isfile(join(folder, f))]
-        return result
-
-    @staticmethod
-    @check_arguments
-    def get_direct_folders_of_folder(folder: str) -> list[str]:
-        result = [os.path.join(folder, f) for f in listdir(folder) if isdir(join(folder, f))]
-        return result
-
-    @staticmethod
-    @check_arguments
-    def get_all_files_of_folder(folder: str) -> list[str]:
-        result = list()
-        result.extend(GeneralUtilities.get_direct_files_of_folder(folder))
-        for subfolder in GeneralUtilities.get_direct_folders_of_folder(folder):
-            result.extend(GeneralUtilities.get_all_files_of_folder(subfolder))
-        return result
-
-    @staticmethod
-    @check_arguments
-    def get_all_folders_of_folder(folder: str) -> list[str]:
-        result = list()
-        subfolders = GeneralUtilities.get_direct_folders_of_folder(folder)
-        result.extend(subfolders)
-        for subfolder in subfolders:
-            result.extend(GeneralUtilities.get_all_folders_of_folder(subfolder))
-        return result
-
-    @staticmethod
-    @check_arguments
-    def get_all_objects_of_folder(folder: str) -> list[str]:
-        return GeneralUtilities.get_all_files_of_folder(folder) + GeneralUtilities.get_all_folders_of_folder(folder)
-
-    @staticmethod
-    @check_arguments
-    def replace_in_filename(file: str, replace_from: str, replace_to: str, replace_only_full_match=False):
-        filename = Path(file).name
-        if (GeneralUtilities.__should_get_replaced(filename, replace_from, replace_only_full_match)):
-            folder_of_file = os.path.dirname(file)
-            os.rename(file, os.path.join(folder_of_file, filename.replace(replace_from, replace_to)))
-
-    @staticmethod
-    @check_arguments
-    def replace_in_foldername(folder: str, replace_from: str, replace_to: str, replace_only_full_match=False):
-        foldername = Path(folder).name
-        if (GeneralUtilities.__should_get_replaced(foldername, replace_from, replace_only_full_match)):
-            folder_of_folder = os.path.dirname(folder)
-            os.rename(folder, os.path.join(folder_of_folder, foldername.replace(replace_from, replace_to)))
-
-    @staticmethod
-    @check_arguments
-    def __should_get_replaced(input_text, search_text, replace_only_full_match) -> bool:
-        if replace_only_full_match:
-            return input_text == search_text
-        else:
-            return search_text in input_text
-
-    @staticmethod
-    @check_arguments
-    def str_none_safe(variable) -> str:
-        if variable is None:
-            return ''
-        else:
-            return str(variable)
-
-    @staticmethod
-    @check_arguments
-    def arguments_to_array(arguments_as_string: str) -> list[str]:
-        if arguments_as_string is None:
-            return []
-        if GeneralUtilities.string_has_content(arguments_as_string):
-            return arguments_as_string.split(" ")  # TODO this function should get improved to allow whitespaces in quote-substrings
-        else:
-            return []
-
-    @staticmethod
-    @check_arguments
-    def arguments_to_array_for_log(arguments_as_string: str) -> list[str]:
-        if arguments_as_string is None:
-            return None
-        return GeneralUtilities.arguments_to_array(arguments_as_string)
-
-    @staticmethod
-    @check_arguments
-    def get_sha256_of_file(file: str) -> str:
-        sha256 = hashlib.sha256()
-        with open(file, "rb") as fileObject:
-            for chunk in iter(lambda: fileObject.read(4096), b""):
-                sha256.update(chunk)
-        return sha256.hexdigest()
-
-    @staticmethod
-    @check_arguments
-    def remove_duplicates(input_list) -> list:
-        result = []
-        for item in input_list:
-            if not item in result:
-                result.append(item)
-        return result
-
-    @staticmethod
-    @check_arguments
-    def print_stacktrace() -> None:
-        for line in traceback.format_stack():
-            GeneralUtilities.write_message_to_stdout(line.strip())
-
-    @staticmethod
-    @check_arguments
-    def string_to_boolean(value: str) -> bool:
-        value = value.strip().lower()
-        if value in ('yes', 'y', 'true', 't', '1'):
-            return True
-        elif value in ('no', 'n', 'false', 'f', '0'):
-            return False
-        else:
-            raise ValueError(f"Can not convert '{value}' to a boolean value")
-
-    @staticmethod
-    @check_arguments
-    def file_is_empty(file: str) -> bool:
-        return os.stat(file).st_size == 0
-
-    @staticmethod
-    @check_arguments
-    def folder_is_empty(folder: str) -> bool:
-        return len(GeneralUtilities.get_direct_files_of_folder(folder)) == 0 and len(GeneralUtilities.get_direct_folders_of_folder(folder)) == 0
-
-    @staticmethod
-    @check_arguments
-    def get_time_based_logfile_by_folder(folder: str, name: str = "Log", in_utc: bool = False) -> str:
-        return os.path.join(GeneralUtilities.resolve_relative_path_from_current_working_directory(folder), f"{GeneralUtilities.get_time_based_logfilename(name, in_utc)}.log")
-
-    @staticmethod
-    @check_arguments
-    def get_time_based_logfilename(name: str = "Log", in_utc: bool = False) -> str:
-        if (in_utc):
-            d = datetime.utcnow()
-        else:
-            d = datetime.now()
-        return f"{name}_{GeneralUtilities.datetime_to_string_for_logfile_name(d)}"
-
-    @staticmethod
-    @check_arguments
-    def bytes_to_string(payload: bytes, encoding: str = 'utf-8') -> str:
-        return payload.decode(encoding, errors="ignore")
-
-    @staticmethod
-    @check_arguments
-    def string_to_bytes(payload: str, encoding: str = 'utf-8') -> bytes:
-        return payload.encode(encoding, errors="ignore")
-
-    @staticmethod
-    @check_arguments
-    def contains_line(lines, regex: str) -> bool:
-        for line in lines:
-            if (re.match(regex, line)):
-                return True
-        return False
-
-    @staticmethod
-    @check_arguments
-    def read_csv_file(file: str, ignore_first_line: bool = False, treat_number_sign_at_begin_of_line_as_comment: bool = True, trim_values: bool = True,
-                      encoding="utf-8", ignore_empty_lines: bool = True, separator_character: str = ";", values_are_surrounded_by_quotes: bool = False) -> list[list[str]]:
-        lines = GeneralUtilities.read_lines_from_file(file, encoding)
-
-        if ignore_first_line:
-            lines = lines[1:]
-        result = list()
-        line: str
-        for line_loopvariable in lines:
-            use_line = True
-            line = line_loopvariable
-
-            if trim_values:
-                line = line.strip()
-            if ignore_empty_lines:
-                if not GeneralUtilities.string_has_content(line):
-                    use_line = False
-
-            if treat_number_sign_at_begin_of_line_as_comment:
-                if line.startswith("#"):
-                    use_line = False
-
-            if use_line:
-                if separator_character in line:
-                    raw_values_of_line = GeneralUtilities.to_list(line, separator_character)
-                else:
-                    raw_values_of_line = [line]
-                if trim_values:
-                    raw_values_of_line = [value.strip() for value in raw_values_of_line]
-                values_of_line = []
-                for raw_value_of_line in raw_values_of_line:
-                    value_of_line = raw_value_of_line
-                    if values_are_surrounded_by_quotes:
-                        value_of_line = value_of_line[1:]
-                        value_of_line = value_of_line[:-1]
-                        value_of_line = value_of_line.replace('""', '"')
-                    values_of_line.append(value_of_line)
-                result.extend([values_of_line])
-        return result
-
-    @staticmethod
-    @check_arguments
-    def epew_is_available() -> bool:
-        try:
-            return shutil.which("epew") is not None
-        except:
-            return False
-
-    @staticmethod
-    @check_arguments
-    @deprecated
-    def absolute_file_paths(directory: str) -> list[str]:
-        return GeneralUtilities.get_all_files_of_folder(directory)
-
-    @staticmethod
-    @check_arguments
-    def to_list(list_as_string: str, separator: str = ",") -> list[str]:
-        result = list()
-        if list_as_string is not None:
-            list_as_string = list_as_string.strip()
-            if list_as_string == "":
-                pass
-            elif separator in list_as_string:
-                for item in list_as_string.split(separator):
-                    result.append(item.strip())
-            else:
-                result.append(list_as_string)
-        return result
-
-    @staticmethod
-    @check_arguments
-    def get_next_square_number(number: int) -> int:
-        GeneralUtilities.assert_condition(number >= 0, "get_next_square_number is only applicable for nonnegative numbers")
-        if number == 0:
-            return 1
-        root = 0
-        square = 0
-        while square < number:
-            root = root+1
-            square = root*root
-        return root*root
-
-    @staticmethod
-    @check_arguments
-    def generate_password(length: int = 16, alphabet: str = None) -> None:
-        if alphabet is None:
-            alphabet = strin.ascii_letters + strin.digits+"_"
-        return ''.join(secrets.choice(alphabet) for i in range(length))
-
-    @staticmethod
-    @check_arguments
-    def assert_condition(condition: bool, information: str) -> None:
-        if (not condition):
-            raise ValueError("Condition failed. "+information)
-
-    @staticmethod
-    def current_system_is_windows():
-        return platform.system() == 'Windows'
-
-    @staticmethod
-    def current_system_is_linux():
-        return platform.system() == 'Linux'
-
-    @staticmethod
-    @check_arguments
-    def get_certificate_expiry_date(certificate_file: str) -> datetime:
-        with open(certificate_file, encoding="utf-8") as certificate_file_content:
-            cert = crypto.load_certificate(crypto.FILETYPE_PEM, certificate_file_content.read())
-            date_as_bytes = cert.get_notAfter()
-            date_as_string = date_as_bytes.decode("utf-8")
-            result = datetime.strptime(date_as_string, '%Y%m%d%H%M%SZ')
-            return result
-
-    @staticmethod
-    @check_arguments
-    def certificate_is_expired(certificate_file: str) -> bool:
-        return GeneralUtilities.get_certificate_expiry_date(certificate_file) < datetime.now()
-
-    @staticmethod
-    @check_arguments
-    def internet_connection_is_available() -> bool:
-        # TODO add more hosts to check to return true if at least one is available
-        try:
-            with urllib.request.urlopen("https://google.com") as url_result:
-                return (url_result.code // 100) == 2
-        except:
-            pass
-        return False
-
-    @staticmethod
-    @check_arguments
-    def replace_variable_in_string(input_string: str, variable_name: str, variable_value: str) -> None:
-        return input_string.replace(f"__[{variable_name}]__", variable_value)
+import codecs
+import platform
+import inspect
+import ctypes
+import hashlib
+import re
+import os
+import shutil
+import urllib
+import stat
+import secrets
+import string as strin
+import sys
+import traceback
+import warnings
+import functools
+from datetime import datetime, timedelta, date
+from os import listdir
+from os.path import isfile, join, isdir
+from pathlib import Path
+from shutil import copyfile
+import typing
+from defusedxml.minidom import parse
+from OpenSSL import crypto
+
+
+class GeneralUtilities:
+
+    __datetime_format: str = "%Y-%m-%dT%H:%M:%S"
+    __date_format: str = "%Y-%m-%d"
+
+    @staticmethod
+    def get_modest_dark_url() -> str:
+        return "https://aniondev.github.io/CDN/ScriptCollectionDesigns/ModestDark/Style.css"
+
+    @staticmethod
+    def is_generic(t: typing.Type):
+        return hasattr(t, "__origin__")
+
+    @staticmethod
+    def check_arguments(function):
+        def __check_function(*args, **named_args):
+            parameters: list = inspect.getfullargspec(function)[0].copy()
+            arguments: list = list(tuple(args)).copy()
+            if "self" in parameters:
+                parameters.remove("self")
+                arguments.pop(0)
+            for index, argument in enumerate(arguments):
+                if argument is not None:  # Check type of None is not possible. None is always a valid argument-value
+                    if parameters[index] in function.__annotations__:  # Check if a type-hint for parameter exist. If not, no parameter-type available for argument-type-check
+                        # Check type of arguments if the type is a generic type seems to be impossible.
+                        if not GeneralUtilities.is_generic(function.__annotations__[parameters[index]]):
+                            if not isinstance(argument, function.__annotations__[parameters[index]]):
+                                raise TypeError(f"Argument with index {index} for function {function.__name__} ('{str(argument)}') is not of type { function.__annotations__[parameters[index]]} but has type "+str(type(argument)))
+            for index, named_argument in enumerate(named_args):
+                if named_args[named_argument] is not None:
+                    if parameters[index] in function.__annotations__:
+                        if not GeneralUtilities.is_generic(function.__annotations__.get(named_argument)):
+                            if not isinstance(named_args[named_argument], function.__annotations__.get(named_argument)):
+                                raise TypeError(f"Argument with name {named_argument} for function {function.__name__} ('{str(named_args[named_argument])}') is not of type { function.__annotations__.get(named_argument)}")
+            return function(*args, **named_args)
+        __check_function.__doc__ = function.__doc__
+        return __check_function
+
+    @staticmethod
+    def deprecated(func):
+        @functools.wraps(func)
+        def new_func(*args, **kwargs):
+            warnings.simplefilter('always', DeprecationWarning)
+            warnings.warn(f"Call to deprecated function {func.__name__}",                        category=DeprecationWarning,                        stacklevel=2)
+            warnings.simplefilter('default', DeprecationWarning)
+            return func(*args, **kwargs)
+        return new_func
+
+    @staticmethod
+    @check_arguments
+    def args_array_surround_with_quotes_if_required(arguments: list[str]) -> list[str]:
+        result = []
+        for argument in arguments:
+            if " " in argument and not (argument.startswith('"') and argument.endswith('"')):
+                result.append(f'"{argument}"')
+            else:
+                result.append(argument)
+        return result
+
+    @staticmethod
+    @check_arguments
+    def string_to_lines(string: str, add_empty_lines: bool = True, adapt_lines: bool = True) -> list[str]:
+        result = list()
+        if (string is not None):
+            lines = list()
+            if ("\n" in string):
+                lines = string.split("\n")
+            else:
+                lines.append(string)
+        for rawline in lines:
+            if adapt_lines:
+                line = rawline.replace("\r", "").strip()
+            else:
+                line = rawline
+            if GeneralUtilities.string_is_none_or_whitespace(line):
+                if add_empty_lines:
+                    result.append(line)
+            else:
+                result.append(line)
+        return result
+
+    @staticmethod
+    @check_arguments
+    def string_to_datetime(value: str) -> datetime:
+        return datetime.strptime(value, GeneralUtilities.__datetime_format)  # value ="2022-10-06T19:26:01" for example
+
+    @staticmethod
+    @check_arguments
+    def datetime_to_string(value: datetime) -> str:
+        return value.strftime(GeneralUtilities.__datetime_format)  # returns "2022-10-06T19:26:01" for example
+
+    @staticmethod
+    @check_arguments
+    def string_to_date(value: str) -> date:
+        splitted = value.split("-")
+        return date(int(splitted[0]), int(splitted[1]), int(splitted[2]))  # value ="2022-10-06" for example
+
+    @staticmethod
+    @check_arguments
+    def date_to_string(value: date) -> str:
+        return value.strftime(GeneralUtilities.__date_format)  # returns "2022-10-06" for example
+
+    @staticmethod
+    @check_arguments
+    def copy_content_of_folder(source_directory: str, target_directory: str, overwrite_existing_files=False) -> None:
+        GeneralUtilities.__copy_or_move_content_of_folder(source_directory, target_directory, overwrite_existing_files, False)
+
+    @staticmethod
+    @check_arguments
+    def move_content_of_folder(source_directory: str, target_directory: str, overwrite_existing_files=False) -> None:
+        GeneralUtilities.__copy_or_move_content_of_folder(source_directory, target_directory, overwrite_existing_files, True)
+
+    @staticmethod
+    @check_arguments
+    def __copy_or_move_content_of_folder(source_directory: str, target_directory: str, overwrite_existing_files, remove_source: bool) -> None:
+        srcDirFull = GeneralUtilities.resolve_relative_path_from_current_working_directory(source_directory)
+        dstDirFull = GeneralUtilities.resolve_relative_path_from_current_working_directory(target_directory)
+        if (os.path.isdir(source_directory)):
+            GeneralUtilities.ensure_directory_exists(target_directory)
+            for file in GeneralUtilities.get_direct_files_of_folder(srcDirFull):
+                filename = os.path.basename(file)
+                targetfile = os.path.join(dstDirFull, filename)
+                if (os.path.isfile(targetfile)):
+                    if overwrite_existing_files:
+                        GeneralUtilities.ensure_file_does_not_exist(targetfile)
+                    else:
+                        raise ValueError(f"Targetfile {targetfile} does already exist")
+                if remove_source:
+                    shutil.move(file, dstDirFull)
+                else:
+                    shutil.copy(file, dstDirFull)
+            for sub_folder in GeneralUtilities.get_direct_folders_of_folder(srcDirFull):
+                foldername = os.path.basename(sub_folder)
+                sub_target = os.path.join(dstDirFull, foldername)
+                GeneralUtilities.__copy_or_move_content_of_folder(sub_folder, sub_target, overwrite_existing_files, remove_source)
+                if remove_source:
+                    GeneralUtilities.ensure_directory_does_not_exist(sub_folder)
+        else:
+            raise ValueError(f"Folder '{source_directory}' does not exist")
+
+    @staticmethod
+    @check_arguments
+    def replace_regex_each_line_of_file(file: str, replace_from_regex: str, replace_to_regex: str, encoding="utf-8", verbose: bool = False) -> None:
+        """This function iterates over each line in the file and replaces it by the line which applied regex.
+        Note: The lines will be taken from open(...).readlines(). So the lines may contain '\\n' or '\\r\\n' for example."""
+        if verbose:
+            GeneralUtilities.write_message_to_stdout(f"Replace '{replace_from_regex}' to '{replace_to_regex}' in '{file}'")
+        with open(file, encoding=encoding, mode="r") as f:
+            lines = f.readlines()
+            replaced_lines = []
+            for line in lines:
+                replaced_line = re.sub(replace_from_regex, replace_to_regex, line)
+                replaced_lines.append(replaced_line)
+        with open(file, encoding=encoding, mode="w") as f:
+            f.writelines(replaced_lines)
+
+    @staticmethod
+    @check_arguments
+    def replace_regex_in_file(file: str, replace_from_regex: str, replace_to_regex: str, encoding="utf-8") -> None:
+        with open(file, encoding=encoding, mode="r") as f:
+            content = f.read()
+            content = re.sub(replace_from_regex, replace_to_regex, content)
+        with open(file, encoding=encoding, mode="w") as f:
+            f.write(content)
+
+    @staticmethod
+    @check_arguments
+    def replace_xmltag_in_file(file: str, tag: str, new_value: str, encoding="utf-8") -> None:
+        GeneralUtilities.replace_regex_in_file(file, f"<{tag}>.*</{tag}>", f"<{tag}>{new_value}</{tag}>", encoding)
+
+    @staticmethod
+    @check_arguments
+    def update_version_in_csproj_file(file: str, target_version: str) -> None:
+        GeneralUtilities.replace_xmltag_in_file(file, "Version", target_version)
+        GeneralUtilities.replace_xmltag_in_file(file, "AssemblyVersion", target_version + ".0")
+        GeneralUtilities.replace_xmltag_in_file(file, "FileVersion", target_version + ".0")
+
+    @staticmethod
+    @check_arguments
+    def replace_underscores_in_text(text: str, replacements: dict) -> str:
+        changed = True
+        while changed:
+            changed = False
+            for key, value in replacements.items():
+                previousValue = text
+                text = text.replace(f"__{key}__", value)
+                if (not text == previousValue):
+                    changed = True
+        return text
+
+    @staticmethod
+    @check_arguments
+    def replace_underscores_in_file(file: str, replacements: dict, encoding: str = "utf-8"):
+        text = GeneralUtilities.read_text_from_file(file, encoding)
+        text = GeneralUtilities.replace_underscores_in_text(text, replacements)
+        GeneralUtilities.write_text_to_file(file, text, encoding)
+
+    @staticmethod
+    @check_arguments
+    def reconfigure_standrd_input_and_outputs():
+        sys.stdin.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+        sys.stdout.reconfigure(encoding='utf-8')
+
+    @staticmethod
+    @check_arguments
+    def write_message_to_stdout(message: str):
+        for line in GeneralUtilities.string_to_lines(message):
+            sys.stdout.write(GeneralUtilities.str_none_safe(line)+"\n")
+            sys.stdout.flush()
+
+    @staticmethod
+    @check_arguments
+    def write_message_to_stderr(message: str):
+        sys.stderr.write(GeneralUtilities.str_none_safe(message)+"\n")
+        sys.stderr.flush()
+
+    @staticmethod
+    @check_arguments
+    def get_advanced_errormessage_for_os_error(os_error: OSError) -> str:
+        if GeneralUtilities.string_has_content(os_error.filename2):
+            secondpath = f" {os_error.filename2}"
+        else:
+            secondpath = ""
+        return f"Related path(s): {os_error.filename}{secondpath}"
+
+    @staticmethod
+    @check_arguments
+    def write_exception_to_stderr(exception: Exception, extra_message: str = None):
+        GeneralUtilities.write_exception_to_stderr_with_traceback(exception, None, extra_message)
+
+    @staticmethod
+    @check_arguments
+    def write_exception_to_stderr_with_traceback(exception: Exception, current_traceback=None, extra_message: str = None):
+        GeneralUtilities.write_message_to_stderr("Exception(")
+        GeneralUtilities.write_message_to_stderr("Type: " + str(type(exception)))
+        GeneralUtilities.write_message_to_stderr("Message: " + str(exception))
+        if extra_message is not None:
+            GeneralUtilities.write_message_to_stderr("Extra-message: " + str(extra_message))
+        if isinstance(exception, OSError):
+            GeneralUtilities.write_message_to_stderr(GeneralUtilities.get_advanced_errormessage_for_os_error(exception))
+        if current_traceback is not None:
+            GeneralUtilities.write_message_to_stderr("Traceback: " + current_traceback.format_exc())
+        GeneralUtilities.write_message_to_stderr(")")
+
+    @staticmethod
+    @check_arguments
+    def string_has_content(string: str) -> bool:
+        if string is None:
+            return False
+        else:
+            return len(string) > 0
+
+    @staticmethod
+    @check_arguments
+    def datetime_to_string_for_logfile_name(datetime_object: datetime) -> str:
+        return datetime_object.strftime('%Y-%m-%d_%H-%M-%S')
+
+    @staticmethod
+    @check_arguments
+    def datetime_to_string_for_logfile_entry(datetime_object: datetime) -> str:
+        return datetime_object.strftime('%Y-%m-%d %H:%M:%S')
+
+    @staticmethod
+    @check_arguments
+    def string_has_nonwhitespace_content(string: str) -> bool:
+        if string is None:
+            return False
+        else:
+            return len(string.strip()) > 0
+
+    @staticmethod
+    @check_arguments
+    def string_is_none_or_empty(argument: str) -> bool:
+        if argument is None:
+            return True
+        type_of_argument = type(argument)
+        if type_of_argument == str:
+            return argument == ""
+        else:
+            raise ValueError(f"expected string-variable in argument of string_is_none_or_empty but the type was '{str(type_of_argument)}'")
+
+    @staticmethod
+    @check_arguments
+    def string_is_none_or_whitespace(string: str) -> bool:
+        if GeneralUtilities.string_is_none_or_empty(string):
+            return True
+        else:
+            return string.strip() == ""
+
+    @staticmethod
+    @check_arguments
+    def strip_new_line_character(value: str) -> str:
+        while not GeneralUtilities.__strip_new_line_character_helper_value_is_ok(value):
+            value = GeneralUtilities.__strip_new_line_character_helper_normalize_value(value)
+        return value
+
+    @staticmethod
+    @check_arguments
+    def __strip_new_line_character_helper_value_is_ok(value: str) -> bool:
+        if value.startswith("\r") or value.endswith("\r"):
+            return False
+        if value.startswith("\n") or value.endswith("\n"):
+            return False
+        return True
+
+    @staticmethod
+    @check_arguments
+    def __strip_new_line_character_helper_normalize_value(value: str) -> str:
+        return value.strip('\n').strip('\r')
+
+    @staticmethod
+    @check_arguments
+    def file_ends_with_newline(file: str) -> bool:
+        with open(file, "rb") as file_object:
+            return GeneralUtilities.ends_with_newline_character(file_object.read())
+
+    @staticmethod
+    @check_arguments
+    def ends_with_newline_character(content: bytes) -> bool:
+        return content.endswith(b'\x0a')
+
+    @staticmethod
+    @check_arguments
+    def __get_new_line_character_if_required(file: str) -> bool:
+        content = GeneralUtilities.read_binary_from_file(file)
+        if len(content) == 0:
+            return ""
+        else:
+            if GeneralUtilities.ends_with_newline_character(content):
+                return ""
+            else:
+                return "\n"
+
+    @staticmethod
+    @check_arguments
+    def append_line_to_file(file: str, line: str, encoding: str = "utf-8") -> None:
+        line = GeneralUtilities.__get_new_line_character_if_required(file)+line
+        GeneralUtilities.append_to_file(file, line, encoding)
+
+    @staticmethod
+    @check_arguments
+    def append_to_file(file: str, content: str, encoding: str = "utf-8") -> None:
+        with open(file, "a", encoding=encoding) as fileObject:
+            fileObject.write(content)
+
+    @staticmethod
+    @check_arguments
+    def ensure_directory_exists(path: str) -> None:
+        if not os.path.isdir(path):
+            os.makedirs(path)
+
+    @staticmethod
+    @check_arguments
+    def ensure_file_exists(path: str) -> None:
+        if (not os.path.isfile(path)):
+            with open(path, "a+", encoding="utf-8"):
+                pass
+
+    @staticmethod
+    @check_arguments
+    def __remove_readonly(func, path, _):
+        os.chmod(path, stat.S_IWRITE)
+        func(path)
+
+    @staticmethod
+    @check_arguments
+    def rmtree(directory: str) -> None:
+        shutil.rmtree(directory, onerror=GeneralUtilities.__remove_readonly)
+
+    @staticmethod
+    @check_arguments
+    def ensure_directory_does_not_exist(path: str) -> None:
+        if (os.path.isdir(path)):
+            for root, dirs, files in os.walk(path, topdown=False):
+                for name in files:
+                    filename = os.path.join(root, name)
+                    os.chmod(filename, stat.S_IWUSR)
+                    os.remove(filename)
+                for name in dirs:
+                    GeneralUtilities.rmtree(os.path.join(root, name))
+            GeneralUtilities.rmtree(path)
+
+    @staticmethod
+    @check_arguments
+    def ensure_folder_exists_and_is_empty(path: str) -> None:
+        GeneralUtilities.ensure_directory_exists(path)
+        for filename in os.listdir(path):
+            file_path = os.path.join(path, filename)
+            if os.path.isfile(file_path):
+                os.remove(file_path)
+            if os.path.islink(file_path):
+                os.unlink(file_path)
+            elif os.path.isdir(file_path):
+                shutil.rmtree(file_path)
+
+    @staticmethod
+    @check_arguments
+    def ensure_file_does_not_exist(path: str) -> None:
+        if (os.path.isfile(path)):
+            os.remove(path)
+
+    @staticmethod
+    @check_arguments
+    def format_xml_file(filepath: str) -> None:
+        GeneralUtilities.format_xml_file_with_encoding(filepath, "utf-8")
+
+    @staticmethod
+    @check_arguments
+    def format_xml_file_with_encoding(filepath: str, encoding: str) -> None:
+        with codecs.open(filepath, 'r', encoding=encoding) as file:
+            text = file.read()
+        text = parse(text).toprettyxml()
+        with codecs.open(filepath, 'w', encoding=encoding) as file:
+            file.write(text)
+
+    @staticmethod
+    @check_arguments
+    def get_clusters_and_sectors_of_disk(diskpath: str) -> None:
+        sectorsPerCluster = ctypes.c_ulonglong(0)
+        bytesPerSector = ctypes.c_ulonglong(0)
+        rootPathName = ctypes.c_wchar_p(diskpath)
+        ctypes.windll.kernel32.GetDiskFreeSpaceW(rootPathName, ctypes.pointer(sectorsPerCluster), ctypes.pointer(bytesPerSector), None, None)
+        return (sectorsPerCluster.value, bytesPerSector.value)
+
+    @staticmethod
+    @check_arguments
+    def ensure_path_is_not_quoted(path: str) -> str:
+        if (path.startswith("\"") and path.endswith("\"")) or (path.startswith("'") and path.endswith("'")):
+            path = path[1:]
+            path = path[:-1]
+            return path
+        else:
+            return path
+
+    @staticmethod
+    @check_arguments
+    def get_missing_files(folderA: str, folderB: str) -> list:
+        folderA_length = len(folderA)
+        result = []
+        for fileA in GeneralUtilities.absolute_file_paths(folderA):
+            file = fileA[folderA_length:]
+            fileB = folderB + file
+            if not os.path.isfile(fileB):
+                result.append(fileB)
+        return result
+
+    @staticmethod
+    @check_arguments
+    def write_lines_to_file(file: str, lines: list, encoding="utf-8") -> None:
+        lines = [GeneralUtilities.strip_new_line_character(line) for line in lines]
+        content = os.linesep.join(lines)
+        GeneralUtilities.write_text_to_file(file, content, encoding)
+
+    @staticmethod
+    @check_arguments
+    def write_text_to_file(file: str, content: str, encoding="utf-8") -> None:
+        GeneralUtilities.write_binary_to_file(file, bytes(bytearray(content, encoding)))
+
+    @staticmethod
+    @check_arguments
+    def write_binary_to_file(file: str, content: bytes) -> None:
+        with open(file, "wb") as file_object:
+            file_object.write(content)
+
+    @staticmethod
+    @check_arguments
+    def read_lines_from_file(file: str, encoding="utf-8") -> list[str]:
+        return [GeneralUtilities.strip_new_line_character(line) for line in GeneralUtilities.read_text_from_file(file, encoding).split('\n')]
+
+    @staticmethod
+    @check_arguments
+    def read_text_from_file(file: str, encoding="utf-8") -> str:
+        return GeneralUtilities.bytes_to_string(GeneralUtilities.read_binary_from_file(file), encoding)
+
+    @staticmethod
+    @check_arguments
+    def read_binary_from_file(file: str) -> bytes:
+        with open(file, "rb") as file_object:
+            return file_object.read()
+
+    @staticmethod
+    @check_arguments
+    def timedelta_to_simple_string(delta: timedelta) -> str:
+        return (datetime(1970, 1, 1, 0, 0, 0) + delta).strftime('%H:%M:%S')
+
+    @staticmethod
+    @check_arguments
+    def resolve_relative_path_from_current_working_directory(path: str) -> str:
+        return GeneralUtilities.resolve_relative_path(path, os.getcwd())
+
+    @staticmethod
+    @check_arguments
+    def resolve_relative_path(path: str, base_path: str):
+        if (os.path.isabs(path)):
+            return path
+        else:
+            return str(Path(os.path.join(base_path, path)).resolve())
+
+    @staticmethod
+    @check_arguments
+    def get_metadata_for_file_for_clone_folder_structure(file: str) -> str:
+        size = os.path.getsize(file)
+        last_modified_timestamp = os.path.getmtime(file)
+        hash_value = GeneralUtilities.get_sha256_of_file(file)
+        last_access_timestamp = os.path.getatime(file)
+        return f'{{"size":"{size}","sha256":"{hash_value}","mtime":"{last_modified_timestamp}","atime":"{last_access_timestamp}"}}'
+
+    @staticmethod
+    @check_arguments
+    def clone_folder_structure(source: str, target: str, copy_only_metadata: bool):
+        source = GeneralUtilities.resolve_relative_path(source, os.getcwd())
+        target = GeneralUtilities.resolve_relative_path(target, os.getcwd())
+        length_of_source = len(source)
+        for source_file in GeneralUtilities.absolute_file_paths(source):
+            target_file = target+source_file[length_of_source:]
+            GeneralUtilities.ensure_directory_exists(os.path.dirname(target_file))
+            if copy_only_metadata:
+                with open(target_file, 'w', encoding='utf8') as f:
+                    f.write(GeneralUtilities.get_metadata_for_file_for_clone_folder_structure(source_file))
+            else:
+                copyfile(source_file, target_file)
+
+    @staticmethod
+    @check_arguments
+    def current_user_has_elevated_privileges() -> bool:
+        try:
+            return os.getuid() == 0
+        except AttributeError:
+            return ctypes.windll.shell32.IsUserAnAdmin() == 1
+
+    @staticmethod
+    @check_arguments
+    def ensure_elevated_privileges() -> None:
+        if (not GeneralUtilities.current_user_has_elevated_privileges()):
+            raise ValueError("Not enough privileges.")
+
+    @staticmethod
+    @check_arguments
+    def rename_names_of_all_files_and_folders(folder: str, replace_from: str, replace_to: str, replace_only_full_match=False):
+        for file in GeneralUtilities.get_direct_files_of_folder(folder):
+            GeneralUtilities.replace_in_filename(file, replace_from, replace_to, replace_only_full_match)
+        for sub_folder in GeneralUtilities.get_direct_folders_of_folder(folder):
+            GeneralUtilities.rename_names_of_all_files_and_folders(sub_folder, replace_from, replace_to, replace_only_full_match)
+        GeneralUtilities.replace_in_foldername(folder, replace_from, replace_to, replace_only_full_match)
+
+    @staticmethod
+    @check_arguments
+    def get_direct_files_of_folder(folder: str) -> list[str]:
+        result = [os.path.join(folder, f) for f in listdir(folder) if isfile(join(folder, f))]
+        return result
+
+    @staticmethod
+    @check_arguments
+    def get_direct_folders_of_folder(folder: str) -> list[str]:
+        result = [os.path.join(folder, f) for f in listdir(folder) if isdir(join(folder, f))]
+        return result
+
+    @staticmethod
+    @check_arguments
+    def get_all_files_of_folder(folder: str) -> list[str]:
+        result = list()
+        result.extend(GeneralUtilities.get_direct_files_of_folder(folder))
+        for subfolder in GeneralUtilities.get_direct_folders_of_folder(folder):
+            result.extend(GeneralUtilities.get_all_files_of_folder(subfolder))
+        return result
+
+    @staticmethod
+    @check_arguments
+    def get_all_folders_of_folder(folder: str) -> list[str]:
+        result = list()
+        subfolders = GeneralUtilities.get_direct_folders_of_folder(folder)
+        result.extend(subfolders)
+        for subfolder in subfolders:
+            result.extend(GeneralUtilities.get_all_folders_of_folder(subfolder))
+        return result
+
+    @staticmethod
+    @check_arguments
+    def get_all_objects_of_folder(folder: str) -> list[str]:
+        return GeneralUtilities.get_all_files_of_folder(folder) + GeneralUtilities.get_all_folders_of_folder(folder)
+
+    @staticmethod
+    @check_arguments
+    def replace_in_filename(file: str, replace_from: str, replace_to: str, replace_only_full_match=False):
+        filename = Path(file).name
+        if (GeneralUtilities.__should_get_replaced(filename, replace_from, replace_only_full_match)):
+            folder_of_file = os.path.dirname(file)
+            os.rename(file, os.path.join(folder_of_file, filename.replace(replace_from, replace_to)))
+
+    @staticmethod
+    @check_arguments
+    def replace_in_foldername(folder: str, replace_from: str, replace_to: str, replace_only_full_match=False):
+        foldername = Path(folder).name
+        if (GeneralUtilities.__should_get_replaced(foldername, replace_from, replace_only_full_match)):
+            folder_of_folder = os.path.dirname(folder)
+            os.rename(folder, os.path.join(folder_of_folder, foldername.replace(replace_from, replace_to)))
+
+    @staticmethod
+    @check_arguments
+    def __should_get_replaced(input_text, search_text, replace_only_full_match) -> bool:
+        if replace_only_full_match:
+            return input_text == search_text
+        else:
+            return search_text in input_text
+
+    @staticmethod
+    @check_arguments
+    def str_none_safe(variable) -> str:
+        if variable is None:
+            return ''
+        else:
+            return str(variable)
+
+    @staticmethod
+    @check_arguments
+    def arguments_to_array(arguments_as_string: str) -> list[str]:
+        if arguments_as_string is None:
+            return []
+        if GeneralUtilities.string_has_content(arguments_as_string):
+            return arguments_as_string.split(" ")  # TODO this function should get improved to allow whitespaces in quote-substrings
+        else:
+            return []
+
+    @staticmethod
+    @check_arguments
+    def arguments_to_array_for_log(arguments_as_string: str) -> list[str]:
+        if arguments_as_string is None:
+            return None
+        return GeneralUtilities.arguments_to_array(arguments_as_string)
+
+    @staticmethod
+    @check_arguments
+    def get_sha256_of_file(file: str) -> str:
+        sha256 = hashlib.sha256()
+        with open(file, "rb") as fileObject:
+            for chunk in iter(lambda: fileObject.read(4096), b""):
+                sha256.update(chunk)
+        return sha256.hexdigest()
+
+    @staticmethod
+    @check_arguments
+    def remove_duplicates(input_list) -> list:
+        result = []
+        for item in input_list:
+            if not item in result:
+                result.append(item)
+        return result
+
+    @staticmethod
+    @check_arguments
+    def print_stacktrace() -> None:
+        for line in traceback.format_stack():
+            GeneralUtilities.write_message_to_stdout(line.strip())
+
+    @staticmethod
+    @check_arguments
+    def string_to_boolean(value: str) -> bool:
+        value = value.strip().lower()
+        if value in ('yes', 'y', 'true', 't', '1'):
+            return True
+        elif value in ('no', 'n', 'false', 'f', '0'):
+            return False
+        else:
+            raise ValueError(f"Can not convert '{value}' to a boolean value")
+
+    @staticmethod
+    @check_arguments
+    def file_is_empty(file: str) -> bool:
+        return os.stat(file).st_size == 0
+
+    @staticmethod
+    @check_arguments
+    def folder_is_empty(folder: str) -> bool:
+        return len(GeneralUtilities.get_direct_files_of_folder(folder)) == 0 and len(GeneralUtilities.get_direct_folders_of_folder(folder)) == 0
+
+    @staticmethod
+    @check_arguments
+    def get_time_based_logfile_by_folder(folder: str, name: str = "Log", in_utc: bool = False) -> str:
+        return os.path.join(GeneralUtilities.resolve_relative_path_from_current_working_directory(folder), f"{GeneralUtilities.get_time_based_logfilename(name, in_utc)}.log")
+
+    @staticmethod
+    @check_arguments
+    def get_time_based_logfilename(name: str = "Log", in_utc: bool = False) -> str:
+        if (in_utc):
+            d = datetime.utcnow()
+        else:
+            d = datetime.now()
+        return f"{name}_{GeneralUtilities.datetime_to_string_for_logfile_name(d)}"
+
+    @staticmethod
+    @check_arguments
+    def bytes_to_string(payload: bytes, encoding: str = 'utf-8') -> str:
+        return payload.decode(encoding, errors="ignore")
+
+    @staticmethod
+    @check_arguments
+    def string_to_bytes(payload: str, encoding: str = 'utf-8') -> bytes:
+        return payload.encode(encoding, errors="ignore")
+
+    @staticmethod
+    @check_arguments
+    def contains_line(lines, regex: str) -> bool:
+        for line in lines:
+            if (re.match(regex, line)):
+                return True
+        return False
+
+    @staticmethod
+    @check_arguments
+    def read_csv_file(file: str, ignore_first_line: bool = False, treat_number_sign_at_begin_of_line_as_comment: bool = True, trim_values: bool = True,
+                      encoding="utf-8", ignore_empty_lines: bool = True, separator_character: str = ";", values_are_surrounded_by_quotes: bool = False) -> list[list[str]]:
+        lines = GeneralUtilities.read_lines_from_file(file, encoding)
+
+        if ignore_first_line:
+            lines = lines[1:]
+        result = list()
+        line: str
+        for line_loopvariable in lines:
+            use_line = True
+            line = line_loopvariable
+
+            if trim_values:
+                line = line.strip()
+            if ignore_empty_lines:
+                if not GeneralUtilities.string_has_content(line):
+                    use_line = False
+
+            if treat_number_sign_at_begin_of_line_as_comment:
+                if line.startswith("#"):
+                    use_line = False
+
+            if use_line:
+                if separator_character in line:
+                    raw_values_of_line = GeneralUtilities.to_list(line, separator_character)
+                else:
+                    raw_values_of_line = [line]
+                if trim_values:
+                    raw_values_of_line = [value.strip() for value in raw_values_of_line]
+                values_of_line = []
+                for raw_value_of_line in raw_values_of_line:
+                    value_of_line = raw_value_of_line
+                    if values_are_surrounded_by_quotes:
+                        value_of_line = value_of_line[1:]
+                        value_of_line = value_of_line[:-1]
+                        value_of_line = value_of_line.replace('""', '"')
+                    values_of_line.append(value_of_line)
+                result.extend([values_of_line])
+        return result
+
+    @staticmethod
+    @check_arguments
+    def epew_is_available() -> bool:
+        try:
+            return shutil.which("epew") is not None
+        except:
+            return False
+
+    @staticmethod
+    @check_arguments
+    @deprecated
+    def absolute_file_paths(directory: str) -> list[str]:
+        return GeneralUtilities.get_all_files_of_folder(directory)
+
+    @staticmethod
+    @check_arguments
+    def to_list(list_as_string: str, separator: str = ",") -> list[str]:
+        result = list()
+        if list_as_string is not None:
+            list_as_string = list_as_string.strip()
+            if list_as_string == "":
+                pass
+            elif separator in list_as_string:
+                for item in list_as_string.split(separator):
+                    result.append(item.strip())
+            else:
+                result.append(list_as_string)
+        return result
+
+    @staticmethod
+    @check_arguments
+    def get_next_square_number(number: int) -> int:
+        GeneralUtilities.assert_condition(number >= 0, "get_next_square_number is only applicable for nonnegative numbers")
+        if number == 0:
+            return 1
+        root = 0
+        square = 0
+        while square < number:
+            root = root+1
+            square = root*root
+        return root*root
+
+    @staticmethod
+    @check_arguments
+    def generate_password(length: int = 16, alphabet: str = None) -> None:
+        if alphabet is None:
+            alphabet = strin.ascii_letters + strin.digits+"_"
+        return ''.join(secrets.choice(alphabet) for i in range(length))
+
+    @staticmethod
+    @check_arguments
+    def assert_condition(condition: bool, information: str) -> None:
+        if (not condition):
+            raise ValueError("Condition failed. "+information)
+
+    @staticmethod
+    def current_system_is_windows():
+        return platform.system() == 'Windows'
+
+    @staticmethod
+    def current_system_is_linux():
+        return platform.system() == 'Linux'
+
+    @staticmethod
+    @check_arguments
+    def get_certificate_expiry_date(certificate_file: str) -> datetime:
+        with open(certificate_file, encoding="utf-8") as certificate_file_content:
+            cert = crypto.load_certificate(crypto.FILETYPE_PEM, certificate_file_content.read())
+            date_as_bytes = cert.get_notAfter()
+            date_as_string = date_as_bytes.decode("utf-8")
+            result = datetime.strptime(date_as_string, '%Y%m%d%H%M%SZ')
+            return result
+
+    @staticmethod
+    @check_arguments
+    def certificate_is_expired(certificate_file: str) -> bool:
+        return GeneralUtilities.get_certificate_expiry_date(certificate_file) < datetime.now()
+
+    @staticmethod
+    @check_arguments
+    def internet_connection_is_available() -> bool:
+        # TODO add more hosts to check to return true if at least one is available
+        try:
+            with urllib.request.urlopen("https://google.com") as url_result:
+                return (url_result.code // 100) == 2
+        except:
+            pass
+        return False
+
+    @staticmethod
+    @check_arguments
+    def replace_variable_in_string(input_string: str, variable_name: str, variable_value: str) -> None:
+        return input_string.replace(f"__[{variable_name}]__", variable_value)