Nuitka-winsvc 2.4.11__cp311-cp311-win_amd64.whl → 2.5.6__cp311-cp311-win_amd64.whl

{Nuitka_winsvc-2.4.11.dist-info → Nuitka_winsvc-2.5.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.2.0)
+Generator: setuptools (75.6.0)
 Root-Is-Purelib: false
 Tag: cp311-cp311-win_amd64
 

nuitka/Builtins.py

@@ -212,6 +212,37 @@ builtin_anon_values = OrderedDict((b, a) for a, b in builtin_anon_names.items())
 # a hash.
 builtin_anon_value_list = tuple(builtin_anon_values)
 
+_exception_size_cache = {}
+
+
+def _getExceptionObjectSize(exception_type):
+    if exception_type not in _exception_size_cache:
+        # spell-checker: ignore getsizeof
+        _exception_size_cache[exception_type] = sys.getsizeof(exception_type())
+
+    return _exception_size_cache[exception_type]
+
+
+_base_exception_size = _getExceptionObjectSize(BaseException)
+
+
+def isBaseExceptionSimpleExtension(exception_type):
+    def checkBases(exc_type):
+        for base_exception_type in exc_type.__bases__:
+            if base_exception_type is BaseException:
+                return True
+
+            if checkBases(base_exception_type):
+                return True
+
+        return False
+
+    return (
+        checkBases(exception_type)
+        and _getExceptionObjectSize(exception_type) == _base_exception_size
+    )
+
+
 #     Part of "Nuitka", an optimizing Python compiler that is compatible and
 #     integrates with CPython, but also works on its own.
 #

nuitka/HardImportRegistry.py

@@ -195,6 +195,12 @@ else:
     module_sys_trust["exc_value"] = trust_not_exist
     module_sys_trust["exc_traceback"] = trust_not_exist
 
+
+# If we are not a module, we are not in REPL mode.
+if not Options.shallMakeModule():
+    module_sys_trust["ps1"] = trust_not_exist
+    module_sys_trust["ps2"] = trust_not_exist
+
 module_typing_trust = {
     "TYPE_CHECKING": trust_constant,
 }
@@ -223,6 +229,8 @@ def makeTypingModuleTrust():
 module_os_trust = {
     "name": trust_constant,
     "listdir": trust_node,
+    "stat": trust_node,
+    "lstat": trust_node,
     "curdir": trust_constant,
     "pardir": trust_constant,
     "sep": trust_constant,

nuitka/MainControl.py

@@ -41,6 +41,7 @@ from nuitka.Options import (
     hasPythonFlagIsolated,
     hasPythonFlagNoAnnotations,
     hasPythonFlagNoAsserts,
+    hasPythonFlagNoBytecodeRuntimeCache,
     hasPythonFlagNoDocStrings,
     hasPythonFlagNoWarnings,
     hasPythonFlagUnbuffered,
@@ -597,6 +598,7 @@ def runSconsBackend():
         "trace_mode": asBoolStr(Options.shallTraceExecution()),
         "file_reference_mode": Options.getFileReferenceMode(),
         "module_count": "%d" % len(ModuleRegistry.getDoneModules()),
+        "gil_mode": asBoolStr(Options.isPythonWithGil()),
     }
 
     if Options.isLowMemory():
@@ -699,6 +701,9 @@ def runSconsBackend():
     if python_version >= 0x370 and sys.flags.utf8_mode:
         options["python_sysflag_utf8"] = asBoolStr(True)
 
+    if hasPythonFlagNoBytecodeRuntimeCache():
+        options["python_sysflag_unbuffered"] = asBoolStr(True)
+
     if hasPythonFlagUnbuffered():
         options["python_sysflag_unbuffered"] = asBoolStr(True)
 
@@ -809,7 +814,7 @@ def _executeMain(binary_filename):
 def _executeModule(tree):
     """Execute the extension module just created."""
 
-    if python_version < 0x340:
+    if python_version < 0x300:
         python_command_template = """\
 import os, imp;\
 assert os.path.normcase(os.path.abspath(os.path.normpath(\
@@ -901,8 +906,7 @@ def compileTree():
     if Options.isShowMemory():
         InstanceCounters.printStats()
 
-    if Options.is_debug:
-        Reports.doMissingOptimizationReport()
+    Reports.doMissingOptimizationReport()
 
     if Options.shallNotDoExecCCompilerCall():
         return True, {}
@@ -1123,7 +1127,8 @@ def _main():
                 """\
 The compilation result is hidden by package directory '%s'. Importing will \
 not use compiled code while it exists."""
-                % base_path
+                % base_path,
+                mnemonic="compiled-package-hidden-by-package",
             )
 
     general.info("Successfully created '%s'." % final_filename)

nuitka/OptionParsing.py

@@ -69,6 +69,21 @@ parser.add_option(
 Create an importable binary extension module executable instead of a program. Defaults to off.""",
 )
 
