Nuitka-winsvc 2.7.7__cp313-cp313-win_amd64.whl

nuitka/tools/environments/CreateEnvironment.py

@@ -0,0 +1,69 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" For creating virtual environments.
+
+This can create empty virtualenv, but also populate them with packages from
+the reports.
+"""
+
+import os
+
+from nuitka.Tracing import tools_logger
+from nuitka.TreeXML import fromFile
+from nuitka.utils.FileOperations import openTextFile
+
+from .Virtualenv import withVirtualenv
+
+
+def createEnvironmentFromReport(environment_folder, report_filename):
+    if os.path.exists(environment_folder):
+        tools_logger.sysexit("Error, environment folder must not exist already.")
+    containing_folder = os.path.dirname(environment_folder)
+
+    if not os.path.exists(containing_folder):
+        tools_logger.sysexit(
+            "Error, environment folder must be in existing folder, not '%s'."
+            % containing_folder
+        )
+
+    if not os.path.isfile(report_filename):
+        tools_logger.sysexit("Error, no such report file '%s'." % report_filename)
+
+    with openTextFile(report_filename, "r", encoding="utf8") as report_file:
+        root = fromFile(report_file, use_lxml=True)
+
+    requirements_filename = os.path.join(environment_folder, "requirements.txt")
+
+    with withVirtualenv(
+        os.path.basename(environment_folder),
+        logger=tools_logger,
+        base_dir=containing_folder,
+        style="blue",
+        delete=False,
+    ) as venv:
+        with openTextFile(
+            requirements_filename, "w", encoding="utf8"
+        ) as requirements_file:
+            for node in root.xpath("distributions/distribution"):
+                requirements_file.write(
+                    "%s==%s\n" % (node.attrib["name"], node.attrib["version"])
+                )
+
+        venv.runCommand("pip install -r requirements.txt", style="blue")
+
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/environments/Virtualenv.py

@@ -0,0 +1,158 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Creating virtualenvs and running commands in them.
+
+"""
+
+import os
+import sys
+from contextlib import contextmanager
+
+from nuitka.__past__ import unicode
+from nuitka.utils.Execution import (
+    NuitkaCalledProcessError,
+    check_call,
+    executeProcess,
+    withEnvironmentVarsOverridden,
+)
+from nuitka.utils.FileOperations import (
+    getDirectoryRealPath,
+    relpath,
+    removeDirectory,
+    withDirectoryChange,
+)
+
+
+class Virtualenv(object):
+    def __init__(self, env_dir, logger):
+        self.env_dir = os.path.abspath(env_dir)
+        self.logger = logger
+
+    def runCommand(self, commands, keep_cwd=False, env=None, style=None):
+        if type(commands) in (str, unicode):
+            commands = [commands]
+
+        with withDirectoryChange(None if keep_cwd else self.env_dir, allow_none=True):
+            if keep_cwd:
+                activate_dir = relpath(self.env_dir, os.getcwd())
+            else:
+                activate_dir = "."
+
+            if os.name == "nt":
+                commands = [r"call %s\scripts\activate.bat" % activate_dir] + commands
+            else:
+                commands = [". %s/bin/activate" % activate_dir] + commands
+
+            command = " && ".join(commands)
+
+            if style is not None:
+                self.logger.info("Executing: %s" % command, style=style)
+
+            with withEnvironmentVarsOverridden(env):
+                exit_code = os.system(command)
+                if exit_code != 0:
+                    self.logger.info(
+                        "Failure %s for: %s" % (exit_code, command),
+                        keep_format=True,
+                        style=style,
+                    )
+
+                    raise NuitkaCalledProcessError(
+                        exit_code, command, output=None, stderr=None
+                    )
+
+    def runCommandWithOutput(self, commands, style=None):
+        """
+        Returns the stdout,stderr,exit_code from running command
+        """
+        if type(commands) in (str, unicode):
+            commands = [commands]
+
+        with withDirectoryChange(self.env_dir):
+            if os.name == "nt":
+                commands = [r"call scripts\activate.bat"] + commands
+            else:
+                commands = [". bin/activate"] + commands
+
+            # Build shell command.
+            command = " && ".join(commands)
+
+            if style is not None:
+                self.logger.info("Executing: %s" % command, style=style)
+
+            # Use subprocess and also return outputs, stdout, stderr, result
+            return executeProcess(
+                command=command,
+                shell=True,
+            )
+
+    def getVirtualenvDir(self):
+        return self.env_dir
+
+
+@contextmanager
+def withVirtualenv(
+    env_name, logger, base_dir=None, python=None, delete=True, style=None
+):
+    """Create a virtualenv and change into it.
+
+    Activating for actual use will be your task.
+    """
+
+    if style is not None:
+        logger.info("Creating a virtualenv:")
+
+    if python is None:
+        python = sys.executable
+
+    # Avoid symlinks on Windows, they won't work for virtualenv e.g.
+    python = os.path.join(
+        getDirectoryRealPath(os.path.dirname(python)),
+        os.path.basename(python),
+    )
+
+    if base_dir is not None:
+        env_dir = os.path.join(base_dir, env_name)
+    else:
+        env_dir = env_name
+
+    removeDirectory(
+        env_dir,
+        logger=logger,
+        ignore_errors=False,
+        extra_recommendation=None,
+    )
+
+    with withDirectoryChange(base_dir, allow_none=True):
+        command = [python, "-m", "virtualenv", env_name]
+        if style is not None:
+            logger.info("Executing: %s" % " ".join(command), style=style)
+        check_call(command)
+
+    try:
+        yield Virtualenv(env_dir, logger=logger)
+    finally:
+        if delete:
+            removeDirectory(
+                env_dir,
+                logger=logger,
+                ignore_errors=False,
+                extra_recommendation=None,
+            )
+
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/environments/__init__.py

