blob: 236a68d6ba2cb90dc8d02341658ef1b63499654a [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002/* Module definition and import implementation */
3
Guido van Rossum79f25d91997-04-29 20:08:16 +00004#include "Python.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00005
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00006#include "node.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00007#include "token.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00008#include "errcode.h"
Guido van Rossumc405b7b1991-06-04 19:39:42 +00009#include "marshal.h"
10#include "compile.h"
Guido van Rossumff4949e1992-08-05 19:58:53 +000011#include "eval.h"
Guido van Rossumd8bac6d1992-02-26 15:19:13 +000012#include "osdefs.h"
Guido van Rossum1ae940a1995-01-02 19:04:15 +000013#include "importdl.h"
Jack Jansen9c96a921995-02-15 22:57:06 +000014#ifdef macintosh
15#include "macglue.h"
16#endif
Guido van Rossumc405b7b1991-06-04 19:39:42 +000017
Guido van Rossum80bb9651996-12-05 23:27:02 +000018#ifdef HAVE_UNISTD_H
19#include <unistd.h>
20#endif
21
Guido van Rossum55a83382000-09-20 20:31:38 +000022#ifdef HAVE_FCNTL_H
23#include <fcntl.h>
24#endif
25
Guido van Rossum595d7ba1997-12-05 21:45:29 +000026#if defined(PYCC_VACPP)
27/* VisualAge C/C++ Failed to Define MountType Field in sys/stat.h */
28#define S_IFMT (S_IFDIR|S_IFCHR|S_IFREG)
29#endif
30
Guido van Rossumaee0bad1997-09-05 07:33:22 +000031#ifndef S_ISDIR
32#define S_ISDIR(mode) (((mode) & S_IFMT) == S_IFDIR)
33#endif
34
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000035extern time_t PyOS_GetLastModificationTime(char *, FILE *);
36 /* In getmtime.c */
Guido van Rossum21d335e1993-10-15 13:01:11 +000037
Guido van Rossum6c849691994-09-26 15:47:17 +000038/* Magic word to reject .pyc files generated by other Python versions */
Guido van Rossum7faeab31995-07-07 22:50:36 +000039/* Change for each incompatible change */
40/* The value of CR and LF is incorporated so if you ever read or write
41 a .pyc file in text mode the magic number will be wrong; also, the
42 Apple MPW compiler swaps their values, botching string constants */
43/* XXX Perhaps the magic number should be frozen and a version field
44 added to the .pyc file header? */
Guido van Rossumdd5db431997-01-17 21:06:11 +000045/* New way to come up with the magic number: (YEAR-1995), MONTH, DAY */
Jeremy Hyltonb1cbc1e2001-02-02 20:13:24 +000046#define MAGIC (60202 | ((long)'\r'<<16) | ((long)'\n'<<24))
Guido van Rossum3ddee711991-12-16 13:06:34 +000047
Guido van Rossum96774c12000-05-01 20:19:08 +000048/* Magic word as global; note that _PyImport_Init() can change the
Jeremy Hylton9262b8a2000-06-30 04:59:17 +000049 value of this global to accommodate for alterations of how the
Guido van Rossum96774c12000-05-01 20:19:08 +000050 compiler works which are enabled by command line switches. */
51static long pyc_magic = MAGIC;
52
Guido van Rossum25ce5661997-08-02 03:10:38 +000053/* See _PyImport_FixupExtension() below */
54static PyObject *extensions = NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +000055
Guido van Rossum771c6c81997-10-31 18:37:24 +000056/* This table is defined in config.c: */
57extern struct _inittab _PyImport_Inittab[];
58
59struct _inittab *PyImport_Inittab = _PyImport_Inittab;
Guido van Rossum66f1fa81991-04-03 19:03:52 +000060
Guido van Rossumed1170e1999-12-20 21:23:41 +000061/* these tables define the module suffixes that Python recognizes */
62struct filedescr * _PyImport_Filetab = NULL;
63static const struct filedescr _PyImport_StandardFiletab[] = {
64 {".py", "r", PY_SOURCE},
65 {".pyc", "rb", PY_COMPILED},
66 {0, 0}
67};
68
Guido van Rossum1ae940a1995-01-02 19:04:15 +000069/* Initialize things */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000070
71void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000072_PyImport_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000073{
Guido van Rossumed1170e1999-12-20 21:23:41 +000074 const struct filedescr *scan;
75 struct filedescr *filetab;
76 int countD = 0;
77 int countS = 0;
78
79 /* prepare _PyImport_Filetab: copy entries from
80 _PyImport_DynLoadFiletab and _PyImport_StandardFiletab.
81 */
82 for (scan = _PyImport_DynLoadFiletab; scan->suffix != NULL; ++scan)
83 ++countD;
84 for (scan = _PyImport_StandardFiletab; scan->suffix != NULL; ++scan)
85 ++countS;
Guido van Rossumb18618d2000-05-03 23:44:39 +000086 filetab = PyMem_NEW(struct filedescr, countD + countS + 1);
Guido van Rossumed1170e1999-12-20 21:23:41 +000087 memcpy(filetab, _PyImport_DynLoadFiletab,
88 countD * sizeof(struct filedescr));
89 memcpy(filetab + countD, _PyImport_StandardFiletab,
90 countS * sizeof(struct filedescr));
91 filetab[countD + countS].suffix = NULL;
92
93 _PyImport_Filetab = filetab;
94
Guido van Rossum0824f631997-03-11 18:37:35 +000095 if (Py_OptimizeFlag) {
Guido van Rossumed1170e1999-12-20 21:23:41 +000096 /* Replace ".pyc" with ".pyo" in _PyImport_Filetab */
97 for (; filetab->suffix != NULL; filetab++) {
98 if (strcmp(filetab->suffix, ".pyc") == 0)
99 filetab->suffix = ".pyo";
Guido van Rossum0824f631997-03-11 18:37:35 +0000100 }
101 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000102
103 if (Py_UnicodeFlag) {
104 /* Fix the pyc_magic so that byte compiled code created
105 using the all-Unicode method doesn't interfere with
106 code created in normal operation mode. */
107 pyc_magic = MAGIC + 1;
108 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000109}
110
Guido van Rossum25ce5661997-08-02 03:10:38 +0000111void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000112_PyImport_Fini(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000113{
114 Py_XDECREF(extensions);
115 extensions = NULL;
Barry Warsaw84294482000-10-03 16:02:05 +0000116 PyMem_DEL(_PyImport_Filetab);
117 _PyImport_Filetab = NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000118}
119
120
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000121/* Locking primitives to prevent parallel imports of the same module
122 in different threads to return with a partially loaded module.
123 These calls are serialized by the global interpreter lock. */
124
125#ifdef WITH_THREAD
126
Guido van Rossum49b56061998-10-01 20:42:43 +0000127#include "pythread.h"
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000128
Guido van Rossum65d5b571998-12-21 19:32:43 +0000129static PyThread_type_lock import_lock = 0;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000130static long import_lock_thread = -1;
131static int import_lock_level = 0;
132
133static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000134lock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000135{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000136 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000137 if (me == -1)
138 return; /* Too bad */
139 if (import_lock == NULL)
Guido van Rossum65d5b571998-12-21 19:32:43 +0000140 import_lock = PyThread_allocate_lock();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000141 if (import_lock_thread == me) {
142 import_lock_level++;
143 return;
144 }
Guido van Rossum65d5b571998-12-21 19:32:43 +0000145 if (import_lock_thread != -1 || !PyThread_acquire_lock(import_lock, 0)) {
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000146 PyThreadState *tstate = PyEval_SaveThread();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000147 PyThread_acquire_lock(import_lock, 1);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000148 PyEval_RestoreThread(tstate);
149 }
150 import_lock_thread = me;
151 import_lock_level = 1;
152}
153
154static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000155unlock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000156{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000157 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000158 if (me == -1)
159 return; /* Too bad */
160 if (import_lock_thread != me)
161 Py_FatalError("unlock_import: not holding the import lock");
162 import_lock_level--;
163 if (import_lock_level == 0) {
164 import_lock_thread = -1;
Guido van Rossum65d5b571998-12-21 19:32:43 +0000165 PyThread_release_lock(import_lock);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000166 }
167}
168
169#else
170
171#define lock_import()
172#define unlock_import()
173
174#endif
175
Guido van Rossum25ce5661997-08-02 03:10:38 +0000176/* Helper for sys */
177
178PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000179PyImport_GetModuleDict(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000180{
181 PyInterpreterState *interp = PyThreadState_Get()->interp;
182 if (interp->modules == NULL)
183 Py_FatalError("PyImport_GetModuleDict: no module dictionary!");
184 return interp->modules;
185}
186
Guido van Rossum3f5da241990-12-20 15:06:42 +0000187
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000188/* List of names to clear in sys */
189static char* sys_deletes[] = {
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000190 "path", "argv", "ps1", "ps2", "exitfunc",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000191 "exc_type", "exc_value", "exc_traceback",
192 "last_type", "last_value", "last_traceback",
193 NULL
194};
195
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000196static char* sys_files[] = {
197 "stdin", "__stdin__",
198 "stdout", "__stdout__",
199 "stderr", "__stderr__",
200 NULL
201};
202
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000203
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000204/* Un-initialize things, as good as we can */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000205
Guido van Rossum3f5da241990-12-20 15:06:42 +0000206void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000207PyImport_Cleanup(void)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000208{
Guido van Rossum758eec01998-01-19 21:58:26 +0000209 int pos, ndone;
210 char *name;
211 PyObject *key, *value, *dict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000212 PyInterpreterState *interp = PyThreadState_Get()->interp;
Guido van Rossum758eec01998-01-19 21:58:26 +0000213 PyObject *modules = interp->modules;
214
215 if (modules == NULL)
216 return; /* Already done */
217
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000218 /* Delete some special variables first. These are common
219 places where user values hide and people complain when their
220 destructors fail. Since the modules containing them are
221 deleted *last* of all, they would come too late in the normal
222 destruction order. Sigh. */
223
224 value = PyDict_GetItemString(modules, "__builtin__");
225 if (value != NULL && PyModule_Check(value)) {
226 dict = PyModule_GetDict(value);
227 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000228 PySys_WriteStderr("# clear __builtin__._\n");
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000229 PyDict_SetItemString(dict, "_", Py_None);
230 }
231 value = PyDict_GetItemString(modules, "sys");
232 if (value != NULL && PyModule_Check(value)) {
233 char **p;
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000234 PyObject *v;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000235 dict = PyModule_GetDict(value);
236 for (p = sys_deletes; *p != NULL; p++) {
237 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000238 PySys_WriteStderr("# clear sys.%s\n", *p);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000239 PyDict_SetItemString(dict, *p, Py_None);
240 }
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000241 for (p = sys_files; *p != NULL; p+=2) {
242 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000243 PySys_WriteStderr("# restore sys.%s\n", *p);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000244 v = PyDict_GetItemString(dict, *(p+1));
245 if (v == NULL)
246 v = Py_None;
247 PyDict_SetItemString(dict, *p, v);
248 }
249 }
250
251 /* First, delete __main__ */
252 value = PyDict_GetItemString(modules, "__main__");
253 if (value != NULL && PyModule_Check(value)) {
254 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000255 PySys_WriteStderr("# cleanup __main__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000256 _PyModule_Clear(value);
257 PyDict_SetItemString(modules, "__main__", Py_None);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000258 }
259
Guido van Rossum758eec01998-01-19 21:58:26 +0000260 /* The special treatment of __builtin__ here is because even
261 when it's not referenced as a module, its dictionary is
262 referenced by almost every module's __builtins__. Since
263 deleting a module clears its dictionary (even if there are
264 references left to it), we need to delete the __builtin__
265 module last. Likewise, we don't delete sys until the very
266 end because it is implicitly referenced (e.g. by print).
267
268 Also note that we 'delete' modules by replacing their entry
269 in the modules dict with None, rather than really deleting
270 them; this avoids a rehash of the modules dictionary and
271 also marks them as "non existent" so they won't be
272 re-imported. */
273
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000274 /* Next, repeatedly delete modules with a reference count of
Guido van Rossum758eec01998-01-19 21:58:26 +0000275 one (skipping __builtin__ and sys) and delete them */
276 do {
277 ndone = 0;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000278 pos = 0;
Guido van Rossum758eec01998-01-19 21:58:26 +0000279 while (PyDict_Next(modules, &pos, &key, &value)) {
280 if (value->ob_refcnt != 1)
281 continue;
Guido van Rossum566373e1998-10-01 15:24:50 +0000282 if (PyString_Check(key) && PyModule_Check(value)) {
283 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000284 if (strcmp(name, "__builtin__") == 0)
285 continue;
286 if (strcmp(name, "sys") == 0)
287 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000288 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000289 PySys_WriteStderr(
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000290 "# cleanup[1] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000291 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000292 PyDict_SetItem(modules, key, Py_None);
293 ndone++;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000294 }
295 }
Guido van Rossum758eec01998-01-19 21:58:26 +0000296 } while (ndone > 0);
297
Guido van Rossum758eec01998-01-19 21:58:26 +0000298 /* Next, delete all modules (still skipping __builtin__ and sys) */
299 pos = 0;
300 while (PyDict_Next(modules, &pos, &key, &value)) {
Guido van Rossum566373e1998-10-01 15:24:50 +0000301 if (PyString_Check(key) && PyModule_Check(value)) {
302 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000303 if (strcmp(name, "__builtin__") == 0)
304 continue;
305 if (strcmp(name, "sys") == 0)
306 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000307 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000308 PySys_WriteStderr("# cleanup[2] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000309 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000310 PyDict_SetItem(modules, key, Py_None);
311 }
312 }
313
314 /* Next, delete sys and __builtin__ (in that order) */
315 value = PyDict_GetItemString(modules, "sys");
316 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000317 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000318 PySys_WriteStderr("# cleanup sys\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000319 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000320 PyDict_SetItemString(modules, "sys", Py_None);
321 }
322 value = PyDict_GetItemString(modules, "__builtin__");
323 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000324 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000325 PySys_WriteStderr("# cleanup __builtin__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000326 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000327 PyDict_SetItemString(modules, "__builtin__", Py_None);
328 }
329
330 /* Finally, clear and delete the modules directory */
331 PyDict_Clear(modules);
332 interp->modules = NULL;
333 Py_DECREF(modules);
Guido van Rossum8d15b5d1990-10-26 14:58:58 +0000334}
Guido van Rossum7f133ed1991-02-19 12:23:57 +0000335
336
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000337/* Helper for pythonrun.c -- return magic number */
338
339long
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000340PyImport_GetMagicNumber(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000341{
Guido van Rossum96774c12000-05-01 20:19:08 +0000342 return pyc_magic;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000343}
344
345
Guido van Rossum25ce5661997-08-02 03:10:38 +0000346/* Magic for extension modules (built-in as well as dynamically
347 loaded). To prevent initializing an extension module more than
348 once, we keep a static dictionary 'extensions' keyed by module name
349 (for built-in modules) or by filename (for dynamically loaded
350 modules), containing these modules. A copy od the module's
351 dictionary is stored by calling _PyImport_FixupExtension()
352 immediately after the module initialization function succeeds. A
353 copy can be retrieved from there by calling
354 _PyImport_FindExtension(). */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000355
Guido van Rossum79f25d91997-04-29 20:08:16 +0000356PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000357_PyImport_FixupExtension(char *name, char *filename)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000358{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000359 PyObject *modules, *mod, *dict, *copy;
360 if (extensions == NULL) {
361 extensions = PyDict_New();
362 if (extensions == NULL)
363 return NULL;
364 }
365 modules = PyImport_GetModuleDict();
366 mod = PyDict_GetItemString(modules, name);
367 if (mod == NULL || !PyModule_Check(mod)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000368 PyErr_Format(PyExc_SystemError,
369 "_PyImport_FixupExtension: module %.200s not loaded", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000370 return NULL;
371 }
372 dict = PyModule_GetDict(mod);
373 if (dict == NULL)
374 return NULL;
375 copy = PyObject_CallMethod(dict, "copy", "");
376 if (copy == NULL)
377 return NULL;
378 PyDict_SetItemString(extensions, filename, copy);
379 Py_DECREF(copy);
380 return copy;
381}
382
383PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000384_PyImport_FindExtension(char *name, char *filename)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000385{
386 PyObject *dict, *mod, *mdict, *result;
387 if (extensions == NULL)
388 return NULL;
389 dict = PyDict_GetItemString(extensions, filename);
390 if (dict == NULL)
391 return NULL;
392 mod = PyImport_AddModule(name);
393 if (mod == NULL)
394 return NULL;
395 mdict = PyModule_GetDict(mod);
396 if (mdict == NULL)
397 return NULL;
398 result = PyObject_CallMethod(mdict, "update", "O", dict);
399 if (result == NULL)
400 return NULL;
401 Py_DECREF(result);
402 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000403 PySys_WriteStderr("import %s # previously loaded (%s)\n",
Guido van Rossum25ce5661997-08-02 03:10:38 +0000404 name, filename);
405 return mod;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000406}
407
408
409/* Get the module object corresponding to a module name.
410 First check the modules dictionary if there's one there,
411 if not, create a new one and insert in in the modules dictionary.
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000412 Because the former action is most common, THIS DOES NOT RETURN A
413 'NEW' REFERENCE! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000414
Guido van Rossum79f25d91997-04-29 20:08:16 +0000415PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000416PyImport_AddModule(char *name)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000417{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000418 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000419 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000420
Guido van Rossum25ce5661997-08-02 03:10:38 +0000421 if ((m = PyDict_GetItemString(modules, name)) != NULL &&
Guido van Rossum79f25d91997-04-29 20:08:16 +0000422 PyModule_Check(m))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000423 return m;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000424 m = PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000425 if (m == NULL)
426 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000427 if (PyDict_SetItemString(modules, name, m) != 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000428 Py_DECREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000429 return NULL;
430 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000431 Py_DECREF(m); /* Yes, it still exists, in modules! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000432
433 return m;
434}
435
436
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000437/* Execute a code object in a module and return the module object
438 WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000439
Guido van Rossum79f25d91997-04-29 20:08:16 +0000440PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000441PyImport_ExecCodeModule(char *name, PyObject *co)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000442{
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000443 return PyImport_ExecCodeModuleEx(name, co, (char *)NULL);
444}
445
446PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000447PyImport_ExecCodeModuleEx(char *name, PyObject *co, char *pathname)
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000448{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000449 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000450 PyObject *m, *d, *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000451
Guido van Rossum79f25d91997-04-29 20:08:16 +0000452 m = PyImport_AddModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000453 if (m == NULL)
454 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000455 d = PyModule_GetDict(m);
456 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
457 if (PyDict_SetItemString(d, "__builtins__",
458 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000459 return NULL;
460 }
Guido van Rossum9c9a07c1996-05-16 20:43:40 +0000461 /* Remember the filename as the __file__ attribute */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000462 v = NULL;
463 if (pathname != NULL) {
464 v = PyString_FromString(pathname);
465 if (v == NULL)
466 PyErr_Clear();
467 }
468 if (v == NULL) {
469 v = ((PyCodeObject *)co)->co_filename;
470 Py_INCREF(v);
471 }
472 if (PyDict_SetItemString(d, "__file__", v) != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000473 PyErr_Clear(); /* Not important enough to report */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000474 Py_DECREF(v);
475
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000476 v = PyEval_EvalCode((PyCodeObject *)co, d, d);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000477 if (v == NULL)
478 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000479 Py_DECREF(v);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000480
Guido van Rossum25ce5661997-08-02 03:10:38 +0000481 if ((m = PyDict_GetItemString(modules, name)) == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000482 PyErr_Format(PyExc_ImportError,
483 "Loaded module %.200s not found in sys.modules",
484 name);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000485 return NULL;
486 }
487
Guido van Rossum79f25d91997-04-29 20:08:16 +0000488 Py_INCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000489
490 return m;
491}
492
493
494/* Given a pathname for a Python source file, fill a buffer with the
495 pathname for the corresponding compiled file. Return the pathname
496 for the compiled file, or NULL if there's no space in the buffer.
497 Doesn't set an exception. */
498
499static char *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000500make_compiled_pathname(char *pathname, char *buf, size_t buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000501{
Fred Drake4c82b232000-06-30 16:18:57 +0000502 size_t len;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000503
504 len = strlen(pathname);
505 if (len+2 > buflen)
506 return NULL;
507 strcpy(buf, pathname);
Guido van Rossum0824f631997-03-11 18:37:35 +0000508 strcpy(buf+len, Py_OptimizeFlag ? "o" : "c");
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000509
510 return buf;
511}
512
513
514/* Given a pathname for a Python source file, its time of last
515 modification, and a pathname for a compiled file, check whether the
516 compiled file represents the same version of the source. If so,
517 return a FILE pointer for the compiled file, positioned just after
518 the header; if not, return NULL.
519 Doesn't set an exception. */
520
521static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000522check_compiled_module(char *pathname, long mtime, char *cpathname)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000523{
524 FILE *fp;
525 long magic;
526 long pyc_mtime;
527
528 fp = fopen(cpathname, "rb");
529 if (fp == NULL)
530 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000531 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000532 if (magic != pyc_magic) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000533 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000534 PySys_WriteStderr("# %s has bad magic\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000535 fclose(fp);
536 return NULL;
537 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000538 pyc_mtime = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000539 if (pyc_mtime != mtime) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000540 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000541 PySys_WriteStderr("# %s has bad mtime\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000542 fclose(fp);
543 return NULL;
544 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000545 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000546 PySys_WriteStderr("# %s matches %s\n", cpathname, pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000547 return fp;
548}
549
550
551/* Read a code object from a file and check it for validity */
552
Guido van Rossum79f25d91997-04-29 20:08:16 +0000553static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000554read_compiled_module(char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000555{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000556 PyObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000557
Tim Petersd9b9ac82001-01-28 00:27:39 +0000558 co = PyMarshal_ReadLastObjectFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000559 /* Ugly: rd_object() may return NULL with or without error */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000560 if (co == NULL || !PyCode_Check(co)) {
561 if (!PyErr_Occurred())
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000562 PyErr_Format(PyExc_ImportError,
563 "Non-code object in %.200s", cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000564 Py_XDECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000565 return NULL;
566 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000567 return (PyCodeObject *)co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000568}
569
570
571/* Load a module from a compiled file, execute it, and return its
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000572 module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000573
Guido van Rossum79f25d91997-04-29 20:08:16 +0000574static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000575load_compiled_module(char *name, char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000576{
577 long magic;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000578 PyCodeObject *co;
579 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000580
Guido van Rossum79f25d91997-04-29 20:08:16 +0000581 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000582 if (magic != pyc_magic) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000583 PyErr_Format(PyExc_ImportError,
584 "Bad magic number in %.200s", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000585 return NULL;
586 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000587 (void) PyMarshal_ReadLongFromFile(fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000588 co = read_compiled_module(cpathname, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000589 if (co == NULL)
590 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000591 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000592 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000593 name, cpathname);
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000594 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000595 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000596
597 return m;
598}
599
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000600/* Parse a source file and return the corresponding code object */
601
Guido van Rossum79f25d91997-04-29 20:08:16 +0000602static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000603parse_source_module(char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000604{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000605 PyCodeObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000606 node *n;
607
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000608 n = PyParser_SimpleParseFile(fp, pathname, Py_file_input);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000609 if (n == NULL)
610 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000611 co = PyNode_Compile(n, pathname);
612 PyNode_Free(n);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000613
614 return co;
615}
616
617
Guido van Rossum55a83382000-09-20 20:31:38 +0000618/* Helper to open a bytecode file for writing in exclusive mode */
619
620static FILE *
621open_exclusive(char *filename)
622{
623#if defined(O_EXCL)&&defined(O_CREAT)&&defined(O_WRONLY)&&defined(O_TRUNC)
624 /* Use O_EXCL to avoid a race condition when another process tries to
625 write the same file. When that happens, our open() call fails,
626 which is just fine (since it's only a cache).
627 XXX If the file exists and is writable but the directory is not
628 writable, the file will never be written. Oh well.
629 */
630 int fd;
631 (void) unlink(filename);
Tim Peters42c83af2000-09-29 04:03:10 +0000632 fd = open(filename, O_EXCL|O_CREAT|O_WRONLY|O_TRUNC
633#ifdef O_BINARY
634 |O_BINARY /* necessary for Windows */
635#endif
Tim Peters50d8d372001-02-28 05:34:27 +0000636
Tim Peters42c83af2000-09-29 04:03:10 +0000637 , 0666);
Guido van Rossum55a83382000-09-20 20:31:38 +0000638 if (fd < 0)
639 return NULL;
640 return fdopen(fd, "wb");
641#else
642 /* Best we can do -- on Windows this can't happen anyway */
643 return fopen(filename, "wb");
644#endif
645}
646
647
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000648/* Write a compiled module to a file, placing the time of last
649 modification of its source into the header.
650 Errors are ignored, if a write error occurs an attempt is made to
651 remove the file. */
652
653static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000654write_compiled_module(PyCodeObject *co, char *cpathname, long mtime)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000655{
656 FILE *fp;
657
Guido van Rossum55a83382000-09-20 20:31:38 +0000658 fp = open_exclusive(cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000659 if (fp == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000660 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000661 PySys_WriteStderr(
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000662 "# can't create %s\n", cpathname);
663 return;
664 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000665 PyMarshal_WriteLongToFile(pyc_magic, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000666 /* First write a 0 for mtime */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000667 PyMarshal_WriteLongToFile(0L, fp);
668 PyMarshal_WriteObjectToFile((PyObject *)co, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000669 if (ferror(fp)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000670 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000671 PySys_WriteStderr("# can't write %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000672 /* Don't keep partial file */
673 fclose(fp);
674 (void) unlink(cpathname);
675 return;
676 }
677 /* Now write the true mtime */
678 fseek(fp, 4L, 0);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000679 PyMarshal_WriteLongToFile(mtime, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000680 fflush(fp);
681 fclose(fp);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000682 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000683 PySys_WriteStderr("# wrote %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000684#ifdef macintosh
Jack Jansencbf630f2000-07-11 21:59:16 +0000685 PyMac_setfiletype(cpathname, 'Pyth', 'PYC ');
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000686#endif
687}
688
689
690/* Load a source module from a given file and return its module
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000691 object WITH INCREMENTED REFERENCE COUNT. If there's a matching
692 byte-compiled file, use that instead. */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000693
Guido van Rossum79f25d91997-04-29 20:08:16 +0000694static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000695load_source_module(char *name, char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000696{
Fred Drake4c82b232000-06-30 16:18:57 +0000697 time_t mtime;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000698 FILE *fpc;
699 char buf[MAXPATHLEN+1];
700 char *cpathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000701 PyCodeObject *co;
702 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000703
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000704 mtime = PyOS_GetLastModificationTime(pathname, fp);
Fred Drake4c82b232000-06-30 16:18:57 +0000705 if (mtime == -1)
706 return NULL;
707#if SIZEOF_TIME_T > 4
708 /* Python's .pyc timestamp handling presumes that the timestamp fits
709 in 4 bytes. This will be fine until sometime in the year 2038,
710 when a 4-byte signed time_t will overflow.
711 */
712 if (mtime >> 32) {
713 PyErr_SetString(PyExc_OverflowError,
714 "modification time overflows a 4 bytes");
715 return NULL;
716 }
717#endif
718 cpathname = make_compiled_pathname(pathname, buf, (size_t)MAXPATHLEN+1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000719 if (cpathname != NULL &&
720 (fpc = check_compiled_module(pathname, mtime, cpathname))) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000721 co = read_compiled_module(cpathname, fpc);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000722 fclose(fpc);
723 if (co == NULL)
724 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000725 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000726 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000727 name, cpathname);
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000728 pathname = cpathname;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000729 }
730 else {
731 co = parse_source_module(pathname, fp);
732 if (co == NULL)
733 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000734 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000735 PySys_WriteStderr("import %s # from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000736 name, pathname);
737 write_compiled_module(co, cpathname, mtime);
738 }
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000739 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, pathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000740 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000741
742 return m;
743}
744
745
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000746/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000747static PyObject *load_module(char *, FILE *, char *, int);
748static struct filedescr *find_module(char *, PyObject *,
749 char *, size_t, FILE **);
750static struct _frozen *find_frozen(char *name);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000751
752/* Load a package and return its module object WITH INCREMENTED
753 REFERENCE COUNT */
754
755static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000756load_package(char *name, char *pathname)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000757{
758 PyObject *m, *d, *file, *path;
759 int err;
760 char buf[MAXPATHLEN+1];
761 FILE *fp = NULL;
762 struct filedescr *fdp;
763
764 m = PyImport_AddModule(name);
765 if (m == NULL)
766 return NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000767 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000768 PySys_WriteStderr("import %s # directory %s\n",
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000769 name, pathname);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000770 d = PyModule_GetDict(m);
771 file = PyString_FromString(pathname);
772 if (file == NULL)
773 return NULL;
774 path = Py_BuildValue("[O]", file);
775 if (path == NULL) {
776 Py_DECREF(file);
777 return NULL;
778 }
779 err = PyDict_SetItemString(d, "__file__", file);
780 if (err == 0)
781 err = PyDict_SetItemString(d, "__path__", path);
782 if (err != 0) {
783 m = NULL;
784 goto cleanup;
785 }
786 buf[0] = '\0';
787 fdp = find_module("__init__", path, buf, sizeof(buf), &fp);
788 if (fdp == NULL) {
789 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
790 PyErr_Clear();
791 }
792 else
793 m = NULL;
794 goto cleanup;
795 }
796 m = load_module(name, fp, buf, fdp->type);
797 if (fp != NULL)
798 fclose(fp);
799 cleanup:
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000800 Py_XDECREF(path);
801 Py_XDECREF(file);
802 return m;
803}
804
805
806/* Helper to test for built-in module */
807
808static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000809is_builtin(char *name)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000810{
811 int i;
Guido van Rossum771c6c81997-10-31 18:37:24 +0000812 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
813 if (strcmp(name, PyImport_Inittab[i].name) == 0) {
814 if (PyImport_Inittab[i].initfunc == NULL)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000815 return -1;
816 else
817 return 1;
818 }
819 }
820 return 0;
821}
822
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000823
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000824/* Search the path (default sys.path) for a module. Return the
825 corresponding filedescr struct, and (via return arguments) the
826 pathname and an open file. Return NULL if the module is not found. */
827
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000828#ifdef MS_COREDLL
Thomas Woutersb4bd21c2000-07-22 23:38:01 +0000829extern FILE *PyWin_FindRegisteredModule(const char *, struct filedescr **,
830 char *, int);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000831#endif
832
Tim Peters50d8d372001-02-28 05:34:27 +0000833static int case_ok(char *, int, int, char *);
Tim Petersdbd9ba62000-07-09 03:09:57 +0000834static int find_init_module(char *); /* Forward */
Guido van Rossum197346f1997-10-31 18:38:52 +0000835
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000836static struct filedescr *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000837find_module(char *realname, PyObject *path, char *buf, size_t buflen,
838 FILE **p_fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000839{
Fred Drake4c82b232000-06-30 16:18:57 +0000840 int i, npath;
841 size_t len, namelen;
Guido van Rossuma5568d31998-03-05 03:45:08 +0000842 struct _frozen *f;
Guido van Rossum80bb9651996-12-05 23:27:02 +0000843 struct filedescr *fdp = NULL;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +0000844 FILE *fp = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000845 struct stat statbuf;
Guido van Rossuma5568d31998-03-05 03:45:08 +0000846 static struct filedescr fd_frozen = {"", "", PY_FROZEN};
847 static struct filedescr fd_builtin = {"", "", C_BUILTIN};
848 static struct filedescr fd_package = {"", "", PKG_DIRECTORY};
Guido van Rossum0506a431998-08-11 15:07:39 +0000849 char name[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000850
Fred Drake4c82b232000-06-30 16:18:57 +0000851 if (strlen(realname) > MAXPATHLEN) {
852 PyErr_SetString(PyExc_OverflowError, "module name is too long");
853 return NULL;
854 }
Guido van Rossum0506a431998-08-11 15:07:39 +0000855 strcpy(name, realname);
856
857 if (path != NULL && PyString_Check(path)) {
858 /* Submodule of "frozen" package:
859 Set name to the fullname, path to NULL
860 and continue as "usual" */
861 if (PyString_Size(path) + 1 + strlen(name) >= (size_t)buflen) {
862 PyErr_SetString(PyExc_ImportError,
863 "full frozen module name too long");
864 return NULL;
865 }
866 strcpy(buf, PyString_AsString(path));
867 strcat(buf, ".");
868 strcat(buf, name);
869 strcpy(name, buf);
870 path = NULL;
871 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000872 if (path == NULL) {
873 if (is_builtin(name)) {
Guido van Rossuma5568d31998-03-05 03:45:08 +0000874 strcpy(buf, name);
875 return &fd_builtin;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000876 }
Guido van Rossuma5568d31998-03-05 03:45:08 +0000877 if ((f = find_frozen(name)) != NULL) {
878 strcpy(buf, name);
879 return &fd_frozen;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000880 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000881
Guido van Rossumac279101996-08-22 23:10:58 +0000882#ifdef MS_COREDLL
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000883 fp = PyWin_FindRegisteredModule(name, &fdp, buf, buflen);
884 if (fp != NULL) {
885 *p_fp = fp;
886 return fdp;
887 }
Guido van Rossuma5a3db71996-04-09 02:39:59 +0000888#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +0000889 path = PySys_GetObject("path");
890 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000891 if (path == NULL || !PyList_Check(path)) {
892 PyErr_SetString(PyExc_ImportError,
Guido van Rossuma5568d31998-03-05 03:45:08 +0000893 "sys.path must be a list of directory names");
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000894 return NULL;
895 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000896 npath = PyList_Size(path);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000897 namelen = strlen(name);
898 for (i = 0; i < npath; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000899 PyObject *v = PyList_GetItem(path, i);
900 if (!PyString_Check(v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000901 continue;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000902 len = PyString_Size(v);
Guido van Rossumef3d02e1997-07-21 14:54:36 +0000903 if (len + 2 + namelen + MAXSUFFIXSIZE >= buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000904 continue; /* Too long */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000905 strcpy(buf, PyString_AsString(v));
Fred Drake4c82b232000-06-30 16:18:57 +0000906 if (strlen(buf) != len)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000907 continue; /* v contains '\0' */
Jack Jansen9c96a921995-02-15 22:57:06 +0000908#ifdef macintosh
Guido van Rossum741689d1997-08-12 14:53:39 +0000909#ifdef INTERN_STRINGS
Tim Peters50d8d372001-02-28 05:34:27 +0000910 /*
Guido van Rossum741689d1997-08-12 14:53:39 +0000911 ** Speedup: each sys.path item is interned, and
912 ** FindResourceModule remembers which items refer to
913 ** folders (so we don't have to bother trying to look
Tim Peters50d8d372001-02-28 05:34:27 +0000914 ** into them for resources).
Guido van Rossum741689d1997-08-12 14:53:39 +0000915 */
916 PyString_InternInPlace(&PyList_GET_ITEM(path, i));
917 v = PyList_GET_ITEM(path, i);
918#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000919 if (PyMac_FindResourceModule((PyStringObject *)v, name, buf)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000920 static struct filedescr resfiledescr =
921 {"", "", PY_RESOURCE};
Tim Peters50d8d372001-02-28 05:34:27 +0000922
Jack Jansen9c96a921995-02-15 22:57:06 +0000923 return &resfiledescr;
924 }
Guido van Rossum0f84a341998-08-06 13:36:01 +0000925 if (PyMac_FindCodeResourceModule((PyStringObject *)v, name, buf)) {
926 static struct filedescr resfiledescr =
927 {"", "", PY_CODERESOURCE};
Tim Peters50d8d372001-02-28 05:34:27 +0000928
Guido van Rossum0f84a341998-08-06 13:36:01 +0000929 return &resfiledescr;
930 }
Jack Jansen9c96a921995-02-15 22:57:06 +0000931#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000932 if (len > 0 && buf[len-1] != SEP
933#ifdef ALTSEP
934 && buf[len-1] != ALTSEP
935#endif
936 )
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000937 buf[len++] = SEP;
Guido van Rossum215c3402000-11-13 17:26:32 +0000938 strcpy(buf+len, name);
939 len += namelen;
Tim Peters50d8d372001-02-28 05:34:27 +0000940
941 /* Check for package import (buf holds a directory name,
942 and there's an __init__ module in that directory */
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000943#ifdef HAVE_STAT
Tim Peters50d8d372001-02-28 05:34:27 +0000944 if (stat(buf, &statbuf) == 0 &&
945 S_ISDIR(statbuf.st_mode) &&
946 find_init_module(buf)) {
947 if (case_ok(buf, len, namelen, name))
948 return &fd_package;
949 else
950 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000951 }
952#else
953 /* XXX How are you going to test for directories? */
954#endif
Guido van Rossum9a61dc91997-10-08 15:25:08 +0000955#ifdef macintosh
956 fdp = PyMac_FindModuleExtension(buf, &len, name);
957 if (fdp)
958 fp = fopen(buf, fdp->mode);
959#else
Guido van Rossum79f25d91997-04-29 20:08:16 +0000960 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000961 strcpy(buf+len, fdp->suffix);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000962 if (Py_VerboseFlag > 1)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000963 PySys_WriteStderr("# trying %s\n", buf);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000964 fp = fopen(buf, fdp->mode);
Tim Peters50d8d372001-02-28 05:34:27 +0000965 if (fp != NULL) {
966 if (case_ok(buf, len, namelen, name))
967 break;
968 else { /* continue search */
969 fclose(fp);
970 fp = NULL;
Barry Warsaw914a0b12001-02-02 19:12:16 +0000971 }
Barry Warsaw914a0b12001-02-02 19:12:16 +0000972 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000973 }
Guido van Rossum741689d1997-08-12 14:53:39 +0000974#endif /* !macintosh */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000975 if (fp != NULL)
976 break;
977 }
978 if (fp == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000979 PyErr_Format(PyExc_ImportError,
980 "No module named %.200s", name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000981 return NULL;
982 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000983 *p_fp = fp;
984 return fdp;
985}
986
Tim Peters50d8d372001-02-28 05:34:27 +0000987/* case_ok(buf, len, namelen, name)
988 * We've already done a successful stat() or fopen() on buf (a path of length
Tim Petersf91ed2d2001-02-28 05:56:18 +0000989 * len, exclusive of trailing null). name is the last component of that path
Tim Peterse860f9b2001-02-28 05:57:51 +0000990 * (a string of length namelen, exclusive of trailing null).
Tim Peters50d8d372001-02-28 05:34:27 +0000991 * case_ok() is to return 1 if there's a case-sensitive match for
992 * name, else 0. case_ok() is also to return 1 if envar PYTHONCASEOK
993 * exists.
994 * case_ok() is used to implement case-sensitive import semantics even
995 * on platforms with case-insensitive filesystems. It's trivial to implement
996 * for case-sensitive filesystems. It's pretty much a cross-platform
997 * nightmare for systems with case-insensitive filesystems.
998 */
Guido van Rossum0980bd91998-02-13 17:18:36 +0000999
Tim Peters50d8d372001-02-28 05:34:27 +00001000/* First we may need a pile of platform-specific header files; the sequence
1001 * of #if's here should match the sequence in the body of case_ok().
1002 */
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001003#if defined(MS_WIN32) || defined(__CYGWIN__)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001004#include <windows.h>
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001005#ifdef __CYGWIN__
1006#include <sys/cygwin.h>
1007#endif
1008
Tim Peters50d8d372001-02-28 05:34:27 +00001009#elif defined(DJGPP)
1010#include <dir.h>
1011
1012#elif defined(macintosh)
1013#include <TextUtils.h>
1014#ifdef USE_GUSI1
1015#include "TFileSpec.h" /* for Path2FSSpec() */
1016#endif
1017
Tim Peters430f5d42001-03-01 01:30:56 +00001018#elif defined(__MACH__) && defined(__APPLE__)
1019#include <sys/types.h>
1020#include <dirent.h>
1021
Tim Peters50d8d372001-02-28 05:34:27 +00001022#endif
1023
Guido van Rossum0980bd91998-02-13 17:18:36 +00001024static int
Tim Peters50d8d372001-02-28 05:34:27 +00001025case_ok(char *buf, int len, int namelen, char *name)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001026{
Tim Peters50d8d372001-02-28 05:34:27 +00001027/* Pick a platform-specific implementation; the sequence of #if's here should
1028 * match the sequence just above.
1029 */
1030
1031/* MS_WIN32 || __CYGWIN__ */
1032#if defined(MS_WIN32) || defined(__CYGWIN__)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001033 WIN32_FIND_DATA data;
1034 HANDLE h;
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001035#ifdef __CYGWIN__
1036 char tempbuf[MAX_PATH];
1037#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001038
Guido van Rossum0980bd91998-02-13 17:18:36 +00001039 if (getenv("PYTHONCASEOK") != NULL)
1040 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001041
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001042#ifdef __CYGWIN__
1043 cygwin32_conv_to_win32_path(buf, tempbuf);
1044 h = FindFirstFile(tempbuf, &data);
1045#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001046 h = FindFirstFile(buf, &data);
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001047#endif
Guido van Rossum0980bd91998-02-13 17:18:36 +00001048 if (h == INVALID_HANDLE_VALUE) {
1049 PyErr_Format(PyExc_NameError,
1050 "Can't find file for module %.100s\n(filename %.300s)",
1051 name, buf);
1052 return 0;
1053 }
1054 FindClose(h);
Tim Peters50d8d372001-02-28 05:34:27 +00001055 return strncmp(data.cFileName, name, namelen) == 0;
1056
1057/* DJGPP */
1058#elif defined(DJGPP)
1059 struct ffblk ffblk;
1060 int done;
1061
1062 if (getenv("PYTHONCASEOK") != NULL)
Guido van Rossum323bf5e1998-06-24 03:54:06 +00001063 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001064
1065 done = findfirst(buf, &ffblk, FA_ARCH|FA_RDONLY|FA_HIDDEN|FA_DIREC);
1066 if (done) {
Guido van Rossum0980bd91998-02-13 17:18:36 +00001067 PyErr_Format(PyExc_NameError,
Tim Peters50d8d372001-02-28 05:34:27 +00001068 "Can't find file for module %.100s\n(filename %.300s)",
Guido van Rossum0980bd91998-02-13 17:18:36 +00001069 name, buf);
1070 return 0;
1071 }
Tim Peters50d8d372001-02-28 05:34:27 +00001072 return strncmp(ffblk.ff_name, name, namelen) == 0;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001073
Tim Peters50d8d372001-02-28 05:34:27 +00001074/* macintosh */
1075#elif defined(macintosh)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001076 FSSpec fss;
1077 OSErr err;
Tim Peters50d8d372001-02-28 05:34:27 +00001078
1079 if (getenv("PYTHONCASEOK") != NULL)
1080 return 1;
1081
Guido van Rossumb33aa1a2000-04-24 15:08:18 +00001082#ifndef USE_GUSI1
Guido van Rossuma0f0a331998-09-14 13:40:53 +00001083 err = FSMakeFSSpec(0, 0, Pstring(buf), &fss);
1084#else
1085 /* GUSI's Path2FSSpec() resolves all possible aliases nicely on
1086 the way, which is fine for all directories, but here we need
1087 the original name of the alias file (say, Dlg.ppc.slb, not
1088 toolboxmodules.ppc.slb). */
1089 char *colon;
1090 err = Path2FSSpec(buf, &fss);
1091 if (err == noErr) {
1092 colon = strrchr(buf, ':'); /* find filename */
1093 if (colon != NULL)
1094 err = FSMakeFSSpec(fss.vRefNum, fss.parID,
1095 Pstring(colon+1), &fss);
1096 else
1097 err = FSMakeFSSpec(fss.vRefNum, fss.parID,
1098 fss.name, &fss);
1099 }
1100#endif
Guido van Rossum0980bd91998-02-13 17:18:36 +00001101 if (err) {
1102 PyErr_Format(PyExc_NameError,
Guido van Rossuma0f0a331998-09-14 13:40:53 +00001103 "Can't find file for module %.100s\n(filename %.300s)",
1104 name, buf);
Guido van Rossum0980bd91998-02-13 17:18:36 +00001105 return 0;
1106 }
Tim Peters50d8d372001-02-28 05:34:27 +00001107 return fss.name[0] >= namelen &&
1108 strncmp(name, (char *)fss.name+1, namelen) == 0;
1109
Tim Peters430f5d42001-03-01 01:30:56 +00001110/* new-fangled macintosh */
1111#elif defined(__MACH__) && defined(__APPLE__)
1112 DIR *dirp;
1113 struct dirent *dp;
1114 char pathname[MAX_PATH + 1];
1115 const int pathlen = len - namelen - 1; /* don't want trailing SEP */
1116
1117 /* Copy the path component into pathname; substitute "." if empty */
1118 if (pathlen <= 0) {
1119 pathname[0] = '.';
1120 pathname[1] = '\0';
1121 }
1122 else {
1123 assert(pathlen <= MAX_PATH);
1124 memcpy(pathname, buf, pathlen);
1125 pathname[pathlen] = '\0';
1126 }
1127 /* Open the directory and search the entries for an exact match. */
1128 dirp = opendir(pathname);
1129 if (dirp) {
1130 while ((dp = readdir(dirp)) != NULL) {
1131#ifdef _DIRENT_HAVE_D_NAMELEN
1132 const int thislen = dp->d_namlen;
1133#else
1134 const int thislen = strlen(dp->d_name);
1135#endif
1136 if (thislen == namelen && !strcmp(dp->d_name, name)) {
1137 (void)closedir(dirp);
1138 return 1; /* Found */
1139 }
1140 }
1141 }
1142 (void)closedir(dirp);
1143 return 0 ; /* Not found */
1144}
1145
Tim Peters50d8d372001-02-28 05:34:27 +00001146/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1147#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001148 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001149
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001150#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001151}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001152
Guido van Rossum0980bd91998-02-13 17:18:36 +00001153
Guido van Rossum197346f1997-10-31 18:38:52 +00001154#ifdef HAVE_STAT
1155/* Helper to look for __init__.py or __init__.py[co] in potential package */
1156static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001157find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001158{
Fred Drake4c82b232000-06-30 16:18:57 +00001159 size_t save_len = strlen(buf);
1160 size_t i = save_len;
Guido van Rossum197346f1997-10-31 18:38:52 +00001161 struct stat statbuf;
1162
1163 if (save_len + 13 >= MAXPATHLEN)
1164 return 0;
1165 buf[i++] = SEP;
1166 strcpy(buf+i, "__init__.py");
1167 if (stat(buf, &statbuf) == 0) {
1168 buf[save_len] = '\0';
1169 return 1;
1170 }
1171 i += strlen(buf+i);
1172 if (Py_OptimizeFlag)
1173 strcpy(buf+i, "o");
1174 else
1175 strcpy(buf+i, "c");
1176 if (stat(buf, &statbuf) == 0) {
1177 buf[save_len] = '\0';
1178 return 1;
1179 }
1180 buf[save_len] = '\0';
1181 return 0;
1182}
1183#endif /* HAVE_STAT */
1184
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001185
Tim Petersdbd9ba62000-07-09 03:09:57 +00001186static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001187
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001188/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001189 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001190
Guido van Rossum79f25d91997-04-29 20:08:16 +00001191static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001192load_module(char *name, FILE *fp, char *buf, int type)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001193{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001194 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001195 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001196 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001197
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001198 /* First check that there's an open file (if we need one) */
1199 switch (type) {
1200 case PY_SOURCE:
1201 case PY_COMPILED:
1202 if (fp == NULL) {
1203 PyErr_Format(PyExc_ValueError,
1204 "file object required for import (type code %d)",
1205 type);
1206 return NULL;
1207 }
1208 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001209
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001210 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001211
1212 case PY_SOURCE:
1213 m = load_source_module(name, buf, fp);
1214 break;
1215
1216 case PY_COMPILED:
1217 m = load_compiled_module(name, buf, fp);
1218 break;
1219
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001220#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001221 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001222 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001223 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001224#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001225
Jack Jansen9c96a921995-02-15 22:57:06 +00001226#ifdef macintosh
1227 case PY_RESOURCE:
1228 m = PyMac_LoadResourceModule(name, buf);
1229 break;
Guido van Rossum0f84a341998-08-06 13:36:01 +00001230 case PY_CODERESOURCE:
1231 m = PyMac_LoadCodeResourceModule(name, buf);
1232 break;
Jack Jansen9c96a921995-02-15 22:57:06 +00001233#endif
1234
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001235 case PKG_DIRECTORY:
1236 m = load_package(name, buf);
1237 break;
1238
1239 case C_BUILTIN:
1240 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001241 if (buf != NULL && buf[0] != '\0')
1242 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001243 if (type == C_BUILTIN)
1244 err = init_builtin(name);
1245 else
1246 err = PyImport_ImportFrozenModule(name);
1247 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001248 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001249 if (err == 0) {
1250 PyErr_Format(PyExc_ImportError,
1251 "Purported %s module %.200s not found",
1252 type == C_BUILTIN ?
1253 "builtin" : "frozen",
1254 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001255 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001256 }
1257 modules = PyImport_GetModuleDict();
1258 m = PyDict_GetItemString(modules, name);
1259 if (m == NULL) {
1260 PyErr_Format(
1261 PyExc_ImportError,
1262 "%s module %.200s not properly initialized",
1263 type == C_BUILTIN ?
1264 "builtin" : "frozen",
1265 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001266 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001267 }
1268 Py_INCREF(m);
1269 break;
1270
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001271 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001272 PyErr_Format(PyExc_ImportError,
1273 "Don't know how to import %.200s (type code %d)",
1274 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001275 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001276
1277 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001278
1279 return m;
1280}
1281
1282
1283/* Initialize a built-in module.
1284 Return 1 for succes, 0 if the module is not found, and -1 with
1285 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001286
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001287static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001288init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001289{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001290 struct _inittab *p;
1291 PyObject *mod;
1292
1293 if ((mod = _PyImport_FindExtension(name, name)) != NULL)
1294 return 1;
1295
Guido van Rossum771c6c81997-10-31 18:37:24 +00001296 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001297 if (strcmp(name, p->name) == 0) {
1298 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001299 PyErr_Format(PyExc_ImportError,
1300 "Cannot re-init internal module %.200s",
1301 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001302 return -1;
1303 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001304 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001305 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001306 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001307 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001308 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001309 if (_PyImport_FixupExtension(name, name) == NULL)
1310 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001311 return 1;
1312 }
1313 }
1314 return 0;
1315}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001316
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001317
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001318/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001319
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001320static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001321find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001322{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001323 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001324
Guido van Rossum79f25d91997-04-29 20:08:16 +00001325 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001326 if (p->name == NULL)
1327 return NULL;
1328 if (strcmp(p->name, name) == 0)
1329 break;
1330 }
1331 return p;
1332}
1333
Guido van Rossum79f25d91997-04-29 20:08:16 +00001334static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001335get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001336{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001337 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001338 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001339
1340 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001341 PyErr_Format(PyExc_ImportError,
1342 "No such frozen object named %.200s",
1343 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001344 return NULL;
1345 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001346 size = p->size;
1347 if (size < 0)
1348 size = -size;
1349 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001350}
1351
1352/* Initialize a frozen module.
1353 Return 1 for succes, 0 if the module is not found, and -1 with
1354 an exception set if the initialization failed.
1355 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001356
1357int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001358PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001359{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001360 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001361 PyObject *co;
1362 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001363 int ispackage;
1364 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001365
1366 if (p == NULL)
1367 return 0;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001368 size = p->size;
1369 ispackage = (size < 0);
1370 if (ispackage)
1371 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001372 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001373 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001374 name, ispackage ? " package" : "");
1375 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001376 if (co == NULL)
1377 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001378 if (!PyCode_Check(co)) {
1379 Py_DECREF(co);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001380 PyErr_Format(PyExc_TypeError,
1381 "frozen object %.200s is not a code object",
1382 name);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001383 return -1;
1384 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001385 if (ispackage) {
1386 /* Set __path__ to the package name */
1387 PyObject *d, *s;
1388 int err;
1389 m = PyImport_AddModule(name);
1390 if (m == NULL)
1391 return -1;
1392 d = PyModule_GetDict(m);
1393 s = PyString_InternFromString(name);
1394 if (s == NULL)
1395 return -1;
1396 err = PyDict_SetItemString(d, "__path__", s);
1397 Py_DECREF(s);
1398 if (err != 0)
1399 return err;
1400 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001401 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum79f25d91997-04-29 20:08:16 +00001402 Py_DECREF(co);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001403 if (m == NULL)
1404 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001405 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001406 return 1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001407}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001408
1409
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001410/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001411 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001412
Guido van Rossum79f25d91997-04-29 20:08:16 +00001413PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001414PyImport_ImportModule(char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001415{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001416 PyObject *pname;
1417 PyObject *result;
1418
1419 pname = PyString_FromString(name);
1420 result = PyImport_Import(pname);
1421 Py_DECREF(pname);
1422 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001423}
1424
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001425/* Forward declarations for helper routines */
Tim Petersdbd9ba62000-07-09 03:09:57 +00001426static PyObject *get_parent(PyObject *globals, char *buf, int *p_buflen);
1427static PyObject *load_next(PyObject *mod, PyObject *altmod,
1428 char **p_name, char *buf, int *p_buflen);
1429static int mark_miss(char *name);
1430static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
1431 char *buf, int buflen, int recursive);
1432static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001433
1434/* The Magnum Opus of dotted-name import :-) */
1435
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001436static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001437import_module_ex(char *name, PyObject *globals, PyObject *locals,
1438 PyObject *fromlist)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001439{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001440 char buf[MAXPATHLEN+1];
1441 int buflen = 0;
1442 PyObject *parent, *head, *next, *tail;
1443
1444 parent = get_parent(globals, buf, &buflen);
1445 if (parent == NULL)
1446 return NULL;
1447
1448 head = load_next(parent, Py_None, &name, buf, &buflen);
1449 if (head == NULL)
1450 return NULL;
1451
1452 tail = head;
1453 Py_INCREF(tail);
1454 while (name) {
1455 next = load_next(tail, tail, &name, buf, &buflen);
1456 Py_DECREF(tail);
1457 if (next == NULL) {
1458 Py_DECREF(head);
1459 return NULL;
1460 }
1461 tail = next;
1462 }
1463
1464 if (fromlist != NULL) {
1465 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
1466 fromlist = NULL;
1467 }
1468
1469 if (fromlist == NULL) {
1470 Py_DECREF(tail);
1471 return head;
1472 }
1473
1474 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001475 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001476 Py_DECREF(tail);
1477 return NULL;
1478 }
1479
1480 return tail;
1481}
1482
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001483PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001484PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
1485 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001486{
1487 PyObject *result;
1488 lock_import();
Guido van Rossumd65911b1998-03-03 22:33:27 +00001489 result = import_module_ex(name, globals, locals, fromlist);
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001490 unlock_import();
1491 return result;
1492}
1493
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001494static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001495get_parent(PyObject *globals, char *buf, int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001496{
1497 static PyObject *namestr = NULL;
1498 static PyObject *pathstr = NULL;
1499 PyObject *modname, *modpath, *modules, *parent;
1500
1501 if (globals == NULL || !PyDict_Check(globals))
1502 return Py_None;
1503
1504 if (namestr == NULL) {
1505 namestr = PyString_InternFromString("__name__");
1506 if (namestr == NULL)
1507 return NULL;
1508 }
1509 if (pathstr == NULL) {
1510 pathstr = PyString_InternFromString("__path__");
1511 if (pathstr == NULL)
1512 return NULL;
1513 }
1514
1515 *buf = '\0';
1516 *p_buflen = 0;
1517 modname = PyDict_GetItem(globals, namestr);
1518 if (modname == NULL || !PyString_Check(modname))
1519 return Py_None;
1520
1521 modpath = PyDict_GetItem(globals, pathstr);
1522 if (modpath != NULL) {
1523 int len = PyString_GET_SIZE(modname);
1524 if (len > MAXPATHLEN) {
1525 PyErr_SetString(PyExc_ValueError,
1526 "Module name too long");
1527 return NULL;
1528 }
1529 strcpy(buf, PyString_AS_STRING(modname));
1530 *p_buflen = len;
1531 }
1532 else {
1533 char *start = PyString_AS_STRING(modname);
1534 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001535 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001536 if (lastdot == NULL)
1537 return Py_None;
1538 len = lastdot - start;
1539 if (len >= MAXPATHLEN) {
1540 PyErr_SetString(PyExc_ValueError,
1541 "Module name too long");
1542 return NULL;
1543 }
1544 strncpy(buf, start, len);
1545 buf[len] = '\0';
1546 *p_buflen = len;
1547 }
1548
1549 modules = PyImport_GetModuleDict();
1550 parent = PyDict_GetItemString(modules, buf);
1551 if (parent == NULL)
1552 parent = Py_None;
1553 return parent;
1554 /* We expect, but can't guarantee, if parent != None, that:
1555 - parent.__name__ == buf
1556 - parent.__dict__ is globals
1557 If this is violated... Who cares? */
1558}
1559
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001560/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001561static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001562load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
1563 int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001564{
1565 char *name = *p_name;
1566 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001567 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001568 char *p;
1569 PyObject *result;
1570
1571 if (dot == NULL) {
1572 *p_name = NULL;
1573 len = strlen(name);
1574 }
1575 else {
1576 *p_name = dot+1;
1577 len = dot-name;
1578 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00001579 if (len == 0) {
1580 PyErr_SetString(PyExc_ValueError,
1581 "Empty module name");
1582 return NULL;
1583 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001584
1585 p = buf + *p_buflen;
1586 if (p != buf)
1587 *p++ = '.';
1588 if (p+len-buf >= MAXPATHLEN) {
1589 PyErr_SetString(PyExc_ValueError,
1590 "Module name too long");
1591 return NULL;
1592 }
1593 strncpy(p, name, len);
1594 p[len] = '\0';
1595 *p_buflen = p+len-buf;
1596
1597 result = import_submodule(mod, p, buf);
1598 if (result == Py_None && altmod != mod) {
1599 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001600 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00001601 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001602 if (result != NULL && result != Py_None) {
1603 if (mark_miss(buf) != 0) {
1604 Py_DECREF(result);
1605 return NULL;
1606 }
1607 strncpy(buf, name, len);
1608 buf[len] = '\0';
1609 *p_buflen = len;
1610 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001611 }
1612 if (result == NULL)
1613 return NULL;
1614
1615 if (result == Py_None) {
1616 Py_DECREF(result);
1617 PyErr_Format(PyExc_ImportError,
1618 "No module named %.200s", name);
1619 return NULL;
1620 }
1621
1622 return result;
1623}
1624
1625static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001626mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001627{
1628 PyObject *modules = PyImport_GetModuleDict();
1629 return PyDict_SetItemString(modules, name, Py_None);
1630}
1631
1632static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001633ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, int buflen,
1634 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001635{
1636 int i;
1637
1638 if (!PyObject_HasAttrString(mod, "__path__"))
1639 return 1;
1640
1641 for (i = 0; ; i++) {
1642 PyObject *item = PySequence_GetItem(fromlist, i);
1643 int hasit;
1644 if (item == NULL) {
1645 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
1646 PyErr_Clear();
1647 return 1;
1648 }
1649 return 0;
1650 }
1651 if (!PyString_Check(item)) {
1652 PyErr_SetString(PyExc_TypeError,
1653 "Item in ``from list'' not a string");
1654 Py_DECREF(item);
1655 return 0;
1656 }
1657 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00001658 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001659 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001660 /* See if the package defines __all__ */
1661 if (recursive)
1662 continue; /* Avoid endless recursion */
1663 all = PyObject_GetAttrString(mod, "__all__");
1664 if (all == NULL)
1665 PyErr_Clear();
1666 else {
1667 if (!ensure_fromlist(mod, all, buf, buflen, 1))
1668 return 0;
1669 Py_DECREF(all);
1670 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001671 continue;
1672 }
1673 hasit = PyObject_HasAttr(mod, item);
1674 if (!hasit) {
1675 char *subname = PyString_AS_STRING(item);
1676 PyObject *submod;
1677 char *p;
1678 if (buflen + strlen(subname) >= MAXPATHLEN) {
1679 PyErr_SetString(PyExc_ValueError,
1680 "Module name too long");
1681 Py_DECREF(item);
1682 return 0;
1683 }
1684 p = buf + buflen;
1685 *p++ = '.';
1686 strcpy(p, subname);
1687 submod = import_submodule(mod, subname, buf);
1688 Py_XDECREF(submod);
1689 if (submod == NULL) {
1690 Py_DECREF(item);
1691 return 0;
1692 }
1693 }
1694 Py_DECREF(item);
1695 }
1696
Guido van Rossuma7f2e811997-10-03 15:33:32 +00001697 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001698}
1699
1700static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001701import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001702{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001703 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001704 PyObject *m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001705
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001706 /* Require:
1707 if mod == None: subname == fullname
1708 else: mod.__name__ + "." + subname == fullname
1709 */
1710
Tim Peters50d8d372001-02-28 05:34:27 +00001711 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001712 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001713 }
1714 else {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001715 PyObject *path;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001716 char buf[MAXPATHLEN+1];
1717 struct filedescr *fdp;
1718 FILE *fp = NULL;
1719
Guido van Rossum9c0afe51998-05-19 15:09:05 +00001720 if (mod == Py_None)
1721 path = NULL;
1722 else {
1723 path = PyObject_GetAttrString(mod, "__path__");
1724 if (path == NULL) {
1725 PyErr_Clear();
1726 Py_INCREF(Py_None);
1727 return Py_None;
1728 }
1729 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001730
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001731 buf[0] = '\0';
Guido van Rossumb68cd421998-07-01 17:36:26 +00001732 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1733 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001734 if (fdp == NULL) {
1735 if (!PyErr_ExceptionMatches(PyExc_ImportError))
1736 return NULL;
1737 PyErr_Clear();
1738 Py_INCREF(Py_None);
1739 return Py_None;
1740 }
1741 m = load_module(fullname, fp, buf, fdp->type);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001742 if (fp)
1743 fclose(fp);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001744 if (m != NULL && mod != Py_None) {
1745 if (PyObject_SetAttrString(mod, subname, m) < 0) {
1746 Py_DECREF(m);
1747 m = NULL;
1748 }
1749 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00001750 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001751
1752 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001753}
1754
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001755
1756/* Re-import a module of any kind and return its module object, WITH
1757 INCREMENTED REFERENCE COUNT */
1758
Guido van Rossum79f25d91997-04-29 20:08:16 +00001759PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001760PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001761{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001762 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum222ef561997-09-06 19:41:09 +00001763 PyObject *path = NULL;
1764 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001765 char buf[MAXPATHLEN+1];
1766 struct filedescr *fdp;
1767 FILE *fp = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001768
Guido van Rossum79f25d91997-04-29 20:08:16 +00001769 if (m == NULL || !PyModule_Check(m)) {
1770 PyErr_SetString(PyExc_TypeError,
1771 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001772 return NULL;
1773 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001774 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001775 if (name == NULL)
1776 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001777 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001778 PyErr_Format(PyExc_ImportError,
1779 "reload(): module %.200s not in sys.modules",
1780 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001781 return NULL;
1782 }
Guido van Rossum222ef561997-09-06 19:41:09 +00001783 subname = strrchr(name, '.');
1784 if (subname == NULL)
1785 subname = name;
1786 else {
1787 PyObject *parentname, *parent;
1788 parentname = PyString_FromStringAndSize(name, (subname-name));
1789 if (parentname == NULL)
1790 return NULL;
1791 parent = PyDict_GetItem(modules, parentname);
Barry Warsaw38793331999-01-27 17:54:20 +00001792 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00001793 if (parent == NULL) {
1794 PyErr_Format(PyExc_ImportError,
1795 "reload(): parent %.200s not in sys.modules",
1796 name);
1797 return NULL;
1798 }
1799 subname++;
1800 path = PyObject_GetAttrString(parent, "__path__");
1801 if (path == NULL)
1802 PyErr_Clear();
1803 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001804 buf[0] = '\0';
Guido van Rossum222ef561997-09-06 19:41:09 +00001805 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1806 Py_XDECREF(path);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001807 if (fdp == NULL)
1808 return NULL;
1809 m = load_module(name, fp, buf, fdp->type);
1810 if (fp)
1811 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001812 return m;
1813}
1814
1815
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001816/* Higher-level import emulator which emulates the "import" statement
1817 more accurately -- it invokes the __import__() function from the
1818 builtins of the current globals. This means that the import is
1819 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00001820 environment, e.g. by "rexec".
1821 A dummy list ["__doc__"] is passed as the 4th argument so that
1822 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
1823 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001824
1825PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001826PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001827{
1828 static PyObject *silly_list = NULL;
1829 static PyObject *builtins_str = NULL;
1830 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001831 PyObject *globals = NULL;
1832 PyObject *import = NULL;
1833 PyObject *builtins = NULL;
1834 PyObject *r = NULL;
1835
1836 /* Initialize constant string objects */
1837 if (silly_list == NULL) {
1838 import_str = PyString_InternFromString("__import__");
1839 if (import_str == NULL)
1840 return NULL;
1841 builtins_str = PyString_InternFromString("__builtins__");
1842 if (builtins_str == NULL)
1843 return NULL;
1844 silly_list = Py_BuildValue("[s]", "__doc__");
1845 if (silly_list == NULL)
1846 return NULL;
1847 }
1848
1849 /* Get the builtins from current globals */
1850 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00001851 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00001852 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001853 builtins = PyObject_GetItem(globals, builtins_str);
1854 if (builtins == NULL)
1855 goto err;
1856 }
1857 else {
1858 /* No globals -- use standard builtins, and fake globals */
1859 PyErr_Clear();
1860
Guido van Rossum85cd1d62001-02-20 21:43:24 +00001861 builtins = PyImport_ImportModuleEx("__builtin__",
1862 NULL, NULL, NULL);
1863 if (builtins == NULL)
1864 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001865 globals = Py_BuildValue("{OO}", builtins_str, builtins);
1866 if (globals == NULL)
1867 goto err;
1868 }
1869
1870 /* Get the __import__ function from the builtins */
1871 if (PyDict_Check(builtins))
1872 import=PyObject_GetItem(builtins, import_str);
1873 else
1874 import=PyObject_GetAttr(builtins, import_str);
1875 if (import == NULL)
1876 goto err;
1877
1878 /* Call the _import__ function with the proper argument list */
1879 r = PyObject_CallFunction(import, "OOOO",
1880 module_name, globals, globals, silly_list);
1881
1882 err:
1883 Py_XDECREF(globals);
1884 Py_XDECREF(builtins);
1885 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00001886
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001887 return r;
1888}
1889
1890
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001891/* Module 'imp' provides Python access to the primitives used for
1892 importing modules.
1893*/
1894
Guido van Rossum79f25d91997-04-29 20:08:16 +00001895static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001896imp_get_magic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001897{
1898 char buf[4];
1899
Guido van Rossum43713e52000-02-29 13:59:29 +00001900 if (!PyArg_ParseTuple(args, ":get_magic"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001901 return NULL;
Guido van Rossum96774c12000-05-01 20:19:08 +00001902 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
1903 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
1904 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
1905 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001906
Guido van Rossum79f25d91997-04-29 20:08:16 +00001907 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001908}
1909
Guido van Rossum79f25d91997-04-29 20:08:16 +00001910static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001911imp_get_suffixes(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001912{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001913 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001914 struct filedescr *fdp;
1915
Guido van Rossum43713e52000-02-29 13:59:29 +00001916 if (!PyArg_ParseTuple(args, ":get_suffixes"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001917 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001918 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001919 if (list == NULL)
1920 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001921 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
1922 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001923 fdp->suffix, fdp->mode, fdp->type);
1924 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001925 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001926 return NULL;
1927 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001928 if (PyList_Append(list, item) < 0) {
1929 Py_DECREF(list);
1930 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001931 return NULL;
1932 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001933 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001934 }
1935 return list;
1936}
1937
Guido van Rossum79f25d91997-04-29 20:08:16 +00001938static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001939call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001940{
Tim Petersdbd9ba62000-07-09 03:09:57 +00001941 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001942 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001943 struct filedescr *fdp;
1944 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001945 FILE *fp = NULL;
1946
1947 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001948 if (path == Py_None)
1949 path = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001950 fdp = find_module(name, path, pathname, MAXPATHLEN+1, &fp);
1951 if (fdp == NULL)
1952 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001953 if (fp != NULL) {
1954 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
1955 if (fob == NULL) {
1956 fclose(fp);
1957 return NULL;
1958 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001959 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001960 else {
1961 fob = Py_None;
1962 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00001963 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001964 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001965 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001966 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001967 return ret;
1968}
1969
Guido van Rossum79f25d91997-04-29 20:08:16 +00001970static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001971imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001972{
1973 char *name;
1974 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00001975 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001976 return NULL;
1977 return call_find_module(name, path);
1978}
1979
1980static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001981imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001982{
1983 char *name;
1984 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001985 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00001986 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001987 return NULL;
1988 ret = init_builtin(name);
1989 if (ret < 0)
1990 return NULL;
1991 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001992 Py_INCREF(Py_None);
1993 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001994 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001995 m = PyImport_AddModule(name);
1996 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001997 return m;
1998}
1999
Guido van Rossum79f25d91997-04-29 20:08:16 +00002000static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002001imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002002{
2003 char *name;
2004 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002005 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002006 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002007 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002008 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002009 if (ret < 0)
2010 return NULL;
2011 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002012 Py_INCREF(Py_None);
2013 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002014 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002015 m = PyImport_AddModule(name);
2016 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002017 return m;
2018}
2019
Guido van Rossum79f25d91997-04-29 20:08:16 +00002020static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002021imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002022{
2023 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002024
Guido van Rossum43713e52000-02-29 13:59:29 +00002025 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002026 return NULL;
2027 return get_frozen_object(name);
2028}
2029
Guido van Rossum79f25d91997-04-29 20:08:16 +00002030static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002031imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002032{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002033 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002034 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002035 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002036 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002037}
2038
Guido van Rossum79f25d91997-04-29 20:08:16 +00002039static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002040imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002041{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002042 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002043 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002044 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002045 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002046 p = find_frozen(name);
2047 return PyInt_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002048}
2049
2050static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002051get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002052{
2053 FILE *fp;
2054 if (fob == NULL) {
2055 fp = fopen(pathname, mode);
2056 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002057 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002058 }
2059 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002060 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002061 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002062 PyErr_SetString(PyExc_ValueError,
2063 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002064 }
2065 return fp;
2066}
2067
Guido van Rossum79f25d91997-04-29 20:08:16 +00002068static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002069imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002070{
2071 char *name;
2072 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002073 PyObject *fob = NULL;
2074 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002075 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002076 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002077 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002078 return NULL;
2079 fp = get_file(pathname, fob, "rb");
2080 if (fp == NULL)
2081 return NULL;
2082 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002083 if (fob == NULL)
2084 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002085 return m;
2086}
2087
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002088#ifdef HAVE_DYNAMIC_LOADING
2089
Guido van Rossum79f25d91997-04-29 20:08:16 +00002090static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002091imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002092{
2093 char *name;
2094 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002095 PyObject *fob = NULL;
2096 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002097 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002098 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002099 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002100 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002101 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002102 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002103 if (fp == NULL)
2104 return NULL;
2105 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002106 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002107 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002108}
2109
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002110#endif /* HAVE_DYNAMIC_LOADING */
2111
Guido van Rossum79f25d91997-04-29 20:08:16 +00002112static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002113imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002114{
2115 char *name;
2116 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002117 PyObject *fob = NULL;
2118 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002119 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002120 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002121 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002122 return NULL;
2123 fp = get_file(pathname, fob, "r");
2124 if (fp == NULL)
2125 return NULL;
2126 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002127 if (fob == NULL)
2128 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002129 return m;
2130}
2131
Jack Jansen9c96a921995-02-15 22:57:06 +00002132#ifdef macintosh
Guido van Rossum79f25d91997-04-29 20:08:16 +00002133static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002134imp_load_resource(PyObject *self, PyObject *args)
Jack Jansen9c96a921995-02-15 22:57:06 +00002135{
2136 char *name;
2137 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002138 PyObject *m;
Jack Jansen9c96a921995-02-15 22:57:06 +00002139
Guido van Rossum43713e52000-02-29 13:59:29 +00002140 if (!PyArg_ParseTuple(args, "ss:load_resource", &name, &pathname))
Jack Jansen9c96a921995-02-15 22:57:06 +00002141 return NULL;
2142 m = PyMac_LoadResourceModule(name, pathname);
2143 return m;
2144}
2145#endif /* macintosh */
2146
Guido van Rossum79f25d91997-04-29 20:08:16 +00002147static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002148imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002149{
2150 char *name;
2151 PyObject *fob;
2152 char *pathname;
2153 char *suffix; /* Unused */
2154 char *mode;
2155 int type;
2156 FILE *fp;
2157
Guido van Rossum43713e52000-02-29 13:59:29 +00002158 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002159 &name, &fob, &pathname,
2160 &suffix, &mode, &type))
2161 return NULL;
2162 if (*mode && (*mode != 'r' || strchr(mode, '+') != NULL)) {
2163 PyErr_Format(PyExc_ValueError,
2164 "invalid file open mode %.200s", mode);
2165 return NULL;
2166 }
2167 if (fob == Py_None)
2168 fp = NULL;
2169 else {
2170 if (!PyFile_Check(fob)) {
2171 PyErr_SetString(PyExc_ValueError,
2172 "load_module arg#2 should be a file or None");
2173 return NULL;
2174 }
2175 fp = get_file(pathname, fob, mode);
2176 if (fp == NULL)
2177 return NULL;
2178 }
2179 return load_module(name, fp, pathname, type);
2180}
2181
2182static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002183imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002184{
2185 char *name;
2186 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002187 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002188 return NULL;
2189 return load_package(name, pathname);
2190}
2191
2192static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002193imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002194{
2195 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002196 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002197 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002198 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002199}
2200
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002201/* Doc strings */
2202
2203static char doc_imp[] = "\
2204This module provides the components needed to build your own\n\
2205__import__ function. Undocumented functions are obsolete.\n\
2206";
2207
2208static char doc_find_module[] = "\
2209find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
2210Search for a module. If path is omitted or None, search for a\n\
2211built-in, frozen or special module and continue search in sys.path.\n\
2212The module name cannot contain '.'; to search for a submodule of a\n\
2213package, pass the submodule name and the package's __path__.\
2214";
2215
2216static char doc_load_module[] = "\
2217load_module(name, file, filename, (suffix, mode, type)) -> module\n\
2218Load a module, given information returned by find_module().\n\
2219The module name must include the full package name, if any.\
2220";
2221
2222static char doc_get_magic[] = "\
2223get_magic() -> string\n\
2224Return the magic number for .pyc or .pyo files.\
2225";
2226
2227static char doc_get_suffixes[] = "\
2228get_suffixes() -> [(suffix, mode, type), ...]\n\
2229Return a list of (suffix, mode, type) tuples describing the files\n\
2230that find_module() looks for.\
2231";
2232
2233static char doc_new_module[] = "\
2234new_module(name) -> module\n\
2235Create a new module. Do not enter it in sys.modules.\n\
2236The module name must include the full package name, if any.\
2237";
2238
Guido van Rossum79f25d91997-04-29 20:08:16 +00002239static PyMethodDef imp_methods[] = {
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002240 {"find_module", imp_find_module, 1, doc_find_module},
2241 {"get_magic", imp_get_magic, 1, doc_get_magic},
2242 {"get_suffixes", imp_get_suffixes, 1, doc_get_suffixes},
2243 {"load_module", imp_load_module, 1, doc_load_module},
2244 {"new_module", imp_new_module, 1, doc_new_module},
2245 /* The rest are obsolete */
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002246 {"get_frozen_object", imp_get_frozen_object, 1},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002247 {"init_builtin", imp_init_builtin, 1},
2248 {"init_frozen", imp_init_frozen, 1},
2249 {"is_builtin", imp_is_builtin, 1},
2250 {"is_frozen", imp_is_frozen, 1},
2251 {"load_compiled", imp_load_compiled, 1},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002252#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002253 {"load_dynamic", imp_load_dynamic, 1},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002254#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002255 {"load_package", imp_load_package, 1},
Jack Jansen9c96a921995-02-15 22:57:06 +00002256#ifdef macintosh
2257 {"load_resource", imp_load_resource, 1},
2258#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002259 {"load_source", imp_load_source, 1},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002260 {NULL, NULL} /* sentinel */
2261};
2262
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002263static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002264setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002265{
2266 PyObject *v;
2267 int err;
2268
2269 v = PyInt_FromLong((long)value);
2270 err = PyDict_SetItemString(d, name, v);
2271 Py_XDECREF(v);
2272 return err;
2273}
2274
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002275void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002276initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002277{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002278 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002279
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002280 m = Py_InitModule4("imp", imp_methods, doc_imp,
2281 NULL, PYTHON_API_VERSION);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002282 d = PyModule_GetDict(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002283
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002284 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
2285 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
2286 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
2287 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
2288 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
2289 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
2290 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
2291 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00002292 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002293
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002294 failure:
2295 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002296}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002297
2298
Guido van Rossumb18618d2000-05-03 23:44:39 +00002299/* API for embedding applications that want to add their own entries
2300 to the table of built-in modules. This should normally be called
2301 *before* Py_Initialize(). When the table resize fails, -1 is
2302 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002303
2304 After a similar function by Just van Rossum. */
2305
2306int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002307PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002308{
2309 static struct _inittab *our_copy = NULL;
2310 struct _inittab *p;
2311 int i, n;
2312
2313 /* Count the number of entries in both tables */
2314 for (n = 0; newtab[n].name != NULL; n++)
2315 ;
2316 if (n == 0)
2317 return 0; /* Nothing to do */
2318 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
2319 ;
2320
2321 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00002322 p = our_copy;
2323 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002324 if (p == NULL)
2325 return -1;
2326
2327 /* Copy the tables into the new memory */
2328 if (our_copy != PyImport_Inittab)
2329 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
2330 PyImport_Inittab = our_copy = p;
2331 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
2332
2333 return 0;
2334}
2335
2336/* Shorthand to add a single entry given a name and a function */
2337
2338int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002339PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002340{
2341 struct _inittab newtab[2];
2342
2343 memset(newtab, '\0', sizeof newtab);
2344
2345 newtab[0].name = name;
2346 newtab[0].initfunc = initfunc;
2347
2348 return PyImport_ExtendInittab(newtab);
2349}