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

nuitka/tools/testing/Common.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
 
 
 """ Common test infrastructure functions. To be used by test runners. """
@@ -17,6 +17,7 @@ from contextlib import contextmanager
 from optparse import OptionParser
 
 from nuitka.__past__ import md5, subprocess
+from nuitka.containers.OrderedDicts import OrderedDict
 from nuitka.Options import getCommercialVersion
 from nuitka.PythonVersions import getTestExecutionPythonVersions, isDebugPython
 from nuitka.Tracing import OurLogger, my_print
@@ -28,6 +29,7 @@ from nuitka.utils.Execution import (
     executeProcess,
     getNullInput,
     getNullOutput,
+    withEnvironmentVarOverridden,
 )
 from nuitka.utils.FileOperations import (
     areSamePaths,
@@ -401,6 +403,48 @@ def _removeCPythonTestSuiteDir():
             raise
 
 
+def _compareWithCPythonVariations(
+    dirname, filename, extra_flags, search_mode, on_error=None
+):
+    if "" not in extra_flags:
+        test_logger.sysexit("Error, default flags not present")
+
+    # Drop empty values or identical values.
+    extra_flags = OrderedDict(
+        (key, value) for (key, value) in extra_flags.items() if (value or key == "")
+    )
+
+    def _getVariation(source, variant_name):
+        if type(source) in (dict, OrderedDict):
+            return source.get(variant_name, source.get(""))
+        else:
+            return source
+
+    if len(extra_flags) == 1:
+        return compareWithCPython(
+            dirname=dirname,
+            filename=filename,
+            extra_flags=_getVariation(extra_flags, ""),
+            search_mode=search_mode,
+            on_error=on_error,
+        )
+
+    for test_variant_name in extra_flags.keys():
+        if test_variant_name == "":
+            test_logger.info("Default variation of the test.")
+        else:
+            test_logger.info("Extra variation '%s'." % test_variant_name)
+
+        with withEnvironmentVarOverridden("NUITKA_TEST_VARIANT", test_variant_name):
+            compareWithCPython(
+                dirname=_getVariation(dirname, test_variant_name),
+                filename=_getVariation(filename, test_variant_name),
+                extra_flags=_getVariation(extra_flags, test_variant_name),
+                search_mode=search_mode,
+                on_error=on_error,
+            )
+
+
 def compareWithCPython(dirname, filename, extra_flags, search_mode, on_error=None):
     """Call the comparison tool. For a given directory filename.
 
@@ -409,6 +453,16 @@ def compareWithCPython(dirname, filename, extra_flags, search_mode, on_error=Non
 
     """
 
+    # Allow being called with variations of extra flags.
+    if type(extra_flags) in (dict, OrderedDict):
+        return _compareWithCPythonVariations(
+            dirname=dirname,
+            filename=filename,
+            extra_flags=extra_flags,
+            search_mode=search_mode,
+            on_error=on_error,
+        )
+
     if dirname is None:
         path = filename
     else:
@@ -657,7 +711,7 @@ def getTotalReferenceCount():
         return result
 
 
-def checkReferenceCount(checked_function, max_rounds=20, explain=False):
+def checkReferenceCount(checked_function, max_rounds=20, explain=False, no_print=True):
     # This is obviously going to be complex, pylint: disable=too-many-branches
 
     # Clean start conditions.
@@ -666,7 +720,8 @@ def checkReferenceCount(checked_function, max_rounds=20, explain=False):
     my_print(checked_function.__name__ + ": ", end="")
     sys.stdout.flush()
 
-    disablePrinting()
+    if no_print:
+        disablePrinting()
 
     # Make sure reference for these are already taken at the start.
     ref_count1 = 17
@@ -699,7 +754,8 @@ def checkReferenceCount(checked_function, max_rounds=20, explain=False):
         if explain and count == max_rounds - 1:
             snapObjRefCntMap(before=False)
 
-    reenablePrinting()
+    if no_print:
+        reenablePrinting()
 
     if result:
         my_print("PASSED")
@@ -853,7 +909,7 @@ def reportSkip(reason, dirname, filename):
 
 
 def executeReferenceChecked(
-    prefix, names, tests_skipped=(), tests_stderr=(), explain=False
+    prefix, names, tests_skipped=(), tests_stderr=(), explain=False, no_print=True
 ):
     gc.disable()
 
@@ -883,10 +939,14 @@ def executeReferenceChecked(
                 if number in tests_stderr:
                     sys.stderr = null_output
             except OSError:  # Windows
-                if not checkReferenceCount(names[name], explain=explain):
+                if not checkReferenceCount(
+                    names[name], explain=explain, no_print=no_print
+                ):
                     result = False
             else:
-                if not checkReferenceCount(names[name], explain=explain):
+                if not checkReferenceCount(
+                    names[name], explain=explain, no_print=no_print
+                ):
                     result = False
             finally:
                 if number in tests_stderr:
@@ -1185,7 +1245,7 @@ def async_iterate(g):
             break
         except StopIteration as ex:
             if ex.args:
-                res.append("ex arg %s" % ex.args[0])
+                res.append("StopIteration args %s" % ex.args)
             else:
                 res.append("EMPTY StopIteration")
                 break
@@ -1195,6 +1255,30 @@ def async_iterate(g):
     return res
 
 
+def sync_iterate(g):
+    """Execute sync generator until it's done."""
+    res = []
+
+    while True:
+        try:
+            if str is bytes:
+                res.append(next(g))
+            else:
+                res.append(g.__next__())
+        except StopIteration as ex:
+            if ex.args:
+                res.append("StopIteration arg %s" % ex.args[0])
+            else:
+                res.append("EMPTY StopIteration")
+
+            break
+        except Exception as ex:  # pylint: disable=broad-exception-caught
+
+            res.append(str(type(ex)))
+
+    return res
+
+
 def getTestingCacheDir():
     cache_dir = getCacheDir("tests_state")
     makePath(cache_dir)
@@ -1210,21 +1294,36 @@ def getTestingCPythonOutputsCacheDir():
     return result
 
 
-def scanDirectoryForTestCases(dirname, template_context=None):
+def scanDirectoryForTestCases(
+    dirname, template_context=None, cases_are_directories=False
+):
     filenames = os.listdir(dirname)
 
-    filenames = [
-        filename
-        for filename in filenames
-        if (filename.endswith(".py") and filename + ".j2" not in filenames)
-        or filename.endswith(".j2")
-    ]
+    if not cases_are_directories:
+        filenames = [
+            filename
+            for filename in filenames
+            if (filename.endswith(".py") and filename + ".j2" not in filenames)
+            or filename.endswith(".j2")
+        ]
 
     for filename in sorted(filenames):
+        if filename.endswith((".build", ".onefile-build", ".dist", ".app")):
+            continue
+
+        filename_full = os.path.join(dirname, filename)
+
+        if cases_are_directories:
+            if not os.path.isdir(filename_full):
+                continue
+        else:
+            if not os.path.isfile(filename_full):
+                continue
+
         if not decideFilenameVersionSkip(filename):
             continue
 
-        if filename.endswith(".j2"):
+        if cases_are_directories and filename.endswith(".j2"):
             # Needs to be a dictionary with template arguments.
             assert template_context is not None
 
@@ -1248,7 +1347,7 @@ def scanDirectoryForTestCases(dirname, template_context=None):
         yield filename
 
 
-def scanDirectoryForTestCaseFolders(dirname):
+def scanDirectoryForTestCaseFolders(dirname, allow_none=False):
     filenames = os.listdir(dirname)
 
     for filename in sorted(filenames):
@@ -1265,7 +1364,7 @@ def scanDirectoryForTestCaseFolders(dirname):
         ):
             continue
 
-        filename_main = getMainProgramFilename(filename)
+        filename_main = getMainProgramFilename(filename, allow_none=allow_none)
 
         yield filename, filename_main
 
@@ -1486,6 +1585,7 @@ def checkLoadedFileAccesses(loaded_filenames, current_dir):
             "/sys",
             "/tmp",
             "/var",
+            "/private/var",
             # Locals may of course be loaded.
             "/usr/lib/locale",
             "/usr/share/locale",
@@ -1853,7 +1953,7 @@ def checkLoadedFileAccesses(loaded_filenames, current_dir):
     return illegal_accesses
 
 
-def getMainProgramFilename(filename):
+def getMainProgramFilename(filename, allow_none=False):
     for filename_main in os.listdir(filename):
         if filename_main.endswith(("Main.py", "Main")):
             return filename_main
@@ -1866,6 +1966,9 @@ def getMainProgramFilename(filename):
         ):
             return filename_main
 
