blob: 36ca7057dd154194248435b5869b6523b06ab6af [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 Rossum55a83382000-09-20 20:31:38 +000018#ifdef HAVE_FCNTL_H
19#include <fcntl.h>
20#endif
21
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000022extern time_t PyOS_GetLastModificationTime(char *, FILE *);
23 /* In getmtime.c */
Guido van Rossum21d335e1993-10-15 13:01:11 +000024
Guido van Rossum6c849691994-09-26 15:47:17 +000025/* Magic word to reject .pyc files generated by other Python versions */
Guido van Rossum7faeab31995-07-07 22:50:36 +000026/* Change for each incompatible change */
27/* The value of CR and LF is incorporated so if you ever read or write
28 a .pyc file in text mode the magic number will be wrong; also, the
Tim Peters36515e22001-11-18 04:06:29 +000029 Apple MPW compiler swaps their values, botching string constants.
30 XXX That probably isn't important anymore.
31*/
Guido van Rossum7faeab31995-07-07 22:50:36 +000032/* XXX Perhaps the magic number should be frozen and a version field
33 added to the .pyc file header? */
Tim Peters36515e22001-11-18 04:06:29 +000034/* New way to come up with the low 16 bits of the magic number:
35 (YEAR-1995) * 10000 + MONTH * 100 + DAY
36 where MONTH and DAY are 1-based.
37 XXX Whatever the "old way" may have been isn't documented.
38 XXX This scheme breaks in 2002, as (2002-1995)*10000 = 70000 doesn't
39 fit in 16 bits.
40 XXX Later, sometimes 1 gets added to MAGIC in order to record that
41 the Unicode -U option is in use. IMO (Tim's), that's a Bad Idea
42 (quite apart from that the -U option doesn't work so isn't used
43 anyway).
Marc-André Lemburgbd3be8f2002-02-07 11:33:49 +000044
45 XXX MAL, 2002-02-07: I had to modify the MAGIC due to a fix of the
46 UTF-8 encoder (it previously produced invalid UTF-8 for unpaired
47 high surrogates), so I simply bumped the month value to 20 (invalid
48 month) and set the day to 1. This should be recognizable by any
49 algorithm relying on the above scheme. Perhaps we should simply
50 start counting in increments of 10 from now on ?!
51
Michael W. Hudsondd32a912002-08-15 14:59:02 +000052 MWH, 2002-08-03: Removed SET_LINENO. Couldn't be bothered figuring
53 out the MAGIC schemes, so just incremented it by 10.
54
Marc-André Lemburgbd3be8f2002-02-07 11:33:49 +000055 Known values:
56 Python 1.5: 20121
57 Python 1.5.1: 20121
58 Python 1.5.2: 20121
59 Python 2.0: 50823
60 Python 2.0.1: 50823
61 Python 2.1: 60202
62 Python 2.1.1: 60202
63 Python 2.1.2: 60202
64 Python 2.2: 60717
Neal Norwitz7fdcb412002-06-14 01:07:39 +000065 Python 2.3a0: 62011
Michael W. Hudsondd32a912002-08-15 14:59:02 +000066 Python 2.3a0: 62021
Tim Peters36515e22001-11-18 04:06:29 +000067*/
Michael W. Hudsondd32a912002-08-15 14:59:02 +000068#define MAGIC (62021 | ((long)'\r'<<16) | ((long)'\n'<<24))
Guido van Rossum3ddee711991-12-16 13:06:34 +000069
Guido van Rossum96774c12000-05-01 20:19:08 +000070/* Magic word as global; note that _PyImport_Init() can change the
Jeremy Hylton9262b8a2000-06-30 04:59:17 +000071 value of this global to accommodate for alterations of how the
Guido van Rossum96774c12000-05-01 20:19:08 +000072 compiler works which are enabled by command line switches. */
73static long pyc_magic = MAGIC;
74
Guido van Rossum25ce5661997-08-02 03:10:38 +000075/* See _PyImport_FixupExtension() below */
76static PyObject *extensions = NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +000077
Guido van Rossum771c6c81997-10-31 18:37:24 +000078/* This table is defined in config.c: */
79extern struct _inittab _PyImport_Inittab[];
80
81struct _inittab *PyImport_Inittab = _PyImport_Inittab;
Guido van Rossum66f1fa81991-04-03 19:03:52 +000082
Guido van Rossumed1170e1999-12-20 21:23:41 +000083/* these tables define the module suffixes that Python recognizes */
84struct filedescr * _PyImport_Filetab = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +000085
86#ifdef RISCOS
87static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000088 {"/py", "U", PY_SOURCE},
Guido van Rossum48a680c2001-03-02 06:34:14 +000089 {"/pyc", "rb", PY_COMPILED},
90 {0, 0}
91};
92#else
Guido van Rossumed1170e1999-12-20 21:23:41 +000093static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000094 {".py", "U", PY_SOURCE},
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000095#ifdef MS_WINDOWS
Jack Jansenc88da1f2002-05-28 10:58:19 +000096 {".pyw", "U", PY_SOURCE},
Tim Peters36515e22001-11-18 04:06:29 +000097#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +000098 {".pyc", "rb", PY_COMPILED},
99 {0, 0}
100};
Guido van Rossum48a680c2001-03-02 06:34:14 +0000101#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000102
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000103/* Initialize things */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000104
105void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000106_PyImport_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000107{
Guido van Rossumed1170e1999-12-20 21:23:41 +0000108 const struct filedescr *scan;
109 struct filedescr *filetab;
110 int countD = 0;
111 int countS = 0;
112
113 /* prepare _PyImport_Filetab: copy entries from
114 _PyImport_DynLoadFiletab and _PyImport_StandardFiletab.
115 */
116 for (scan = _PyImport_DynLoadFiletab; scan->suffix != NULL; ++scan)
117 ++countD;
118 for (scan = _PyImport_StandardFiletab; scan->suffix != NULL; ++scan)
119 ++countS;
Guido van Rossumb18618d2000-05-03 23:44:39 +0000120 filetab = PyMem_NEW(struct filedescr, countD + countS + 1);
Guido van Rossumed1170e1999-12-20 21:23:41 +0000121 memcpy(filetab, _PyImport_DynLoadFiletab,
122 countD * sizeof(struct filedescr));
123 memcpy(filetab + countD, _PyImport_StandardFiletab,
124 countS * sizeof(struct filedescr));
125 filetab[countD + countS].suffix = NULL;
126
127 _PyImport_Filetab = filetab;
128
Guido van Rossum0824f631997-03-11 18:37:35 +0000129 if (Py_OptimizeFlag) {
Guido van Rossumed1170e1999-12-20 21:23:41 +0000130 /* Replace ".pyc" with ".pyo" in _PyImport_Filetab */
131 for (; filetab->suffix != NULL; filetab++) {
Guido van Rossum48a680c2001-03-02 06:34:14 +0000132#ifndef RISCOS
Guido van Rossumed1170e1999-12-20 21:23:41 +0000133 if (strcmp(filetab->suffix, ".pyc") == 0)
134 filetab->suffix = ".pyo";
Guido van Rossum48a680c2001-03-02 06:34:14 +0000135#else
136 if (strcmp(filetab->suffix, "/pyc") == 0)
137 filetab->suffix = "/pyo";
138#endif
Guido van Rossum0824f631997-03-11 18:37:35 +0000139 }
140 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000141
142 if (Py_UnicodeFlag) {
143 /* Fix the pyc_magic so that byte compiled code created
144 using the all-Unicode method doesn't interfere with
145 code created in normal operation mode. */
146 pyc_magic = MAGIC + 1;
147 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000148}
149
Guido van Rossum25ce5661997-08-02 03:10:38 +0000150void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000151_PyImport_Fini(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000152{
153 Py_XDECREF(extensions);
154 extensions = NULL;
Barry Warsaw84294482000-10-03 16:02:05 +0000155 PyMem_DEL(_PyImport_Filetab);
156 _PyImport_Filetab = NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000157}
158
159
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000160/* Locking primitives to prevent parallel imports of the same module
161 in different threads to return with a partially loaded module.
162 These calls are serialized by the global interpreter lock. */
163
164#ifdef WITH_THREAD
165
Guido van Rossum49b56061998-10-01 20:42:43 +0000166#include "pythread.h"
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000167
Guido van Rossum65d5b571998-12-21 19:32:43 +0000168static PyThread_type_lock import_lock = 0;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000169static long import_lock_thread = -1;
170static int import_lock_level = 0;
171
172static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000173lock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000174{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000175 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000176 if (me == -1)
177 return; /* Too bad */
178 if (import_lock == NULL)
Guido van Rossum65d5b571998-12-21 19:32:43 +0000179 import_lock = PyThread_allocate_lock();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000180 if (import_lock_thread == me) {
181 import_lock_level++;
182 return;
183 }
Guido van Rossum65d5b571998-12-21 19:32:43 +0000184 if (import_lock_thread != -1 || !PyThread_acquire_lock(import_lock, 0)) {
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000185 PyThreadState *tstate = PyEval_SaveThread();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000186 PyThread_acquire_lock(import_lock, 1);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000187 PyEval_RestoreThread(tstate);
188 }
189 import_lock_thread = me;
190 import_lock_level = 1;
191}
192
193static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000194unlock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000195{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000196 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000197 if (me == -1)
198 return; /* Too bad */
199 if (import_lock_thread != me)
200 Py_FatalError("unlock_import: not holding the import lock");
201 import_lock_level--;
202 if (import_lock_level == 0) {
203 import_lock_thread = -1;
Guido van Rossum65d5b571998-12-21 19:32:43 +0000204 PyThread_release_lock(import_lock);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000205 }
206}
207
208#else
209
210#define lock_import()
211#define unlock_import()
212
213#endif
214
Tim Peters69232342001-08-30 05:16:13 +0000215static PyObject *
216imp_lock_held(PyObject *self, PyObject *args)
217{
218 if (!PyArg_ParseTuple(args, ":lock_held"))
219 return NULL;
220#ifdef WITH_THREAD
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000221 return PyBool_FromLong(import_lock_thread != -1);
Tim Peters69232342001-08-30 05:16:13 +0000222#else
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000223 return PyBool_FromLong(0);
Tim Peters69232342001-08-30 05:16:13 +0000224#endif
225}
226
Guido van Rossum25ce5661997-08-02 03:10:38 +0000227/* Helper for sys */
228
229PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000230PyImport_GetModuleDict(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000231{
232 PyInterpreterState *interp = PyThreadState_Get()->interp;
233 if (interp->modules == NULL)
234 Py_FatalError("PyImport_GetModuleDict: no module dictionary!");
235 return interp->modules;
236}
237
Guido van Rossum3f5da241990-12-20 15:06:42 +0000238
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000239/* List of names to clear in sys */
240static char* sys_deletes[] = {
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000241 "path", "argv", "ps1", "ps2", "exitfunc",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000242 "exc_type", "exc_value", "exc_traceback",
243 "last_type", "last_value", "last_traceback",
244 NULL
245};
246
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000247static char* sys_files[] = {
248 "stdin", "__stdin__",
249 "stdout", "__stdout__",
250 "stderr", "__stderr__",
251 NULL
252};
253
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000254
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000255/* Un-initialize things, as good as we can */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000256
Guido van Rossum3f5da241990-12-20 15:06:42 +0000257void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000258PyImport_Cleanup(void)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000259{
Guido van Rossum758eec01998-01-19 21:58:26 +0000260 int pos, ndone;
261 char *name;
262 PyObject *key, *value, *dict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000263 PyInterpreterState *interp = PyThreadState_Get()->interp;
Guido van Rossum758eec01998-01-19 21:58:26 +0000264 PyObject *modules = interp->modules;
265
266 if (modules == NULL)
267 return; /* Already done */
268
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000269 /* Delete some special variables first. These are common
270 places where user values hide and people complain when their
271 destructors fail. Since the modules containing them are
272 deleted *last* of all, they would come too late in the normal
273 destruction order. Sigh. */
274
275 value = PyDict_GetItemString(modules, "__builtin__");
276 if (value != NULL && PyModule_Check(value)) {
277 dict = PyModule_GetDict(value);
278 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000279 PySys_WriteStderr("# clear __builtin__._\n");
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000280 PyDict_SetItemString(dict, "_", Py_None);
281 }
282 value = PyDict_GetItemString(modules, "sys");
283 if (value != NULL && PyModule_Check(value)) {
284 char **p;
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000285 PyObject *v;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000286 dict = PyModule_GetDict(value);
287 for (p = sys_deletes; *p != NULL; p++) {
288 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000289 PySys_WriteStderr("# clear sys.%s\n", *p);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000290 PyDict_SetItemString(dict, *p, Py_None);
291 }
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000292 for (p = sys_files; *p != NULL; p+=2) {
293 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000294 PySys_WriteStderr("# restore sys.%s\n", *p);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000295 v = PyDict_GetItemString(dict, *(p+1));
296 if (v == NULL)
297 v = Py_None;
298 PyDict_SetItemString(dict, *p, v);
299 }
300 }
301
302 /* First, delete __main__ */
303 value = PyDict_GetItemString(modules, "__main__");
304 if (value != NULL && PyModule_Check(value)) {
305 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000306 PySys_WriteStderr("# cleanup __main__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000307 _PyModule_Clear(value);
308 PyDict_SetItemString(modules, "__main__", Py_None);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000309 }
310
Guido van Rossum758eec01998-01-19 21:58:26 +0000311 /* The special treatment of __builtin__ here is because even
312 when it's not referenced as a module, its dictionary is
313 referenced by almost every module's __builtins__. Since
314 deleting a module clears its dictionary (even if there are
315 references left to it), we need to delete the __builtin__
316 module last. Likewise, we don't delete sys until the very
317 end because it is implicitly referenced (e.g. by print).
318
319 Also note that we 'delete' modules by replacing their entry
320 in the modules dict with None, rather than really deleting
321 them; this avoids a rehash of the modules dictionary and
322 also marks them as "non existent" so they won't be
323 re-imported. */
324
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000325 /* Next, repeatedly delete modules with a reference count of
Guido van Rossum758eec01998-01-19 21:58:26 +0000326 one (skipping __builtin__ and sys) and delete them */
327 do {
328 ndone = 0;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000329 pos = 0;
Guido van Rossum758eec01998-01-19 21:58:26 +0000330 while (PyDict_Next(modules, &pos, &key, &value)) {
331 if (value->ob_refcnt != 1)
332 continue;
Guido van Rossum566373e1998-10-01 15:24:50 +0000333 if (PyString_Check(key) && PyModule_Check(value)) {
334 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000335 if (strcmp(name, "__builtin__") == 0)
336 continue;
337 if (strcmp(name, "sys") == 0)
338 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000339 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000340 PySys_WriteStderr(
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000341 "# cleanup[1] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000342 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000343 PyDict_SetItem(modules, key, Py_None);
344 ndone++;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000345 }
346 }
Guido van Rossum758eec01998-01-19 21:58:26 +0000347 } while (ndone > 0);
348
Guido van Rossum758eec01998-01-19 21:58:26 +0000349 /* Next, delete all modules (still skipping __builtin__ and sys) */
350 pos = 0;
351 while (PyDict_Next(modules, &pos, &key, &value)) {
Guido van Rossum566373e1998-10-01 15:24:50 +0000352 if (PyString_Check(key) && PyModule_Check(value)) {
353 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000354 if (strcmp(name, "__builtin__") == 0)
355 continue;
356 if (strcmp(name, "sys") == 0)
357 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000358 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000359 PySys_WriteStderr("# cleanup[2] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000360 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000361 PyDict_SetItem(modules, key, Py_None);
362 }
363 }
364
365 /* Next, delete sys and __builtin__ (in that order) */
366 value = PyDict_GetItemString(modules, "sys");
367 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000368 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000369 PySys_WriteStderr("# cleanup sys\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000370 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000371 PyDict_SetItemString(modules, "sys", Py_None);
372 }
373 value = PyDict_GetItemString(modules, "__builtin__");
374 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000375 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000376 PySys_WriteStderr("# cleanup __builtin__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000377 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000378 PyDict_SetItemString(modules, "__builtin__", Py_None);
379 }
380
381 /* Finally, clear and delete the modules directory */
382 PyDict_Clear(modules);
383 interp->modules = NULL;
384 Py_DECREF(modules);
Guido van Rossum8d15b5d1990-10-26 14:58:58 +0000385}
Guido van Rossum7f133ed1991-02-19 12:23:57 +0000386
387
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000388/* Helper for pythonrun.c -- return magic number */
389
390long
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000391PyImport_GetMagicNumber(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000392{
Guido van Rossum96774c12000-05-01 20:19:08 +0000393 return pyc_magic;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000394}
395
396
Guido van Rossum25ce5661997-08-02 03:10:38 +0000397/* Magic for extension modules (built-in as well as dynamically
398 loaded). To prevent initializing an extension module more than
399 once, we keep a static dictionary 'extensions' keyed by module name
400 (for built-in modules) or by filename (for dynamically loaded
Barry Warsaw92883382001-08-13 23:05:44 +0000401 modules), containing these modules. A copy of the module's
Guido van Rossum25ce5661997-08-02 03:10:38 +0000402 dictionary is stored by calling _PyImport_FixupExtension()
403 immediately after the module initialization function succeeds. A
404 copy can be retrieved from there by calling
405 _PyImport_FindExtension(). */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000406
Guido van Rossum79f25d91997-04-29 20:08:16 +0000407PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000408_PyImport_FixupExtension(char *name, char *filename)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000409{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000410 PyObject *modules, *mod, *dict, *copy;
411 if (extensions == NULL) {
412 extensions = PyDict_New();
413 if (extensions == NULL)
414 return NULL;
415 }
416 modules = PyImport_GetModuleDict();
417 mod = PyDict_GetItemString(modules, name);
418 if (mod == NULL || !PyModule_Check(mod)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000419 PyErr_Format(PyExc_SystemError,
420 "_PyImport_FixupExtension: module %.200s not loaded", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000421 return NULL;
422 }
423 dict = PyModule_GetDict(mod);
424 if (dict == NULL)
425 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000426 copy = PyDict_Copy(dict);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000427 if (copy == NULL)
428 return NULL;
429 PyDict_SetItemString(extensions, filename, copy);
430 Py_DECREF(copy);
431 return copy;
432}
433
434PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000435_PyImport_FindExtension(char *name, char *filename)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000436{
Fred Drake9cd0efc2001-10-25 21:38:59 +0000437 PyObject *dict, *mod, *mdict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000438 if (extensions == NULL)
439 return NULL;
440 dict = PyDict_GetItemString(extensions, filename);
441 if (dict == NULL)
442 return NULL;
443 mod = PyImport_AddModule(name);
444 if (mod == NULL)
445 return NULL;
446 mdict = PyModule_GetDict(mod);
447 if (mdict == NULL)
448 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000449 if (PyDict_Update(mdict, dict))
Guido van Rossum25ce5661997-08-02 03:10:38 +0000450 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000451 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000452 PySys_WriteStderr("import %s # previously loaded (%s)\n",
Guido van Rossum25ce5661997-08-02 03:10:38 +0000453 name, filename);
454 return mod;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000455}
456
457
458/* Get the module object corresponding to a module name.
459 First check the modules dictionary if there's one there,
460 if not, create a new one and insert in in the modules dictionary.
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000461 Because the former action is most common, THIS DOES NOT RETURN A
462 'NEW' REFERENCE! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000463
Guido van Rossum79f25d91997-04-29 20:08:16 +0000464PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000465PyImport_AddModule(char *name)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000466{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000467 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000468 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000469
Guido van Rossum25ce5661997-08-02 03:10:38 +0000470 if ((m = PyDict_GetItemString(modules, name)) != NULL &&
Guido van Rossum79f25d91997-04-29 20:08:16 +0000471 PyModule_Check(m))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000472 return m;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000473 m = PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000474 if (m == NULL)
475 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000476 if (PyDict_SetItemString(modules, name, m) != 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000477 Py_DECREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000478 return NULL;
479 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000480 Py_DECREF(m); /* Yes, it still exists, in modules! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000481
482 return m;
483}
484
485
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000486/* Execute a code object in a module and return the module object
487 WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000488
Guido van Rossum79f25d91997-04-29 20:08:16 +0000489PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000490PyImport_ExecCodeModule(char *name, PyObject *co)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000491{
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000492 return PyImport_ExecCodeModuleEx(name, co, (char *)NULL);
493}
494
495PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000496PyImport_ExecCodeModuleEx(char *name, PyObject *co, char *pathname)
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000497{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000498 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000499 PyObject *m, *d, *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000500
Guido van Rossum79f25d91997-04-29 20:08:16 +0000501 m = PyImport_AddModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000502 if (m == NULL)
503 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000504 d = PyModule_GetDict(m);
505 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
506 if (PyDict_SetItemString(d, "__builtins__",
507 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000508 return NULL;
509 }
Guido van Rossum9c9a07c1996-05-16 20:43:40 +0000510 /* Remember the filename as the __file__ attribute */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000511 v = NULL;
512 if (pathname != NULL) {
513 v = PyString_FromString(pathname);
514 if (v == NULL)
515 PyErr_Clear();
516 }
517 if (v == NULL) {
518 v = ((PyCodeObject *)co)->co_filename;
519 Py_INCREF(v);
520 }
521 if (PyDict_SetItemString(d, "__file__", v) != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000522 PyErr_Clear(); /* Not important enough to report */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000523 Py_DECREF(v);
524
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000525 v = PyEval_EvalCode((PyCodeObject *)co, d, d);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000526 if (v == NULL)
527 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000528 Py_DECREF(v);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000529
Guido van Rossum25ce5661997-08-02 03:10:38 +0000530 if ((m = PyDict_GetItemString(modules, name)) == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000531 PyErr_Format(PyExc_ImportError,
532 "Loaded module %.200s not found in sys.modules",
533 name);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000534 return NULL;
535 }
536
Guido van Rossum79f25d91997-04-29 20:08:16 +0000537 Py_INCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000538
539 return m;
540}
541
542
543/* Given a pathname for a Python source file, fill a buffer with the
544 pathname for the corresponding compiled file. Return the pathname
545 for the compiled file, or NULL if there's no space in the buffer.
546 Doesn't set an exception. */
547
548static char *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000549make_compiled_pathname(char *pathname, char *buf, size_t buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000550{
Tim Petersc1731372001-08-04 08:12:36 +0000551 size_t len = strlen(pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000552 if (len+2 > buflen)
553 return NULL;
Tim Petersc1731372001-08-04 08:12:36 +0000554
Martin v. Löwis6238d2b2002-06-30 15:26:10 +0000555#ifdef MS_WINDOWS
Tim Petersc1731372001-08-04 08:12:36 +0000556 /* Treat .pyw as if it were .py. The case of ".pyw" must match
557 that used in _PyImport_StandardFiletab. */
558 if (len >= 4 && strcmp(&pathname[len-4], ".pyw") == 0)
559 --len; /* pretend 'w' isn't there */
560#endif
561 memcpy(buf, pathname, len);
562 buf[len] = Py_OptimizeFlag ? 'o' : 'c';
563 buf[len+1] = '\0';
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000564
565 return buf;
566}
567
568
569/* Given a pathname for a Python source file, its time of last
570 modification, and a pathname for a compiled file, check whether the
571 compiled file represents the same version of the source. If so,
572 return a FILE pointer for the compiled file, positioned just after
573 the header; if not, return NULL.
574 Doesn't set an exception. */
575
576static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000577check_compiled_module(char *pathname, long mtime, char *cpathname)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000578{
579 FILE *fp;
580 long magic;
581 long pyc_mtime;
582
583 fp = fopen(cpathname, "rb");
584 if (fp == NULL)
585 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000586 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000587 if (magic != pyc_magic) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000588 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000589 PySys_WriteStderr("# %s has bad magic\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000590 fclose(fp);
591 return NULL;
592 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000593 pyc_mtime = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000594 if (pyc_mtime != mtime) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000595 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000596 PySys_WriteStderr("# %s has bad mtime\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000597 fclose(fp);
598 return NULL;
599 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000600 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000601 PySys_WriteStderr("# %s matches %s\n", cpathname, pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000602 return fp;
603}
604
605
606/* Read a code object from a file and check it for validity */
607
Guido van Rossum79f25d91997-04-29 20:08:16 +0000608static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000609read_compiled_module(char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000610{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000611 PyObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000612
Tim Petersd9b9ac82001-01-28 00:27:39 +0000613 co = PyMarshal_ReadLastObjectFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000614 /* Ugly: rd_object() may return NULL with or without error */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000615 if (co == NULL || !PyCode_Check(co)) {
616 if (!PyErr_Occurred())
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000617 PyErr_Format(PyExc_ImportError,
618 "Non-code object in %.200s", cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000619 Py_XDECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000620 return NULL;
621 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000622 return (PyCodeObject *)co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000623}
624
625
626/* Load a module from a compiled file, execute it, and return its
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000627 module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000628
Guido van Rossum79f25d91997-04-29 20:08:16 +0000629static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000630load_compiled_module(char *name, char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000631{
632 long magic;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000633 PyCodeObject *co;
634 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000635
Guido van Rossum79f25d91997-04-29 20:08:16 +0000636 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000637 if (magic != pyc_magic) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000638 PyErr_Format(PyExc_ImportError,
639 "Bad magic number in %.200s", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000640 return NULL;
641 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000642 (void) PyMarshal_ReadLongFromFile(fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000643 co = read_compiled_module(cpathname, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000644 if (co == NULL)
645 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000646 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000647 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000648 name, cpathname);
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000649 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000650 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000651
652 return m;
653}
654
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000655/* Parse a source file and return the corresponding code object */
656
Guido van Rossum79f25d91997-04-29 20:08:16 +0000657static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000658parse_source_module(char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000659{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000660 PyCodeObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000661 node *n;
662
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000663 n = PyParser_SimpleParseFile(fp, pathname, Py_file_input);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000664 if (n == NULL)
665 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000666 co = PyNode_Compile(n, pathname);
667 PyNode_Free(n);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000668
669 return co;
670}
671
672
Guido van Rossum55a83382000-09-20 20:31:38 +0000673/* Helper to open a bytecode file for writing in exclusive mode */
674
675static FILE *
676open_exclusive(char *filename)
677{
678#if defined(O_EXCL)&&defined(O_CREAT)&&defined(O_WRONLY)&&defined(O_TRUNC)
679 /* Use O_EXCL to avoid a race condition when another process tries to
680 write the same file. When that happens, our open() call fails,
681 which is just fine (since it's only a cache).
682 XXX If the file exists and is writable but the directory is not
683 writable, the file will never be written. Oh well.
684 */
685 int fd;
686 (void) unlink(filename);
Tim Peters42c83af2000-09-29 04:03:10 +0000687 fd = open(filename, O_EXCL|O_CREAT|O_WRONLY|O_TRUNC
688#ifdef O_BINARY
689 |O_BINARY /* necessary for Windows */
690#endif
Tim Peters50d8d372001-02-28 05:34:27 +0000691
Tim Peters42c83af2000-09-29 04:03:10 +0000692 , 0666);
Guido van Rossum55a83382000-09-20 20:31:38 +0000693 if (fd < 0)
694 return NULL;
695 return fdopen(fd, "wb");
696#else
697 /* Best we can do -- on Windows this can't happen anyway */
698 return fopen(filename, "wb");
699#endif
700}
701
702
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000703/* Write a compiled module to a file, placing the time of last
704 modification of its source into the header.
705 Errors are ignored, if a write error occurs an attempt is made to
706 remove the file. */
707
708static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000709write_compiled_module(PyCodeObject *co, char *cpathname, long mtime)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000710{
711 FILE *fp;
712
Guido van Rossum55a83382000-09-20 20:31:38 +0000713 fp = open_exclusive(cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000714 if (fp == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000715 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000716 PySys_WriteStderr(
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000717 "# can't create %s\n", cpathname);
718 return;
719 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000720 PyMarshal_WriteLongToFile(pyc_magic, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000721 /* First write a 0 for mtime */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000722 PyMarshal_WriteLongToFile(0L, fp);
723 PyMarshal_WriteObjectToFile((PyObject *)co, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000724 if (ferror(fp)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000725 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000726 PySys_WriteStderr("# can't write %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000727 /* Don't keep partial file */
728 fclose(fp);
729 (void) unlink(cpathname);
730 return;
731 }
732 /* Now write the true mtime */
733 fseek(fp, 4L, 0);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000734 PyMarshal_WriteLongToFile(mtime, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000735 fflush(fp);
736 fclose(fp);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000737 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000738 PySys_WriteStderr("# wrote %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000739#ifdef macintosh
Jack Jansencbf630f2000-07-11 21:59:16 +0000740 PyMac_setfiletype(cpathname, 'Pyth', 'PYC ');
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000741#endif
742}
743
744
745/* Load a source module from a given file and return its module
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000746 object WITH INCREMENTED REFERENCE COUNT. If there's a matching
747 byte-compiled file, use that instead. */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000748
Guido van Rossum79f25d91997-04-29 20:08:16 +0000749static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000750load_source_module(char *name, char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000751{
Fred Drake4c82b232000-06-30 16:18:57 +0000752 time_t mtime;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000753 FILE *fpc;
754 char buf[MAXPATHLEN+1];
755 char *cpathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000756 PyCodeObject *co;
757 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000758
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000759 mtime = PyOS_GetLastModificationTime(pathname, fp);
Fred Drakec63d3e92001-03-01 06:33:32 +0000760 if (mtime == (time_t)(-1))
Fred Drake4c82b232000-06-30 16:18:57 +0000761 return NULL;
762#if SIZEOF_TIME_T > 4
763 /* Python's .pyc timestamp handling presumes that the timestamp fits
764 in 4 bytes. This will be fine until sometime in the year 2038,
765 when a 4-byte signed time_t will overflow.
766 */
767 if (mtime >> 32) {
768 PyErr_SetString(PyExc_OverflowError,
Fred Drakec63d3e92001-03-01 06:33:32 +0000769 "modification time overflows a 4 byte field");
Fred Drake4c82b232000-06-30 16:18:57 +0000770 return NULL;
771 }
772#endif
Tim Peters36515e22001-11-18 04:06:29 +0000773 cpathname = make_compiled_pathname(pathname, buf,
Jeremy Hylton37832f02001-04-13 17:50:20 +0000774 (size_t)MAXPATHLEN + 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000775 if (cpathname != NULL &&
776 (fpc = check_compiled_module(pathname, mtime, cpathname))) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000777 co = read_compiled_module(cpathname, fpc);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000778 fclose(fpc);
779 if (co == NULL)
780 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000781 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000782 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000783 name, cpathname);
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000784 pathname = cpathname;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000785 }
786 else {
787 co = parse_source_module(pathname, fp);
788 if (co == NULL)
789 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000790 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000791 PySys_WriteStderr("import %s # from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000792 name, pathname);
793 write_compiled_module(co, cpathname, mtime);
794 }
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000795 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, pathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000796 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000797
798 return m;
799}
800
801
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000802/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000803static PyObject *load_module(char *, FILE *, char *, int);
804static struct filedescr *find_module(char *, PyObject *,
805 char *, size_t, FILE **);
806static struct _frozen *find_frozen(char *name);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000807
808/* Load a package and return its module object WITH INCREMENTED
809 REFERENCE COUNT */
810
811static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000812load_package(char *name, char *pathname)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000813{
814 PyObject *m, *d, *file, *path;
815 int err;
816 char buf[MAXPATHLEN+1];
817 FILE *fp = NULL;
818 struct filedescr *fdp;
819
820 m = PyImport_AddModule(name);
821 if (m == NULL)
822 return NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000823 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000824 PySys_WriteStderr("import %s # directory %s\n",
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000825 name, pathname);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000826 d = PyModule_GetDict(m);
827 file = PyString_FromString(pathname);
828 if (file == NULL)
829 return NULL;
830 path = Py_BuildValue("[O]", file);
831 if (path == NULL) {
832 Py_DECREF(file);
833 return NULL;
834 }
835 err = PyDict_SetItemString(d, "__file__", file);
836 if (err == 0)
837 err = PyDict_SetItemString(d, "__path__", path);
838 if (err != 0) {
839 m = NULL;
840 goto cleanup;
841 }
842 buf[0] = '\0';
843 fdp = find_module("__init__", path, buf, sizeof(buf), &fp);
844 if (fdp == NULL) {
845 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
846 PyErr_Clear();
847 }
848 else
849 m = NULL;
850 goto cleanup;
851 }
852 m = load_module(name, fp, buf, fdp->type);
853 if (fp != NULL)
854 fclose(fp);
855 cleanup:
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000856 Py_XDECREF(path);
857 Py_XDECREF(file);
858 return m;
859}
860
861
862/* Helper to test for built-in module */
863
864static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000865is_builtin(char *name)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000866{
867 int i;
Guido van Rossum771c6c81997-10-31 18:37:24 +0000868 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
869 if (strcmp(name, PyImport_Inittab[i].name) == 0) {
870 if (PyImport_Inittab[i].initfunc == NULL)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000871 return -1;
872 else
873 return 1;
874 }
875 }
876 return 0;
877}
878
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000879
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000880/* Search the path (default sys.path) for a module. Return the
881 corresponding filedescr struct, and (via return arguments) the
882 pathname and an open file. Return NULL if the module is not found. */
883
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000884#ifdef MS_COREDLL
Thomas Woutersb4bd21c2000-07-22 23:38:01 +0000885extern FILE *PyWin_FindRegisteredModule(const char *, struct filedescr **,
886 char *, int);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000887#endif
888
Tim Peters50d8d372001-02-28 05:34:27 +0000889static int case_ok(char *, int, int, char *);
Tim Petersdbd9ba62000-07-09 03:09:57 +0000890static int find_init_module(char *); /* Forward */
Guido van Rossum197346f1997-10-31 18:38:52 +0000891
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000892static struct filedescr *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000893find_module(char *realname, PyObject *path, char *buf, size_t buflen,
894 FILE **p_fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000895{
Fred Drake4c82b232000-06-30 16:18:57 +0000896 int i, npath;
897 size_t len, namelen;
Guido van Rossum80bb9651996-12-05 23:27:02 +0000898 struct filedescr *fdp = NULL;
Jack Jansenc88da1f2002-05-28 10:58:19 +0000899 char *filemode;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +0000900 FILE *fp = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +0000901#ifndef RISCOS
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000902 struct stat statbuf;
Guido van Rossum48a680c2001-03-02 06:34:14 +0000903#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +0000904 static struct filedescr fd_frozen = {"", "", PY_FROZEN};
905 static struct filedescr fd_builtin = {"", "", C_BUILTIN};
906 static struct filedescr fd_package = {"", "", PKG_DIRECTORY};
Guido van Rossum0506a431998-08-11 15:07:39 +0000907 char name[MAXPATHLEN+1];
Andrew MacIntyred9400542002-02-26 11:41:34 +0000908#if defined(PYOS_OS2)
909 size_t saved_len;
910 size_t saved_namelen;
911 char *saved_buf = NULL;
912#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000913
Fred Drake4c82b232000-06-30 16:18:57 +0000914 if (strlen(realname) > MAXPATHLEN) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +0000915 PyErr_SetString(PyExc_OverflowError,
916 "module name is too long");
Fred Drake4c82b232000-06-30 16:18:57 +0000917 return NULL;
918 }
Guido van Rossum0506a431998-08-11 15:07:39 +0000919 strcpy(name, realname);
920
921 if (path != NULL && PyString_Check(path)) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +0000922 /* The only type of submodule allowed inside a "frozen"
923 package are other frozen modules or packages. */
Guido van Rossum0506a431998-08-11 15:07:39 +0000924 if (PyString_Size(path) + 1 + strlen(name) >= (size_t)buflen) {
925 PyErr_SetString(PyExc_ImportError,
926 "full frozen module name too long");
927 return NULL;
928 }
929 strcpy(buf, PyString_AsString(path));
930 strcat(buf, ".");
931 strcat(buf, name);
932 strcpy(name, buf);
Jack Jansen550fdae2001-10-30 13:08:39 +0000933#ifdef macintosh
934 /* Freezing on the mac works different, and the modules are
935 ** actually on sys.path. So we don't take the quick exit but
936 ** continue with the normal flow.
937 */
938 path = NULL;
939#else
Guido van Rossum8f4d3312001-10-18 18:54:11 +0000940 if (find_frozen(name) != NULL) {
941 strcpy(buf, name);
942 return &fd_frozen;
943 }
944 PyErr_Format(PyExc_ImportError,
945 "No frozen submodule named %.200s", name);
946 return NULL;
Jack Jansen550fdae2001-10-30 13:08:39 +0000947#endif
Guido van Rossum0506a431998-08-11 15:07:39 +0000948 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000949 if (path == NULL) {
950 if (is_builtin(name)) {
Guido van Rossuma5568d31998-03-05 03:45:08 +0000951 strcpy(buf, name);
952 return &fd_builtin;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000953 }
Greg Ward201baee2001-10-04 14:52:06 +0000954 if ((find_frozen(name)) != NULL) {
Guido van Rossuma5568d31998-03-05 03:45:08 +0000955 strcpy(buf, name);
956 return &fd_frozen;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000957 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000958
Guido van Rossumac279101996-08-22 23:10:58 +0000959#ifdef MS_COREDLL
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000960 fp = PyWin_FindRegisteredModule(name, &fdp, buf, buflen);
961 if (fp != NULL) {
962 *p_fp = fp;
963 return fdp;
964 }
Guido van Rossuma5a3db71996-04-09 02:39:59 +0000965#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +0000966 path = PySys_GetObject("path");
967 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000968 if (path == NULL || !PyList_Check(path)) {
969 PyErr_SetString(PyExc_ImportError,
Guido van Rossuma5568d31998-03-05 03:45:08 +0000970 "sys.path must be a list of directory names");
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000971 return NULL;
972 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000973 npath = PyList_Size(path);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000974 namelen = strlen(name);
975 for (i = 0; i < npath; i++) {
Walter Dörwald3430d702002-06-17 10:43:59 +0000976 PyObject *copy = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000977 PyObject *v = PyList_GetItem(path, i);
Walter Dörwald3430d702002-06-17 10:43:59 +0000978#ifdef Py_USING_UNICODE
979 if (PyUnicode_Check(v)) {
980 copy = PyUnicode_Encode(PyUnicode_AS_UNICODE(v),
981 PyUnicode_GET_SIZE(v), Py_FileSystemDefaultEncoding, NULL);
982 if (copy == NULL)
983 return NULL;
984 v = copy;
985 }
986 else
987#endif
Guido van Rossum79f25d91997-04-29 20:08:16 +0000988 if (!PyString_Check(v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000989 continue;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000990 len = PyString_Size(v);
Walter Dörwald3430d702002-06-17 10:43:59 +0000991 if (len + 2 + namelen + MAXSUFFIXSIZE >= buflen) {
992 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000993 continue; /* Too long */
Walter Dörwald3430d702002-06-17 10:43:59 +0000994 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000995 strcpy(buf, PyString_AsString(v));
Walter Dörwald3430d702002-06-17 10:43:59 +0000996 if (strlen(buf) != len) {
997 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000998 continue; /* v contains '\0' */
Walter Dörwald3430d702002-06-17 10:43:59 +0000999 }
Jack Jansen9c96a921995-02-15 22:57:06 +00001000#ifdef macintosh
Tim Peters50d8d372001-02-28 05:34:27 +00001001 /*
Guido van Rossum741689d1997-08-12 14:53:39 +00001002 ** Speedup: each sys.path item is interned, and
1003 ** FindResourceModule remembers which items refer to
1004 ** folders (so we don't have to bother trying to look
Tim Peters50d8d372001-02-28 05:34:27 +00001005 ** into them for resources).
Guido van Rossum741689d1997-08-12 14:53:39 +00001006 */
1007 PyString_InternInPlace(&PyList_GET_ITEM(path, i));
1008 v = PyList_GET_ITEM(path, i);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001009 if (PyMac_FindResourceModule((PyStringObject *)v, name, buf)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001010 static struct filedescr resfiledescr =
1011 {"", "", PY_RESOURCE};
Tim Peters50d8d372001-02-28 05:34:27 +00001012
Walter Dörwald3430d702002-06-17 10:43:59 +00001013 Py_XDECREF(copy);
Jack Jansen9c96a921995-02-15 22:57:06 +00001014 return &resfiledescr;
1015 }
Guido van Rossum0f84a341998-08-06 13:36:01 +00001016 if (PyMac_FindCodeResourceModule((PyStringObject *)v, name, buf)) {
1017 static struct filedescr resfiledescr =
1018 {"", "", PY_CODERESOURCE};
Tim Peters50d8d372001-02-28 05:34:27 +00001019
Walter Dörwald3430d702002-06-17 10:43:59 +00001020 Py_XDECREF(copy);
Guido van Rossum0f84a341998-08-06 13:36:01 +00001021 return &resfiledescr;
1022 }
Jack Jansen9c96a921995-02-15 22:57:06 +00001023#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001024 if (len > 0 && buf[len-1] != SEP
1025#ifdef ALTSEP
1026 && buf[len-1] != ALTSEP
1027#endif
1028 )
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001029 buf[len++] = SEP;
Guido van Rossum215c3402000-11-13 17:26:32 +00001030 strcpy(buf+len, name);
1031 len += namelen;
Tim Peters50d8d372001-02-28 05:34:27 +00001032
1033 /* Check for package import (buf holds a directory name,
1034 and there's an __init__ module in that directory */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001035#ifdef HAVE_STAT
Walter Dörwald3430d702002-06-17 10:43:59 +00001036 if (stat(buf, &statbuf) == 0 && /* it exists */
1037 S_ISDIR(statbuf.st_mode) && /* it's a directory */
1038 find_init_module(buf) && /* it has __init__.py */
1039 case_ok(buf, len, namelen, name)) { /* and case matches */
1040 Py_XDECREF(copy);
Tim Peterscab3f682001-04-29 22:21:25 +00001041 return &fd_package;
Walter Dörwald3430d702002-06-17 10:43:59 +00001042 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001043#else
1044 /* XXX How are you going to test for directories? */
Guido van Rossum48a680c2001-03-02 06:34:14 +00001045#ifdef RISCOS
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001046 if (isdir(buf) &&
1047 find_init_module(buf) &&
Walter Dörwald3430d702002-06-17 10:43:59 +00001048 case_ok(buf, len, namelen, name)) {
1049 Py_XDECREF(copy);
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001050 return &fd_package;
Walter Dörwald3430d702002-06-17 10:43:59 +00001051 }
Guido van Rossum48a680c2001-03-02 06:34:14 +00001052#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001053#endif
Guido van Rossum9a61dc91997-10-08 15:25:08 +00001054#ifdef macintosh
1055 fdp = PyMac_FindModuleExtension(buf, &len, name);
Jack Jansen4df3c522001-03-20 23:09:54 +00001056 if (fdp) {
Guido van Rossum9a61dc91997-10-08 15:25:08 +00001057#else
Andrew MacIntyred9400542002-02-26 11:41:34 +00001058#if defined(PYOS_OS2)
1059 /* take a snapshot of the module spec for restoration
1060 * after the 8 character DLL hackery
1061 */
1062 saved_buf = strdup(buf);
1063 saved_len = len;
1064 saved_namelen = namelen;
1065#endif /* PYOS_OS2 */
Guido van Rossum79f25d91997-04-29 20:08:16 +00001066 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
Andrew MacIntyred9400542002-02-26 11:41:34 +00001067#if defined(PYOS_OS2)
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001068 /* OS/2 limits DLLs to 8 character names (w/o
1069 extension)
Andrew MacIntyred9400542002-02-26 11:41:34 +00001070 * so if the name is longer than that and its a
1071 * dynamically loaded module we're going to try,
1072 * truncate the name before trying
1073 */
1074 if (strlen(realname) > 8) {
1075 /* is this an attempt to load a C extension? */
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001076 const struct filedescr *scan;
1077 scan = _PyImport_DynLoadFiletab;
Andrew MacIntyred9400542002-02-26 11:41:34 +00001078 while (scan->suffix != NULL) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001079 if (!strcmp(scan->suffix, fdp->suffix))
Andrew MacIntyred9400542002-02-26 11:41:34 +00001080 break;
1081 else
1082 scan++;
1083 }
1084 if (scan->suffix != NULL) {
1085 /* yes, so truncate the name */
1086 namelen = 8;
1087 len -= strlen(realname) - namelen;
1088 buf[len] = '\0';
1089 }
1090 }
1091#endif /* PYOS_OS2 */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001092 strcpy(buf+len, fdp->suffix);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001093 if (Py_VerboseFlag > 1)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001094 PySys_WriteStderr("# trying %s\n", buf);
Jack Jansen4df3c522001-03-20 23:09:54 +00001095#endif /* !macintosh */
Jack Jansenc88da1f2002-05-28 10:58:19 +00001096 filemode = fdp->mode;
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001097 if (filemode[0] == 'U')
1098 filemode = "r" PY_STDIOTEXTMODE;
Jack Jansenc88da1f2002-05-28 10:58:19 +00001099 fp = fopen(buf, filemode);
Tim Peters50d8d372001-02-28 05:34:27 +00001100 if (fp != NULL) {
1101 if (case_ok(buf, len, namelen, name))
1102 break;
1103 else { /* continue search */
1104 fclose(fp);
1105 fp = NULL;
Barry Warsaw914a0b12001-02-02 19:12:16 +00001106 }
Barry Warsaw914a0b12001-02-02 19:12:16 +00001107 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001108#if defined(PYOS_OS2)
1109 /* restore the saved snapshot */
1110 strcpy(buf, saved_buf);
1111 len = saved_len;
1112 namelen = saved_namelen;
1113#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001114 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001115#if defined(PYOS_OS2)
1116 /* don't need/want the module name snapshot anymore */
1117 if (saved_buf)
1118 {
1119 free(saved_buf);
1120 saved_buf = NULL;
1121 }
1122#endif
Walter Dörwald3430d702002-06-17 10:43:59 +00001123 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001124 if (fp != NULL)
1125 break;
1126 }
1127 if (fp == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001128 PyErr_Format(PyExc_ImportError,
1129 "No module named %.200s", name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001130 return NULL;
1131 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001132 *p_fp = fp;
1133 return fdp;
1134}
1135
Tim Petersd1e87a82001-03-01 18:12:00 +00001136/* case_ok(char* buf, int len, int namelen, char* name)
1137 * The arguments here are tricky, best shown by example:
1138 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1139 * ^ ^ ^ ^
1140 * |--------------------- buf ---------------------|
1141 * |------------------- len ------------------|
1142 * |------ name -------|
1143 * |----- namelen -----|
1144 * buf is the full path, but len only counts up to (& exclusive of) the
1145 * extension. name is the module name, also exclusive of extension.
1146 *
1147 * We've already done a successful stat() or fopen() on buf, so know that
1148 * there's some match, possibly case-insensitive.
1149 *
Tim Peters50d8d372001-02-28 05:34:27 +00001150 * case_ok() is to return 1 if there's a case-sensitive match for
1151 * name, else 0. case_ok() is also to return 1 if envar PYTHONCASEOK
1152 * exists.
Tim Petersd1e87a82001-03-01 18:12:00 +00001153 *
Tim Peters50d8d372001-02-28 05:34:27 +00001154 * case_ok() is used to implement case-sensitive import semantics even
1155 * on platforms with case-insensitive filesystems. It's trivial to implement
1156 * for case-sensitive filesystems. It's pretty much a cross-platform
1157 * nightmare for systems with case-insensitive filesystems.
1158 */
Guido van Rossum0980bd91998-02-13 17:18:36 +00001159
Tim Peters50d8d372001-02-28 05:34:27 +00001160/* First we may need a pile of platform-specific header files; the sequence
1161 * of #if's here should match the sequence in the body of case_ok().
1162 */
Martin v. Löwis6238d2b2002-06-30 15:26:10 +00001163#if defined(MS_WINDOWS) || defined(__CYGWIN__)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001164#include <windows.h>
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001165#ifdef __CYGWIN__
1166#include <sys/cygwin.h>
1167#endif
1168
Tim Peters50d8d372001-02-28 05:34:27 +00001169#elif defined(DJGPP)
1170#include <dir.h>
1171
1172#elif defined(macintosh)
1173#include <TextUtils.h>
Tim Peters50d8d372001-02-28 05:34:27 +00001174
Tim Petersd1e87a82001-03-01 18:12:00 +00001175#elif defined(__MACH__) && defined(__APPLE__) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001176#include <sys/types.h>
1177#include <dirent.h>
1178
Andrew MacIntyred9400542002-02-26 11:41:34 +00001179#elif defined(PYOS_OS2)
1180#define INCL_DOS
1181#define INCL_DOSERRORS
1182#define INCL_NOPMAPI
1183#include <os2.h>
1184
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001185#elif defined(RISCOS)
1186#include "oslib/osfscontrol.h"
Tim Peters50d8d372001-02-28 05:34:27 +00001187#endif
1188
Guido van Rossum0980bd91998-02-13 17:18:36 +00001189static int
Tim Peters50d8d372001-02-28 05:34:27 +00001190case_ok(char *buf, int len, int namelen, char *name)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001191{
Tim Peters50d8d372001-02-28 05:34:27 +00001192/* Pick a platform-specific implementation; the sequence of #if's here should
1193 * match the sequence just above.
1194 */
1195
Martin v. Löwis6238d2b2002-06-30 15:26:10 +00001196/* MS_WINDOWS || __CYGWIN__ */
1197#if defined(MS_WINDOWS) || defined(__CYGWIN__)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001198 WIN32_FIND_DATA data;
1199 HANDLE h;
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001200#ifdef __CYGWIN__
1201 char tempbuf[MAX_PATH];
1202#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001203
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001204 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001205 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001206
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001207#ifdef __CYGWIN__
1208 cygwin32_conv_to_win32_path(buf, tempbuf);
1209 h = FindFirstFile(tempbuf, &data);
1210#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001211 h = FindFirstFile(buf, &data);
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001212#endif
Guido van Rossum0980bd91998-02-13 17:18:36 +00001213 if (h == INVALID_HANDLE_VALUE) {
1214 PyErr_Format(PyExc_NameError,
1215 "Can't find file for module %.100s\n(filename %.300s)",
1216 name, buf);
1217 return 0;
1218 }
1219 FindClose(h);
Tim Peters50d8d372001-02-28 05:34:27 +00001220 return strncmp(data.cFileName, name, namelen) == 0;
1221
1222/* DJGPP */
1223#elif defined(DJGPP)
1224 struct ffblk ffblk;
1225 int done;
1226
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001227 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum323bf5e1998-06-24 03:54:06 +00001228 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001229
1230 done = findfirst(buf, &ffblk, FA_ARCH|FA_RDONLY|FA_HIDDEN|FA_DIREC);
1231 if (done) {
Guido van Rossum0980bd91998-02-13 17:18:36 +00001232 PyErr_Format(PyExc_NameError,
Tim Peters50d8d372001-02-28 05:34:27 +00001233 "Can't find file for module %.100s\n(filename %.300s)",
Guido van Rossum0980bd91998-02-13 17:18:36 +00001234 name, buf);
1235 return 0;
1236 }
Tim Peters50d8d372001-02-28 05:34:27 +00001237 return strncmp(ffblk.ff_name, name, namelen) == 0;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001238
Tim Peters50d8d372001-02-28 05:34:27 +00001239/* macintosh */
1240#elif defined(macintosh)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001241 FSSpec fss;
1242 OSErr err;
Tim Peters50d8d372001-02-28 05:34:27 +00001243
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001244 if (Py_GETENV("PYTHONCASEOK") != NULL)
Tim Peters50d8d372001-02-28 05:34:27 +00001245 return 1;
1246
Guido van Rossuma0f0a331998-09-14 13:40:53 +00001247 err = FSMakeFSSpec(0, 0, Pstring(buf), &fss);
Guido van Rossum0980bd91998-02-13 17:18:36 +00001248 if (err) {
1249 PyErr_Format(PyExc_NameError,
Guido van Rossuma0f0a331998-09-14 13:40:53 +00001250 "Can't find file for module %.100s\n(filename %.300s)",
1251 name, buf);
Guido van Rossum0980bd91998-02-13 17:18:36 +00001252 return 0;
1253 }
Tim Peters50d8d372001-02-28 05:34:27 +00001254 return fss.name[0] >= namelen &&
1255 strncmp(name, (char *)fss.name+1, namelen) == 0;
1256
Tim Peters677898a2001-03-02 03:28:03 +00001257/* new-fangled macintosh (macosx) */
Tim Petersd1e87a82001-03-01 18:12:00 +00001258#elif defined(__MACH__) && defined(__APPLE__) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001259 DIR *dirp;
1260 struct dirent *dp;
Tim Petersd1e87a82001-03-01 18:12:00 +00001261 char dirname[MAXPATHLEN + 1];
1262 const int dirlen = len - namelen - 1; /* don't want trailing SEP */
Tim Peters430f5d42001-03-01 01:30:56 +00001263
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001264 if (Py_GETENV("PYTHONCASEOK") != NULL)
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001265 return 1;
1266
Tim Petersd1e87a82001-03-01 18:12:00 +00001267 /* Copy the dir component into dirname; substitute "." if empty */
1268 if (dirlen <= 0) {
1269 dirname[0] = '.';
1270 dirname[1] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001271 }
1272 else {
Tim Petersd1e87a82001-03-01 18:12:00 +00001273 assert(dirlen <= MAXPATHLEN);
1274 memcpy(dirname, buf, dirlen);
1275 dirname[dirlen] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001276 }
1277 /* Open the directory and search the entries for an exact match. */
Tim Petersd1e87a82001-03-01 18:12:00 +00001278 dirp = opendir(dirname);
Tim Peters430f5d42001-03-01 01:30:56 +00001279 if (dirp) {
Tim Peters677898a2001-03-02 03:28:03 +00001280 char *nameWithExt = buf + len - namelen;
Tim Peters430f5d42001-03-01 01:30:56 +00001281 while ((dp = readdir(dirp)) != NULL) {
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001282 const int thislen =
Tim Peters430f5d42001-03-01 01:30:56 +00001283#ifdef _DIRENT_HAVE_D_NAMELEN
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001284 dp->d_namlen;
Tim Peters430f5d42001-03-01 01:30:56 +00001285#else
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001286 strlen(dp->d_name);
Tim Peters430f5d42001-03-01 01:30:56 +00001287#endif
Tim Petersd1e87a82001-03-01 18:12:00 +00001288 if (thislen >= namelen &&
Tim Peters677898a2001-03-02 03:28:03 +00001289 strcmp(dp->d_name, nameWithExt) == 0) {
Tim Peters430f5d42001-03-01 01:30:56 +00001290 (void)closedir(dirp);
1291 return 1; /* Found */
1292 }
1293 }
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001294 (void)closedir(dirp);
Tim Peters430f5d42001-03-01 01:30:56 +00001295 }
Tim Peters430f5d42001-03-01 01:30:56 +00001296 return 0 ; /* Not found */
Tim Peters430f5d42001-03-01 01:30:56 +00001297
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001298/* RISC OS */
1299#elif defined(RISCOS)
1300 char canon[MAXPATHLEN+1]; /* buffer for the canonical form of the path */
1301 char buf2[MAXPATHLEN+2];
1302 char *nameWithExt = buf+len-namelen;
1303 int canonlen;
1304 os_error *e;
1305
1306 if (Py_GETENV("PYTHONCASEOK") != NULL)
1307 return 1;
1308
1309 /* workaround:
1310 append wildcard, otherwise case of filename wouldn't be touched */
1311 strcpy(buf2, buf);
1312 strcat(buf2, "*");
1313
1314 e = xosfscontrol_canonicalise_path(buf2,canon,0,0,MAXPATHLEN+1,&canonlen);
1315 canonlen = MAXPATHLEN+1-canonlen;
1316 if (e || canonlen<=0 || canonlen>(MAXPATHLEN+1) )
1317 return 0;
1318 if (strcmp(nameWithExt, canon+canonlen-strlen(nameWithExt))==0)
1319 return 1; /* match */
1320
1321 return 0;
1322
Andrew MacIntyred9400542002-02-26 11:41:34 +00001323/* OS/2 */
1324#elif defined(PYOS_OS2)
1325 HDIR hdir = 1;
1326 ULONG srchcnt = 1;
1327 FILEFINDBUF3 ffbuf;
1328 APIRET rc;
1329
1330 if (getenv("PYTHONCASEOK") != NULL)
1331 return 1;
1332
1333 rc = DosFindFirst(buf,
1334 &hdir,
1335 FILE_READONLY | FILE_HIDDEN | FILE_SYSTEM | FILE_DIRECTORY,
1336 &ffbuf, sizeof(ffbuf),
1337 &srchcnt,
1338 FIL_STANDARD);
1339 if (rc != NO_ERROR)
1340 return 0;
1341 return strncmp(ffbuf.achName, name, namelen) == 0;
1342
Tim Peters50d8d372001-02-28 05:34:27 +00001343/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1344#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001345 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001346
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001347#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001348}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001349
Guido van Rossum0980bd91998-02-13 17:18:36 +00001350
Guido van Rossum197346f1997-10-31 18:38:52 +00001351#ifdef HAVE_STAT
1352/* Helper to look for __init__.py or __init__.py[co] in potential package */
1353static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001354find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001355{
Tim Peters0f9431f2001-07-05 03:47:53 +00001356 const size_t save_len = strlen(buf);
Fred Drake4c82b232000-06-30 16:18:57 +00001357 size_t i = save_len;
Tim Peters0f9431f2001-07-05 03:47:53 +00001358 char *pname; /* pointer to start of __init__ */
Guido van Rossum197346f1997-10-31 18:38:52 +00001359 struct stat statbuf;
1360
Tim Peters0f9431f2001-07-05 03:47:53 +00001361/* For calling case_ok(buf, len, namelen, name):
1362 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1363 * ^ ^ ^ ^
1364 * |--------------------- buf ---------------------|
1365 * |------------------- len ------------------|
1366 * |------ name -------|
1367 * |----- namelen -----|
1368 */
Guido van Rossum197346f1997-10-31 18:38:52 +00001369 if (save_len + 13 >= MAXPATHLEN)
1370 return 0;
1371 buf[i++] = SEP;
Tim Peters0f9431f2001-07-05 03:47:53 +00001372 pname = buf + i;
1373 strcpy(pname, "__init__.py");
Guido van Rossum197346f1997-10-31 18:38:52 +00001374 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001375 if (case_ok(buf,
1376 save_len + 9, /* len("/__init__") */
1377 8, /* len("__init__") */
1378 pname)) {
1379 buf[save_len] = '\0';
1380 return 1;
1381 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001382 }
Tim Peters0f9431f2001-07-05 03:47:53 +00001383 i += strlen(pname);
1384 strcpy(buf+i, Py_OptimizeFlag ? "o" : "c");
Guido van Rossum197346f1997-10-31 18:38:52 +00001385 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001386 if (case_ok(buf,
1387 save_len + 9, /* len("/__init__") */
1388 8, /* len("__init__") */
1389 pname)) {
1390 buf[save_len] = '\0';
1391 return 1;
1392 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001393 }
1394 buf[save_len] = '\0';
1395 return 0;
1396}
Guido van Rossum48a680c2001-03-02 06:34:14 +00001397
1398#else
1399
1400#ifdef RISCOS
1401static int
1402find_init_module(buf)
1403 char *buf;
1404{
1405 int save_len = strlen(buf);
1406 int i = save_len;
1407
1408 if (save_len + 13 >= MAXPATHLEN)
1409 return 0;
1410 buf[i++] = SEP;
1411 strcpy(buf+i, "__init__/py");
1412 if (isfile(buf)) {
1413 buf[save_len] = '\0';
1414 return 1;
1415 }
1416
1417 if (Py_OptimizeFlag)
1418 strcpy(buf+i, "o");
1419 else
1420 strcpy(buf+i, "c");
1421 if (isfile(buf)) {
1422 buf[save_len] = '\0';
1423 return 1;
1424 }
1425 buf[save_len] = '\0';
1426 return 0;
1427}
1428#endif /*RISCOS*/
1429
Guido van Rossum197346f1997-10-31 18:38:52 +00001430#endif /* HAVE_STAT */
1431
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001432
Tim Petersdbd9ba62000-07-09 03:09:57 +00001433static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001434
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001435/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001436 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001437
Guido van Rossum79f25d91997-04-29 20:08:16 +00001438static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001439load_module(char *name, FILE *fp, char *buf, int type)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001440{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001441 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001442 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001443 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001444
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001445 /* First check that there's an open file (if we need one) */
1446 switch (type) {
1447 case PY_SOURCE:
1448 case PY_COMPILED:
1449 if (fp == NULL) {
1450 PyErr_Format(PyExc_ValueError,
1451 "file object required for import (type code %d)",
1452 type);
1453 return NULL;
1454 }
1455 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001456
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001457 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001458
1459 case PY_SOURCE:
1460 m = load_source_module(name, buf, fp);
1461 break;
1462
1463 case PY_COMPILED:
1464 m = load_compiled_module(name, buf, fp);
1465 break;
1466
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001467#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001468 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001469 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001470 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001471#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001472
Jack Jansen9c96a921995-02-15 22:57:06 +00001473#ifdef macintosh
1474 case PY_RESOURCE:
1475 m = PyMac_LoadResourceModule(name, buf);
1476 break;
Guido van Rossum0f84a341998-08-06 13:36:01 +00001477 case PY_CODERESOURCE:
1478 m = PyMac_LoadCodeResourceModule(name, buf);
1479 break;
Jack Jansen9c96a921995-02-15 22:57:06 +00001480#endif
1481
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001482 case PKG_DIRECTORY:
1483 m = load_package(name, buf);
1484 break;
1485
1486 case C_BUILTIN:
1487 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001488 if (buf != NULL && buf[0] != '\0')
1489 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001490 if (type == C_BUILTIN)
1491 err = init_builtin(name);
1492 else
1493 err = PyImport_ImportFrozenModule(name);
1494 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001495 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001496 if (err == 0) {
1497 PyErr_Format(PyExc_ImportError,
1498 "Purported %s module %.200s not found",
1499 type == C_BUILTIN ?
1500 "builtin" : "frozen",
1501 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001502 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001503 }
1504 modules = PyImport_GetModuleDict();
1505 m = PyDict_GetItemString(modules, name);
1506 if (m == NULL) {
1507 PyErr_Format(
1508 PyExc_ImportError,
1509 "%s module %.200s not properly initialized",
1510 type == C_BUILTIN ?
1511 "builtin" : "frozen",
1512 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001513 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001514 }
1515 Py_INCREF(m);
1516 break;
1517
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001518 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001519 PyErr_Format(PyExc_ImportError,
1520 "Don't know how to import %.200s (type code %d)",
1521 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001522 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001523
1524 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001525
1526 return m;
1527}
1528
1529
1530/* Initialize a built-in module.
1531 Return 1 for succes, 0 if the module is not found, and -1 with
1532 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001533
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001534static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001535init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001536{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001537 struct _inittab *p;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001538
Greg Ward201baee2001-10-04 14:52:06 +00001539 if (_PyImport_FindExtension(name, name) != NULL)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001540 return 1;
1541
Guido van Rossum771c6c81997-10-31 18:37:24 +00001542 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001543 if (strcmp(name, p->name) == 0) {
1544 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001545 PyErr_Format(PyExc_ImportError,
1546 "Cannot re-init internal module %.200s",
1547 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001548 return -1;
1549 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001550 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001551 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001552 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001553 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001554 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001555 if (_PyImport_FixupExtension(name, name) == NULL)
1556 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001557 return 1;
1558 }
1559 }
1560 return 0;
1561}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001562
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001563
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001564/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001565
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001566static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001567find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001568{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001569 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001570
Guido van Rossum79f25d91997-04-29 20:08:16 +00001571 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001572 if (p->name == NULL)
1573 return NULL;
1574 if (strcmp(p->name, name) == 0)
1575 break;
1576 }
1577 return p;
1578}
1579
Guido van Rossum79f25d91997-04-29 20:08:16 +00001580static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001581get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001582{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001583 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001584 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001585
1586 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001587 PyErr_Format(PyExc_ImportError,
1588 "No such frozen object named %.200s",
1589 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001590 return NULL;
1591 }
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001592 if (p->code == NULL) {
1593 PyErr_Format(PyExc_ImportError,
1594 "Excluded frozen object named %.200s",
1595 name);
1596 return NULL;
1597 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001598 size = p->size;
1599 if (size < 0)
1600 size = -size;
1601 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001602}
1603
1604/* Initialize a frozen module.
1605 Return 1 for succes, 0 if the module is not found, and -1 with
1606 an exception set if the initialization failed.
1607 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001608
1609int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001610PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001611{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001612 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001613 PyObject *co;
1614 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001615 int ispackage;
1616 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001617
1618 if (p == NULL)
1619 return 0;
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001620 if (p->code == NULL) {
1621 PyErr_Format(PyExc_ImportError,
1622 "Excluded frozen object named %.200s",
1623 name);
1624 return -1;
1625 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001626 size = p->size;
1627 ispackage = (size < 0);
1628 if (ispackage)
1629 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001630 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001631 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001632 name, ispackage ? " package" : "");
1633 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001634 if (co == NULL)
1635 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001636 if (!PyCode_Check(co)) {
1637 Py_DECREF(co);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001638 PyErr_Format(PyExc_TypeError,
1639 "frozen object %.200s is not a code object",
1640 name);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001641 return -1;
1642 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001643 if (ispackage) {
1644 /* Set __path__ to the package name */
1645 PyObject *d, *s;
1646 int err;
1647 m = PyImport_AddModule(name);
1648 if (m == NULL)
1649 return -1;
1650 d = PyModule_GetDict(m);
1651 s = PyString_InternFromString(name);
1652 if (s == NULL)
1653 return -1;
1654 err = PyDict_SetItemString(d, "__path__", s);
1655 Py_DECREF(s);
1656 if (err != 0)
1657 return err;
1658 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001659 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum79f25d91997-04-29 20:08:16 +00001660 Py_DECREF(co);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001661 if (m == NULL)
1662 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001663 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001664 return 1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001665}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001666
1667
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001668/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001669 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001670
Guido van Rossum79f25d91997-04-29 20:08:16 +00001671PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001672PyImport_ImportModule(char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001673{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001674 PyObject *pname;
1675 PyObject *result;
1676
1677 pname = PyString_FromString(name);
1678 result = PyImport_Import(pname);
1679 Py_DECREF(pname);
1680 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001681}
1682
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001683/* Forward declarations for helper routines */
Tim Petersdbd9ba62000-07-09 03:09:57 +00001684static PyObject *get_parent(PyObject *globals, char *buf, int *p_buflen);
1685static PyObject *load_next(PyObject *mod, PyObject *altmod,
1686 char **p_name, char *buf, int *p_buflen);
1687static int mark_miss(char *name);
1688static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
1689 char *buf, int buflen, int recursive);
1690static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001691
1692/* The Magnum Opus of dotted-name import :-) */
1693
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001694static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001695import_module_ex(char *name, PyObject *globals, PyObject *locals,
1696 PyObject *fromlist)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001697{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001698 char buf[MAXPATHLEN+1];
1699 int buflen = 0;
1700 PyObject *parent, *head, *next, *tail;
1701
1702 parent = get_parent(globals, buf, &buflen);
1703 if (parent == NULL)
1704 return NULL;
1705
1706 head = load_next(parent, Py_None, &name, buf, &buflen);
1707 if (head == NULL)
1708 return NULL;
1709
1710 tail = head;
1711 Py_INCREF(tail);
1712 while (name) {
1713 next = load_next(tail, tail, &name, buf, &buflen);
1714 Py_DECREF(tail);
1715 if (next == NULL) {
1716 Py_DECREF(head);
1717 return NULL;
1718 }
1719 tail = next;
1720 }
1721
1722 if (fromlist != NULL) {
1723 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
1724 fromlist = NULL;
1725 }
1726
1727 if (fromlist == NULL) {
1728 Py_DECREF(tail);
1729 return head;
1730 }
1731
1732 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001733 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001734 Py_DECREF(tail);
1735 return NULL;
1736 }
1737
1738 return tail;
1739}
1740
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001741PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001742PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
1743 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001744{
1745 PyObject *result;
1746 lock_import();
Guido van Rossumd65911b1998-03-03 22:33:27 +00001747 result = import_module_ex(name, globals, locals, fromlist);
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001748 unlock_import();
1749 return result;
1750}
1751
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001752static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001753get_parent(PyObject *globals, char *buf, int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001754{
1755 static PyObject *namestr = NULL;
1756 static PyObject *pathstr = NULL;
1757 PyObject *modname, *modpath, *modules, *parent;
1758
1759 if (globals == NULL || !PyDict_Check(globals))
1760 return Py_None;
1761
1762 if (namestr == NULL) {
1763 namestr = PyString_InternFromString("__name__");
1764 if (namestr == NULL)
1765 return NULL;
1766 }
1767 if (pathstr == NULL) {
1768 pathstr = PyString_InternFromString("__path__");
1769 if (pathstr == NULL)
1770 return NULL;
1771 }
1772
1773 *buf = '\0';
1774 *p_buflen = 0;
1775 modname = PyDict_GetItem(globals, namestr);
1776 if (modname == NULL || !PyString_Check(modname))
1777 return Py_None;
1778
1779 modpath = PyDict_GetItem(globals, pathstr);
1780 if (modpath != NULL) {
1781 int len = PyString_GET_SIZE(modname);
1782 if (len > MAXPATHLEN) {
1783 PyErr_SetString(PyExc_ValueError,
1784 "Module name too long");
1785 return NULL;
1786 }
1787 strcpy(buf, PyString_AS_STRING(modname));
1788 *p_buflen = len;
1789 }
1790 else {
1791 char *start = PyString_AS_STRING(modname);
1792 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001793 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001794 if (lastdot == NULL)
1795 return Py_None;
1796 len = lastdot - start;
1797 if (len >= MAXPATHLEN) {
1798 PyErr_SetString(PyExc_ValueError,
1799 "Module name too long");
1800 return NULL;
1801 }
1802 strncpy(buf, start, len);
1803 buf[len] = '\0';
1804 *p_buflen = len;
1805 }
1806
1807 modules = PyImport_GetModuleDict();
1808 parent = PyDict_GetItemString(modules, buf);
1809 if (parent == NULL)
1810 parent = Py_None;
1811 return parent;
1812 /* We expect, but can't guarantee, if parent != None, that:
1813 - parent.__name__ == buf
1814 - parent.__dict__ is globals
1815 If this is violated... Who cares? */
1816}
1817
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001818/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001819static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001820load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
1821 int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001822{
1823 char *name = *p_name;
1824 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001825 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001826 char *p;
1827 PyObject *result;
1828
1829 if (dot == NULL) {
1830 *p_name = NULL;
1831 len = strlen(name);
1832 }
1833 else {
1834 *p_name = dot+1;
1835 len = dot-name;
1836 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00001837 if (len == 0) {
1838 PyErr_SetString(PyExc_ValueError,
1839 "Empty module name");
1840 return NULL;
1841 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001842
1843 p = buf + *p_buflen;
1844 if (p != buf)
1845 *p++ = '.';
1846 if (p+len-buf >= MAXPATHLEN) {
1847 PyErr_SetString(PyExc_ValueError,
1848 "Module name too long");
1849 return NULL;
1850 }
1851 strncpy(p, name, len);
1852 p[len] = '\0';
1853 *p_buflen = p+len-buf;
1854
1855 result = import_submodule(mod, p, buf);
1856 if (result == Py_None && altmod != mod) {
1857 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001858 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00001859 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001860 if (result != NULL && result != Py_None) {
1861 if (mark_miss(buf) != 0) {
1862 Py_DECREF(result);
1863 return NULL;
1864 }
1865 strncpy(buf, name, len);
1866 buf[len] = '\0';
1867 *p_buflen = len;
1868 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001869 }
1870 if (result == NULL)
1871 return NULL;
1872
1873 if (result == Py_None) {
1874 Py_DECREF(result);
1875 PyErr_Format(PyExc_ImportError,
1876 "No module named %.200s", name);
1877 return NULL;
1878 }
1879
1880 return result;
1881}
1882
1883static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001884mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001885{
1886 PyObject *modules = PyImport_GetModuleDict();
1887 return PyDict_SetItemString(modules, name, Py_None);
1888}
1889
1890static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001891ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, int buflen,
1892 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001893{
1894 int i;
1895
1896 if (!PyObject_HasAttrString(mod, "__path__"))
1897 return 1;
1898
1899 for (i = 0; ; i++) {
1900 PyObject *item = PySequence_GetItem(fromlist, i);
1901 int hasit;
1902 if (item == NULL) {
1903 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
1904 PyErr_Clear();
1905 return 1;
1906 }
1907 return 0;
1908 }
1909 if (!PyString_Check(item)) {
1910 PyErr_SetString(PyExc_TypeError,
1911 "Item in ``from list'' not a string");
1912 Py_DECREF(item);
1913 return 0;
1914 }
1915 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00001916 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001917 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001918 /* See if the package defines __all__ */
1919 if (recursive)
1920 continue; /* Avoid endless recursion */
1921 all = PyObject_GetAttrString(mod, "__all__");
1922 if (all == NULL)
1923 PyErr_Clear();
1924 else {
1925 if (!ensure_fromlist(mod, all, buf, buflen, 1))
1926 return 0;
1927 Py_DECREF(all);
1928 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001929 continue;
1930 }
1931 hasit = PyObject_HasAttr(mod, item);
1932 if (!hasit) {
1933 char *subname = PyString_AS_STRING(item);
1934 PyObject *submod;
1935 char *p;
1936 if (buflen + strlen(subname) >= MAXPATHLEN) {
1937 PyErr_SetString(PyExc_ValueError,
1938 "Module name too long");
1939 Py_DECREF(item);
1940 return 0;
1941 }
1942 p = buf + buflen;
1943 *p++ = '.';
1944 strcpy(p, subname);
1945 submod = import_submodule(mod, subname, buf);
1946 Py_XDECREF(submod);
1947 if (submod == NULL) {
1948 Py_DECREF(item);
1949 return 0;
1950 }
1951 }
1952 Py_DECREF(item);
1953 }
1954
Guido van Rossuma7f2e811997-10-03 15:33:32 +00001955 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001956}
1957
1958static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001959import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001960{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001961 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossumf48f11c2001-07-23 13:27:49 +00001962 PyObject *m, *res = NULL;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001963
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001964 /* Require:
1965 if mod == None: subname == fullname
1966 else: mod.__name__ + "." + subname == fullname
1967 */
1968
Tim Peters50d8d372001-02-28 05:34:27 +00001969 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001970 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001971 }
1972 else {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001973 PyObject *path;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001974 char buf[MAXPATHLEN+1];
1975 struct filedescr *fdp;
1976 FILE *fp = NULL;
1977
Guido van Rossum9c0afe51998-05-19 15:09:05 +00001978 if (mod == Py_None)
1979 path = NULL;
1980 else {
1981 path = PyObject_GetAttrString(mod, "__path__");
1982 if (path == NULL) {
1983 PyErr_Clear();
1984 Py_INCREF(Py_None);
1985 return Py_None;
1986 }
1987 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001988
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001989 buf[0] = '\0';
Guido van Rossumb68cd421998-07-01 17:36:26 +00001990 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1991 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001992 if (fdp == NULL) {
1993 if (!PyErr_ExceptionMatches(PyExc_ImportError))
1994 return NULL;
1995 PyErr_Clear();
1996 Py_INCREF(Py_None);
1997 return Py_None;
1998 }
1999 m = load_module(fullname, fp, buf, fdp->type);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002000 if (fp)
2001 fclose(fp);
Guido van Rossumf48f11c2001-07-23 13:27:49 +00002002 if (mod != Py_None) {
2003 /* Irrespective of the success of this load, make a
2004 reference to it in the parent package module.
2005 A copy gets saved in the modules dictionary
2006 under the full name, so get a reference from
2007 there, if need be. (The exception is when
2008 the load failed with a SyntaxError -- then
2009 there's no trace in sys.modules. In that case,
2010 of course, do nothing extra.) */
2011 res = m;
2012 if (res == NULL)
2013 res = PyDict_GetItemString(modules, fullname);
2014 if (res != NULL &&
2015 PyObject_SetAttrString(mod, subname, res) < 0) {
2016 Py_XDECREF(m);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002017 m = NULL;
2018 }
2019 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00002020 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002021
2022 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002023}
2024
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002025
2026/* Re-import a module of any kind and return its module object, WITH
2027 INCREMENTED REFERENCE COUNT */
2028
Guido van Rossum79f25d91997-04-29 20:08:16 +00002029PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002030PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002031{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002032 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum222ef561997-09-06 19:41:09 +00002033 PyObject *path = NULL;
2034 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002035 char buf[MAXPATHLEN+1];
2036 struct filedescr *fdp;
2037 FILE *fp = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002038
Guido van Rossum79f25d91997-04-29 20:08:16 +00002039 if (m == NULL || !PyModule_Check(m)) {
2040 PyErr_SetString(PyExc_TypeError,
2041 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002042 return NULL;
2043 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002044 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002045 if (name == NULL)
2046 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00002047 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002048 PyErr_Format(PyExc_ImportError,
2049 "reload(): module %.200s not in sys.modules",
2050 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002051 return NULL;
2052 }
Guido van Rossum222ef561997-09-06 19:41:09 +00002053 subname = strrchr(name, '.');
2054 if (subname == NULL)
2055 subname = name;
2056 else {
2057 PyObject *parentname, *parent;
2058 parentname = PyString_FromStringAndSize(name, (subname-name));
2059 if (parentname == NULL)
2060 return NULL;
2061 parent = PyDict_GetItem(modules, parentname);
Barry Warsaw38793331999-01-27 17:54:20 +00002062 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002063 if (parent == NULL) {
2064 PyErr_Format(PyExc_ImportError,
2065 "reload(): parent %.200s not in sys.modules",
2066 name);
2067 return NULL;
2068 }
2069 subname++;
2070 path = PyObject_GetAttrString(parent, "__path__");
2071 if (path == NULL)
2072 PyErr_Clear();
2073 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002074 buf[0] = '\0';
Guido van Rossum222ef561997-09-06 19:41:09 +00002075 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
2076 Py_XDECREF(path);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002077 if (fdp == NULL)
2078 return NULL;
2079 m = load_module(name, fp, buf, fdp->type);
2080 if (fp)
2081 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002082 return m;
2083}
2084
2085
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002086/* Higher-level import emulator which emulates the "import" statement
2087 more accurately -- it invokes the __import__() function from the
2088 builtins of the current globals. This means that the import is
2089 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00002090 environment, e.g. by "rexec".
2091 A dummy list ["__doc__"] is passed as the 4th argument so that
2092 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
2093 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002094
2095PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002096PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002097{
2098 static PyObject *silly_list = NULL;
2099 static PyObject *builtins_str = NULL;
2100 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002101 PyObject *globals = NULL;
2102 PyObject *import = NULL;
2103 PyObject *builtins = NULL;
2104 PyObject *r = NULL;
2105
2106 /* Initialize constant string objects */
2107 if (silly_list == NULL) {
2108 import_str = PyString_InternFromString("__import__");
2109 if (import_str == NULL)
2110 return NULL;
2111 builtins_str = PyString_InternFromString("__builtins__");
2112 if (builtins_str == NULL)
2113 return NULL;
2114 silly_list = Py_BuildValue("[s]", "__doc__");
2115 if (silly_list == NULL)
2116 return NULL;
2117 }
2118
2119 /* Get the builtins from current globals */
2120 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002121 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00002122 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002123 builtins = PyObject_GetItem(globals, builtins_str);
2124 if (builtins == NULL)
2125 goto err;
2126 }
2127 else {
2128 /* No globals -- use standard builtins, and fake globals */
2129 PyErr_Clear();
2130
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002131 builtins = PyImport_ImportModuleEx("__builtin__",
2132 NULL, NULL, NULL);
2133 if (builtins == NULL)
2134 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002135 globals = Py_BuildValue("{OO}", builtins_str, builtins);
2136 if (globals == NULL)
2137 goto err;
2138 }
2139
2140 /* Get the __import__ function from the builtins */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002141 if (PyDict_Check(builtins)) {
Fred Drakea76ba6e2001-03-06 06:31:15 +00002142 import = PyObject_GetItem(builtins, import_str);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002143 if (import == NULL)
2144 PyErr_SetObject(PyExc_KeyError, import_str);
2145 }
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002146 else
Fred Drakea76ba6e2001-03-06 06:31:15 +00002147 import = PyObject_GetAttr(builtins, import_str);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002148 if (import == NULL)
2149 goto err;
2150
2151 /* Call the _import__ function with the proper argument list */
2152 r = PyObject_CallFunction(import, "OOOO",
2153 module_name, globals, globals, silly_list);
2154
2155 err:
2156 Py_XDECREF(globals);
2157 Py_XDECREF(builtins);
2158 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00002159
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002160 return r;
2161}
2162
2163
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002164/* Module 'imp' provides Python access to the primitives used for
2165 importing modules.
2166*/
2167
Guido van Rossum79f25d91997-04-29 20:08:16 +00002168static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002169imp_get_magic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002170{
2171 char buf[4];
2172
Guido van Rossum43713e52000-02-29 13:59:29 +00002173 if (!PyArg_ParseTuple(args, ":get_magic"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002174 return NULL;
Guido van Rossum96774c12000-05-01 20:19:08 +00002175 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
2176 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
2177 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
2178 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002179
Guido van Rossum79f25d91997-04-29 20:08:16 +00002180 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002181}
2182
Guido van Rossum79f25d91997-04-29 20:08:16 +00002183static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002184imp_get_suffixes(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002185{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002186 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002187 struct filedescr *fdp;
2188
Guido van Rossum43713e52000-02-29 13:59:29 +00002189 if (!PyArg_ParseTuple(args, ":get_suffixes"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002190 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002191 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002192 if (list == NULL)
2193 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002194 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
2195 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002196 fdp->suffix, fdp->mode, fdp->type);
2197 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002198 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002199 return NULL;
2200 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002201 if (PyList_Append(list, item) < 0) {
2202 Py_DECREF(list);
2203 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002204 return NULL;
2205 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002206 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002207 }
2208 return list;
2209}
2210
Guido van Rossum79f25d91997-04-29 20:08:16 +00002211static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002212call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002213{
Tim Petersdbd9ba62000-07-09 03:09:57 +00002214 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002215 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002216 struct filedescr *fdp;
2217 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002218 FILE *fp = NULL;
2219
2220 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002221 if (path == Py_None)
2222 path = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002223 fdp = find_module(name, path, pathname, MAXPATHLEN+1, &fp);
2224 if (fdp == NULL)
2225 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002226 if (fp != NULL) {
2227 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
2228 if (fob == NULL) {
2229 fclose(fp);
2230 return NULL;
2231 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002232 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002233 else {
2234 fob = Py_None;
2235 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00002236 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002237 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002238 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002239 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002240 return ret;
2241}
2242
Guido van Rossum79f25d91997-04-29 20:08:16 +00002243static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002244imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002245{
2246 char *name;
2247 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002248 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002249 return NULL;
2250 return call_find_module(name, path);
2251}
2252
2253static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002254imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002255{
2256 char *name;
2257 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002258 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002259 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002260 return NULL;
2261 ret = init_builtin(name);
2262 if (ret < 0)
2263 return NULL;
2264 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002265 Py_INCREF(Py_None);
2266 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002267 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002268 m = PyImport_AddModule(name);
2269 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002270 return m;
2271}
2272
Guido van Rossum79f25d91997-04-29 20:08:16 +00002273static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002274imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002275{
2276 char *name;
2277 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002278 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002279 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002280 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002281 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002282 if (ret < 0)
2283 return NULL;
2284 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002285 Py_INCREF(Py_None);
2286 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002287 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002288 m = PyImport_AddModule(name);
2289 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002290 return m;
2291}
2292
Guido van Rossum79f25d91997-04-29 20:08:16 +00002293static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002294imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002295{
2296 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002297
Guido van Rossum43713e52000-02-29 13:59:29 +00002298 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002299 return NULL;
2300 return get_frozen_object(name);
2301}
2302
Guido van Rossum79f25d91997-04-29 20:08:16 +00002303static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002304imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002305{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002306 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002307 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002308 return NULL;
Guido van Rossum50ee94f2002-04-09 18:00:58 +00002309 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002310}
2311
Guido van Rossum79f25d91997-04-29 20:08:16 +00002312static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002313imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002314{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002315 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002316 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002317 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002318 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002319 p = find_frozen(name);
Guido van Rossumb8bff3f2002-04-07 06:34:38 +00002320 return PyBool_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002321}
2322
2323static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002324get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002325{
2326 FILE *fp;
2327 if (fob == NULL) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002328 if (mode[0] == 'U')
2329 mode = "r" PY_STDIOTEXTMODE;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002330 fp = fopen(pathname, mode);
2331 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002332 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002333 }
2334 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002335 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002336 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002337 PyErr_SetString(PyExc_ValueError,
2338 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002339 }
2340 return fp;
2341}
2342
Guido van Rossum79f25d91997-04-29 20:08:16 +00002343static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002344imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002345{
2346 char *name;
2347 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002348 PyObject *fob = NULL;
2349 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002350 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002351 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002352 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002353 return NULL;
2354 fp = get_file(pathname, fob, "rb");
2355 if (fp == NULL)
2356 return NULL;
2357 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002358 if (fob == NULL)
2359 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002360 return m;
2361}
2362
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002363#ifdef HAVE_DYNAMIC_LOADING
2364
Guido van Rossum79f25d91997-04-29 20:08:16 +00002365static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002366imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002367{
2368 char *name;
2369 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002370 PyObject *fob = NULL;
2371 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002372 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002373 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002374 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002375 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002376 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002377 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002378 if (fp == NULL)
2379 return NULL;
2380 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002381 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002382 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002383}
2384
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002385#endif /* HAVE_DYNAMIC_LOADING */
2386
Guido van Rossum79f25d91997-04-29 20:08:16 +00002387static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002388imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002389{
2390 char *name;
2391 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002392 PyObject *fob = NULL;
2393 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002394 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002395 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002396 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002397 return NULL;
2398 fp = get_file(pathname, fob, "r");
2399 if (fp == NULL)
2400 return NULL;
2401 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002402 if (fob == NULL)
2403 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002404 return m;
2405}
2406
Jack Jansen9c96a921995-02-15 22:57:06 +00002407#ifdef macintosh
Guido van Rossum79f25d91997-04-29 20:08:16 +00002408static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002409imp_load_resource(PyObject *self, PyObject *args)
Jack Jansen9c96a921995-02-15 22:57:06 +00002410{
2411 char *name;
2412 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002413 PyObject *m;
Jack Jansen9c96a921995-02-15 22:57:06 +00002414
Guido van Rossum43713e52000-02-29 13:59:29 +00002415 if (!PyArg_ParseTuple(args, "ss:load_resource", &name, &pathname))
Jack Jansen9c96a921995-02-15 22:57:06 +00002416 return NULL;
2417 m = PyMac_LoadResourceModule(name, pathname);
2418 return m;
2419}
2420#endif /* macintosh */
2421
Guido van Rossum79f25d91997-04-29 20:08:16 +00002422static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002423imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002424{
2425 char *name;
2426 PyObject *fob;
2427 char *pathname;
2428 char *suffix; /* Unused */
2429 char *mode;
2430 int type;
2431 FILE *fp;
2432
Guido van Rossum43713e52000-02-29 13:59:29 +00002433 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002434 &name, &fob, &pathname,
2435 &suffix, &mode, &type))
2436 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002437 if (*mode) {
2438 /* Mode must start with 'r' or 'U' and must not contain '+'.
2439 Implicit in this test is the assumption that the mode
2440 may contain other modifiers like 'b' or 't'. */
2441
2442 if (!(*mode == 'r' || *mode == 'U') || strchr(mode, '+')) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002443 PyErr_Format(PyExc_ValueError,
2444 "invalid file open mode %.200s", mode);
2445 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002446 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002447 }
2448 if (fob == Py_None)
2449 fp = NULL;
2450 else {
2451 if (!PyFile_Check(fob)) {
2452 PyErr_SetString(PyExc_ValueError,
2453 "load_module arg#2 should be a file or None");
2454 return NULL;
2455 }
2456 fp = get_file(pathname, fob, mode);
2457 if (fp == NULL)
2458 return NULL;
2459 }
2460 return load_module(name, fp, pathname, type);
2461}
2462
2463static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002464imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002465{
2466 char *name;
2467 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002468 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002469 return NULL;
2470 return load_package(name, pathname);
2471}
2472
2473static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002474imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002475{
2476 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002477 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002478 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002479 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002480}
2481
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002482/* Doc strings */
2483
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002484PyDoc_STRVAR(doc_imp,
2485"This module provides the components needed to build your own\n\
2486__import__ function. Undocumented functions are obsolete.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002487
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002488PyDoc_STRVAR(doc_find_module,
2489"find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002490Search for a module. If path is omitted or None, search for a\n\
2491built-in, frozen or special module and continue search in sys.path.\n\
2492The module name cannot contain '.'; to search for a submodule of a\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002493package, pass the submodule name and the package's __path__.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002494
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002495PyDoc_STRVAR(doc_load_module,
2496"load_module(name, file, filename, (suffix, mode, type)) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002497Load a module, given information returned by find_module().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002498The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002499
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002500PyDoc_STRVAR(doc_get_magic,
2501"get_magic() -> string\n\
2502Return the magic number for .pyc or .pyo files.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002503
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002504PyDoc_STRVAR(doc_get_suffixes,
2505"get_suffixes() -> [(suffix, mode, type), ...]\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002506Return a list of (suffix, mode, type) tuples describing the files\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002507that find_module() looks for.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002508
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002509PyDoc_STRVAR(doc_new_module,
2510"new_module(name) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002511Create a new module. Do not enter it in sys.modules.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002512The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002513
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002514PyDoc_STRVAR(doc_lock_held,
2515"lock_held() -> 0 or 1\n\
Tim Peters69232342001-08-30 05:16:13 +00002516Return 1 if the import lock is currently held.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002517On platforms without threads, return 0.");
Tim Peters69232342001-08-30 05:16:13 +00002518
Guido van Rossum79f25d91997-04-29 20:08:16 +00002519static PyMethodDef imp_methods[] = {
Neal Norwitz031829d2002-03-31 14:37:44 +00002520 {"find_module", imp_find_module, METH_VARARGS, doc_find_module},
2521 {"get_magic", imp_get_magic, METH_VARARGS, doc_get_magic},
2522 {"get_suffixes", imp_get_suffixes, METH_VARARGS, doc_get_suffixes},
2523 {"load_module", imp_load_module, METH_VARARGS, doc_load_module},
2524 {"new_module", imp_new_module, METH_VARARGS, doc_new_module},
2525 {"lock_held", imp_lock_held, METH_VARARGS, doc_lock_held},
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002526 /* The rest are obsolete */
Neal Norwitz031829d2002-03-31 14:37:44 +00002527 {"get_frozen_object", imp_get_frozen_object, METH_VARARGS},
2528 {"init_builtin", imp_init_builtin, METH_VARARGS},
2529 {"init_frozen", imp_init_frozen, METH_VARARGS},
2530 {"is_builtin", imp_is_builtin, METH_VARARGS},
2531 {"is_frozen", imp_is_frozen, METH_VARARGS},
2532 {"load_compiled", imp_load_compiled, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002533#ifdef HAVE_DYNAMIC_LOADING
Neal Norwitz031829d2002-03-31 14:37:44 +00002534 {"load_dynamic", imp_load_dynamic, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002535#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002536 {"load_package", imp_load_package, METH_VARARGS},
Jack Jansen9c96a921995-02-15 22:57:06 +00002537#ifdef macintosh
Neal Norwitz031829d2002-03-31 14:37:44 +00002538 {"load_resource", imp_load_resource, METH_VARARGS},
Jack Jansen9c96a921995-02-15 22:57:06 +00002539#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002540 {"load_source", imp_load_source, METH_VARARGS},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002541 {NULL, NULL} /* sentinel */
2542};
2543
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002544static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002545setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002546{
2547 PyObject *v;
2548 int err;
2549
2550 v = PyInt_FromLong((long)value);
2551 err = PyDict_SetItemString(d, name, v);
2552 Py_XDECREF(v);
2553 return err;
2554}
2555
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002556void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002557initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002558{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002559 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002560
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002561 m = Py_InitModule4("imp", imp_methods, doc_imp,
2562 NULL, PYTHON_API_VERSION);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002563 d = PyModule_GetDict(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002564
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002565 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
2566 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
2567 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
2568 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
2569 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
2570 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
2571 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
2572 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00002573 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002574
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002575 failure:
2576 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002577}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002578
2579
Guido van Rossumb18618d2000-05-03 23:44:39 +00002580/* API for embedding applications that want to add their own entries
2581 to the table of built-in modules. This should normally be called
2582 *before* Py_Initialize(). When the table resize fails, -1 is
2583 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002584
2585 After a similar function by Just van Rossum. */
2586
2587int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002588PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002589{
2590 static struct _inittab *our_copy = NULL;
2591 struct _inittab *p;
2592 int i, n;
2593
2594 /* Count the number of entries in both tables */
2595 for (n = 0; newtab[n].name != NULL; n++)
2596 ;
2597 if (n == 0)
2598 return 0; /* Nothing to do */
2599 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
2600 ;
2601
2602 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00002603 p = our_copy;
2604 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002605 if (p == NULL)
2606 return -1;
2607
2608 /* Copy the tables into the new memory */
2609 if (our_copy != PyImport_Inittab)
2610 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
2611 PyImport_Inittab = our_copy = p;
2612 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
2613
2614 return 0;
2615}
2616
2617/* Shorthand to add a single entry given a name and a function */
2618
2619int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002620PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002621{
2622 struct _inittab newtab[2];
2623
2624 memset(newtab, '\0', sizeof newtab);
2625
2626 newtab[0].name = name;
2627 newtab[0].initfunc = initfunc;
2628
2629 return PyImport_ExtendInittab(newtab);
2630}