@@ -0,0 +1,19 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Dummy file to make this directory a package. """
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/__init__.py

@@ -0,0 +1,19 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Dummy file to make this directory a package. """
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/dll_report/__init__.py

@@ -0,0 +1,19 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Dummy file to make this directory a package. """
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/dll_report/__main__.py

@@ -0,0 +1,83 @@
+#!/usr/bin/env python
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Main program for DLL checker tool.
+
+"""
+
+import os
+import sys
+import tempfile
+from optparse import OptionParser
+
+from nuitka.freezer.DllDependenciesWin32 import detectBinaryPathDLLsWin32
+from nuitka.Tracing import my_print
+from nuitka.utils.SharedLibraries import getDLLVersion, getSxsFromDLL
+from nuitka.utils.Timing import TimerReport
+
+
+def main():
+    parser = OptionParser()
+
+    parser.add_option(
+        "--no-use-path",
+        action="store_false",
+        dest="use_path",
+        default=True,
+        help="""Do NOT use PATH to locate DLL dependencies.""",
+    )
+
+    options, positional_args = parser.parse_args()
+
+    if not positional_args:
+        sys.exit("No DLLs given.")
+
+    for filename in positional_args:
+        my_print("Filename: %s" % filename)
+        my_print("Version Information: %s" % (getDLLVersion(filename),))
+
+        my_print("SXS information (manifests):")
+        sxs = getSxsFromDLL(filename=filename, with_data=True)
+        if sxs:
+            my_print(sxs)
+
+        my_print("DLLs recursively depended (depends.exe):")
+
+        with TimerReport(
+            message="Finding dependencies for %s took %%.2f seconds" % filename
+        ):
+            r = detectBinaryPathDLLsWin32(
+                is_main_executable=False,
+                source_dir=tempfile.gettempdir(),
+                original_dir=os.path.dirname(filename),
+                binary_filename=filename,
+                package_name=None,
+                use_path=options.use_path,
+                use_cache=False,
+                update_cache=False,
+            )
+
+            for dll_filename in sorted(r):
+                my_print("   %s" % dll_filename)
+
+            my_print("Total: %d" % len(r))
+
+
+if __name__ == "__main__":
+    main()
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/find_module/FindModuleCode.py

