blob: b9637b2e8b605588be0420ee48e7badc1db3b063 [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 Drakec63d3e92001-03-01 06:33:32 +0000705 if (mtime == (time_t)(-1))
Fred Drake4c82b232000-06-30 16:18:57 +0000706 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,
Fred Drakec63d3e92001-03-01 06:33:32 +0000714 "modification time overflows a 4 byte field");
Fred Drake4c82b232000-06-30 16:18:57 +0000715 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;
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001114 char pathname[MAXPATHLEN + 1];
Tim Peters430f5d42001-03-01 01:30:56 +00001115 const int pathlen = len - namelen - 1; /* don't want trailing SEP */
1116
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001117 if (getenv("PYTHONCASEOK") != NULL)
1118 return 1;
1119
Tim Peters430f5d42001-03-01 01:30:56 +00001120 /* Copy the path component into pathname; substitute "." if empty */
1121 if (pathlen <= 0) {
1122 pathname[0] = '.';
1123 pathname[1] = '\0';
1124 }
1125 else {
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001126 assert(pathlen <= MAXPATHLEN);
Tim Peters430f5d42001-03-01 01:30:56 +00001127 memcpy(pathname, buf, pathlen);
1128 pathname[pathlen] = '\0';
1129 }
1130 /* Open the directory and search the entries for an exact match. */
1131 dirp = opendir(pathname);
1132 if (dirp) {
1133 while ((dp = readdir(dirp)) != NULL) {
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001134 const int thislen =
Tim Peters430f5d42001-03-01 01:30:56 +00001135#ifdef _DIRENT_HAVE_D_NAMELEN
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001136 dp->d_namlen;
Tim Peters430f5d42001-03-01 01:30:56 +00001137#else
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001138 strlen(dp->d_name);
Tim Peters430f5d42001-03-01 01:30:56 +00001139#endif
1140 if (thislen == namelen && !strcmp(dp->d_name, name)) {
1141 (void)closedir(dirp);
1142 return 1; /* Found */
1143 }
1144 }
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001145 (void)closedir(dirp);
Tim Peters430f5d42001-03-01 01:30:56 +00001146 }
Tim Peters430f5d42001-03-01 01:30:56 +00001147 return 0 ; /* Not found */
Tim Peters430f5d42001-03-01 01:30:56 +00001148
Tim Peters50d8d372001-02-28 05:34:27 +00001149/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1150#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001151 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001152
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001153#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001154}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001155
Guido van Rossum0980bd91998-02-13 17:18:36 +00001156
Guido van Rossum197346f1997-10-31 18:38:52 +00001157#ifdef HAVE_STAT
1158/* Helper to look for __init__.py or __init__.py[co] in potential package */
1159static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001160find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001161{
Fred Drake4c82b232000-06-30 16:18:57 +00001162 size_t save_len = strlen(buf);
1163 size_t i = save_len;
Guido van Rossum197346f1997-10-31 18:38:52 +00001164 struct stat statbuf;
1165
1166 if (save_len + 13 >= MAXPATHLEN)
1167 return 0;
1168 buf[i++] = SEP;
1169 strcpy(buf+i, "__init__.py");
1170 if (stat(buf, &statbuf) == 0) {
1171 buf[save_len] = '\0';
1172 return 1;
1173 }
1174 i += strlen(buf+i);
1175 if (Py_OptimizeFlag)
1176 strcpy(buf+i, "o");
1177 else
1178 strcpy(buf+i, "c");
1179 if (stat(buf, &statbuf) == 0) {
1180 buf[save_len] = '\0';
1181 return 1;
1182 }
1183 buf[save_len] = '\0';
1184 return 0;
1185}
1186#endif /* HAVE_STAT */
1187
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001188
Tim Petersdbd9ba62000-07-09 03:09:57 +00001189static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001190
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001191/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001192 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001193
Guido van Rossum79f25d91997-04-29 20:08:16 +00001194static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001195load_module(char *name, FILE *fp, char *buf, int type)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001196{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001197 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001198 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001199 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001200
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001201 /* First check that there's an open file (if we need one) */
1202 switch (type) {
1203 case PY_SOURCE:
1204 case PY_COMPILED:
1205 if (fp == NULL) {
1206 PyErr_Format(PyExc_ValueError,
1207 "file object required for import (type code %d)",
1208 type);
1209 return NULL;
1210 }
1211 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001212
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001213 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001214
1215 case PY_SOURCE:
1216 m = load_source_module(name, buf, fp);
1217 break;
1218
1219 case PY_COMPILED:
1220 m = load_compiled_module(name, buf, fp);
1221 break;
1222
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001223#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001224 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001225 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001226 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001227#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001228
Jack Jansen9c96a921995-02-15 22:57:06 +00001229#ifdef macintosh
1230 case PY_RESOURCE:
1231 m = PyMac_LoadResourceModule(name, buf);
1232 break;
Guido van Rossum0f84a341998-08-06 13:36:01 +00001233 case PY_CODERESOURCE:
1234 m = PyMac_LoadCodeResourceModule(name, buf);
1235 break;
Jack Jansen9c96a921995-02-15 22:57:06 +00001236#endif
1237
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001238 case PKG_DIRECTORY:
1239 m = load_package(name, buf);
1240 break;
1241
1242 case C_BUILTIN:
1243 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001244 if (buf != NULL && buf[0] != '\0')
1245 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001246 if (type == C_BUILTIN)
1247 err = init_builtin(name);
1248 else
1249 err = PyImport_ImportFrozenModule(name);
1250 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001251 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001252 if (err == 0) {
1253 PyErr_Format(PyExc_ImportError,
1254 "Purported %s module %.200s not found",
1255 type == C_BUILTIN ?
1256 "builtin" : "frozen",
1257 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001258 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001259 }
1260 modules = PyImport_GetModuleDict();
1261 m = PyDict_GetItemString(modules, name);
1262 if (m == NULL) {
1263 PyErr_Format(
1264 PyExc_ImportError,
1265 "%s module %.200s not properly initialized",
1266 type == C_BUILTIN ?
1267 "builtin" : "frozen",
1268 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001269 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001270 }
1271 Py_INCREF(m);
1272 break;
1273
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001274 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001275 PyErr_Format(PyExc_ImportError,
1276 "Don't know how to import %.200s (type code %d)",
1277 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001278 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001279
1280 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001281
1282 return m;
1283}
1284
1285
1286/* Initialize a built-in module.
1287 Return 1 for succes, 0 if the module is not found, and -1 with
1288 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001289
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001290static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001291init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001292{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001293 struct _inittab *p;
1294 PyObject *mod;
1295
1296 if ((mod = _PyImport_FindExtension(name, name)) != NULL)
1297 return 1;
1298
Guido van Rossum771c6c81997-10-31 18:37:24 +00001299 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001300 if (strcmp(name, p->name) == 0) {
1301 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001302 PyErr_Format(PyExc_ImportError,
1303 "Cannot re-init internal module %.200s",
1304 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001305 return -1;
1306 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001307 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001308 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001309 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001310 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001311 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001312 if (_PyImport_FixupExtension(name, name) == NULL)
1313 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001314 return 1;
1315 }
1316 }
1317 return 0;
1318}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001319
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001320
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001321/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001322
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001323static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001324find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001325{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001326 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001327
Guido van Rossum79f25d91997-04-29 20:08:16 +00001328 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001329 if (p->name == NULL)
1330 return NULL;
1331 if (strcmp(p->name, name) == 0)
1332 break;
1333 }
1334 return p;
1335}
1336
Guido van Rossum79f25d91997-04-29 20:08:16 +00001337static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001338get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001339{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001340 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001341 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001342
1343 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001344 PyErr_Format(PyExc_ImportError,
1345 "No such frozen object named %.200s",
1346 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001347 return NULL;
1348 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001349 size = p->size;
1350 if (size < 0)
1351 size = -size;
1352 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001353}
1354
1355/* Initialize a frozen module.
1356 Return 1 for succes, 0 if the module is not found, and -1 with
1357 an exception set if the initialization failed.
1358 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001359
1360int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001361PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001362{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001363 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001364 PyObject *co;
1365 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001366 int ispackage;
1367 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001368
1369 if (p == NULL)
1370 return 0;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001371 size = p->size;
1372 ispackage = (size < 0);
1373 if (ispackage)
1374 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001375 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001376 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001377 name, ispackage ? " package" : "");
1378 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001379 if (co == NULL)
1380 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001381 if (!PyCode_Check(co)) {
1382 Py_DECREF(co);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001383 PyErr_Format(PyExc_TypeError,
1384 "frozen object %.200s is not a code object",
1385 name);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001386 return -1;
1387 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001388 if (ispackage) {
1389 /* Set __path__ to the package name */
1390 PyObject *d, *s;
1391 int err;
1392 m = PyImport_AddModule(name);
1393 if (m == NULL)
1394 return -1;
1395 d = PyModule_GetDict(m);
1396 s = PyString_InternFromString(name);
1397 if (s == NULL)
1398 return -1;
1399 err = PyDict_SetItemString(d, "__path__", s);
1400 Py_DECREF(s);
1401 if (err != 0)
1402 return err;
1403 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001404 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum79f25d91997-04-29 20:08:16 +00001405 Py_DECREF(co);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001406 if (m == NULL)
1407 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001408 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001409 return 1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001410}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001411
1412
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001413/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001414 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001415
Guido van Rossum79f25d91997-04-29 20:08:16 +00001416PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001417PyImport_ImportModule(char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001418{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001419 PyObject *pname;
1420 PyObject *result;
1421
1422 pname = PyString_FromString(name);
1423 result = PyImport_Import(pname);
1424 Py_DECREF(pname);
1425 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001426}
1427
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001428/* Forward declarations for helper routines */
Tim Petersdbd9ba62000-07-09 03:09:57 +00001429static PyObject *get_parent(PyObject *globals, char *buf, int *p_buflen);
1430static PyObject *load_next(PyObject *mod, PyObject *altmod,
1431 char **p_name, char *buf, int *p_buflen);
1432static int mark_miss(char *name);
1433static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
1434 char *buf, int buflen, int recursive);
1435static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001436
1437/* The Magnum Opus of dotted-name import :-) */
1438
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001439static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001440import_module_ex(char *name, PyObject *globals, PyObject *locals,
1441 PyObject *fromlist)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001442{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001443 char buf[MAXPATHLEN+1];
1444 int buflen = 0;
1445 PyObject *parent, *head, *next, *tail;
1446
1447 parent = get_parent(globals, buf, &buflen);
1448 if (parent == NULL)
1449 return NULL;
1450
1451 head = load_next(parent, Py_None, &name, buf, &buflen);
1452 if (head == NULL)
1453 return NULL;
1454
1455 tail = head;
1456 Py_INCREF(tail);
1457 while (name) {
1458 next = load_next(tail, tail, &name, buf, &buflen);
1459 Py_DECREF(tail);
1460 if (next == NULL) {
1461 Py_DECREF(head);
1462 return NULL;
1463 }
1464 tail = next;
1465 }
1466
1467 if (fromlist != NULL) {
1468 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
1469 fromlist = NULL;
1470 }
1471
1472 if (fromlist == NULL) {
1473 Py_DECREF(tail);
1474 return head;
1475 }
1476
1477 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001478 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001479 Py_DECREF(tail);
1480 return NULL;
1481 }
1482
1483 return tail;
1484}
1485
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001486PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001487PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
1488 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001489{
1490 PyObject *result;
1491 lock_import();
Guido van Rossumd65911b1998-03-03 22:33:27 +00001492 result = import_module_ex(name, globals, locals, fromlist);
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001493 unlock_import();
1494 return result;
1495}
1496
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001497static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001498get_parent(PyObject *globals, char *buf, int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001499{
1500 static PyObject *namestr = NULL;
1501 static PyObject *pathstr = NULL;
1502 PyObject *modname, *modpath, *modules, *parent;
1503
1504 if (globals == NULL || !PyDict_Check(globals))
1505 return Py_None;
1506
1507 if (namestr == NULL) {
1508 namestr = PyString_InternFromString("__name__");
1509 if (namestr == NULL)
1510 return NULL;
1511 }
1512 if (pathstr == NULL) {
1513 pathstr = PyString_InternFromString("__path__");
1514 if (pathstr == NULL)
1515 return NULL;
1516 }
1517
1518 *buf = '\0';
1519 *p_buflen = 0;
1520 modname = PyDict_GetItem(globals, namestr);
1521 if (modname == NULL || !PyString_Check(modname))
1522 return Py_None;
1523
1524 modpath = PyDict_GetItem(globals, pathstr);
1525 if (modpath != NULL) {
1526 int len = PyString_GET_SIZE(modname);
1527 if (len > MAXPATHLEN) {
1528 PyErr_SetString(PyExc_ValueError,
1529 "Module name too long");
1530 return NULL;
1531 }
1532 strcpy(buf, PyString_AS_STRING(modname));
1533 *p_buflen = len;
1534 }
1535 else {
1536 char *start = PyString_AS_STRING(modname);
1537 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001538 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001539 if (lastdot == NULL)
1540 return Py_None;
1541 len = lastdot - start;
1542 if (len >= MAXPATHLEN) {
1543 PyErr_SetString(PyExc_ValueError,
1544 "Module name too long");
1545 return NULL;
1546 }
1547 strncpy(buf, start, len);
1548 buf[len] = '\0';
1549 *p_buflen = len;
1550 }
1551
1552 modules = PyImport_GetModuleDict();
1553 parent = PyDict_GetItemString(modules, buf);
1554 if (parent == NULL)
1555 parent = Py_None;
1556 return parent;
1557 /* We expect, but can't guarantee, if parent != None, that:
1558 - parent.__name__ == buf
1559 - parent.__dict__ is globals
1560 If this is violated... Who cares? */
1561}
1562
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001563/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001564static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001565load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
1566 int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001567{
1568 char *name = *p_name;
1569 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001570 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001571 char *p;
1572 PyObject *result;
1573
1574 if (dot == NULL) {
1575 *p_name = NULL;
1576 len = strlen(name);
1577 }
1578 else {
1579 *p_name = dot+1;
1580 len = dot-name;
1581 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00001582 if (len == 0) {
1583 PyErr_SetString(PyExc_ValueError,
1584 "Empty module name");
1585 return NULL;
1586 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001587
1588 p = buf + *p_buflen;
1589 if (p != buf)
1590 *p++ = '.';
1591 if (p+len-buf >= MAXPATHLEN) {
1592 PyErr_SetString(PyExc_ValueError,
1593 "Module name too long");
1594 return NULL;
1595 }
1596 strncpy(p, name, len);
1597 p[len] = '\0';
1598 *p_buflen = p+len-buf;
1599
1600 result = import_submodule(mod, p, buf);
1601 if (result == Py_None && altmod != mod) {
1602 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001603 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00001604 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001605 if (result != NULL && result != Py_None) {
1606 if (mark_miss(buf) != 0) {
1607 Py_DECREF(result);
1608 return NULL;
1609 }
1610 strncpy(buf, name, len);
1611 buf[len] = '\0';
1612 *p_buflen = len;
1613 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001614 }
1615 if (result == NULL)
1616 return NULL;
1617
1618 if (result == Py_None) {
1619 Py_DECREF(result);
1620 PyErr_Format(PyExc_ImportError,
1621 "No module named %.200s", name);
1622 return NULL;
1623 }
1624
1625 return result;
1626}
1627
1628static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001629mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001630{
1631 PyObject *modules = PyImport_GetModuleDict();
1632 return PyDict_SetItemString(modules, name, Py_None);
1633}
1634
1635static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001636ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, int buflen,
1637 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001638{
1639 int i;
1640
1641 if (!PyObject_HasAttrString(mod, "__path__"))
1642 return 1;
1643
1644 for (i = 0; ; i++) {
1645 PyObject *item = PySequence_GetItem(fromlist, i);
1646 int hasit;
1647 if (item == NULL) {
1648 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
1649 PyErr_Clear();
1650 return 1;
1651 }
1652 return 0;
1653 }
1654 if (!PyString_Check(item)) {
1655 PyErr_SetString(PyExc_TypeError,
1656 "Item in ``from list'' not a string");
1657 Py_DECREF(item);
1658 return 0;
1659 }
1660 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00001661 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001662 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001663 /* See if the package defines __all__ */
1664 if (recursive)
1665 continue; /* Avoid endless recursion */
1666 all = PyObject_GetAttrString(mod, "__all__");
1667 if (all == NULL)
1668 PyErr_Clear();
1669 else {
1670 if (!ensure_fromlist(mod, all, buf, buflen, 1))
1671 return 0;
1672 Py_DECREF(all);
1673 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001674 continue;
1675 }
1676 hasit = PyObject_HasAttr(mod, item);
1677 if (!hasit) {
1678 char *subname = PyString_AS_STRING(item);
1679 PyObject *submod;
1680 char *p;
1681 if (buflen + strlen(subname) >= MAXPATHLEN) {
1682 PyErr_SetString(PyExc_ValueError,
1683 "Module name too long");
1684 Py_DECREF(item);
1685 return 0;
1686 }
1687 p = buf + buflen;
1688 *p++ = '.';
1689 strcpy(p, subname);
1690 submod = import_submodule(mod, subname, buf);
1691 Py_XDECREF(submod);
1692 if (submod == NULL) {
1693 Py_DECREF(item);
1694 return 0;
1695 }
1696 }
1697 Py_DECREF(item);
1698 }
1699
Guido van Rossuma7f2e811997-10-03 15:33:32 +00001700 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001701}
1702
1703static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001704import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001705{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001706 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001707 PyObject *m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001708
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001709 /* Require:
1710 if mod == None: subname == fullname
1711 else: mod.__name__ + "." + subname == fullname
1712 */
1713
Tim Peters50d8d372001-02-28 05:34:27 +00001714 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001715 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001716 }
1717 else {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001718 PyObject *path;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001719 char buf[MAXPATHLEN+1];
1720 struct filedescr *fdp;
1721 FILE *fp = NULL;
1722
Guido van Rossum9c0afe51998-05-19 15:09:05 +00001723 if (mod == Py_None)
1724 path = NULL;
1725 else {
1726 path = PyObject_GetAttrString(mod, "__path__");
1727 if (path == NULL) {
1728 PyErr_Clear();
1729 Py_INCREF(Py_None);
1730 return Py_None;
1731 }
1732 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001733
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001734 buf[0] = '\0';
Guido van Rossumb68cd421998-07-01 17:36:26 +00001735 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1736 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001737 if (fdp == NULL) {
1738 if (!PyErr_ExceptionMatches(PyExc_ImportError))
1739 return NULL;
1740 PyErr_Clear();
1741 Py_INCREF(Py_None);
1742 return Py_None;
1743 }
1744 m = load_module(fullname, fp, buf, fdp->type);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001745 if (fp)
1746 fclose(fp);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001747 if (m != NULL && mod != Py_None) {
1748 if (PyObject_SetAttrString(mod, subname, m) < 0) {
1749 Py_DECREF(m);
1750 m = NULL;
1751 }
1752 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00001753 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001754
1755 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001756}
1757
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001758
1759/* Re-import a module of any kind and return its module object, WITH
1760 INCREMENTED REFERENCE COUNT */
1761
Guido van Rossum79f25d91997-04-29 20:08:16 +00001762PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001763PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001764{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001765 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum222ef561997-09-06 19:41:09 +00001766 PyObject *path = NULL;
1767 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001768 char buf[MAXPATHLEN+1];
1769 struct filedescr *fdp;
1770 FILE *fp = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001771
Guido van Rossum79f25d91997-04-29 20:08:16 +00001772 if (m == NULL || !PyModule_Check(m)) {
1773 PyErr_SetString(PyExc_TypeError,
1774 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001775 return NULL;
1776 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001777 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001778 if (name == NULL)
1779 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001780 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001781 PyErr_Format(PyExc_ImportError,
1782 "reload(): module %.200s not in sys.modules",
1783 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001784 return NULL;
1785 }
Guido van Rossum222ef561997-09-06 19:41:09 +00001786 subname = strrchr(name, '.');
1787 if (subname == NULL)
1788 subname = name;
1789 else {
1790 PyObject *parentname, *parent;
1791 parentname = PyString_FromStringAndSize(name, (subname-name));
1792 if (parentname == NULL)
1793 return NULL;
1794 parent = PyDict_GetItem(modules, parentname);
Barry Warsaw38793331999-01-27 17:54:20 +00001795 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00001796 if (parent == NULL) {
1797 PyErr_Format(PyExc_ImportError,
1798 "reload(): parent %.200s not in sys.modules",
1799 name);
1800 return NULL;
1801 }
1802 subname++;
1803 path = PyObject_GetAttrString(parent, "__path__");
1804 if (path == NULL)
1805 PyErr_Clear();
1806 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001807 buf[0] = '\0';
Guido van Rossum222ef561997-09-06 19:41:09 +00001808 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1809 Py_XDECREF(path);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001810 if (fdp == NULL)
1811 return NULL;
1812 m = load_module(name, fp, buf, fdp->type);
1813 if (fp)
1814 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001815 return m;
1816}
1817
1818
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001819/* Higher-level import emulator which emulates the "import" statement
1820 more accurately -- it invokes the __import__() function from the
1821 builtins of the current globals. This means that the import is
1822 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00001823 environment, e.g. by "rexec".
1824 A dummy list ["__doc__"] is passed as the 4th argument so that
1825 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
1826 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001827
1828PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001829PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001830{
1831 static PyObject *silly_list = NULL;
1832 static PyObject *builtins_str = NULL;
1833 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001834 PyObject *globals = NULL;
1835 PyObject *import = NULL;
1836 PyObject *builtins = NULL;
1837 PyObject *r = NULL;
1838
1839 /* Initialize constant string objects */
1840 if (silly_list == NULL) {
1841 import_str = PyString_InternFromString("__import__");
1842 if (import_str == NULL)
1843 return NULL;
1844 builtins_str = PyString_InternFromString("__builtins__");
1845 if (builtins_str == NULL)
1846 return NULL;
1847 silly_list = Py_BuildValue("[s]", "__doc__");
1848 if (silly_list == NULL)
1849 return NULL;
1850 }
1851
1852 /* Get the builtins from current globals */
1853 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00001854 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00001855 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001856 builtins = PyObject_GetItem(globals, builtins_str);
1857 if (builtins == NULL)
1858 goto err;
1859 }
1860 else {
1861 /* No globals -- use standard builtins, and fake globals */
1862 PyErr_Clear();
1863
Guido van Rossum85cd1d62001-02-20 21:43:24 +00001864 builtins = PyImport_ImportModuleEx("__builtin__",
1865 NULL, NULL, NULL);
1866 if (builtins == NULL)
1867 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001868 globals = Py_BuildValue("{OO}", builtins_str, builtins);
1869 if (globals == NULL)
1870 goto err;
1871 }
1872
1873 /* Get the __import__ function from the builtins */
1874 if (PyDict_Check(builtins))
1875 import=PyObject_GetItem(builtins, import_str);
1876 else
1877 import=PyObject_GetAttr(builtins, import_str);
1878 if (import == NULL)
1879 goto err;
1880
1881 /* Call the _import__ function with the proper argument list */
1882 r = PyObject_CallFunction(import, "OOOO",
1883 module_name, globals, globals, silly_list);
1884
1885 err:
1886 Py_XDECREF(globals);
1887 Py_XDECREF(builtins);
1888 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00001889
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001890 return r;
1891}
1892
1893
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001894/* Module 'imp' provides Python access to the primitives used for
1895 importing modules.
1896*/
1897
Guido van Rossum79f25d91997-04-29 20:08:16 +00001898static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001899imp_get_magic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001900{
1901 char buf[4];
1902
Guido van Rossum43713e52000-02-29 13:59:29 +00001903 if (!PyArg_ParseTuple(args, ":get_magic"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001904 return NULL;
Guido van Rossum96774c12000-05-01 20:19:08 +00001905 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
1906 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
1907 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
1908 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001909
Guido van Rossum79f25d91997-04-29 20:08:16 +00001910 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001911}
1912
Guido van Rossum79f25d91997-04-29 20:08:16 +00001913static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001914imp_get_suffixes(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001915{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001916 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001917 struct filedescr *fdp;
1918
Guido van Rossum43713e52000-02-29 13:59:29 +00001919 if (!PyArg_ParseTuple(args, ":get_suffixes"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001920 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001921 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001922 if (list == NULL)
1923 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001924 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
1925 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001926 fdp->suffix, fdp->mode, fdp->type);
1927 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001928 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001929 return NULL;
1930 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001931 if (PyList_Append(list, item) < 0) {
1932 Py_DECREF(list);
1933 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001934 return NULL;
1935 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001936 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001937 }
1938 return list;
1939}
1940
Guido van Rossum79f25d91997-04-29 20:08:16 +00001941static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001942call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001943{
Tim Petersdbd9ba62000-07-09 03:09:57 +00001944 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001945 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001946 struct filedescr *fdp;
1947 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001948 FILE *fp = NULL;
1949
1950 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001951 if (path == Py_None)
1952 path = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001953 fdp = find_module(name, path, pathname, MAXPATHLEN+1, &fp);
1954 if (fdp == NULL)
1955 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001956 if (fp != NULL) {
1957 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
1958 if (fob == NULL) {
1959 fclose(fp);
1960 return NULL;
1961 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001962 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001963 else {
1964 fob = Py_None;
1965 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00001966 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001967 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001968 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001969 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001970 return ret;
1971}
1972
Guido van Rossum79f25d91997-04-29 20:08:16 +00001973static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001974imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001975{
1976 char *name;
1977 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00001978 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001979 return NULL;
1980 return call_find_module(name, path);
1981}
1982
1983static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001984imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001985{
1986 char *name;
1987 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001988 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00001989 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001990 return NULL;
1991 ret = init_builtin(name);
1992 if (ret < 0)
1993 return NULL;
1994 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001995 Py_INCREF(Py_None);
1996 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001997 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001998 m = PyImport_AddModule(name);
1999 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002000 return m;
2001}
2002
Guido van Rossum79f25d91997-04-29 20:08:16 +00002003static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002004imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002005{
2006 char *name;
2007 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002008 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002009 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002010 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002011 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002012 if (ret < 0)
2013 return NULL;
2014 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002015 Py_INCREF(Py_None);
2016 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002017 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002018 m = PyImport_AddModule(name);
2019 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002020 return m;
2021}
2022
Guido van Rossum79f25d91997-04-29 20:08:16 +00002023static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002024imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002025{
2026 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002027
Guido van Rossum43713e52000-02-29 13:59:29 +00002028 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002029 return NULL;
2030 return get_frozen_object(name);
2031}
2032
Guido van Rossum79f25d91997-04-29 20:08:16 +00002033static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002034imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002035{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002036 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002037 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002038 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002039 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002040}
2041
Guido van Rossum79f25d91997-04-29 20:08:16 +00002042static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002043imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002044{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002045 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002046 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002047 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002048 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002049 p = find_frozen(name);
2050 return PyInt_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002051}
2052
2053static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002054get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002055{
2056 FILE *fp;
2057 if (fob == NULL) {
2058 fp = fopen(pathname, mode);
2059 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002060 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002061 }
2062 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002063 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002064 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002065 PyErr_SetString(PyExc_ValueError,
2066 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002067 }
2068 return fp;
2069}
2070
Guido van Rossum79f25d91997-04-29 20:08:16 +00002071static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002072imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002073{
2074 char *name;
2075 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002076 PyObject *fob = NULL;
2077 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002078 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002079 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002080 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002081 return NULL;
2082 fp = get_file(pathname, fob, "rb");
2083 if (fp == NULL)
2084 return NULL;
2085 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002086 if (fob == NULL)
2087 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002088 return m;
2089}
2090
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002091#ifdef HAVE_DYNAMIC_LOADING
2092
Guido van Rossum79f25d91997-04-29 20:08:16 +00002093static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002094imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002095{
2096 char *name;
2097 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002098 PyObject *fob = NULL;
2099 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002100 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002101 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002102 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002103 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002104 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002105 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002106 if (fp == NULL)
2107 return NULL;
2108 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002109 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002110 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002111}
2112
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002113#endif /* HAVE_DYNAMIC_LOADING */
2114
Guido van Rossum79f25d91997-04-29 20:08:16 +00002115static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002116imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002117{
2118 char *name;
2119 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002120 PyObject *fob = NULL;
2121 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002122 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002123 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002124 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002125 return NULL;
2126 fp = get_file(pathname, fob, "r");
2127 if (fp == NULL)
2128 return NULL;
2129 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002130 if (fob == NULL)
2131 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002132 return m;
2133}
2134
Jack Jansen9c96a921995-02-15 22:57:06 +00002135#ifdef macintosh
Guido van Rossum79f25d91997-04-29 20:08:16 +00002136static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002137imp_load_resource(PyObject *self, PyObject *args)
Jack Jansen9c96a921995-02-15 22:57:06 +00002138{
2139 char *name;
2140 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002141 PyObject *m;
Jack Jansen9c96a921995-02-15 22:57:06 +00002142
Guido van Rossum43713e52000-02-29 13:59:29 +00002143 if (!PyArg_ParseTuple(args, "ss:load_resource", &name, &pathname))
Jack Jansen9c96a921995-02-15 22:57:06 +00002144 return NULL;
2145 m = PyMac_LoadResourceModule(name, pathname);
2146 return m;
2147}
2148#endif /* macintosh */
2149
Guido van Rossum79f25d91997-04-29 20:08:16 +00002150static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002151imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002152{
2153 char *name;
2154 PyObject *fob;
2155 char *pathname;
2156 char *suffix; /* Unused */
2157 char *mode;
2158 int type;
2159 FILE *fp;
2160
Guido van Rossum43713e52000-02-29 13:59:29 +00002161 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002162 &name, &fob, &pathname,
2163 &suffix, &mode, &type))
2164 return NULL;
2165 if (*mode && (*mode != 'r' || strchr(mode, '+') != NULL)) {
2166 PyErr_Format(PyExc_ValueError,
2167 "invalid file open mode %.200s", mode);
2168 return NULL;
2169 }
2170 if (fob == Py_None)
2171 fp = NULL;
2172 else {
2173 if (!PyFile_Check(fob)) {
2174 PyErr_SetString(PyExc_ValueError,
2175 "load_module arg#2 should be a file or None");
2176 return NULL;
2177 }
2178 fp = get_file(pathname, fob, mode);
2179 if (fp == NULL)
2180 return NULL;
2181 }
2182 return load_module(name, fp, pathname, type);
2183}
2184
2185static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002186imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002187{
2188 char *name;
2189 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002190 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002191 return NULL;
2192 return load_package(name, pathname);
2193}
2194
2195static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002196imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002197{
2198 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002199 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002200 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002201 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002202}
2203
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002204/* Doc strings */
2205
2206static char doc_imp[] = "\
2207This module provides the components needed to build your own\n\
2208__import__ function. Undocumented functions are obsolete.\n\
2209";
2210
2211static char doc_find_module[] = "\
2212find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
2213Search for a module. If path is omitted or None, search for a\n\
2214built-in, frozen or special module and continue search in sys.path.\n\
2215The module name cannot contain '.'; to search for a submodule of a\n\
2216package, pass the submodule name and the package's __path__.\
2217";
2218
2219static char doc_load_module[] = "\
2220load_module(name, file, filename, (suffix, mode, type)) -> module\n\
2221Load a module, given information returned by find_module().\n\
2222The module name must include the full package name, if any.\
2223";
2224
2225static char doc_get_magic[] = "\
2226get_magic() -> string\n\
2227Return the magic number for .pyc or .pyo files.\
2228";
2229
2230static char doc_get_suffixes[] = "\
2231get_suffixes() -> [(suffix, mode, type), ...]\n\
2232Return a list of (suffix, mode, type) tuples describing the files\n\
2233that find_module() looks for.\
2234";
2235
2236static char doc_new_module[] = "\
2237new_module(name) -> module\n\
2238Create a new module. Do not enter it in sys.modules.\n\
2239The module name must include the full package name, if any.\
2240";
2241
Guido van Rossum79f25d91997-04-29 20:08:16 +00002242static PyMethodDef imp_methods[] = {
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002243 {"find_module", imp_find_module, 1, doc_find_module},
2244 {"get_magic", imp_get_magic, 1, doc_get_magic},
2245 {"get_suffixes", imp_get_suffixes, 1, doc_get_suffixes},
2246 {"load_module", imp_load_module, 1, doc_load_module},
2247 {"new_module", imp_new_module, 1, doc_new_module},
2248 /* The rest are obsolete */
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002249 {"get_frozen_object", imp_get_frozen_object, 1},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002250 {"init_builtin", imp_init_builtin, 1},
2251 {"init_frozen", imp_init_frozen, 1},
2252 {"is_builtin", imp_is_builtin, 1},
2253 {"is_frozen", imp_is_frozen, 1},
2254 {"load_compiled", imp_load_compiled, 1},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002255#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002256 {"load_dynamic", imp_load_dynamic, 1},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002257#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002258 {"load_package", imp_load_package, 1},
Jack Jansen9c96a921995-02-15 22:57:06 +00002259#ifdef macintosh
2260 {"load_resource", imp_load_resource, 1},
2261#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002262 {"load_source", imp_load_source, 1},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002263 {NULL, NULL} /* sentinel */
2264};
2265
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002266static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002267setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002268{
2269 PyObject *v;
2270 int err;
2271
2272 v = PyInt_FromLong((long)value);
2273 err = PyDict_SetItemString(d, name, v);
2274 Py_XDECREF(v);
2275 return err;
2276}
2277
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002278void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002279initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002280{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002281 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002282
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002283 m = Py_InitModule4("imp", imp_methods, doc_imp,
2284 NULL, PYTHON_API_VERSION);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002285 d = PyModule_GetDict(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002286
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002287 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
2288 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
2289 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
2290 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
2291 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
2292 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
2293 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
2294 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00002295 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002296
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002297 failure:
2298 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002299}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002300
2301
Guido van Rossumb18618d2000-05-03 23:44:39 +00002302/* API for embedding applications that want to add their own entries
2303 to the table of built-in modules. This should normally be called
2304 *before* Py_Initialize(). When the table resize fails, -1 is
2305 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002306
2307 After a similar function by Just van Rossum. */
2308
2309int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002310PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002311{
2312 static struct _inittab *our_copy = NULL;
2313 struct _inittab *p;
2314 int i, n;
2315
2316 /* Count the number of entries in both tables */
2317 for (n = 0; newtab[n].name != NULL; n++)
2318 ;
2319 if (n == 0)
2320 return 0; /* Nothing to do */
2321 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
2322 ;
2323
2324 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00002325 p = our_copy;
2326 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002327 if (p == NULL)
2328 return -1;
2329
2330 /* Copy the tables into the new memory */
2331 if (our_copy != PyImport_Inittab)
2332 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
2333 PyImport_Inittab = our_copy = p;
2334 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
2335
2336 return 0;
2337}
2338
2339/* Shorthand to add a single entry given a name and a function */
2340
2341int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002342PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002343{
2344 struct _inittab newtab[2];
2345
2346 memset(newtab, '\0', sizeof newtab);
2347
2348 newtab[0].name = name;
2349 newtab[0].initfunc = initfunc;
2350
2351 return PyImport_ExtendInittab(newtab);
2352}