blob: 114287583cc99005bb3231683d5723c63de128db [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;
1114 char pathname[MAX_PATH + 1];
1115 const int pathlen = len - namelen - 1; /* don't want trailing SEP */
1116
1117 /* Copy the path component into pathname; substitute "." if empty */
1118 if (pathlen <= 0) {
1119 pathname[0] = '.';
1120 pathname[1] = '\0';
1121 }
1122 else {
1123 assert(pathlen <= MAX_PATH);
1124 memcpy(pathname, buf, pathlen);
1125 pathname[pathlen] = '\0';
1126 }
1127 /* Open the directory and search the entries for an exact match. */
1128 dirp = opendir(pathname);
1129 if (dirp) {
1130 while ((dp = readdir(dirp)) != NULL) {
1131#ifdef _DIRENT_HAVE_D_NAMELEN
1132 const int thislen = dp->d_namlen;
1133#else
1134 const int thislen = strlen(dp->d_name);
1135#endif
1136 if (thislen == namelen && !strcmp(dp->d_name, name)) {
1137 (void)closedir(dirp);
1138 return 1; /* Found */
1139 }
1140 }
1141 }
1142 (void)closedir(dirp);
1143 return 0 ; /* Not found */
Tim Peters430f5d42001-03-01 01:30:56 +00001144
Tim Peters50d8d372001-02-28 05:34:27 +00001145/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1146#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001147 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001148
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001149#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001150}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001151
Guido van Rossum0980bd91998-02-13 17:18:36 +00001152
Guido van Rossum197346f1997-10-31 18:38:52 +00001153#ifdef HAVE_STAT
1154/* Helper to look for __init__.py or __init__.py[co] in potential package */
1155static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001156find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001157{
Fred Drake4c82b232000-06-30 16:18:57 +00001158 size_t save_len = strlen(buf);
1159 size_t i = save_len;
Guido van Rossum197346f1997-10-31 18:38:52 +00001160 struct stat statbuf;
1161
1162 if (save_len + 13 >= MAXPATHLEN)
1163 return 0;
1164 buf[i++] = SEP;
1165 strcpy(buf+i, "__init__.py");
1166 if (stat(buf, &statbuf) == 0) {
1167 buf[save_len] = '\0';
1168 return 1;
1169 }
1170 i += strlen(buf+i);
1171 if (Py_OptimizeFlag)
1172 strcpy(buf+i, "o");
1173 else
1174 strcpy(buf+i, "c");
1175 if (stat(buf, &statbuf) == 0) {
1176 buf[save_len] = '\0';
1177 return 1;
1178 }
1179 buf[save_len] = '\0';
1180 return 0;
1181}
1182#endif /* HAVE_STAT */
1183
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001184
Tim Petersdbd9ba62000-07-09 03:09:57 +00001185static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001186
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001187/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001188 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001189
Guido van Rossum79f25d91997-04-29 20:08:16 +00001190static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001191load_module(char *name, FILE *fp, char *buf, int type)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001192{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001193 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001194 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001195 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001196
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001197 /* First check that there's an open file (if we need one) */
1198 switch (type) {
1199 case PY_SOURCE:
1200 case PY_COMPILED:
1201 if (fp == NULL) {
1202 PyErr_Format(PyExc_ValueError,
1203 "file object required for import (type code %d)",
1204 type);
1205 return NULL;
1206 }
1207 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001208
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001209 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001210
1211 case PY_SOURCE:
1212 m = load_source_module(name, buf, fp);
1213 break;
1214
1215 case PY_COMPILED:
1216 m = load_compiled_module(name, buf, fp);
1217 break;
1218
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001219#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001220 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001221 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001222 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001223#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001224
Jack Jansen9c96a921995-02-15 22:57:06 +00001225#ifdef macintosh
1226 case PY_RESOURCE:
1227 m = PyMac_LoadResourceModule(name, buf);
1228 break;
Guido van Rossum0f84a341998-08-06 13:36:01 +00001229 case PY_CODERESOURCE:
1230 m = PyMac_LoadCodeResourceModule(name, buf);
1231 break;
Jack Jansen9c96a921995-02-15 22:57:06 +00001232#endif
1233
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001234 case PKG_DIRECTORY:
1235 m = load_package(name, buf);
1236 break;
1237
1238 case C_BUILTIN:
1239 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001240 if (buf != NULL && buf[0] != '\0')
1241 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001242 if (type == C_BUILTIN)
1243 err = init_builtin(name);
1244 else
1245 err = PyImport_ImportFrozenModule(name);
1246 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001247 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001248 if (err == 0) {
1249 PyErr_Format(PyExc_ImportError,
1250 "Purported %s module %.200s not found",
1251 type == C_BUILTIN ?
1252 "builtin" : "frozen",
1253 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001254 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001255 }
1256 modules = PyImport_GetModuleDict();
1257 m = PyDict_GetItemString(modules, name);
1258 if (m == NULL) {
1259 PyErr_Format(
1260 PyExc_ImportError,
1261 "%s module %.200s not properly initialized",
1262 type == C_BUILTIN ?
1263 "builtin" : "frozen",
1264 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001265 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001266 }
1267 Py_INCREF(m);
1268 break;
1269
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001270 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001271 PyErr_Format(PyExc_ImportError,
1272 "Don't know how to import %.200s (type code %d)",
1273 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001274 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001275
1276 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001277
1278 return m;
1279}
1280
1281
1282/* Initialize a built-in module.
1283 Return 1 for succes, 0 if the module is not found, and -1 with
1284 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001285
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001286static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001287init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001288{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001289 struct _inittab *p;
1290 PyObject *mod;
1291
1292 if ((mod = _PyImport_FindExtension(name, name)) != NULL)
1293 return 1;
1294
Guido van Rossum771c6c81997-10-31 18:37:24 +00001295 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001296 if (strcmp(name, p->name) == 0) {
1297 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001298 PyErr_Format(PyExc_ImportError,
1299 "Cannot re-init internal module %.200s",
1300 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001301 return -1;
1302 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001303 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001304 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001305 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001306 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001307 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001308 if (_PyImport_FixupExtension(name, name) == NULL)
1309 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001310 return 1;
1311 }
1312 }
1313 return 0;
1314}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001315
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001316
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001317/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001318
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001319static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001320find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001321{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001322 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001323
Guido van Rossum79f25d91997-04-29 20:08:16 +00001324 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001325 if (p->name == NULL)
1326 return NULL;
1327 if (strcmp(p->name, name) == 0)
1328 break;
1329 }
1330 return p;
1331}
1332
Guido van Rossum79f25d91997-04-29 20:08:16 +00001333static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001334get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001335{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001336 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001337 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001338
1339 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001340 PyErr_Format(PyExc_ImportError,
1341 "No such frozen object named %.200s",
1342 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001343 return NULL;
1344 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001345 size = p->size;
1346 if (size < 0)
1347 size = -size;
1348 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001349}
1350
1351/* Initialize a frozen module.
1352 Return 1 for succes, 0 if the module is not found, and -1 with
1353 an exception set if the initialization failed.
1354 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001355
1356int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001357PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001358{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001359 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001360 PyObject *co;
1361 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001362 int ispackage;
1363 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001364
1365 if (p == NULL)
1366 return 0;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001367 size = p->size;
1368 ispackage = (size < 0);
1369 if (ispackage)
1370 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001371 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001372 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001373 name, ispackage ? " package" : "");
1374 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001375 if (co == NULL)
1376 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001377 if (!PyCode_Check(co)) {
1378 Py_DECREF(co);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001379 PyErr_Format(PyExc_TypeError,
1380 "frozen object %.200s is not a code object",
1381 name);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001382 return -1;
1383 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001384 if (ispackage) {
1385 /* Set __path__ to the package name */
1386 PyObject *d, *s;
1387 int err;
1388 m = PyImport_AddModule(name);
1389 if (m == NULL)
1390 return -1;
1391 d = PyModule_GetDict(m);
1392 s = PyString_InternFromString(name);
1393 if (s == NULL)
1394 return -1;
1395 err = PyDict_SetItemString(d, "__path__", s);
1396 Py_DECREF(s);
1397 if (err != 0)
1398 return err;
1399 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001400 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum79f25d91997-04-29 20:08:16 +00001401 Py_DECREF(co);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001402 if (m == NULL)
1403 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001404 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001405 return 1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001406}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001407
1408
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001409/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001410 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001411
Guido van Rossum79f25d91997-04-29 20:08:16 +00001412PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001413PyImport_ImportModule(char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001414{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001415 PyObject *pname;
1416 PyObject *result;
1417
1418 pname = PyString_FromString(name);
1419 result = PyImport_Import(pname);
1420 Py_DECREF(pname);
1421 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001422}
1423
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001424/* Forward declarations for helper routines */
Tim Petersdbd9ba62000-07-09 03:09:57 +00001425static PyObject *get_parent(PyObject *globals, char *buf, int *p_buflen);
1426static PyObject *load_next(PyObject *mod, PyObject *altmod,
1427 char **p_name, char *buf, int *p_buflen);
1428static int mark_miss(char *name);
1429static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
1430 char *buf, int buflen, int recursive);
1431static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001432
1433/* The Magnum Opus of dotted-name import :-) */
1434
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001435static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001436import_module_ex(char *name, PyObject *globals, PyObject *locals,
1437 PyObject *fromlist)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001438{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001439 char buf[MAXPATHLEN+1];
1440 int buflen = 0;
1441 PyObject *parent, *head, *next, *tail;
1442
1443 parent = get_parent(globals, buf, &buflen);
1444 if (parent == NULL)
1445 return NULL;
1446
1447 head = load_next(parent, Py_None, &name, buf, &buflen);
1448 if (head == NULL)
1449 return NULL;
1450
1451 tail = head;
1452 Py_INCREF(tail);
1453 while (name) {
1454 next = load_next(tail, tail, &name, buf, &buflen);
1455 Py_DECREF(tail);
1456 if (next == NULL) {
1457 Py_DECREF(head);
1458 return NULL;
1459 }
1460 tail = next;
1461 }
1462
1463 if (fromlist != NULL) {
1464 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
1465 fromlist = NULL;
1466 }
1467
1468 if (fromlist == NULL) {
1469 Py_DECREF(tail);
1470 return head;
1471 }
1472
1473 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001474 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001475 Py_DECREF(tail);
1476 return NULL;
1477 }
1478
1479 return tail;
1480}
1481
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001482PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001483PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
1484 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001485{
1486 PyObject *result;
1487 lock_import();
Guido van Rossumd65911b1998-03-03 22:33:27 +00001488 result = import_module_ex(name, globals, locals, fromlist);
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001489 unlock_import();
1490 return result;
1491}
1492
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001493static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001494get_parent(PyObject *globals, char *buf, int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001495{
1496 static PyObject *namestr = NULL;
1497 static PyObject *pathstr = NULL;
1498 PyObject *modname, *modpath, *modules, *parent;
1499
1500 if (globals == NULL || !PyDict_Check(globals))
1501 return Py_None;
1502
1503 if (namestr == NULL) {
1504 namestr = PyString_InternFromString("__name__");
1505 if (namestr == NULL)
1506 return NULL;
1507 }
1508 if (pathstr == NULL) {
1509 pathstr = PyString_InternFromString("__path__");
1510 if (pathstr == NULL)
1511 return NULL;
1512 }
1513
1514 *buf = '\0';
1515 *p_buflen = 0;
1516 modname = PyDict_GetItem(globals, namestr);
1517 if (modname == NULL || !PyString_Check(modname))
1518 return Py_None;
1519
1520 modpath = PyDict_GetItem(globals, pathstr);
1521 if (modpath != NULL) {
1522 int len = PyString_GET_SIZE(modname);
1523 if (len > MAXPATHLEN) {
1524 PyErr_SetString(PyExc_ValueError,
1525 "Module name too long");
1526 return NULL;
1527 }
1528 strcpy(buf, PyString_AS_STRING(modname));
1529 *p_buflen = len;
1530 }
1531 else {
1532 char *start = PyString_AS_STRING(modname);
1533 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001534 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001535 if (lastdot == NULL)
1536 return Py_None;
1537 len = lastdot - start;
1538 if (len >= MAXPATHLEN) {
1539 PyErr_SetString(PyExc_ValueError,
1540 "Module name too long");
1541 return NULL;
1542 }
1543 strncpy(buf, start, len);
1544 buf[len] = '\0';
1545 *p_buflen = len;
1546 }
1547
1548 modules = PyImport_GetModuleDict();
1549 parent = PyDict_GetItemString(modules, buf);
1550 if (parent == NULL)
1551 parent = Py_None;
1552 return parent;
1553 /* We expect, but can't guarantee, if parent != None, that:
1554 - parent.__name__ == buf
1555 - parent.__dict__ is globals
1556 If this is violated... Who cares? */
1557}
1558
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001559/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001560static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001561load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
1562 int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001563{
1564 char *name = *p_name;
1565 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001566 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001567 char *p;
1568 PyObject *result;
1569
1570 if (dot == NULL) {
1571 *p_name = NULL;
1572 len = strlen(name);
1573 }
1574 else {
1575 *p_name = dot+1;
1576 len = dot-name;
1577 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00001578 if (len == 0) {
1579 PyErr_SetString(PyExc_ValueError,
1580 "Empty module name");
1581 return NULL;
1582 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001583
1584 p = buf + *p_buflen;
1585 if (p != buf)
1586 *p++ = '.';
1587 if (p+len-buf >= MAXPATHLEN) {
1588 PyErr_SetString(PyExc_ValueError,
1589 "Module name too long");
1590 return NULL;
1591 }
1592 strncpy(p, name, len);
1593 p[len] = '\0';
1594 *p_buflen = p+len-buf;
1595
1596 result = import_submodule(mod, p, buf);
1597 if (result == Py_None && altmod != mod) {
1598 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001599 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00001600 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001601 if (result != NULL && result != Py_None) {
1602 if (mark_miss(buf) != 0) {
1603 Py_DECREF(result);
1604 return NULL;
1605 }
1606 strncpy(buf, name, len);
1607 buf[len] = '\0';
1608 *p_buflen = len;
1609 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001610 }
1611 if (result == NULL)
1612 return NULL;
1613
1614 if (result == Py_None) {
1615 Py_DECREF(result);
1616 PyErr_Format(PyExc_ImportError,
1617 "No module named %.200s", name);
1618 return NULL;
1619 }
1620
1621 return result;
1622}
1623
1624static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001625mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001626{
1627 PyObject *modules = PyImport_GetModuleDict();
1628 return PyDict_SetItemString(modules, name, Py_None);
1629}
1630
1631static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001632ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, int buflen,
1633 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001634{
1635 int i;
1636
1637 if (!PyObject_HasAttrString(mod, "__path__"))
1638 return 1;
1639
1640 for (i = 0; ; i++) {
1641 PyObject *item = PySequence_GetItem(fromlist, i);
1642 int hasit;
1643 if (item == NULL) {
1644 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
1645 PyErr_Clear();
1646 return 1;
1647 }
1648 return 0;
1649 }
1650 if (!PyString_Check(item)) {
1651 PyErr_SetString(PyExc_TypeError,
1652 "Item in ``from list'' not a string");
1653 Py_DECREF(item);
1654 return 0;
1655 }
1656 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00001657 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001658 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001659 /* See if the package defines __all__ */
1660 if (recursive)
1661 continue; /* Avoid endless recursion */
1662 all = PyObject_GetAttrString(mod, "__all__");
1663 if (all == NULL)
1664 PyErr_Clear();
1665 else {
1666 if (!ensure_fromlist(mod, all, buf, buflen, 1))
1667 return 0;
1668 Py_DECREF(all);
1669 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001670 continue;
1671 }
1672 hasit = PyObject_HasAttr(mod, item);
1673 if (!hasit) {
1674 char *subname = PyString_AS_STRING(item);
1675 PyObject *submod;
1676 char *p;
1677 if (buflen + strlen(subname) >= MAXPATHLEN) {
1678 PyErr_SetString(PyExc_ValueError,
1679 "Module name too long");
1680 Py_DECREF(item);
1681 return 0;
1682 }
1683 p = buf + buflen;
1684 *p++ = '.';
1685 strcpy(p, subname);
1686 submod = import_submodule(mod, subname, buf);
1687 Py_XDECREF(submod);
1688 if (submod == NULL) {
1689 Py_DECREF(item);
1690 return 0;
1691 }
1692 }
1693 Py_DECREF(item);
1694 }
1695
Guido van Rossuma7f2e811997-10-03 15:33:32 +00001696 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001697}
1698
1699static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001700import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001701{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001702 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001703 PyObject *m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001704
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001705 /* Require:
1706 if mod == None: subname == fullname
1707 else: mod.__name__ + "." + subname == fullname
1708 */
1709
Tim Peters50d8d372001-02-28 05:34:27 +00001710 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001711 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001712 }
1713 else {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001714 PyObject *path;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001715 char buf[MAXPATHLEN+1];
1716 struct filedescr *fdp;
1717 FILE *fp = NULL;
1718
Guido van Rossum9c0afe51998-05-19 15:09:05 +00001719 if (mod == Py_None)
1720 path = NULL;
1721 else {
1722 path = PyObject_GetAttrString(mod, "__path__");
1723 if (path == NULL) {
1724 PyErr_Clear();
1725 Py_INCREF(Py_None);
1726 return Py_None;
1727 }
1728 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001729
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001730 buf[0] = '\0';
Guido van Rossumb68cd421998-07-01 17:36:26 +00001731 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1732 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001733 if (fdp == NULL) {
1734 if (!PyErr_ExceptionMatches(PyExc_ImportError))
1735 return NULL;
1736 PyErr_Clear();
1737 Py_INCREF(Py_None);
1738 return Py_None;
1739 }
1740 m = load_module(fullname, fp, buf, fdp->type);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001741 if (fp)
1742 fclose(fp);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001743 if (m != NULL && mod != Py_None) {
1744 if (PyObject_SetAttrString(mod, subname, m) < 0) {
1745 Py_DECREF(m);
1746 m = NULL;
1747 }
1748 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00001749 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001750
1751 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001752}
1753
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001754
1755/* Re-import a module of any kind and return its module object, WITH
1756 INCREMENTED REFERENCE COUNT */
1757
Guido van Rossum79f25d91997-04-29 20:08:16 +00001758PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001759PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001760{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001761 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum222ef561997-09-06 19:41:09 +00001762 PyObject *path = NULL;
1763 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001764 char buf[MAXPATHLEN+1];
1765 struct filedescr *fdp;
1766 FILE *fp = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001767
Guido van Rossum79f25d91997-04-29 20:08:16 +00001768 if (m == NULL || !PyModule_Check(m)) {
1769 PyErr_SetString(PyExc_TypeError,
1770 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001771 return NULL;
1772 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001773 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001774 if (name == NULL)
1775 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001776 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001777 PyErr_Format(PyExc_ImportError,
1778 "reload(): module %.200s not in sys.modules",
1779 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001780 return NULL;
1781 }
Guido van Rossum222ef561997-09-06 19:41:09 +00001782 subname = strrchr(name, '.');
1783 if (subname == NULL)
1784 subname = name;
1785 else {
1786 PyObject *parentname, *parent;
1787 parentname = PyString_FromStringAndSize(name, (subname-name));
1788 if (parentname == NULL)
1789 return NULL;
1790 parent = PyDict_GetItem(modules, parentname);
Barry Warsaw38793331999-01-27 17:54:20 +00001791 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00001792 if (parent == NULL) {
1793 PyErr_Format(PyExc_ImportError,
1794 "reload(): parent %.200s not in sys.modules",
1795 name);
1796 return NULL;
1797 }
1798 subname++;
1799 path = PyObject_GetAttrString(parent, "__path__");
1800 if (path == NULL)
1801 PyErr_Clear();
1802 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001803 buf[0] = '\0';
Guido van Rossum222ef561997-09-06 19:41:09 +00001804 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1805 Py_XDECREF(path);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001806 if (fdp == NULL)
1807 return NULL;
1808 m = load_module(name, fp, buf, fdp->type);
1809 if (fp)
1810 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001811 return m;
1812}
1813
1814
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001815/* Higher-level import emulator which emulates the "import" statement
1816 more accurately -- it invokes the __import__() function from the
1817 builtins of the current globals. This means that the import is
1818 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00001819 environment, e.g. by "rexec".
1820 A dummy list ["__doc__"] is passed as the 4th argument so that
1821 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
1822 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001823
1824PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001825PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001826{
1827 static PyObject *silly_list = NULL;
1828 static PyObject *builtins_str = NULL;
1829 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001830 PyObject *globals = NULL;
1831 PyObject *import = NULL;
1832 PyObject *builtins = NULL;
1833 PyObject *r = NULL;
1834
1835 /* Initialize constant string objects */
1836 if (silly_list == NULL) {
1837 import_str = PyString_InternFromString("__import__");
1838 if (import_str == NULL)
1839 return NULL;
1840 builtins_str = PyString_InternFromString("__builtins__");
1841 if (builtins_str == NULL)
1842 return NULL;
1843 silly_list = Py_BuildValue("[s]", "__doc__");
1844 if (silly_list == NULL)
1845 return NULL;
1846 }
1847
1848 /* Get the builtins from current globals */
1849 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00001850 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00001851 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001852 builtins = PyObject_GetItem(globals, builtins_str);
1853 if (builtins == NULL)
1854 goto err;
1855 }
1856 else {
1857 /* No globals -- use standard builtins, and fake globals */
1858 PyErr_Clear();
1859
Guido van Rossum85cd1d62001-02-20 21:43:24 +00001860 builtins = PyImport_ImportModuleEx("__builtin__",
1861 NULL, NULL, NULL);
1862 if (builtins == NULL)
1863 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001864 globals = Py_BuildValue("{OO}", builtins_str, builtins);
1865 if (globals == NULL)
1866 goto err;
1867 }
1868
1869 /* Get the __import__ function from the builtins */
1870 if (PyDict_Check(builtins))
1871 import=PyObject_GetItem(builtins, import_str);
1872 else
1873 import=PyObject_GetAttr(builtins, import_str);
1874 if (import == NULL)
1875 goto err;
1876
1877 /* Call the _import__ function with the proper argument list */
1878 r = PyObject_CallFunction(import, "OOOO",
1879 module_name, globals, globals, silly_list);
1880
1881 err:
1882 Py_XDECREF(globals);
1883 Py_XDECREF(builtins);
1884 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00001885
Guido van Rossumd47a0a81997-08-14 20:11:26 +00001886 return r;
1887}
1888
1889
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001890/* Module 'imp' provides Python access to the primitives used for
1891 importing modules.
1892*/
1893
Guido van Rossum79f25d91997-04-29 20:08:16 +00001894static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001895imp_get_magic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001896{
1897 char buf[4];
1898
Guido van Rossum43713e52000-02-29 13:59:29 +00001899 if (!PyArg_ParseTuple(args, ":get_magic"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001900 return NULL;
Guido van Rossum96774c12000-05-01 20:19:08 +00001901 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
1902 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
1903 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
1904 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001905
Guido van Rossum79f25d91997-04-29 20:08:16 +00001906 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001907}
1908
Guido van Rossum79f25d91997-04-29 20:08:16 +00001909static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001910imp_get_suffixes(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001911{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001912 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001913 struct filedescr *fdp;
1914
Guido van Rossum43713e52000-02-29 13:59:29 +00001915 if (!PyArg_ParseTuple(args, ":get_suffixes"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001916 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001917 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001918 if (list == NULL)
1919 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001920 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
1921 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001922 fdp->suffix, fdp->mode, fdp->type);
1923 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001924 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001925 return NULL;
1926 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001927 if (PyList_Append(list, item) < 0) {
1928 Py_DECREF(list);
1929 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001930 return NULL;
1931 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001932 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001933 }
1934 return list;
1935}
1936
Guido van Rossum79f25d91997-04-29 20:08:16 +00001937static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001938call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001939{
Tim Petersdbd9ba62000-07-09 03:09:57 +00001940 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001941 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001942 struct filedescr *fdp;
1943 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001944 FILE *fp = NULL;
1945
1946 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001947 if (path == Py_None)
1948 path = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001949 fdp = find_module(name, path, pathname, MAXPATHLEN+1, &fp);
1950 if (fdp == NULL)
1951 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001952 if (fp != NULL) {
1953 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
1954 if (fob == NULL) {
1955 fclose(fp);
1956 return NULL;
1957 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001958 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001959 else {
1960 fob = Py_None;
1961 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00001962 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001963 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001964 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001965 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001966 return ret;
1967}
1968
Guido van Rossum79f25d91997-04-29 20:08:16 +00001969static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001970imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001971{
1972 char *name;
1973 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00001974 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001975 return NULL;
1976 return call_find_module(name, path);
1977}
1978
1979static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001980imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001981{
1982 char *name;
1983 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001984 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00001985 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001986 return NULL;
1987 ret = init_builtin(name);
1988 if (ret < 0)
1989 return NULL;
1990 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001991 Py_INCREF(Py_None);
1992 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001993 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001994 m = PyImport_AddModule(name);
1995 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001996 return m;
1997}
1998
Guido van Rossum79f25d91997-04-29 20:08:16 +00001999static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002000imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002001{
2002 char *name;
2003 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002004 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002005 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002006 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002007 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002008 if (ret < 0)
2009 return NULL;
2010 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002011 Py_INCREF(Py_None);
2012 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002013 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002014 m = PyImport_AddModule(name);
2015 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002016 return m;
2017}
2018
Guido van Rossum79f25d91997-04-29 20:08:16 +00002019static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002020imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002021{
2022 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002023
Guido van Rossum43713e52000-02-29 13:59:29 +00002024 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002025 return NULL;
2026 return get_frozen_object(name);
2027}
2028
Guido van Rossum79f25d91997-04-29 20:08:16 +00002029static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002030imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002031{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002032 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002033 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002034 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002035 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002036}
2037
Guido van Rossum79f25d91997-04-29 20:08:16 +00002038static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002039imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002040{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002041 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002042 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002043 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002044 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002045 p = find_frozen(name);
2046 return PyInt_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002047}
2048
2049static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002050get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002051{
2052 FILE *fp;
2053 if (fob == NULL) {
2054 fp = fopen(pathname, mode);
2055 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002056 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002057 }
2058 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002059 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002060 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002061 PyErr_SetString(PyExc_ValueError,
2062 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002063 }
2064 return fp;
2065}
2066
Guido van Rossum79f25d91997-04-29 20:08:16 +00002067static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002068imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002069{
2070 char *name;
2071 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002072 PyObject *fob = NULL;
2073 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002074 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002075 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002076 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002077 return NULL;
2078 fp = get_file(pathname, fob, "rb");
2079 if (fp == NULL)
2080 return NULL;
2081 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002082 if (fob == NULL)
2083 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002084 return m;
2085}
2086
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002087#ifdef HAVE_DYNAMIC_LOADING
2088
Guido van Rossum79f25d91997-04-29 20:08:16 +00002089static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002090imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002091{
2092 char *name;
2093 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002094 PyObject *fob = NULL;
2095 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002096 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002097 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002098 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002099 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002100 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002101 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002102 if (fp == NULL)
2103 return NULL;
2104 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002105 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002106 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002107}
2108
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002109#endif /* HAVE_DYNAMIC_LOADING */
2110
Guido van Rossum79f25d91997-04-29 20:08:16 +00002111static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002112imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002113{
2114 char *name;
2115 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002116 PyObject *fob = NULL;
2117 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002118 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002119 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002120 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002121 return NULL;
2122 fp = get_file(pathname, fob, "r");
2123 if (fp == NULL)
2124 return NULL;
2125 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002126 if (fob == NULL)
2127 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002128 return m;
2129}
2130
Jack Jansen9c96a921995-02-15 22:57:06 +00002131#ifdef macintosh
Guido van Rossum79f25d91997-04-29 20:08:16 +00002132static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002133imp_load_resource(PyObject *self, PyObject *args)
Jack Jansen9c96a921995-02-15 22:57:06 +00002134{
2135 char *name;
2136 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002137 PyObject *m;
Jack Jansen9c96a921995-02-15 22:57:06 +00002138
Guido van Rossum43713e52000-02-29 13:59:29 +00002139 if (!PyArg_ParseTuple(args, "ss:load_resource", &name, &pathname))
Jack Jansen9c96a921995-02-15 22:57:06 +00002140 return NULL;
2141 m = PyMac_LoadResourceModule(name, pathname);
2142 return m;
2143}
2144#endif /* macintosh */
2145
Guido van Rossum79f25d91997-04-29 20:08:16 +00002146static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002147imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002148{
2149 char *name;
2150 PyObject *fob;
2151 char *pathname;
2152 char *suffix; /* Unused */
2153 char *mode;
2154 int type;
2155 FILE *fp;
2156
Guido van Rossum43713e52000-02-29 13:59:29 +00002157 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002158 &name, &fob, &pathname,
2159 &suffix, &mode, &type))
2160 return NULL;
2161 if (*mode && (*mode != 'r' || strchr(mode, '+') != NULL)) {
2162 PyErr_Format(PyExc_ValueError,
2163 "invalid file open mode %.200s", mode);
2164 return NULL;
2165 }
2166 if (fob == Py_None)
2167 fp = NULL;
2168 else {
2169 if (!PyFile_Check(fob)) {
2170 PyErr_SetString(PyExc_ValueError,
2171 "load_module arg#2 should be a file or None");
2172 return NULL;
2173 }
2174 fp = get_file(pathname, fob, mode);
2175 if (fp == NULL)
2176 return NULL;
2177 }
2178 return load_module(name, fp, pathname, type);
2179}
2180
2181static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002182imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002183{
2184 char *name;
2185 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002186 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002187 return NULL;
2188 return load_package(name, pathname);
2189}
2190
2191static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002192imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002193{
2194 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002195 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002196 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002197 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002198}
2199
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002200/* Doc strings */
2201
2202static char doc_imp[] = "\
2203This module provides the components needed to build your own\n\
2204__import__ function. Undocumented functions are obsolete.\n\
2205";
2206
2207static char doc_find_module[] = "\
2208find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
2209Search for a module. If path is omitted or None, search for a\n\
2210built-in, frozen or special module and continue search in sys.path.\n\
2211The module name cannot contain '.'; to search for a submodule of a\n\
2212package, pass the submodule name and the package's __path__.\
2213";
2214
2215static char doc_load_module[] = "\
2216load_module(name, file, filename, (suffix, mode, type)) -> module\n\
2217Load a module, given information returned by find_module().\n\
2218The module name must include the full package name, if any.\
2219";
2220
2221static char doc_get_magic[] = "\
2222get_magic() -> string\n\
2223Return the magic number for .pyc or .pyo files.\
2224";
2225
2226static char doc_get_suffixes[] = "\
2227get_suffixes() -> [(suffix, mode, type), ...]\n\
2228Return a list of (suffix, mode, type) tuples describing the files\n\
2229that find_module() looks for.\
2230";
2231
2232static char doc_new_module[] = "\
2233new_module(name) -> module\n\
2234Create a new module. Do not enter it in sys.modules.\n\
2235The module name must include the full package name, if any.\
2236";
2237
Guido van Rossum79f25d91997-04-29 20:08:16 +00002238static PyMethodDef imp_methods[] = {
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002239 {"find_module", imp_find_module, 1, doc_find_module},
2240 {"get_magic", imp_get_magic, 1, doc_get_magic},
2241 {"get_suffixes", imp_get_suffixes, 1, doc_get_suffixes},
2242 {"load_module", imp_load_module, 1, doc_load_module},
2243 {"new_module", imp_new_module, 1, doc_new_module},
2244 /* The rest are obsolete */
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002245 {"get_frozen_object", imp_get_frozen_object, 1},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002246 {"init_builtin", imp_init_builtin, 1},
2247 {"init_frozen", imp_init_frozen, 1},
2248 {"is_builtin", imp_is_builtin, 1},
2249 {"is_frozen", imp_is_frozen, 1},
2250 {"load_compiled", imp_load_compiled, 1},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002251#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002252 {"load_dynamic", imp_load_dynamic, 1},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002253#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002254 {"load_package", imp_load_package, 1},
Jack Jansen9c96a921995-02-15 22:57:06 +00002255#ifdef macintosh
2256 {"load_resource", imp_load_resource, 1},
2257#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002258 {"load_source", imp_load_source, 1},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002259 {NULL, NULL} /* sentinel */
2260};
2261
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002262static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002263setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002264{
2265 PyObject *v;
2266 int err;
2267
2268 v = PyInt_FromLong((long)value);
2269 err = PyDict_SetItemString(d, name, v);
2270 Py_XDECREF(v);
2271 return err;
2272}
2273
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002274void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002275initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002276{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002277 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002278
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002279 m = Py_InitModule4("imp", imp_methods, doc_imp,
2280 NULL, PYTHON_API_VERSION);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002281 d = PyModule_GetDict(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002282
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002283 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
2284 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
2285 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
2286 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
2287 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
2288 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
2289 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
2290 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00002291 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002292
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002293 failure:
2294 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002295}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002296
2297
Guido van Rossumb18618d2000-05-03 23:44:39 +00002298/* API for embedding applications that want to add their own entries
2299 to the table of built-in modules. This should normally be called
2300 *before* Py_Initialize(). When the table resize fails, -1 is
2301 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002302
2303 After a similar function by Just van Rossum. */
2304
2305int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002306PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002307{
2308 static struct _inittab *our_copy = NULL;
2309 struct _inittab *p;
2310 int i, n;
2311
2312 /* Count the number of entries in both tables */
2313 for (n = 0; newtab[n].name != NULL; n++)
2314 ;
2315 if (n == 0)
2316 return 0; /* Nothing to do */
2317 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
2318 ;
2319
2320 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00002321 p = our_copy;
2322 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002323 if (p == NULL)
2324 return -1;
2325
2326 /* Copy the tables into the new memory */
2327 if (our_copy != PyImport_Inittab)
2328 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
2329 PyImport_Inittab = our_copy = p;
2330 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
2331
2332 return 0;
2333}
2334
2335/* Shorthand to add a single entry given a name and a function */
2336
2337int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002338PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002339{
2340 struct _inittab newtab[2];
2341
2342 memset(newtab, '\0', sizeof newtab);
2343
2344 newtab[0].name = name;
2345 newtab[0].initfunc = initfunc;
2346
2347 return PyImport_ExtendInittab(newtab);
2348}