Nuitka-winsvc 2.5.1__cp311-cp311-win_amd64.whl → 2.6__cp311-cp311-win_amd64.whl

nuitka/utils/Execution.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Program execution related stuff.
@@ -255,11 +255,11 @@ def withEnvironmentVarsOverridden(mapping):
             os.environ[env_var_name] = old_values[env_var_name]
 
 
-def wrapCommandForDebuggerForExec(*args):
+def wrapCommandForDebuggerForExec(command, debugger=None):
     """Wrap a command for system debugger to call exec
 
     Args:
-        args: (list of str) args for call to be debugged
+        command: (iterable of str) args for call to be debugged
     Returns:
         args tuple with debugger command inserted
 
@@ -268,28 +268,48 @@ def wrapCommandForDebuggerForExec(*args):
         debuggers would be very welcome.
     """
 
+    command = tuple(command)
+
     gdb_path = getExecutablePath("gdb")
-    lldb_path = None
+    lldb_path = getExecutablePath("lldb")
+
+    # Default from environment variable.
+    if debugger is None:
+        debugger = os.getenv("NUITKA_DEBUGGER_CHOICE")
+
+    if debugger not in ("gdb", "lldb", None):
+        general.sysexit("Error, the selected debugger name '%s' is not supported.")
 
     # Windows extra ball, attempt the downloaded one.
-    if isWin32Windows() and gdb_path is None:
+    if isWin32Windows() and gdb_path is None and lldb_path is None:
         from nuitka.Options import assumeYesForDownloads
 
         mingw64_gcc_path = getCachedDownloadedMinGW64(
             target_arch=getArchitecture(),
             assume_yes_for_downloads=assumeYesForDownloads(),
+            download_ok=True,
         )
 
         with withEnvironmentPathAdded("PATH", os.path.dirname(mingw64_gcc_path)):
             lldb_path = getExecutablePath("lldb")
 
     if gdb_path is None and lldb_path is None:
-        lldb_path = getExecutablePath("lldb")
-
         if lldb_path is None:
             general.sysexit("Error, no 'gdb' or 'lldb' binary found in path.")
 
-    if gdb_path is not None:
+    if lldb_path is not None and debugger != "gdb":
+        args = (
+            lldb_path,
+            "lldb",
+            "-o",
+            "run",
+            "-o",
+            "bt",
+            "-o",
+            "quit",
+            "--",
+        ) + command
+    elif gdb_path is not None and debugger != "lldb":
         args = (
             gdb_path,
             "gdb",
@@ -300,14 +320,14 @@ def wrapCommandForDebuggerForExec(*args):
             "-ex=where",
             "-ex=quit",
             "--args",
-        ) + args
+        ) + command
     else:
-        args = (lldb_path, "lldb", "-o", "run", "-o", "bt", "-o", "quit", "--") + args
+        general.sysexit("Error, the selected debugger '%s' was not found in path.")
 
     return args
 
 
-def wrapCommandForDebuggerForSubprocess(*args):
+def wrapCommandForDebuggerForSubprocess(command, debugger=None):
     """Wrap a command for system debugger with subprocess module.
 
     Args:
@@ -320,7 +340,7 @@ def wrapCommandForDebuggerForSubprocess(*args):
         debuggers would be very welcome.
     """
 
-    args = wrapCommandForDebuggerForExec(*args)
+    args = wrapCommandForDebuggerForExec(command=command, debugger=debugger)
 
     # Discard exec only argument.
     args = args[0:1] + args[2:]
@@ -349,7 +369,7 @@ def getNullInput():
 
 
 def executeToolChecked(
-    logger, command, absence_message, stderr_filter=None, optional=False
+    logger, command, absence_message, stderr_filter=None, optional=False, decoding=False
 ):
     """Execute external tool, checking for success and no error outputs, returning result."""
 
