unfreezing.h

//     Copyright 2026, Kay Hayen, mailto:kay.hayen@gmail.com find license text at end of file
 
#ifndef __NUITKA_UNFREEZING_H__
#define __NUITKA_UNFREEZING_H__
 
#include <stdbool.h>
 
/* Modes for loading modules, can be compiled, external shared library, or
 * bytecode. */
#define NUITKA_COMPILED_MODULE 0
#define NUITKA_EXTENSION_MODULE_FLAG 1
#define NUITKA_PACKAGE_FLAG 2
#define NUITKA_BYTECODE_FLAG 4
 
#define NUITKA_ABORT_MODULE_FLAG 8
 
#define NUITKA_TRANSLATED_FLAG 16
 
#define NUITKA_PERFECT_SUPPORTED_FLAG 32
 
#if _NUITKA_STANDALONE_MODE && !defined(_NUITKA_DEPLOYMENT_MODE) &&                                                    \
    !defined(_NUITKA_NO_DEPLOYMENT_EXCLUDED_MODULE_USAGE)
#define NUITKA_EXCLUDED_MODULE_FLAG 64
#endif
 
struct Nuitka_MetaPathBasedLoaderEntry;
 
typedef PyObject *(*module_init_func)(PyThreadState *tstate, PyObject *module,
                                      struct Nuitka_MetaPathBasedLoaderEntry const *loader_entry);
 
#if PYTHON_VERSION >= 0x370 && _NUITKA_EXE_MODE && !_NUITKA_STANDALONE_MODE &&                                         \
    defined(_NUITKA_FILE_REFERENCE_ORIGINAL_MODE)
#define _NUITKA_FREEZER_HAS_FILE_PATH
#endif
 
struct Nuitka_MetaPathBasedLoaderEntry {
    // Full module name, including package name.
    char const *name;
 
#if _NUITKA_MODULE_MODE
    // Runtime module name, updated to match what package we are loaded into.
    char const *compilation_name;
#endif
 
    // Entry function if compiled module, otherwise NULL.
    module_init_func python_init_func;
 
    // For bytecode modules, start and size inside the constants blob.
    int bytecode_index;
    int bytecode_size;
 
    // Flags: Indicators if this is compiled, bytecode or shared library.
    int flags;
 
    // For accelerated mode, we need to be able to tell where the module "__file__"
    // lives, so we can resolve resource reader paths, not relative to the binary
    // but to code location without loading it.
#if defined(_NUITKA_FREEZER_HAS_FILE_PATH)
#if defined _WIN32
    wchar_t const *file_path;
#else
    char const *file_path;
#endif
#endif
};
 
/* For embedded modules, register the meta path based loader. Used by main
 * program/package only.
 */
extern void registerMetaPathBasedLoader(struct Nuitka_MetaPathBasedLoaderEntry *loader_entries,
                                        unsigned char **bytecode_data);
 
// For module mode, embedded modules may have to be shifted to below the
// namespace they are loaded into.
#if _NUITKA_MODULE_MODE
extern void updateMetaPathBasedLoaderModuleRoot(char const *module_root_name);
#endif
 
/* Create a loader object responsible for a package. */
extern PyObject *Nuitka_Loader_New(struct Nuitka_MetaPathBasedLoaderEntry const *entry);
 
// Create a distribution object from the given metadata.
extern PyObject *Nuitka_Distribution_New(PyThreadState *tstate, PyObject *name);
 
// Check if we provide a distribution object ourselves.
extern bool Nuitka_DistributionNext(Py_ssize_t *pos, PyObject **distribution_name_ptr);
 
#endif
 
//     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
//
//        http://www.gnu.org/licenses/agpl.txt
//
//     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.