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

nuitka/nodes/FunctionNodes.py

@@ -1,20 +1,6 @@
-#     Copyright 2023, Kay Hayen, mailto:kay.hayen@gmail.com
-#
-#     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.
-#
+#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
 """ Nodes for functions and their creations.
 
 Lambdas are functions too. The functions are at the core of the language and
@@ -30,6 +16,7 @@ classes.
 """
 
 import inspect
+import re
 
 from nuitka import Options, Variables
 from nuitka.Constants import isMutable
@@ -43,8 +30,9 @@ from nuitka.specs.ParameterSpecs import (
     TooManyArguments,
     matchCall,
 )
-from nuitka.Tracing import optimization_logger
+from nuitka.Tracing import optimization_logger, printError
 from nuitka.tree.Extractions import updateVariableUsage
+from nuitka.tree.SourceHandling import readSourceLines
 from nuitka.tree.TreeHelpers import makeDictCreationOrConstant2
 
 from .ChildrenHavingMixins import (
@@ -98,11 +86,8 @@ class ExpressionFunctionBodyBase(
         "flags",
     )
 
-    if python_version >= 0x340:
-        __slots__ += ("qualname_provider",)
-
     if python_version >= 0x300:
-        __slots__ += ("non_local_declarations",)
+        __slots__ += ("qualname_provider", "non_local_declarations")
 
     # Might be None initially in some cases.
     named_children = ("body|optional+setter",)
@@ -130,13 +115,12 @@ class ExpressionFunctionBodyBase(
         # officially a child yet. Important during building.
         self.parent = provider
 
-        # Python3.4: Might be overridden by global statement on the class name.
-        # TODO: Make this class only code.
-        if python_version >= 0x340:
+        if python_version >= 0x300:
+            # Python3: Might be overridden by global statement on the class name.
+            # TODO: Make this class only code.
             self.qualname_provider = provider
 
-        # Non-local declarations.
-        if python_version >= 0x300:
+            # Non-local declarations if any.
             self.non_local_declarations = None
 
     @staticmethod
@@ -360,7 +344,7 @@ class ExpressionFunctionBodyBase(
 
         function_name = self.getFunctionName()
 
-        if python_version < 0x340:
+        if python_version < 0x300:
             qualname_provider = self.getParentVariableProvider()
         else:
             qualname_provider = self.qualname_provider
@@ -568,7 +552,7 @@ class ExpressionFunctionBody(
     ExpressionFunctionEntryPointBase,
 ):
     # TODO: There should be more special ones than this general type in order to
-    # not cover exec ones in the same object. pylint: disable=too-many-instance-attributes
+    # not cover exec ones in the same object.
 
     kind = "EXPRESSION_FUNCTION_BODY"
 
@@ -583,7 +567,7 @@ class ExpressionFunctionBody(
         "parameters",
     )
 
-    if python_version >= 0x340:
+    if python_version >= 0x300:
         __slots__ += ("qualname_setup",)
 
     def __init__(
@@ -595,6 +579,7 @@ class ExpressionFunctionBody(
         parameters,
         flags,
         auto_release,
+        code_prefix,
         source_ref,
     ):
         ExpressionFunctionEntryPointBase.__init__(
@@ -602,7 +587,7 @@ class ExpressionFunctionBody(
             provider=provider,
             name=name,
             code_object=code_object,
-            code_prefix="function",
+            code_prefix=code_prefix,
             flags=flags,
             auto_release=auto_release,
             source_ref=source_ref,
@@ -624,7 +609,7 @@ class ExpressionFunctionBody(
         # Indicator if the function is used outside of where it's defined.
         self.cross_module_use = False
 
-        if python_version >= 0x340:
+        if python_version >= 0x300:
             self.qualname_setup = None
 
         self.parameters = parameters
@@ -791,6 +776,7 @@ class ExpressionFunctionPureBody(ExpressionFunctionBody):
         parameters,
         flags,
         auto_release,
+        code_prefix,
         source_ref,
     ):
         ExpressionFunctionBody.__init__(
@@ -802,6 +788,7 @@ class ExpressionFunctionPureBody(ExpressionFunctionBody):
             parameters=parameters,
             flags=flags,
             auto_release=auto_release,
+            code_prefix=code_prefix,
             source_ref=source_ref,
         )
 
@@ -820,9 +807,11 @@ class ExpressionFunctionPureBody(ExpressionFunctionBody):
                     "{source_ref} : {tags} : {message}".format(
                         source_ref=source_ref.getAsString(),
                         tags=tag,
-                        message=change_desc()
-                        if inspect.isfunction(change_desc)
-                        else change_desc,
+                        message=(
+                            change_desc()
+                            if inspect.isfunction(change_desc)
+                            else change_desc
+                        ),
                     )
                 )
 
@@ -1039,7 +1028,7 @@ class ExpressionFunctionCreationOld(
 ):
     kind = "EXPRESSION_FUNCTION_CREATION_OLD"
 
-    python_version_spec = "< 0x340"
+    python_version_spec = "< 0x300"
     # Note: The order of evaluation for these is a bit unexpected, but
     # true. Keyword defaults go first, then normal defaults, and annotations of
     # all kinds go last.
@@ -1107,14 +1096,14 @@ class ExpressionFunctionCreation(
         self.variable_closure_traces = None
 
 
-if python_version < 0x340:
+if python_version < 0x300:
     ExpressionFunctionCreation = ExpressionFunctionCreationOld
 
 
 class ExpressionFunctionRef(ExpressionNoSideEffectsMixin, ExpressionBase):
     kind = "EXPRESSION_FUNCTION_REF"
 
-    __slots__ = "function_body", "code_name"
+    __slots__ = "function_body", "code_name", "function_source"
 
     def __init__(self, source_ref, function_body=None, code_name=None):
         assert function_body is not None or code_name is not None
@@ -1124,10 +1113,12 @@ class ExpressionFunctionRef(ExpressionNoSideEffectsMixin, ExpressionBase):
 
         self.function_body = function_body
         self.code_name = code_name
+        self.function_source = None
 
     def finalize(self):
         del self.parent
         del self.function_body
+        del self.function_source
 
     def getName(self):
         return self.function_body.getName()
@@ -1156,6 +1147,45 @@ class ExpressionFunctionRef(ExpressionNoSideEffectsMixin, ExpressionBase):
         # TODO: Function after collection may now know something.
         return self, None, None
 
+    def getFunctionSourceCode(self):
+        if self.function_source is None:
+            try:
+                lines = readSourceLines(self.getFunctionBody().source_ref)
+
+                # This needs to match "inspect.findsource".
+                pat = re.compile(
+                    r"^(\s*def\s)|(\s*async\s+def\s)|(.*(?<!\w)lambda(:|\s))|^(\s*@)"
+                )
+
+                line_number = self.source_ref.line - 1
+
+                while line_number > 0:
+                    line = lines[line_number]
+
+                    if pat.match(line):
+                        break
+
+                    line_number = line_number - 1
+
+                self.function_source = (
+                    "".join(inspect.getblock(lines[line_number:])),
+                    line_number,
+                )
+            except Exception:
+                printError(
+                    "Problem with retrieving source code of '%s' at %s"
+                    % (self.getFunctionSuperQualifiedName(), self.source_ref)
+                )
+                raise
+
+        return self.function_source
+
+    def getFunctionSuperQualifiedName(self):
+        return "%s.%s" % (
+            self.getParentModule().getFullName(),
+            self.getFunctionBody().getFunctionQualname(),
+        )
+
 
 def makeExpressionFunctionCall(function, values, source_ref):
     assert function.isExpressionFunctionCreation()
@@ -1248,3 +1278,19 @@ class ExpressionFunctionCall(ChildrenHavingFunctionValuesTupleMixin, ExpressionB
 
     def getClosureVariableVersions(self):
         return self.variable_closure_traces
+
+
+#     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/nodes/FutureSpecs.py

@@ -1,20 +1,6 @@
-#     Copyright 2023, Kay Hayen, mailto:kay.hayen@gmail.com
-#
-#     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.
-#
+#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
 """ Specification record for future flags.
 
 A source reference also implies a specific set of future flags in use by the
@@ -38,6 +24,9 @@ _future_annotations_default = python_version >= 0x400
 
 
 class FutureSpec(object):
+    # We are using a bunch of flags here, Python decides them and then we add
+    # even more modes ourselves, pylint: disable=too-many-instance-attributes
+
     __slots__ = (
         "future_division",
         "unicode_literals",
@@ -46,10 +35,11 @@ class FutureSpec(object):
         "barry_bdfl",
         "generator_stop",
         "future_annotations",
+        "use_annotations",
     )
 
     @counted_init
-    def __init__(self):
+    def __init__(self, use_annotations):
         self.future_division = _future_division_default
         self.unicode_literals = False
         self.absolute_import = _future_absolute_import_default
@@ -58,6 +48,9 @@ class FutureSpec(object):
         self.generator_stop = _future_generator_stop_default
         self.future_annotations = _future_annotations_default
 
+        # Attaching our special modes here still.
+        self.use_annotations = use_annotations
+
     if isCountingInstances():
         __del__ = counted_del()
 
@@ -65,7 +58,7 @@ class FutureSpec(object):
         return "<FutureSpec %s>" % ",".join(self.asFlags())
 
     def clone(self):
-        result = FutureSpec()
+        result = FutureSpec(use_annotations=self.use_annotations)
 
         result.future_division = self.future_division
         result.unicode_literals = self.unicode_literals
@@ -110,6 +103,9 @@ class FutureSpec(object):
     def enableFutureAnnotations(self):
         self.future_annotations = True
 
+    def shallUseAnnotations(self):
+        return self.use_annotations
+
     def isFutureAnnotations(self):
         return self.future_annotations
 
@@ -151,7 +147,10 @@ def fromFlags(flags):
     if "" in flags:
         flags.remove("")
 
-    result = FutureSpec()
+    # TODO: For persistence, that's not very good, but it's actually only using
+    # our "no_annotations" flag during building phase, which is completed here,
+    # but we might have to add it in the future to XML differently.
+    result = FutureSpec(use_annotations=False)
 
     if "CO_FUTURE_DIVISION" in flags:
         result.enableFutureDivision()
@@ -175,3 +174,19 @@ def fromFlags(flags):
     assert tuple(result.asFlags()) == tuple(flags), (result, result.asFlags(), flags)
 
     return result
+
+
+#     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/nodes/GeneratorNodes.py

@@ -1,20 +1,6 @@
-#     Copyright 2023, Kay Hayen, mailto:kay.hayen@gmail.com
-#
-#     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.
-#
+#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
 """ Nodes for generator objects and their creations.
 
 Generators are turned into normal functions that create generator objects,
@@ -84,7 +70,7 @@ class ExpressionGeneratorObjectBody(
         "qualname_provider",
     )
 
-    if python_version >= 0x340:
+    if python_version >= 0x300:
         __slots__ += ("qualname_setup",)
 
     def __init__(self, provider, name, code_object, flags, auto_release, source_ref):
@@ -105,20 +91,17 @@ class ExpressionGeneratorObjectBody(
 
         self.trace_collection = None
 
-        if python_version >= 0x340:
+        if python_version >= 0x300:
             self.qualname_setup = None
 
     def getFunctionName(self):
         return self.name
 
-    def markAsNeedsGeneratorReturnHandling(self, value):
-        self.needs_generator_return_exit = max(self.needs_generator_return_exit, value)
-
-    def needsGeneratorReturnHandling(self):
-        return self.needs_generator_return_exit == 2
+    def markAsNeedsGeneratorReturnHandling(self):
+        self.needs_generator_return_exit = True
 
     def needsGeneratorReturnExit(self):
-        return bool(self.needs_generator_return_exit)
+        return self.needs_generator_return_exit
 
     @staticmethod
     def needsCreation():
@@ -200,3 +183,19 @@ class StatementGeneratorReturnNone(StatementReturnNone):
     @staticmethod
     def getStatementNiceName():
         return "generator return statement"
+
+
+#     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/nodes/GlobalsLocalsNodes.py

@@ -1,20 +1,6 @@
-#     Copyright 2023, Kay Hayen, mailto:kay.hayen@gmail.com
-#
-#     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.
-#
+#     Copyright 2024, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
+
+
 """ Globals/locals/single arg dir nodes
 
 These nodes give access to variables, highly problematic, because using them,
@@ -94,6 +80,9 @@ class ExpressionBuiltinLocalsRef(ExpressionBuiltinLocalsBase):
             self, locals_scope=locals_scope, source_ref=source_ref
         )
 
+    def getDetails(self):
+        return {"locals_scope": self.locals_scope}
+
     def getLocalsScope(self):
         return self.locals_scope
 
@@ -202,3 +191,19 @@ class ExpressionBuiltinDir1(ExpressionBuiltinSingleArgBase):
         trace_collection.onExceptionRaiseExit(BaseException)
 
         return self, None, 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.