@@ -359,13 +379,19 @@ def executeToolChecked(
     if not isExecutableCommand(tool):
         if optional:
             logger.warning(absence_message)
-            return ""
+            return b"" if decoding else ""
         else:
             logger.sysexit(absence_message)
 
     # Allow to avoid repeated scans in PATH for the tool.
     command[0] = getExecutablePath(tool)
 
+    if None in command:
+        logger.sysexit(
+            "Error, call to '%s' failed due to 'None' value: %s index %d."
+            % (tool, command, command.index(None))
+        )
+
     with withEnvironmentVarOverridden("LC_ALL", "C"):
         with getNullInput() as null_input:
             process = subprocess.Popen(
@@ -394,6 +420,9 @@ def executeToolChecked(
             "Error, call to '%s' gave warnings: %s -> %s." % (tool, command, stderr)
         )
 
+    if decoding:
+        stdout = stdout.decode("utf8")
+
     return stdout
 
 

nuitka/utils/FileOperations.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Utils for file and directory operations.
@@ -555,7 +555,7 @@ def listExeFilesFromDirectory(path, prefix=None, suffixes=None):
     # On Windows, we check exe suffixes, on other platforms we shell all filenames,
     # matching the prefix, but they have to the executable bit set.
     if not suffixes and isWin32OrPosixWindows():
-        suffixes = "exe", "bin"
+        suffixes = ("exe", "bin")
 
     if suffixes:
         pattern_list = [prefix + "*." + suffix for suffix in suffixes]
@@ -774,13 +774,31 @@ def resetDirectory(path, logger, ignore_errors, extra_recommendation):
 
 
 @contextmanager
-def withTemporaryFile(suffix="", mode="w", delete=True, temp_path=None):
+def withTemporaryFile(prefix="", suffix="", mode="w", delete=True, temp_path=None):
+    """Provide a temporary file opened and potentially deleted."""
     with tempfile.NamedTemporaryFile(
-        suffix=suffix, mode=mode, delete=delete, dir=temp_path
+        prefix=prefix, suffix=suffix, mode=mode, delete=delete, dir=temp_path
     ) as temp_file:
         yield temp_file
 
 
+@contextmanager
+def withTemporaryFilename(prefix="", suffix="", temp_path=None):
+    """Provide a temporary filename."""
+    with tempfile.NamedTemporaryFile(
+        prefix=prefix,
+        suffix=suffix,
+        mode="wb",
+        delete=False,
+        dir=temp_path,
+    ) as temp_file:
+        filename = temp_file.name
+        temp_file.close()
+        deleteFile(filename, must_exist=True)
+
+        yield filename
+
+
 def getFileContentByLine(filename, mode="r", encoding=None, errors=None):
     # We read the whole, to keep lock times minimal. We only deal with small
     # files like this normally.
@@ -890,7 +908,7 @@ def changeTextFileContents(filename, contents, encoding=None, compare_only=False
         or getFileContents(filename, encoding=encoding) != contents
     ):
         if not compare_only:
-            putTextFileContents(filename, contents)
+            putTextFileContents(filename, contents, encoding=encoding)
 
         return True
     else:
@@ -1097,6 +1115,9 @@ def isFilenameBelowPath(path, filename, consider_short=True):
 
 def isFilenameSameAsOrBelowPath(path, filename):
     """Is a filename inside of a given directory path or the same path as that directory."""
+    if type(path) in (tuple, list):
+        return any(isFilenameSameAsOrBelowPath(path=p, filename=filename) for p in path)
+
     return isFilenameBelowPath(path, filename) or areSamePaths(path, filename)
 
 
@@ -1515,6 +1536,9 @@ def getNormalizedPath(path):
     if isWin32Windows():
         path = path.replace("/", "\\")
 
+    if isMacOS():
+        path = os.path.expanduser(path)
+
     return path
 
 

nuitka/utils/Hashing.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Module for working with hashes in Nuitka.
@@ -7,6 +7,7 @@ Offers support for hashing incrementally and files esp. without having
 to read their contents.
 """
 
+import struct
 from binascii import crc32
 
 from nuitka.__past__ import md5, unicode
@@ -111,10 +112,13 @@ class HashCRC32(HashBase):
         self.hash = crc32(value, self.hash)
 
     def asDigest(self):
+        if self.hash < 0:
+            return struct.unpack("I", struct.pack("i", self.hash))[0]
+
         return self.hash
 
     def asHexDigest(self):
-        return hex(self.hash)[2:]
+        return hex(self.asDigest())[2:]
 
 
 #     Part of "Nuitka", an optimizing Python compiler that is compatible and

nuitka/utils/Images.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Handling of images, esp. format conversions for icons.
@@ -12,7 +12,13 @@ from .Utils import isMacOS, isWin32Windows
 def checkIconUsage(logger, icon_path):
     icon_format = getFilenameExtension(icon_path)
 
-    if icon_format != ".icns" and isMacOS():
+    if icon_format == "":
+        logger.sysexit(
+            """\
+Cannot detect the icon format from filename extension of '%s'."""
+            % (icon_path)
+        )
+    elif icon_format != ".icns" and isMacOS():
         needs_conversion = True
     elif icon_format != ".ico" and isWin32Windows():
         needs_conversion = True

nuitka/utils/Importing.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Helper to import a file as a module.

nuitka/utils/InlineCopies.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Policies for locating inline copies."""

nuitka/utils/InstalledPythons.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Provide installed Pythons with module availability checks. """

nuitka/utils/InstanceCounters.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Instance counter primitives

nuitka/utils/Jinja2.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Jinja folklore wrappers and handling of inline copy usage.

nuitka/utils/Json.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Utils module to provide helper for our common json operations.
@@ -21,7 +21,7 @@ def loadJsonFromFilename(filename):
 
 def writeJsonToFilename(filename, contents, indent=2):
     with openTextFile(filename, "w") as output:
-        json.dump(contents, output, indent=indent)
+        json.dump(contents, output, indent=indent, sort_keys=True)
 
 
 #     Part of "Nuitka", an optimizing Python compiler that is compatible and

nuitka/utils/MacOSApp.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ For macOS application bundle creation
@@ -44,7 +44,7 @@ def createPlistInfoFile(logger, onefile):
             ("CFBundleIdentifier", signed_app_name),
             ("CFBundleExecutable", executable_name),
             ("CFBundleInfoDictionaryVersion", "6.0"),
-            ("CFBundlePackageType", "APPL"),
+            ("CFBundlePackageType", "APPL"),  # spell-checker: ignore appl
             ("CFBundleShortVersionString", app_version),
         ]
     )
@@ -56,6 +56,7 @@ def createPlistInfoFile(logger, onefile):
         icon_path = icon_paths[0]
 
         # Convert to single macOS .icns file if necessary
+        # spell-checker: ignore icns
         if not icon_path.endswith(".icns"):
             logger.info(
                 "File '%s' is not in macOS icon format, converting to it." % icon_path
@@ -90,7 +91,7 @@ def createPlistInfoFile(logger, onefile):
     if Options.isMacOSBackgroundApp():
         infos["LSBackgroundOnly"] = True
     elif Options.isMacOSUiElementApp():
-        infos["LSUIElement"] = True
+        infos["LSUIElement"] = True  # spell-checker: ignore LSUI
     else:
         infos["NSHighResolutionCapable"] = True
 

nuitka/utils/MemoryUsage.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Tools for tracing memory usage at compiled time.

nuitka/utils/ModuleNames.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Module names are common string type, which deserves special operations.

nuitka/utils/PackageResources.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Access package data. """

nuitka/utils/ReExecute.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """Ability to restart Nuitka, needed for removing site module effects and using Python PGO after compile.

nuitka/utils/Rest.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Work with ReST documentations.

nuitka/utils/SharedLibraries.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ This module deals with finding and information about shared libraries.
@@ -26,6 +26,7 @@ from .FileOperations import (
     makeContainingPath,
     withMadeWritableFileMode,
 )
+from .Importing import importFromInlineCopy
 from .Utils import (
     isAlpineLinux,
     isLinux,
@@ -258,6 +259,29 @@ def _getMacOSArchOption():
         return ()
 
 
+# TODO: Use this for more output filters.
+def _filterOutputByLine(output, filter_func):
+    non_errors = []
+
+    for line in output.splitlines():
+        if line and not filter_func(line):
+            non_errors.append(line)
+
+    output = b"\n".join(non_errors)
+
+    return (0 if non_errors else None), output
+
+
+def _filterOtoolErrorOutput(stderr):
+    def isNonErrorExit(line):
+        if b"missing from root that overrides" in line:
+            return True
+
+        return False
+
+    return _filterOutputByLine(stderr, isNonErrorExit)
+
+
 def _getOToolCommandOutput(otool_option, filename):
     filename = os.path.abspath(filename)
 
@@ -272,6 +296,7 @@ def _getOToolCommandOutput(otool_option, filename):
         _otool_output_cache[cache_key] = executeToolChecked(
             logger=postprocessing_logger,
             command=command,
+            stderr_filter=_filterOtoolErrorOutput,
             absence_message="The 'otool' is used to analyze dependencies on macOS and required to be found.",
         )
 
@@ -615,11 +640,9 @@ def _getFileCommandOutput(filename):
             logger=postprocessing_logger,
             command=("file", filename),
             absence_message=_file_usage,
+            decoding=str is not bytes,
         )
 
-        if str is not bytes:
-            file_output = file_output.decode("utf8")
-
         assert file_output.startswith(filename + ":")
         file_output = file_output[len(filename) + 1 :].splitlines()[0].strip()
 
@@ -836,8 +859,56 @@ _nm_usage = """\
 Error, needs 'nm' on your system, to detect exported DLL symbols."""
 
 
+def _decodeWin32EntryPoint(entry_point_name):
+    if str is bytes:
+        return entry_point_name
+    else:
+        # Not sure about the actual encoding used, this will cover most cases.
+        return entry_point_name.decode("utf8", "backslashreplace")
+
+
+def getPEFileUsedDllNames(filename):
+    """Return the used DLL PE file information of a Windows EXE or DLL
+
+    Args:
+        filename - The file to be investigated.
+
+    Notes:
+        Use of this is obviously only for Windows, although the module
+        will exist on other platforms too.
+    """
+
+    pefile = importFromInlineCopy("pefile", must_exist=True)
+
+    try:
+        pe_info = pefile.PE(filename)
+    except pefile.PEFormatError:
+        return None
+
+    # TODO: Check arch with pefile as well and ignore wrong arches if asked to.
+
+    # TODO: The decoding cannot expect ASCII, but also surely is not UTF8.
+    return OrderedSet(
+        dll_entry.dll.decode("utf8")
+        for dll_entry in getattr(pe_info, "DIRECTORY_ENTRY_IMPORT", ())
+    )
+
+
 def getDllExportedSymbols(logger, filename):
-    if isLinux or isMacOS():
+    if isWin32Windows():
+        pefile = importFromInlineCopy("pefile", must_exist=True)
+
+        try:
+            pe_info = pefile.PE(filename)
+        except pefile.PEFormatError:
+            return None
+
+        return tuple(
+            _decodeWin32EntryPoint(entry_point.name)
+            for entry_point in pe_info.DIRECTORY_ENTRY_EXPORT.symbols
+            if entry_point.name is not None
+        )
+    else:
         if isLinux():
             command = ("nm", "-D", filename)
         elif isMacOS():
@@ -863,8 +934,6 @@ def getDllExportedSymbols(logger, filename):
                 result.add(symbol_name.decode("utf8"))
 
         return result
-    else:
-        return None
 
 
 #     Part of "Nuitka", an optimizing Python compiler that is compatible and

nuitka/utils/Shebang.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Utils to work with shebang lines.

nuitka/utils/Signing.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Signing of executables.
@@ -6,6 +6,7 @@
 """
 
 from nuitka.Options import (
+    getMacOSSignedAppName,
     getMacOSSigningIdentity,
     shallUseSigningForNotarization,
 )
@@ -43,11 +44,9 @@ def detectMacIdentity():
         logger=postprocessing_logger,
         command=["security", "find-identity"],
         absence_message="The 'security' program is used to scan for signing identities",
+        decoding=str is not bytes,
     )
 
-    if str is not bytes:
-        output = output.decode("utf8")
-
     signing_name = None
     result = None
 
@@ -104,9 +103,16 @@ def addMacOSCodeSignature(filenames):
         "--force",
         "--deep",
         "--preserve-metadata=entitlements",
-        # ,
     ]
 