@@ -0,0 +1,127 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Find module code and open it in Visual Code.
+
+The idea is that this can be used during development, to accept module names,
+but also standalone filenames, etc. to simply find the original code in the
+compiling environment with "--edit-module-code" option.
+
+TODO: At this time it doesn't do all desired things yet.
+"""
+
+import os
+
+from nuitka.importing.Importing import (
+    ModuleName,
+    addMainScriptDirectory,
+    locateModule,
+)
+from nuitka.Tracing import tools_logger
+from nuitka.utils.Execution import callProcess, getExecutablePath
+from nuitka.utils.FileOperations import relpath
+from nuitka.utils.Importing import getPackageDirFilename
+from nuitka.utils.Utils import isWin32Windows
+
+
+def findModuleCode(module_name):
+    module_name = ModuleName(module_name)
+
+    return locateModule(module_name=module_name, parent_package=None, level=0)[1]
+
+
+def editModuleCode(module_search_desc):
+    # plenty of checks to resolved, pylint: disable=too-many-branches
+
+    module_filename = None
+    module_name = None
+
+    if isWin32Windows() and "\\" in module_search_desc:
+        if os.path.exists(module_search_desc):
+            module_filename = module_search_desc
+        else:
+            if module_search_desc.endswith(".py"):
+                module_search_desc = module_search_desc[:-3]
+
+            candidate = module_search_desc
+
+            # spell-checker: ignore ONEFIL
+            while not candidate.endswith((".DIS", ".dist")) and not os.path.basename(
+                candidate
+            ).startswith("ONEFIL"):
+                candidate = os.path.dirname(candidate)
+
+            module_name = relpath(module_search_desc, start=candidate).replace(
+                "\\", "."
+            )
+    elif not isWin32Windows() and "/" in module_search_desc:
+        if os.path.exists(module_search_desc):
+            module_filename = module_search_desc
+        else:
+            if module_search_desc.endswith(".py"):
+                module_search_desc = module_search_desc[:-3]
+
+            candidate = module_search_desc
+
+            while not candidate.endswith((".dist", ".app")) and candidate:
+                candidate = os.path.dirname(candidate)
+
+            if candidate:
+                module_name = relpath(module_search_desc, start=candidate).replace(
+                    "/", "."
+                )
+
+                if module_name.startswith("Contents.MacOS."):
+                    module_name = module_name[15:]
+            else:
+                module_name = None
+    else:
+        module_name = ModuleName(module_search_desc)
+
+    if module_name is None:
+        tools_logger.sysexit(
+            "Error, did not find module for '%s' " % module_search_desc
+        )
+    else:
+        addMainScriptDirectory(os.getcwd())
+        module_filename = findModuleCode(module_name)
+
+    if module_filename is None:
+        tools_logger.sysexit("Error, did not find '%s' module" % module_name)
+    else:
+        if os.path.isdir(module_filename):
+            candidate = getPackageDirFilename(module_filename)
+
+            if candidate is not None:
+                module_filename = candidate
+
+        if os.path.isdir(module_filename):
+            tools_logger.sysexit(
+                "Error, %s is a namespace package with no code" % module_name
+            )
+
+        if module_name is not None:
+            tools_logger.info("Found '%s' as '%s'" % (module_name, module_filename))
+
+        visual_code_binary = getExecutablePath(
+            "code.cmd" if isWin32Windows() else "code"
+        )
+
+        if visual_code_binary:
+            callProcess([visual_code_binary, module_filename])
+
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/find_module/__init__.py

@@ -0,0 +1,19 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Dummy file to make this directory a package. """
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/generate_header/GenerateHeader.py

@@ -0,0 +1,73 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Generate header files that provide compiler specifics."""
+
+from nuitka.build.SconsInterface import (
+    cleanSconsDirectory,
+    getCommonSconsOptions,
+    runScons,
+    setPythonTargetOptions,
+)
+from nuitka.PythonVersions import isPythonWithGil, python_version_str
+from nuitka.Tracing import offsets_logger
+from nuitka.utils.Execution import check_output
+from nuitka.utils.FileOperations import makePath, withTemporaryFilename
+
+
+def generateHeader():
+    scons_options, env_values = getCommonSconsOptions()
+
+    setPythonTargetOptions(scons_options)
+
+    scons_options["source_dir"] = "generate_header.build"
+    cleanSconsDirectory(scons_options["source_dir"])
+    makePath(scons_options["source_dir"])
+
+    python_version_id = "%s_%s" % (
+        python_version_str,
+        "gil" if isPythonWithGil() else "no-gil",
+    )
+
+    with withTemporaryFilename(prefix=python_version_id, suffix=".exe") as result_exe:
+        scons_options["result_exe"] = result_exe
+
+        runScons(
+            scons_options=scons_options,
+            env_values=env_values,
+            scons_filename="Offsets.scons",
+        )
+
+        header_output = check_output([result_exe])
+
+        if str is not bytes:
+            header_output = header_output.decode("utf8")
+
+        offsets_logger.info(repr(header_output))
+
+        lines = header_output.splitlines()
+
+        if lines[-1] != "OK.":
+            offsets_logger.sysexit("Error, failed to produce expected output.")
+        del lines[-1]
+
+        for line in lines:
+            offsets_logger.info("Processing: %s" % line)
+
+        offsets_logger.info("OK.")
+
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.

nuitka/tools/general/generate_header/__init__.py

@@ -0,0 +1,19 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Dummy file to make this directory a package. """
+
+#     Part of "Nuitka", an optimizing Python compiler that is compatible and
+#     integrates with CPython, but also works on its own.
+#
+#     Licensed under the Apache License, Version 2.0 (the "License");
+#     you may not use this file except in compliance with the License.
+#     You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.