+parser.add_option(
+    "--mode",
+    action="store",
+    dest="compilation_mode",
+    metavar="COMPILATION_MODE",
+    choices=("app", "onefile", "standalone", "accelerated", "module"),
+    default=None,
+    help="""\
+Mode in which to compile. Accelerated runs in your Python
+installation and depends on it. Standalone creates a folder
+with an executable contained to run it. Onefile creates a
+single executable to deploy. App is onefile except on macOS
+where it's not to be used. Default is 'accelerated'.""",
+)
+
 parser.add_option(
     "--standalone",
     action="store_true",
@@ -176,11 +191,12 @@ parser.add_option(
     dest="github_workflow_options",
     default=False,
     github_action=False,
-    help=SUPPRESS_HELP,
+    help=SUPPRESS_HELP,  # For use in GitHub Action only.
 )
 
 include_group = parser.add_option_group(
-    "Control the inclusion of modules and packages in result"
+    "Control the inclusion of modules and packages in result",
+    link="include-section",
 )
 
 include_group.add_option(
@@ -441,8 +457,9 @@ data_group.add_option(
     help="""\
 Include the specified data file patterns outside of the onefile binary,
 rather than on the inside. Makes only sense in case of '--onefile'
-compilation. First files have to be specified as included somehow,
-then this refers to target paths. Default empty.""",
+compilation. First files have to be specified as included with other
+`--include-*data*` options, and then this refers to target paths
+inside the distribution. Default empty.""",
 )
 
 data_group.add_option(
@@ -625,7 +642,7 @@ compilation_group.add_option(
     "--file-reference-choice",
     action="store",
     dest="file_reference_mode",
-    metavar="MODE",
+    metavar="FILE_MODE",
     choices=("original", "runtime", "frozen"),
     default=None,
     help="""\
@@ -644,7 +661,7 @@ compilation_group.add_option(
     "--module-name-choice",
     action="store",
     dest="module_name_mode",
-    metavar="MODE",
+    metavar="MODULE_NAME_MODE",
     choices=("original", "runtime"),
     default=None,
     help="""\
@@ -710,6 +727,18 @@ used to detect implicit imports.
 Defaults to off.""",
 )
 
+output_group.add_option(
+    "--no-pyi-stubs",
+    action="store_false",
+    dest="pyi_stubs",
+    default=True,
+    help="""\
+Do not use stubgen when creating a '.pyi' file for extension modules
+created by Nuitka. They expose your API, but stubgen may cause issues.
+Defaults to off.""",
+)
+
+
 del output_group
 
 deployment_group = parser.add_option_group("Deployment control")
@@ -805,17 +834,6 @@ debug_group.add_option(
 Enable vmprof based profiling of time spent. Not working currently. Defaults to off.""",
 )
 
-debug_group.add_option(
-    "--internal-graph",
-    action="store_true",
-    dest="internal_graph",
-    default=False,
-    github_action=False,
-    help="""\
-Create graph of optimization process internals, do not use for whole programs, but only
-for small test cases. Defaults to off.""",
-)
-
 debug_group.add_option(
     "--trace-execution",
     action="store_true",
@@ -826,20 +844,6 @@ Traced execution output, output the line of code before executing it.
 Defaults to off.""",
 )
 
-debug_group.add_option(
-    "--recompile-c-only",
-    action="store_true",
-    dest="recompile_c_only",
-    default=False,
-    github_action=False,
-    help="""\
-This is not incremental compilation, but for Nuitka development only. Takes
-existing files and simply compile them as C again. Allows compiling edited
-C files for quick debugging changes to the generated source, e.g. to see if
-code is passed by, values output, etc, Defaults to off. Depends on compiling
-Python source to determine which files it should look at.""",
-)
-
 debug_group.add_option(
     "--xml",
     action="store",
@@ -906,6 +910,61 @@ off. Do not think you can use this directly.""",
 
 del debug_group
 
+
+development_group = parser.add_option_group("Nuitka Development features")
+
+
+development_group.add_option(
+    "--devel-missing-code-helpers",
+    action="store_true",
+    dest="report_missing_code_helpers",
+    default=False,
+    help="""\
+Report warnings for code helpers for types that were attempted, but don't
+exist. This helps to identify opportunities for improving optimization of
+generated code from type knowledge not used. Default False.""",
+)
+
+development_group.add_option(
+    "--devel-missing-trust",
+    action="store_true",
+    dest="report_missing_trust",
+    default=False,
+    help="""\
+Report warnings for imports that could be trusted, but currently are not. This
+is to identify opportunities for improving handling of hard modules, where this
+sometimes could allow more static optimization. Default False.""",
+)
+
+development_group.add_option(
+    "--devel-recompile-c-only",
+    action="store_true",
+    dest="recompile_c_only",
+    default=False,
+    github_action=False,
+    help="""\
+This is not incremental compilation, but for Nuitka development only. Takes
+existing files and simply compiles them as C again after doing the Python
+steps. Allows compiling edited C files for manual debugging changes to the
+generated source. Allows us to add printing, check and print values, but it
+is now what users would want. Depends on compiling Python source to
+determine which files it should look at.""",
+)
+
+development_group.add_option(
+    "--devel-internal-graph",
+    action="store_true",
+    dest="internal_graph",
+    default=False,
+    github_action=False,
+    help="""\
+Create graph of optimization process internals, do not use for whole programs, but only
+for small test cases. Defaults to off.""",
+)
+
+
+del development_group
+
 # This is for testing framework, "coverage.py" hates to loose the process. And
 # we can use it to make sure it's not done unknowingly.
 parser.add_option(
@@ -1058,9 +1117,7 @@ caching_group.add_option(
     action="store_true",
     dest="disable_bytecode_cache",
     default=False,
-    help="""\
-Do not reuse dependency analysis results for modules, esp. from standard library,
-that are included as bytecode. Same as --disable-cache=bytecode.""",
+    help=SUPPRESS_HELP,
 )
 
 caching_group.add_option(
@@ -1068,23 +1125,18 @@ caching_group.add_option(
     action="store_true",
     dest="disable_ccache",
     default=False,
-    help="""\
-Do not attempt to use ccache (gcc, clang, etc.) or clcache (MSVC, clangcl).
-Same as --disable-cache=ccache.""",
+    help=SUPPRESS_HELP,
 )
 
-if isWin32Windows():
-    caching_group.add_option(
-        "--disable-dll-dependency-cache",
-        action="store_true",
-        dest="disable_dll_dependency_cache",
-        default=False,
-        help="""\
-Disable the dependency walker cache. Will result in much longer times to create
-the distribution folder, but might be used in case the cache is suspect to cause
-errors. Same as --disable-cache=dll-dependencies.""",
-    )
+caching_group.add_option(
+    "--disable-dll-dependency-cache",
+    action="store_true",
+    dest="disable_dll_dependency_cache",
+    default=False,
+    help=SUPPRESS_HELP,
+)
 
+if isWin32Windows():
     caching_group.add_option(
         "--force-dll-dependency-cache-update",
         action="store_true",
@@ -1119,7 +1171,7 @@ pgo_group.add_option(
     action="store_true",
     dest="is_python_pgo",
     default=False,
-    help=SUPPRESS_HELP,
+    help=SUPPRESS_HELP,  # Not yet ready
 )
 
 pgo_group.add_option(
@@ -1127,7 +1179,7 @@ pgo_group.add_option(
     action="store",
     dest="python_pgo_input",
     default=None,
-    help=SUPPRESS_HELP,
+    help=SUPPRESS_HELP,  # Not yet ready
 )
 
 pgo_group.add_option(
@@ -1136,7 +1188,7 @@ pgo_group.add_option(
     dest="python_pgo_policy_unused_module",
     choices=("include", "exclude", "bytecode"),
     default="include",
-    help=SUPPRESS_HELP,
+    help=SUPPRESS_HELP,  # Not yet ready
 )
 
 pgo_group.add_option(
@@ -1351,14 +1403,16 @@ windows_group.add_option(
     "--windows-console-mode",
     action="store",
     dest="console_mode",
-    choices=("force", "disable", "attach"),
+    choices=("force", "disable", "attach", "hide"),
     metavar="CONSOLE_MODE",
     default=None,
     help="""\
 Select console mode to use. Default mode is 'force' and creates a
 console window unless the program was started from one. With 'disable'
 it doesn't create or use a console at all. With 'attach' an existing
-console will be used for outputs. Default is 'force'.
+console will be used for outputs. With 'hide' a newly spawned console
+will be hidden and an already existing console will behave like
+'force'. Default is 'force'.
 """,
 )
 
@@ -1569,7 +1623,7 @@ macos_group.add_option(
     "--macos-app-mode",
     action="store",
     dest="macos_app_mode",
-    metavar="MODE",
+    metavar="APP_MODE",
     choices=("gui", "background", "ui-element"),
     default="gui",
     help="""\

nuitka/Options.py

@@ -20,7 +20,10 @@ import sys
 
 from nuitka import Progress, Tracing
 from nuitka.containers.OrderedDicts import OrderedDict
-from nuitka.containers.OrderedSets import OrderedSet
+from nuitka.containers.OrderedSets import (
+    OrderedSet,
+    recommended_orderedset_package_name,
+)
 from nuitka.importing.StandardLibrary import isStandardLibraryPath
 from nuitka.OptionParsing import (
     parseOptions,
@@ -54,12 +57,14 @@ from nuitka.PythonVersions import (
 from nuitka.utils.Execution import getExecutablePath
 from nuitka.utils.FileOperations import (
     getNormalizedPath,
+    getReportPath,
     isLegalPath,
     isPathExecutable,
     openTextFile,
     resolveShellPatternToFilenames,
 )
 from nuitka.utils.Images import checkIconUsage
+from nuitka.utils.Importing import getInlineCopyFolder
 from nuitka.utils.StaticLibraries import getSystemStaticLibPythonPath
 from nuitka.utils.Utils import (
     getArchitecture,
@@ -89,7 +94,8 @@ is_nuitka_run = None
 is_debug = None
 is_non_debug = None
 is_full_compat = None
-is_report_missing = None
+report_missing_code_helpers = None
+report_missing_trust = None
 is_verbose = None
 
 
@@ -291,15 +297,13 @@ it with e.g. '{TEMP}', '{CACHE_DIR}' is recommended: '%s'"""
 
 
 def _getVersionInformationValues():
-    # TODO: Might be nice if we could delay version information computation
-    # until it's actually used.
     yield getNuitkaVersion()
     yield "Commercial: %s" % getCommercialVersion()
     yield "Python: %s" % sys.version.split("\n", 1)[0]
     yield "Flavor: %s" % getPythonFlavorName()
     if python_version >= 0x3D0:
         yield "GIL: %s" % ("yes" if isPythonWithGil() else "no")
-    yield "Executable: %s" % sys.executable
+    yield "Executable: %s" % getReportPath(sys.executable)
     yield "OS: %s" % getOS()
     yield "Arch: %s" % getArchitecture()
 
@@ -381,7 +385,7 @@ def parseArgs():
     # singleton with many cases checking the options right away.
     # pylint: disable=global-statement,too-many-branches,too-many-locals,too-many-statements
     global is_nuitka_run, options, positional_args, extra_args, is_debug, is_non_debug
-    global is_full_compat, is_report_missing, is_verbose
+    global is_full_compat, report_missing_code_helpers, report_missing_trust, is_verbose
 
     if os.name == "nt":
         # Windows store Python's don't allow looking at the python, catch that.
@@ -414,8 +418,8 @@ Error, the Python from Windows app store is not supported.""",
     if getattr(options, "disable_dll_dependency_cache", False):
         options.disabled_caches.append("dll-dependencies")
 
-    # TODO: Have dedicated option for it.
-    is_report_missing = is_debug
+    report_missing_code_helpers = options.report_missing_code_helpers
+    report_missing_trust = options.report_missing_trust
 
     if options.quiet or int(os.getenv("NUITKA_QUIET", "0")):
         Tracing.setQuiet()
@@ -488,6 +492,29 @@ Error, the Python from Windows app store is not supported.""",
 
     Tracing.progress_logger.is_quiet = not options.show_progress
 
+    if options.compilation_mode is not None:
+        if (
+            options.is_onefile
+            or options.is_standalone
+            or options.module_mode
+            or options.macos_create_bundle
+        ):
+            Tracing.options_logger.sysexit(
+                "Cannot use both '--mode=' and deprecated options that specify mode."
+            )
+
+        if options.compilation_mode == "onefile":
+            options.is_onefile = True
+        elif options.compilation_mode == "standalone":
+            options.is_standalone = True
+        elif options.compilation_mode == "module":
+            options.module_mode = True
+        elif options.compilation_mode == "app":
+            if isMacOS():
+                options.macos_create_bundle = True
+            else:
+                options.is_onefile = True
+
     # Onefile implies standalone build.
     if options.is_onefile:
         options.is_standalone = True
@@ -1171,7 +1198,7 @@ but errors may happen."""
             """\
 Using very slow fallback for ordered sets, please install '%s' \
 PyPI package for best Python compile time performance."""
-            % ("ordered-set" if python_version >= 0x370 else "orderedset")
+            % recommended_orderedset_package_name
         )
 
     if shallUsePythonDebug() and not isDebugPython():
@@ -1319,7 +1346,7 @@ def getModuleNameMode():
 
 def shallMakeModule():
     """:returns: bool derived from ``--module``"""
-    return options.module_mode
+    return options is not None and options.module_mode
 
 
 def shallCreatePyiFile():
@@ -1327,6 +1354,11 @@ def shallCreatePyiFile():
     return options.pyi_file
 
 
+def shallCreatePyiFileContainStubs():
+    """*bool* = **not** ``--no-pyi-stubs``"""
+    return options.pyi_stubs
+
+
 def isAllowedToReexecute():
     """*bool* = **not** ``--must-not-re-execute``"""
     return options.allow_reexecute
@@ -1445,6 +1477,14 @@ def getShallIncludeDataDirs():
         yield src, dest
 
 
+def getShallIncludeRawDirs():
+    """*list*, items of ``--include-raw-dir=``"""
+    for data_file in options.raw_dirs:
+        src, dest = data_file.split("=", 1)
+
+        yield src, dest
+
+
 def getShallNotIncludeDataFilePatterns():
     """*list*, items of ``--noinclude-data-files=``"""
 
@@ -1526,7 +1566,7 @@ def getOutputFilename():
 def getOutputPath(path):
     """Return output pathname of a given path (filename)."""
     if options.output_dir:
-        return os.path.normpath(os.path.join(options.output_dir, path))
+        return getNormalizedPath(os.path.join(options.output_dir, path))
     else:
         return path
 
@@ -1556,7 +1596,7 @@ def getMainEntryPointFilenames():
     else:
         result = (positional_args[0],)
 
-    return tuple(os.path.normpath(r).rstrip(os.path.sep) for r in result)
+    return tuple(getNormalizedPath(r) for r in result)
 
 
 def isMultidistMode():
@@ -1596,6 +1636,14 @@ def _shallUseStaticLibPython():
             and isDebianSuitableForStaticLinking()
             and not shallUsePythonDebug()
         ):
+            if python_version >= 0x3C0 and not os.path.exists(
+                getInlineCopyFolder("python_hacl")
+            ):
+                return (
+                    False,
+                    "Nuitka on Debian-Python needs inline copy of hacl not included.",
+                )
+
             return True, "Nuitka on Debian-Python needs package '%s' installed." % (
                 "python2-dev" if str is bytes else "python3-dev"
             )
@@ -2299,6 +2347,8 @@ def _getPythonFlags():
                     _python_flags.add("package_mode")
                 elif part in ("-I", "isolated"):
                     _python_flags.add("isolated")
+                elif part in ("-B", "dontwritebytecode"):
+                    _python_flags.add("dontwritebytecode")
                 else:
                     Tracing.options_logger.sysexit(
                         "Unsupported python flag '%s'." % part
@@ -2355,8 +2405,14 @@ def hasPythonFlagNoRandomization():
     return "no_randomization" in _getPythonFlags()
 
 
+def hasPythonFlagNoBytecodeRuntimeCache():
+    """*bool* = "dontwritebytecode", "-u" in python flags given"""
+
+    return "dontwritebytecode" in _getPythonFlags()
+
+
 def hasPythonFlagUnbuffered():
-    """*bool* = "package_mode", "-m" in python flags given"""
+    """*bool* = "unbuffered", "-u" in python flags given"""
 
     return "unbuffered" in _getPythonFlags()
 

nuitka/OutputDirectories.py

@@ -15,6 +15,7 @@ import os
 from nuitka import Options
 from nuitka.utils.FileOperations import (
     addFilenameExtension,
+    getNormalizedPath,
     makePath,
     putTextFileContents,
 )
@@ -39,10 +40,14 @@ def hasMainModule():
     return _main_module is not None
 
 
+def getMainModule():
+    return _main_module
+
+
 def getSourceDirectoryPath(onefile=False):
     """Return path inside the build directory."""
 
-    # Distinct build folders for oneline mode.
+    # Distinct build folders for onefile mode.
     if onefile:
         suffix = ".onefile-build"
     else:
@@ -139,7 +144,7 @@ def getResultFullpath(onefile):
         if not isWin32OrPosixWindows() and Options.isOnefileMode() and not onefile:
             result = addFilenameExtension(result, ".bin")
 
-    return result
+    return getNormalizedPath(result)
 
 
 def getResultRunFilename(onefile):