+    macos_signed_app_name = getMacOSSignedAppName()
+
+    if macos_signed_app_name is not None:
+        command += [
+            "-i",
+            macos_signed_app_name,
+        ]
+
     if shallUseSigningForNotarization():
         command.append("--options=runtime")
 

nuitka/utils/SlotMetaClasses.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Helper for portable metaclasses that do checks. """

nuitka/utils/StaticLibraries.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ This module deals with finding and information about static libraries.
@@ -13,6 +13,7 @@ from nuitka.PythonFlavors import (
     isDebianPackagePython,
     isNuitkaPython,
     isRyePython,
+    isSelfCompiledPythonUninstalled,
 )
 from nuitka.PythonVersions import (
     getPythonABI,
@@ -22,6 +23,7 @@ from nuitka.PythonVersions import (
 )
 from nuitka.Tracing import general
 
+from .Execution import executeToolChecked
 from .FileOperations import getFileContentByLine, getFileList
 from .Utils import (
     getLinuxDistribution,
@@ -155,6 +157,12 @@ def _getSystemStaticLibPythonPath():
     if isMacOS() and isRyePython():
         return None
 
+    if isSelfCompiledPythonUninstalled():
+        candidate = os.path.join(sys_prefix, "libpython" + python_abi_version + ".a")
+
+        if os.path.exists(candidate):
+            return candidate
+
     candidate = os.path.join(sys_prefix, "lib", "libpython" + python_abi_version + ".a")
 
     if os.path.exists(candidate):
@@ -212,6 +220,22 @@ def getSystemStaticLibPythonPath():
     return _static_lib_python_path
 
 
+_nm_usage = "nm is used to detect symbols of static link libraries"
+
+
+def getStaticLinkLibrarySymbols(logger, static_library_path):
+    """Get the list of symbols exported by a static link library."""
+
+    output = executeToolChecked(
+        logger=logger,
+        command=("nm", "-U", "-g", "-j", static_library_path),
+        absence_message=_nm_usage,
+        decoding=str is not bytes,
+    )
+
+    return output.splitlines()
+
+
 #     Part of "Nuitka", an optimizing Python compiler that is compatible and
 #     integrates with CPython, but also works on its own.
 #

nuitka/utils/ThreadedExecutor.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Threaded pool execution.

nuitka/utils/Timing.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Time taking.

nuitka/utils/Utils.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ Utility module.

nuitka/utils/WindowsFileUsage.py

@@ -1,4 +1,4 @@
-#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
 
 """ This is work in progress and hangs unfortunately on some file handles.