1996-05-28 22:30:17 +00:00
|
|
|
|
2021-08-30 23:25:11 +00:00
|
|
|
/* Frozen modules initializer
|
|
|
|
*
|
|
|
|
* Frozen modules are written to header files by Programs/_freeze_module.
|
|
|
|
* These files are typically put in Python/frozen_modules/. Each holds
|
|
|
|
* an array of bytes named "_Py_M__<module>", which is used below.
|
|
|
|
*
|
|
|
|
* These files must be regenerated any time the corresponding .pyc
|
|
|
|
* file would change (including with changes to the compiler, bytecode
|
|
|
|
* format, marshal format). This can be done with "make regen-frozen".
|
2022-10-17 10:01:00 +00:00
|
|
|
* That make target just runs Tools/build/freeze_modules.py.
|
2021-08-30 23:25:11 +00:00
|
|
|
*
|
|
|
|
* The freeze_modules.py script also determines which modules get
|
|
|
|
* frozen. Update the list at the top of the script to add, remove,
|
|
|
|
* or modify the target modules. Then run the script
|
|
|
|
* (or run "make regen-frozen").
|
|
|
|
*
|
|
|
|
* The script does the following:
|
|
|
|
*
|
|
|
|
* 1. run Programs/_freeze_module on the target modules
|
|
|
|
* 2. update the includes and _PyImport_FrozenModules[] in this file
|
|
|
|
* 3. update the FROZEN_FILES variable in Makefile.pre.in
|
|
|
|
* 4. update the per-module targets in Makefile.pre.in
|
|
|
|
* 5. update the lists of modules in PCbuild/_freeze_module.vcxproj and
|
|
|
|
* PCbuild/_freeze_module.vcxproj.filters
|
|
|
|
*
|
|
|
|
* (Note that most of the data in this file is auto-generated by the script.)
|
|
|
|
*
|
|
|
|
* Those steps can also be done manually, though this is not recommended.
|
|
|
|
* Expect such manual changes to be removed the next time
|
|
|
|
* freeze_modules.py runs.
|
|
|
|
* */
|
1996-05-28 22:30:17 +00:00
|
|
|
|
1995-08-04 04:20:48 +00:00
|
|
|
/* In order to test the support for frozen modules, by default we
|
2021-08-30 23:25:11 +00:00
|
|
|
define some simple frozen modules: __hello__, __phello__ (a package),
|
|
|
|
and __phello__.spam. Loading any will print some famous words... */
|
1995-08-04 04:20:48 +00:00
|
|
|
|
2021-08-30 23:25:11 +00:00
|
|
|
#include "Python.h"
|
2021-10-05 17:26:37 +00:00
|
|
|
#include "pycore_import.h"
|
1995-08-04 04:20:48 +00:00
|
|
|
|
2022-02-25 08:25:54 +00:00
|
|
|
#include <stdbool.h>
|
|
|
|
|
2021-08-30 23:25:11 +00:00
|
|
|
/* Includes for frozen modules: */
|
2023-04-24 21:48:05 +00:00
|
|
|
#include "frozen_modules/importlib._bootstrap.h"
|
|
|
|
#include "frozen_modules/importlib._bootstrap_external.h"
|
|
|
|
#include "frozen_modules/zipimport.h"
|
|
|
|
#include "frozen_modules/abc.h"
|
|
|
|
#include "frozen_modules/codecs.h"
|
|
|
|
#include "frozen_modules/io.h"
|
|
|
|
#include "frozen_modules/_collections_abc.h"
|
|
|
|
#include "frozen_modules/_sitebuiltins.h"
|
|
|
|
#include "frozen_modules/genericpath.h"
|
|
|
|
#include "frozen_modules/ntpath.h"
|
|
|
|
#include "frozen_modules/posixpath.h"
|
|
|
|
#include "frozen_modules/os.h"
|
|
|
|
#include "frozen_modules/site.h"
|
|
|
|
#include "frozen_modules/stat.h"
|
|
|
|
#include "frozen_modules/importlib.util.h"
|
|
|
|
#include "frozen_modules/importlib.machinery.h"
|
|
|
|
#include "frozen_modules/runpy.h"
|
|
|
|
#include "frozen_modules/__hello__.h"
|
|
|
|
#include "frozen_modules/__phello__.h"
|
|
|
|
#include "frozen_modules/__phello__.ham.h"
|
|
|
|
#include "frozen_modules/__phello__.ham.eggs.h"
|
|
|
|
#include "frozen_modules/__phello__.spam.h"
|
|
|
|
#include "frozen_modules/frozen_only.h"
|
2021-08-30 23:25:11 +00:00
|
|
|
/* End includes */
|
|
|
|
|
2021-10-28 21:04:33 +00:00
|
|
|
static const struct _frozen bootstrap_modules[] = {
|
2023-09-08 09:34:40 +00:00
|
|
|
{"_frozen_importlib", _Py_M__importlib__bootstrap, (int)sizeof(_Py_M__importlib__bootstrap), false},
|
|
|
|
{"_frozen_importlib_external", _Py_M__importlib__bootstrap_external, (int)sizeof(_Py_M__importlib__bootstrap_external), false},
|
|
|
|
{"zipimport", _Py_M__zipimport, (int)sizeof(_Py_M__zipimport), false},
|
2021-10-28 21:04:33 +00:00
|
|
|
{0, 0, 0} /* bootstrap sentinel */
|
|
|
|
};
|
|
|
|
static const struct _frozen stdlib_modules[] = {
|
2021-09-17 22:31:31 +00:00
|
|
|
/* stdlib - startup, without site (python -S) */
|
2023-09-08 09:34:40 +00:00
|
|
|
{"abc", _Py_M__abc, (int)sizeof(_Py_M__abc), false},
|
|
|
|
{"codecs", _Py_M__codecs, (int)sizeof(_Py_M__codecs), false},
|
|
|
|
{"io", _Py_M__io, (int)sizeof(_Py_M__io), false},
|
2021-09-17 22:31:31 +00:00
|
|
|
|
|
|
|
/* stdlib - startup, with site */
|
2023-09-08 09:34:40 +00:00
|
|
|
{"_collections_abc", _Py_M___collections_abc, (int)sizeof(_Py_M___collections_abc), false},
|
|
|
|
{"_sitebuiltins", _Py_M___sitebuiltins, (int)sizeof(_Py_M___sitebuiltins), false},
|
|
|
|
{"genericpath", _Py_M__genericpath, (int)sizeof(_Py_M__genericpath), false},
|
|
|
|
{"ntpath", _Py_M__ntpath, (int)sizeof(_Py_M__ntpath), false},
|
|
|
|
{"posixpath", _Py_M__posixpath, (int)sizeof(_Py_M__posixpath), false},
|
|
|
|
{"os.path", _Py_M__posixpath, (int)sizeof(_Py_M__posixpath), false},
|
|
|
|
{"os", _Py_M__os, (int)sizeof(_Py_M__os), false},
|
|
|
|
{"site", _Py_M__site, (int)sizeof(_Py_M__site), false},
|
|
|
|
{"stat", _Py_M__stat, (int)sizeof(_Py_M__stat), false},
|
2021-12-09 16:51:09 +00:00
|
|
|
|
|
|
|
/* runpy - run module with -m */
|
2023-09-08 09:34:40 +00:00
|
|
|
{"importlib.util", _Py_M__importlib_util, (int)sizeof(_Py_M__importlib_util), false},
|
|
|
|
{"importlib.machinery", _Py_M__importlib_machinery, (int)sizeof(_Py_M__importlib_machinery), false},
|
|
|
|
{"runpy", _Py_M__runpy, (int)sizeof(_Py_M__runpy), false},
|
2021-10-28 21:04:33 +00:00
|
|
|
{0, 0, 0} /* stdlib sentinel */
|
|
|
|
};
|
|
|
|
static const struct _frozen test_modules[] = {
|
2023-09-08 09:34:40 +00:00
|
|
|
{"__hello__", _Py_M____hello__, (int)sizeof(_Py_M____hello__), false},
|
|
|
|
{"__hello_alias__", _Py_M____hello__, (int)sizeof(_Py_M____hello__), false},
|
|
|
|
{"__phello_alias__", _Py_M____hello__, (int)sizeof(_Py_M____hello__), true},
|
|
|
|
{"__phello_alias__.spam", _Py_M____hello__, (int)sizeof(_Py_M____hello__), false},
|
|
|
|
{"__phello__", _Py_M____phello__, (int)sizeof(_Py_M____phello__), true},
|
|
|
|
{"__phello__.__init__", _Py_M____phello__, (int)sizeof(_Py_M____phello__), false},
|
|
|
|
{"__phello__.ham", _Py_M____phello___ham, (int)sizeof(_Py_M____phello___ham), true},
|
|
|
|
{"__phello__.ham.__init__", _Py_M____phello___ham, (int)sizeof(_Py_M____phello___ham), false},
|
|
|
|
{"__phello__.ham.eggs", _Py_M____phello___ham_eggs, (int)sizeof(_Py_M____phello___ham_eggs), false},
|
|
|
|
{"__phello__.spam", _Py_M____phello___spam, (int)sizeof(_Py_M____phello___spam), false},
|
|
|
|
{"__hello_only__", _Py_M__frozen_only, (int)sizeof(_Py_M__frozen_only), false},
|
2021-10-28 21:04:33 +00:00
|
|
|
{0, 0, 0} /* test sentinel */
|
1995-08-04 04:20:48 +00:00
|
|
|
};
|
2021-10-28 21:04:33 +00:00
|
|
|
const struct _frozen *_PyImport_FrozenBootstrap = bootstrap_modules;
|
|
|
|
const struct _frozen *_PyImport_FrozenStdlib = stdlib_modules;
|
|
|
|
const struct _frozen *_PyImport_FrozenTest = test_modules;
|
1996-06-17 17:07:23 +00:00
|
|
|
|
2021-10-05 17:26:37 +00:00
|
|
|
static const struct _module_alias aliases[] = {
|
|
|
|
{"_frozen_importlib", "importlib._bootstrap"},
|
|
|
|
{"_frozen_importlib_external", "importlib._bootstrap_external"},
|
|
|
|
{"os.path", "posixpath"},
|
|
|
|
{"__hello_alias__", "__hello__"},
|
|
|
|
{"__phello_alias__", "__hello__"},
|
|
|
|
{"__phello_alias__.spam", "__hello__"},
|
|
|
|
{"__phello__.__init__", "<__phello__"},
|
|
|
|
{"__phello__.ham.__init__", "<__phello__.ham"},
|
|
|
|
{"__hello_only__", NULL},
|
|
|
|
{0, 0} /* aliases sentinel */
|
|
|
|
};
|
|
|
|
const struct _module_alias *_PyImport_FrozenAliases = aliases;
|
|
|
|
|
|
|
|
|
1996-06-17 17:07:23 +00:00
|
|
|
/* Embedding apps may change this pointer to point to their favorite
|
|
|
|
collection of frozen modules: */
|
|
|
|
|
2021-10-28 21:04:33 +00:00
|
|
|
const struct _frozen *PyImport_FrozenModules = NULL;
|