+    if allow_none:
+        return None
+
     test_logger.sysexit(
         """\
 Error, no file ends with 'Main.py' or 'Main' in '%s', incomplete test case."""
@@ -1982,6 +2085,24 @@ def extractNuitkaVersionFromFilePath(version_filename):
     return version_line[8:].rstrip()
 
 
+def decryptOutput(project_options, output):
+    nuitka_decrypt_call = [
+        os.environ.get("PYTHON", sys.executable),
+        "-m",
+        "nuitka.tools.commercial.decrypt",  # Note: Needed for Python2.6
+    ]
+
+    for project_option in project_options:
+        if project_option.startswith("--encryption-key="):
+            nuitka_decrypt_call.append("--key=" + project_option.split("=", 1)[1])
+
+    stdout, stderr, exit_code = executeProcess(nuitka_decrypt_call, stdin=output)
+
+    assert exit_code == 0, stderr
+
+    return stdout
+
+
 #     Part of "Nuitka", an optimizing Python compiler that is compatible and
 #     integrates with CPython, but also works on its own.
 #

nuitka/tools/testing/Constructs.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 construct tests.

nuitka/tools/testing/OutputComparison.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 to compare outputs of compiled and not compiled programs.
@@ -96,9 +96,10 @@ def makeDiffable(output, ignore_warnings, syntax_errors):
             line = line[:-1]
 
         if line.startswith("REFCOUNTS"):
-            first_value = line[line.find("[") + 1 : line.find(",")]
-            last_value = line[line.rfind(" ") + 1 : line.rfind("]")]
-            line = line.replace(first_value, "xxxxx").replace(last_value, "xxxxx")
+            if "[" in line:
+                first_value = line[line.find("[") + 1 : line.find(",")]
+                last_value = line[line.rfind(" ") + 1 : line.rfind("]")]
+                line = line.replace(first_value, "xxxxx").replace(last_value, "xxxxx")
 
         if line.startswith("[") and line.endswith("refs]"):
             continue

nuitka/tools/testing/Pythons.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
 
 
 """ Test tool to run a program with various Pythons. """

nuitka/tools/testing/RuntimeTracing.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
 
 
 """ Runtime tracing

nuitka/tools/testing/SearchModes.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
 
 
 """ Search modes for Nuitka's test runner.

nuitka/tools/testing/Valgrind.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
 
 
 """ Valgrind tool usage.

nuitka/tools/testing/__init__.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
 
 
 """ Dummy file to make this directory a package. """

nuitka/tools/testing/check_reference_counts/__init__.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
 
 
 """ Dummy file to make this directory a package. """

nuitka/tools/testing/check_reference_counts/__main__.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-#     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
 
 
 """ Tool to compare reference counting behavior of CPython and Nuitka.
@@ -24,6 +24,7 @@ def main():
         "--checked-module",
         action="store",
         dest="checked_module",
+        default=None,
         help="""\
 Module with main() function to be checked for reference count stability.""",
     )
