mirror of
https://github.com/Nuitka/Nuitka.git
synced 2026-06-30 12:22:09 +02:00
Kay Hayen
7bcd580a6d
* Reference the runtime exception everywhere as that is expected to be done, not just generally. * Proper link to the correct version of the license file on the web.
169 lines
4.7 KiB
Python
169 lines
4.7 KiB
Python
# Copyright 2026, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
|
|
|
|
|
|
"""The hints module should contain functions to call in your code.
|
|
|
|
In reality, right now it does only contain an import tracing mechanism
|
|
that helps us with debugging.
|
|
"""
|
|
|
|
from __future__ import print_function
|
|
|
|
import os
|
|
import sys
|
|
import traceback
|
|
|
|
try:
|
|
import __builtin__ as builtins
|
|
except ImportError:
|
|
import builtins
|
|
|
|
|
|
original_import = __import__
|
|
|
|
_indentation = 0
|
|
|
|
|
|
def _normalizePath(path):
|
|
path = os.path.abspath(path)
|
|
|
|
best = None
|
|
|
|
paths = list(sys.path)
|
|
|
|
# Nuitka standalone mode.
|
|
try:
|
|
paths.append(__nuitka_binary_dir)
|
|
paths.append(os.getcwd())
|
|
except NameError:
|
|
pass
|
|
|
|
for path_entry in paths:
|
|
path_entry = os.path.normcase(path_entry)
|
|
|
|
if os.path.normcase(path).startswith(path_entry):
|
|
if best is None or len(path_entry) > len(best):
|
|
best = path_entry
|
|
|
|
if best is not None:
|
|
path = "$PYTHONPATH" + path[len(best) :]
|
|
|
|
return path
|
|
|
|
|
|
def _moduleRepr(module):
|
|
try:
|
|
module_filename = module.__file__
|
|
module_filename = module_filename.replace(".pyc", ".py")
|
|
|
|
if module_filename.endswith(".so"):
|
|
module_filename = os.path.join(
|
|
os.path.dirname(module_filename),
|
|
os.path.basename(module_filename).split(".")[0] + ".so",
|
|
)
|
|
|
|
file_desc = "file " + _normalizePath(module_filename).replace(".pyc", ".py")
|
|
except AttributeError:
|
|
file_desc = "built-in"
|
|
|
|
return "<module %s %s>" % (module.__name__, file_desc)
|
|
|
|
|
|
do_normalize_paths = None
|
|
do_show_source = None
|
|
|
|
|
|
def _our_import(
|
|
name,
|
|
globals=None, # pylint: disable=redefined-builtin
|
|
locals=None, # pylint: disable=redefined-builtin
|
|
fromlist=None,
|
|
level=-1 if sys.version_info[0] < 3 else 0,
|
|
):
|
|
builtins.__import__ = original_import
|
|
|
|
# Singleton, pylint: disable=global-statement
|
|
global _indentation
|
|
try:
|
|
_indentation += 1
|
|
|
|
print(
|
|
_indentation * " "
|
|
+ "called with: name=%r level=%d fromlist=%s" % (name, level, fromlist)
|
|
)
|
|
|
|
for entry in traceback.extract_stack()[:-1]:
|
|
if entry[2] == "_our_import":
|
|
print(_indentation * " " + "by __import__")
|
|
else:
|
|
entry = list(entry)
|
|
|
|
if not do_show_source:
|
|
del entry[-1]
|
|
del entry[-1]
|
|
|
|
if do_normalize_paths:
|
|
entry[0] = _normalizePath(entry[0])
|
|
|
|
if entry[0].startswith("<frozen importlib._bootstrap"):
|
|
continue
|
|
|
|
print(_indentation * " " + "by " + "|".join(str(s) for s in entry))
|
|
|
|
print(_indentation * " " + "*" * 40)
|
|
|
|
builtins.__import__ = _our_import
|
|
try:
|
|
result = original_import(name, globals, locals, fromlist, level)
|
|
except ImportError as e:
|
|
print(_indentation * " " + "EXCEPTION:", e)
|
|
raise
|
|
finally:
|
|
builtins.__import__ = original_import
|
|
|
|
print(_indentation * " " + "RESULT:", _moduleRepr(result))
|
|
print(_indentation * " " + "*" * 40)
|
|
|
|
builtins.__import__ = _our_import
|
|
|
|
return result
|
|
finally:
|
|
_indentation -= 1
|
|
|
|
|
|
_our_import_reference = None
|
|
|
|
|
|
def enableImportTracing(normalize_paths=True, show_source=False):
|
|
# Remember these settings for the import replacement, pylint: disable=global-statement
|
|
global do_normalize_paths, do_show_source
|
|
|
|
do_normalize_paths = normalize_paths
|
|
do_show_source = show_source
|
|
|
|
builtins.__import__ = _our_import
|
|
|
|
# Since we swap this around, prevent it from releasing by giving it a global
|
|
# name too, not only a local one, pylint: disable=global-statement
|
|
global _our_import_reference
|
|
_our_import_reference = _our_import
|
|
|
|
|
|
# Part of "Nuitka", an optimizing Python compiler that is compatible and
|
|
# integrates with CPython, but also works on its own.
|
|
#
|
|
# Licensed under the GNU Affero General Public License, Version 3 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# https://www.gnu.org/licenses/agpl-3.0.txt
|
|
#
|
|
# See also: "Nuitka Runtime Library Exception, Version 1.0" in file
|
|
# "LICENSE-RUNTIME.txt" for additional permissions granted under Section 7.
|
|
#
|
|
# 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.
|