@@ -42,6 +43,9 @@ Try to explain the differences by comparing object counts.""",
     if positional_args and options.checked_module is None:
         options.checked_module = positional_args.pop()
 
+    if options.checked_module is None:
+        sys.exit("\nNeed to provide checked module filename.")
+
     if positional_args and options.checked_module:
         parser.print_help()
 
@@ -57,7 +61,7 @@ Try to explain the differences by comparing object counts.""",
         sys.executable,
         "-m",
         "nuitka",
-        "--module",
+        "--mode=module",
         options.checked_module,
         "--output-dir=%s" % temp_dir,
     ]

nuitka/tools/testing/compare_with_cpython/__init__.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
 
 
 """ Dummy file to make this directory a package. """

nuitka/tools/testing/compare_with_cpython/__main__.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-#     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
 
 
 """ Tool to compare output of CPython and Nuitka.
@@ -16,6 +16,7 @@ from nuitka.__past__ import md5
 from nuitka.OptionParsing import getNuitkaProjectOptions
 from nuitka.tools.testing.Common import (
     addToPythonPath,
+    decryptOutput,
     executeAfterTimePassed,
     getDebugPython,
     getTempDir,
@@ -37,6 +38,7 @@ from nuitka.utils.Execution import (
 from nuitka.utils.FileOperations import deleteFile
 from nuitka.utils.Importing import getSharedLibrarySuffix
 from nuitka.utils.Timing import StopWatch
+from nuitka.utils.Utils import isMacOS
 
 
 def displayOutput(stdout, stderr):
@@ -215,7 +217,8 @@ def main():
     expect_success = hasArg("expect_success")
     expect_failure = hasArg("expect_failure")
     python_debug = hasArg("python_debug") or hasArg("--python-debug")
-    module_mode = hasArg("--module")
+    package_mode = hasArg("--mode=package")
+    module_mode = hasArg("--mode=module") or hasArg("--mode=module") or package_mode
     module_entry_point = hasArgValue("--module-entry-point")
     coverage_mode = hasArg("coverage")
     two_step_execution = hasArg("two_step_execution")
@@ -225,8 +228,11 @@ def main():
     )
     remove_output = hasArg("remove_output")
     remove_binary = not hasArg("--keep-binary")
-    standalone_mode = hasArg("--standalone")
-    onefile_mode = hasArg("--onefile")
+    app_bundle_mode = hasArg("--mode=app") and isMacOS()
+    standalone_mode = (
+        hasArg("--standalone") or hasArg("--mode=standalone") or app_bundle_mode
+    )
+    onefile_mode = hasArg("--onefile") or hasArg("--mode=onefile")
     no_site = hasArg("no_site") or coverage_mode
     report = hasArgValue("--report")
     nofollow_imports = hasArg("recurse_none") or hasArg("--nofollow-imports")
@@ -287,11 +293,18 @@ def main():
         )
     )
 
-    if "--standalone" in project_options:
+    if "--standalone" in project_options or "--mode=standalone" in project_options:
         standalone_mode = True
-    if "--onefile" in project_options:
+    if "--onefile" in project_options or "--mode=onefile" in project_options:
         standalone_mode = True
         onefile_mode = True
+    if "--mode=app" in project_options:
+        if isMacOS():
+            standalone_mode = True
+            app_bundle_mode = True
+        else:
+            standalone_mode = True
+            onefile_mode = True
 
     # In coverage mode, we don't want to execute, and to do this only in one mode,
     # we enable two step execution, which splits running the binary from the actual
@@ -535,12 +548,16 @@ Taking coverage of '{filename}' using '{python}' with flags {args} ...""".format
 
     # Now build the command to run Nuitka.
     if not two_step_execution:
-        if module_mode:
-            extra_options.append("--module")
+        if package_mode:
+            extra_options.append("--mode=package")
+        elif module_mode:
+            extra_options.append("--mode=module")
         elif onefile_mode:
-            extra_options.append("--onefile")
+            extra_options.append("--mode=onefile")
+        elif app_bundle_mode:
+            extra_options.append("--mode=app")
         elif standalone_mode:
-            extra_options.append("--standalone")
+            extra_options.append("--mode=standalone")
 
         nuitka_cmd = nuitka_call + extra_options + ["--run", filename]
 
@@ -548,12 +565,22 @@ Taking coverage of '{filename}' using '{python}' with flags {args} ...""".format
             nuitka_cmd.insert(len(nuitka_cmd) - 1, "--python-flag=-S")
 
     else:
-        if module_mode:
+        if package_mode:
+            nuitka_cmd1 = (
+                nuitka_call
+                + extra_options
+                + ["--mode=package", os.path.abspath(filename)]
+            )
+        elif module_mode:
             nuitka_cmd1 = (
-                nuitka_call + extra_options + ["--module", os.path.abspath(filename)]
+                nuitka_call
+                + extra_options
+                + ["--mode=module", os.path.abspath(filename)]
             )
+        elif onefile_mode:
+            nuitka_cmd1 = nuitka_call + extra_options + ["--mode=onefile", filename]
         elif standalone_mode:
-            nuitka_cmd1 = nuitka_call + extra_options + ["--standalone", filename]
+            nuitka_cmd1 = nuitka_call + extra_options + ["--mode=standalone", filename]
         else:
             nuitka_cmd1 = nuitka_call + extra_options + [filename]
 
@@ -698,7 +725,9 @@ Stderr was:
 
                     # In case of segfault or assertion triggered, run in debugger.
                     if exit_nuitka in (-11, -6) and sys.platform != "nt":
-                        nuitka_cmd2 = wrapCommandForDebuggerForSubprocess(*nuitka_cmd2)
+                        nuitka_cmd2 = wrapCommandForDebuggerForSubprocess(
+                            command=nuitka_cmd2
+                        )
 
                         callProcess(nuitka_cmd2, shell=False)
                 else:
@@ -716,6 +745,14 @@ Stderr was:
     stop_watch.stop()
     nuitka_time = stop_watch.getDelta()
 
+    if "--encrypt-stderr" in project_options:
+        with withPythonPathChange(nuitka_package_dir):
+            stderr_nuitka = decryptOutput(project_options, stderr_nuitka)
+
+    if "--encrypt-stdout" in project_options:
+        with withPythonPathChange(nuitka_package_dir):
+            stdout_nuitka = decryptOutput(project_options, stdout_nuitka)
+
     if not silent_mode:
         displayOutput(stdout_nuitka, stderr_nuitka)
 

nuitka/tools/testing/find_sxs_modules/__init__.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
 
 
 """ Dummy file to make this directory a package. """

nuitka/tools/testing/find_sxs_modules/__main__.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-#     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
 
 
 """ Tool to compare find SxS using modules.

nuitka/tools/testing/measure_construct_performance/__init__.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
 
 
 """ Dummy file to make this directory a package. """

nuitka/tools/testing/measure_construct_performance/__main__.py

@@ -1,5 +1,5 @@
 #!/usr/bin/python
-#     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
 
 
 """ Run a construct based comparison test.

nuitka/tools/testing/run_nuitka_tests/__init__.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
 
 
 """ Dummy file to make this directory a package. """

nuitka/tools/testing/run_nuitka_tests/__main__.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-#     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
 
 
 """ Main front-end to the tests of Nuitka.

nuitka/tools/watch/AutoStage.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
 
 
 """ Stage changes in Nuitka-Watch automatically

nuitka/tools/watch/Common.py

@@ -0,0 +1,55 @@
+#     Copyright 2025, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
+""" Shared code for nuitka-watch backends.
+
+"""
+
+import os
+import sys
+
+
+def getPlatformRequirements(installed_python, case_data):
+    requirements = list(case_data["requirements"])
+
+    # Nuitka house keeping, these are from setup.py but we ignore onefile needs
+    # as that is not currently covered in watches.
+    # spell-checker: ignore orderedset,imageio
+    needs_onefile = False
+
+    if installed_python.getHexVersion() >= 0x370:
+        requirements.append("ordered-set >= 4.1.0")
+    if installed_python.getHexVersion() < 0x300:
+        requirements.append("subprocess32")
+    if needs_onefile and installed_python.getHexVersion() >= 0x370:
+        requirements.append("zstandard >= 0.15")
+    if (
+        os.name != "nt"
+        and sys.platform != "darwin"
+        and installed_python.getHexVersion() < 0x370
+    ):
+        requirements.append("orderedset >= 2.0.3")
+    if sys.platform == "darwin" and installed_python.getHexVersion() < 0x370:
+        requirements.append("orderedset >= 2.0.3")
+
+    # For icon conversion.
+    if case_data.get("icons", "no") == "yes":
+        requirements.append("imageio")
+
+    return requirements
+
+
+#     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.