blob: 6fd05d8786d68de5f0076b49672ecebc3325b013 [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
52 Known values:
53 Python 1.5: 20121
54 Python 1.5.1: 20121
55 Python 1.5.2: 20121
56 Python 2.0: 50823
57 Python 2.0.1: 50823
58 Python 2.1: 60202
59 Python 2.1.1: 60202
60 Python 2.1.2: 60202
61 Python 2.2: 60717
Neal Norwitz7fdcb412002-06-14 01:07:39 +000062 Python 2.3a0: 62011
Tim Peters36515e22001-11-18 04:06:29 +000063*/
Neal Norwitz7fdcb412002-06-14 01:07:39 +000064#define MAGIC (62011 | ((long)'\r'<<16) | ((long)'\n'<<24))
Guido van Rossum3ddee711991-12-16 13:06:34 +000065
Guido van Rossum96774c12000-05-01 20:19:08 +000066/* Magic word as global; note that _PyImport_Init() can change the
Jeremy Hylton9262b8a2000-06-30 04:59:17 +000067 value of this global to accommodate for alterations of how the
Guido van Rossum96774c12000-05-01 20:19:08 +000068 compiler works which are enabled by command line switches. */
69static long pyc_magic = MAGIC;
70
Guido van Rossum25ce5661997-08-02 03:10:38 +000071/* See _PyImport_FixupExtension() below */
72static PyObject *extensions = NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +000073
Guido van Rossum771c6c81997-10-31 18:37:24 +000074/* This table is defined in config.c: */
75extern struct _inittab _PyImport_Inittab[];
76
77struct _inittab *PyImport_Inittab = _PyImport_Inittab;
Guido van Rossum66f1fa81991-04-03 19:03:52 +000078
Guido van Rossumed1170e1999-12-20 21:23:41 +000079/* these tables define the module suffixes that Python recognizes */
80struct filedescr * _PyImport_Filetab = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +000081
82#ifdef RISCOS
83static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000084 {"/py", "U", PY_SOURCE},
Guido van Rossum48a680c2001-03-02 06:34:14 +000085 {"/pyc", "rb", PY_COMPILED},
86 {0, 0}
87};
88#else
Guido van Rossumed1170e1999-12-20 21:23:41 +000089static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000090 {".py", "U", PY_SOURCE},
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000091#ifdef MS_WINDOWS
Jack Jansenc88da1f2002-05-28 10:58:19 +000092 {".pyw", "U", PY_SOURCE},
Tim Peters36515e22001-11-18 04:06:29 +000093#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +000094 {".pyc", "rb", PY_COMPILED},
95 {0, 0}
96};
Guido van Rossum48a680c2001-03-02 06:34:14 +000097#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +000098
Guido van Rossum1ae940a1995-01-02 19:04:15 +000099/* Initialize things */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000100
101void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000102_PyImport_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000103{
Guido van Rossumed1170e1999-12-20 21:23:41 +0000104 const struct filedescr *scan;
105 struct filedescr *filetab;
106 int countD = 0;
107 int countS = 0;
108
109 /* prepare _PyImport_Filetab: copy entries from
110 _PyImport_DynLoadFiletab and _PyImport_StandardFiletab.
111 */
112 for (scan = _PyImport_DynLoadFiletab; scan->suffix != NULL; ++scan)
113 ++countD;
114 for (scan = _PyImport_StandardFiletab; scan->suffix != NULL; ++scan)
115 ++countS;
Guido van Rossumb18618d2000-05-03 23:44:39 +0000116 filetab = PyMem_NEW(struct filedescr, countD + countS + 1);
Guido van Rossumed1170e1999-12-20 21:23:41 +0000117 memcpy(filetab, _PyImport_DynLoadFiletab,
118 countD * sizeof(struct filedescr));
119 memcpy(filetab + countD, _PyImport_StandardFiletab,
120 countS * sizeof(struct filedescr));
121 filetab[countD + countS].suffix = NULL;
122
123 _PyImport_Filetab = filetab;
124
Guido van Rossum0824f631997-03-11 18:37:35 +0000125 if (Py_OptimizeFlag) {
Guido van Rossumed1170e1999-12-20 21:23:41 +0000126 /* Replace ".pyc" with ".pyo" in _PyImport_Filetab */
127 for (; filetab->suffix != NULL; filetab++) {
Guido van Rossum48a680c2001-03-02 06:34:14 +0000128#ifndef RISCOS
Guido van Rossumed1170e1999-12-20 21:23:41 +0000129 if (strcmp(filetab->suffix, ".pyc") == 0)
130 filetab->suffix = ".pyo";
Guido van Rossum48a680c2001-03-02 06:34:14 +0000131#else
132 if (strcmp(filetab->suffix, "/pyc") == 0)
133 filetab->suffix = "/pyo";
134#endif
Guido van Rossum0824f631997-03-11 18:37:35 +0000135 }
136 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000137
138 if (Py_UnicodeFlag) {
139 /* Fix the pyc_magic so that byte compiled code created
140 using the all-Unicode method doesn't interfere with
141 code created in normal operation mode. */
142 pyc_magic = MAGIC + 1;
143 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000144}
145
Guido van Rossum25ce5661997-08-02 03:10:38 +0000146void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000147_PyImport_Fini(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000148{
149 Py_XDECREF(extensions);
150 extensions = NULL;
Barry Warsaw84294482000-10-03 16:02:05 +0000151 PyMem_DEL(_PyImport_Filetab);
152 _PyImport_Filetab = NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000153}
154
155
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000156/* Locking primitives to prevent parallel imports of the same module
157 in different threads to return with a partially loaded module.
158 These calls are serialized by the global interpreter lock. */
159
160#ifdef WITH_THREAD
161
Guido van Rossum49b56061998-10-01 20:42:43 +0000162#include "pythread.h"
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000163
Guido van Rossum65d5b571998-12-21 19:32:43 +0000164static PyThread_type_lock import_lock = 0;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000165static long import_lock_thread = -1;
166static int import_lock_level = 0;
167
168static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000169lock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000170{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000171 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000172 if (me == -1)
173 return; /* Too bad */
174 if (import_lock == NULL)
Guido van Rossum65d5b571998-12-21 19:32:43 +0000175 import_lock = PyThread_allocate_lock();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000176 if (import_lock_thread == me) {
177 import_lock_level++;
178 return;
179 }
Guido van Rossum65d5b571998-12-21 19:32:43 +0000180 if (import_lock_thread != -1 || !PyThread_acquire_lock(import_lock, 0)) {
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000181 PyThreadState *tstate = PyEval_SaveThread();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000182 PyThread_acquire_lock(import_lock, 1);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000183 PyEval_RestoreThread(tstate);
184 }
185 import_lock_thread = me;
186 import_lock_level = 1;
187}
188
189static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000190unlock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000191{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000192 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000193 if (me == -1)
194 return; /* Too bad */
195 if (import_lock_thread != me)
196 Py_FatalError("unlock_import: not holding the import lock");
197 import_lock_level--;
198 if (import_lock_level == 0) {
199 import_lock_thread = -1;
Guido van Rossum65d5b571998-12-21 19:32:43 +0000200 PyThread_release_lock(import_lock);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000201 }
202}
203
204#else
205
206#define lock_import()
207#define unlock_import()
208
209#endif
210
Tim Peters69232342001-08-30 05:16:13 +0000211static PyObject *
212imp_lock_held(PyObject *self, PyObject *args)
213{
214 if (!PyArg_ParseTuple(args, ":lock_held"))
215 return NULL;
216#ifdef WITH_THREAD
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000217 return PyBool_FromLong(import_lock_thread != -1);
Tim Peters69232342001-08-30 05:16:13 +0000218#else
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000219 return PyBool_FromLong(0);
Tim Peters69232342001-08-30 05:16:13 +0000220#endif
221}
222
Guido van Rossum25ce5661997-08-02 03:10:38 +0000223/* Helper for sys */
224
225PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000226PyImport_GetModuleDict(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000227{
228 PyInterpreterState *interp = PyThreadState_Get()->interp;
229 if (interp->modules == NULL)
230 Py_FatalError("PyImport_GetModuleDict: no module dictionary!");
231 return interp->modules;
232}
233
Guido van Rossum3f5da241990-12-20 15:06:42 +0000234
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000235/* List of names to clear in sys */
236static char* sys_deletes[] = {
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000237 "path", "argv", "ps1", "ps2", "exitfunc",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000238 "exc_type", "exc_value", "exc_traceback",
239 "last_type", "last_value", "last_traceback",
240 NULL
241};
242
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000243static char* sys_files[] = {
244 "stdin", "__stdin__",
245 "stdout", "__stdout__",
246 "stderr", "__stderr__",
247 NULL
248};
249
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000250
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000251/* Un-initialize things, as good as we can */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000252
Guido van Rossum3f5da241990-12-20 15:06:42 +0000253void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000254PyImport_Cleanup(void)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000255{
Guido van Rossum758eec01998-01-19 21:58:26 +0000256 int pos, ndone;
257 char *name;
258 PyObject *key, *value, *dict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000259 PyInterpreterState *interp = PyThreadState_Get()->interp;
Guido van Rossum758eec01998-01-19 21:58:26 +0000260 PyObject *modules = interp->modules;
261
262 if (modules == NULL)
263 return; /* Already done */
264
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000265 /* Delete some special variables first. These are common
266 places where user values hide and people complain when their
267 destructors fail. Since the modules containing them are
268 deleted *last* of all, they would come too late in the normal
269 destruction order. Sigh. */
270
271 value = PyDict_GetItemString(modules, "__builtin__");
272 if (value != NULL && PyModule_Check(value)) {
273 dict = PyModule_GetDict(value);
274 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000275 PySys_WriteStderr("# clear __builtin__._\n");
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000276 PyDict_SetItemString(dict, "_", Py_None);
277 }
278 value = PyDict_GetItemString(modules, "sys");
279 if (value != NULL && PyModule_Check(value)) {
280 char **p;
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000281 PyObject *v;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000282 dict = PyModule_GetDict(value);
283 for (p = sys_deletes; *p != NULL; p++) {
284 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000285 PySys_WriteStderr("# clear sys.%s\n", *p);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000286 PyDict_SetItemString(dict, *p, Py_None);
287 }
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000288 for (p = sys_files; *p != NULL; p+=2) {
289 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000290 PySys_WriteStderr("# restore sys.%s\n", *p);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000291 v = PyDict_GetItemString(dict, *(p+1));
292 if (v == NULL)
293 v = Py_None;
294 PyDict_SetItemString(dict, *p, v);
295 }
296 }
297
298 /* First, delete __main__ */
299 value = PyDict_GetItemString(modules, "__main__");
300 if (value != NULL && PyModule_Check(value)) {
301 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000302 PySys_WriteStderr("# cleanup __main__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000303 _PyModule_Clear(value);
304 PyDict_SetItemString(modules, "__main__", Py_None);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000305 }
306
Guido van Rossum758eec01998-01-19 21:58:26 +0000307 /* The special treatment of __builtin__ here is because even
308 when it's not referenced as a module, its dictionary is
309 referenced by almost every module's __builtins__. Since
310 deleting a module clears its dictionary (even if there are
311 references left to it), we need to delete the __builtin__
312 module last. Likewise, we don't delete sys until the very
313 end because it is implicitly referenced (e.g. by print).
314
315 Also note that we 'delete' modules by replacing their entry
316 in the modules dict with None, rather than really deleting
317 them; this avoids a rehash of the modules dictionary and
318 also marks them as "non existent" so they won't be
319 re-imported. */
320
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000321 /* Next, repeatedly delete modules with a reference count of
Guido van Rossum758eec01998-01-19 21:58:26 +0000322 one (skipping __builtin__ and sys) and delete them */
323 do {
324 ndone = 0;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000325 pos = 0;
Guido van Rossum758eec01998-01-19 21:58:26 +0000326 while (PyDict_Next(modules, &pos, &key, &value)) {
327 if (value->ob_refcnt != 1)
328 continue;
Guido van Rossum566373e1998-10-01 15:24:50 +0000329 if (PyString_Check(key) && PyModule_Check(value)) {
330 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000331 if (strcmp(name, "__builtin__") == 0)
332 continue;
333 if (strcmp(name, "sys") == 0)
334 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000335 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000336 PySys_WriteStderr(
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000337 "# cleanup[1] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000338 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000339 PyDict_SetItem(modules, key, Py_None);
340 ndone++;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000341 }
342 }
Guido van Rossum758eec01998-01-19 21:58:26 +0000343 } while (ndone > 0);
344
Guido van Rossum758eec01998-01-19 21:58:26 +0000345 /* Next, delete all modules (still skipping __builtin__ and sys) */
346 pos = 0;
347 while (PyDict_Next(modules, &pos, &key, &value)) {
Guido van Rossum566373e1998-10-01 15:24:50 +0000348 if (PyString_Check(key) && PyModule_Check(value)) {
349 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000350 if (strcmp(name, "__builtin__") == 0)
351 continue;
352 if (strcmp(name, "sys") == 0)
353 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000354 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000355 PySys_WriteStderr("# cleanup[2] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000356 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000357 PyDict_SetItem(modules, key, Py_None);
358 }
359 }
360
361 /* Next, delete sys and __builtin__ (in that order) */
362 value = PyDict_GetItemString(modules, "sys");
363 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000364 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000365 PySys_WriteStderr("# cleanup sys\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000366 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000367 PyDict_SetItemString(modules, "sys", Py_None);
368 }
369 value = PyDict_GetItemString(modules, "__builtin__");
370 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000371 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000372 PySys_WriteStderr("# cleanup __builtin__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000373 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000374 PyDict_SetItemString(modules, "__builtin__", Py_None);
375 }
376
377 /* Finally, clear and delete the modules directory */
378 PyDict_Clear(modules);
379 interp->modules = NULL;
380 Py_DECREF(modules);
Guido van Rossum8d15b5d1990-10-26 14:58:58 +0000381}
Guido van Rossum7f133ed1991-02-19 12:23:57 +0000382
383
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000384/* Helper for pythonrun.c -- return magic number */
385
386long
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000387PyImport_GetMagicNumber(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000388{
Guido van Rossum96774c12000-05-01 20:19:08 +0000389 return pyc_magic;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000390}
391
392
Guido van Rossum25ce5661997-08-02 03:10:38 +0000393/* Magic for extension modules (built-in as well as dynamically
394 loaded). To prevent initializing an extension module more than
395 once, we keep a static dictionary 'extensions' keyed by module name
396 (for built-in modules) or by filename (for dynamically loaded
Barry Warsaw92883382001-08-13 23:05:44 +0000397 modules), containing these modules. A copy of the module's
Guido van Rossum25ce5661997-08-02 03:10:38 +0000398 dictionary is stored by calling _PyImport_FixupExtension()
399 immediately after the module initialization function succeeds. A
400 copy can be retrieved from there by calling
401 _PyImport_FindExtension(). */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000402
Guido van Rossum79f25d91997-04-29 20:08:16 +0000403PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000404_PyImport_FixupExtension(char *name, char *filename)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000405{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000406 PyObject *modules, *mod, *dict, *copy;
407 if (extensions == NULL) {
408 extensions = PyDict_New();
409 if (extensions == NULL)
410 return NULL;
411 }
412 modules = PyImport_GetModuleDict();
413 mod = PyDict_GetItemString(modules, name);
414 if (mod == NULL || !PyModule_Check(mod)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000415 PyErr_Format(PyExc_SystemError,
416 "_PyImport_FixupExtension: module %.200s not loaded", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000417 return NULL;
418 }
419 dict = PyModule_GetDict(mod);
420 if (dict == NULL)
421 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000422 copy = PyDict_Copy(dict);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000423 if (copy == NULL)
424 return NULL;
425 PyDict_SetItemString(extensions, filename, copy);
426 Py_DECREF(copy);
427 return copy;
428}
429
430PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000431_PyImport_FindExtension(char *name, char *filename)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000432{
Fred Drake9cd0efc2001-10-25 21:38:59 +0000433 PyObject *dict, *mod, *mdict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000434 if (extensions == NULL)
435 return NULL;
436 dict = PyDict_GetItemString(extensions, filename);
437 if (dict == NULL)
438 return NULL;
439 mod = PyImport_AddModule(name);
440 if (mod == NULL)
441 return NULL;
442 mdict = PyModule_GetDict(mod);
443 if (mdict == NULL)
444 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000445 if (PyDict_Update(mdict, dict))
Guido van Rossum25ce5661997-08-02 03:10:38 +0000446 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000447 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000448 PySys_WriteStderr("import %s # previously loaded (%s)\n",
Guido van Rossum25ce5661997-08-02 03:10:38 +0000449 name, filename);
450 return mod;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000451}
452
453
454/* Get the module object corresponding to a module name.
455 First check the modules dictionary if there's one there,
456 if not, create a new one and insert in in the modules dictionary.
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000457 Because the former action is most common, THIS DOES NOT RETURN A
458 'NEW' REFERENCE! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000459
Guido van Rossum79f25d91997-04-29 20:08:16 +0000460PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000461PyImport_AddModule(char *name)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000462{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000463 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000464 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000465
Guido van Rossum25ce5661997-08-02 03:10:38 +0000466 if ((m = PyDict_GetItemString(modules, name)) != NULL &&
Guido van Rossum79f25d91997-04-29 20:08:16 +0000467 PyModule_Check(m))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000468 return m;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000469 m = PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000470 if (m == NULL)
471 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000472 if (PyDict_SetItemString(modules, name, m) != 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000473 Py_DECREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000474 return NULL;
475 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000476 Py_DECREF(m); /* Yes, it still exists, in modules! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000477
478 return m;
479}
480
481
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000482/* Execute a code object in a module and return the module object
483 WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000484
Guido van Rossum79f25d91997-04-29 20:08:16 +0000485PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000486PyImport_ExecCodeModule(char *name, PyObject *co)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000487{
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000488 return PyImport_ExecCodeModuleEx(name, co, (char *)NULL);
489}
490
491PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000492PyImport_ExecCodeModuleEx(char *name, PyObject *co, char *pathname)
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000493{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000494 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000495 PyObject *m, *d, *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000496
Guido van Rossum79f25d91997-04-29 20:08:16 +0000497 m = PyImport_AddModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000498 if (m == NULL)
499 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000500 d = PyModule_GetDict(m);
501 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
502 if (PyDict_SetItemString(d, "__builtins__",
503 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000504 return NULL;
505 }
Guido van Rossum9c9a07c1996-05-16 20:43:40 +0000506 /* Remember the filename as the __file__ attribute */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000507 v = NULL;
508 if (pathname != NULL) {
509 v = PyString_FromString(pathname);
510 if (v == NULL)
511 PyErr_Clear();
512 }
513 if (v == NULL) {
514 v = ((PyCodeObject *)co)->co_filename;
515 Py_INCREF(v);
516 }
517 if (PyDict_SetItemString(d, "__file__", v) != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000518 PyErr_Clear(); /* Not important enough to report */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000519 Py_DECREF(v);
520
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000521 v = PyEval_EvalCode((PyCodeObject *)co, d, d);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000522 if (v == NULL)
523 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000524 Py_DECREF(v);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000525
Guido van Rossum25ce5661997-08-02 03:10:38 +0000526 if ((m = PyDict_GetItemString(modules, name)) == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000527 PyErr_Format(PyExc_ImportError,
528 "Loaded module %.200s not found in sys.modules",
529 name);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000530 return NULL;
531 }
532
Guido van Rossum79f25d91997-04-29 20:08:16 +0000533 Py_INCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000534
535 return m;
536}
537
538
539/* Given a pathname for a Python source file, fill a buffer with the
540 pathname for the corresponding compiled file. Return the pathname
541 for the compiled file, or NULL if there's no space in the buffer.
542 Doesn't set an exception. */
543
544static char *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000545make_compiled_pathname(char *pathname, char *buf, size_t buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000546{
Tim Petersc1731372001-08-04 08:12:36 +0000547 size_t len = strlen(pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000548 if (len+2 > buflen)
549 return NULL;
Tim Petersc1731372001-08-04 08:12:36 +0000550
Martin v. Löwis6238d2b2002-06-30 15:26:10 +0000551#ifdef MS_WINDOWS
Tim Petersc1731372001-08-04 08:12:36 +0000552 /* Treat .pyw as if it were .py. The case of ".pyw" must match
553 that used in _PyImport_StandardFiletab. */
554 if (len >= 4 && strcmp(&pathname[len-4], ".pyw") == 0)
555 --len; /* pretend 'w' isn't there */
556#endif
557 memcpy(buf, pathname, len);
558 buf[len] = Py_OptimizeFlag ? 'o' : 'c';
559 buf[len+1] = '\0';
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000560
561 return buf;
562}
563
564
565/* Given a pathname for a Python source file, its time of last
566 modification, and a pathname for a compiled file, check whether the
567 compiled file represents the same version of the source. If so,
568 return a FILE pointer for the compiled file, positioned just after
569 the header; if not, return NULL.
570 Doesn't set an exception. */
571
572static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000573check_compiled_module(char *pathname, long mtime, char *cpathname)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000574{
575 FILE *fp;
576 long magic;
577 long pyc_mtime;
578
579 fp = fopen(cpathname, "rb");
580 if (fp == NULL)
581 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000582 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000583 if (magic != pyc_magic) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000584 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000585 PySys_WriteStderr("# %s has bad magic\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000586 fclose(fp);
587 return NULL;
588 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000589 pyc_mtime = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000590 if (pyc_mtime != mtime) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000591 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000592 PySys_WriteStderr("# %s has bad mtime\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000593 fclose(fp);
594 return NULL;
595 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000596 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000597 PySys_WriteStderr("# %s matches %s\n", cpathname, pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000598 return fp;
599}
600
601
602/* Read a code object from a file and check it for validity */
603
Guido van Rossum79f25d91997-04-29 20:08:16 +0000604static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000605read_compiled_module(char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000606{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000607 PyObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000608
Tim Petersd9b9ac82001-01-28 00:27:39 +0000609 co = PyMarshal_ReadLastObjectFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000610 /* Ugly: rd_object() may return NULL with or without error */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000611 if (co == NULL || !PyCode_Check(co)) {
612 if (!PyErr_Occurred())
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000613 PyErr_Format(PyExc_ImportError,
614 "Non-code object in %.200s", cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000615 Py_XDECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000616 return NULL;
617 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000618 return (PyCodeObject *)co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000619}
620
621
622/* Load a module from a compiled file, execute it, and return its
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000623 module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000624
Guido van Rossum79f25d91997-04-29 20:08:16 +0000625static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000626load_compiled_module(char *name, char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000627{
628 long magic;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000629 PyCodeObject *co;
630 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000631
Guido van Rossum79f25d91997-04-29 20:08:16 +0000632 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000633 if (magic != pyc_magic) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000634 PyErr_Format(PyExc_ImportError,
635 "Bad magic number in %.200s", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000636 return NULL;
637 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000638 (void) PyMarshal_ReadLongFromFile(fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000639 co = read_compiled_module(cpathname, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000640 if (co == NULL)
641 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000642 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000643 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000644 name, cpathname);
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000645 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000646 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000647
648 return m;
649}
650
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000651/* Parse a source file and return the corresponding code object */
652
Guido van Rossum79f25d91997-04-29 20:08:16 +0000653static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000654parse_source_module(char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000655{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000656 PyCodeObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000657 node *n;
658
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000659 n = PyParser_SimpleParseFile(fp, pathname, Py_file_input);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000660 if (n == NULL)
661 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000662 co = PyNode_Compile(n, pathname);
663 PyNode_Free(n);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000664
665 return co;
666}
667
668
Guido van Rossum55a83382000-09-20 20:31:38 +0000669/* Helper to open a bytecode file for writing in exclusive mode */
670
671static FILE *
672open_exclusive(char *filename)
673{
674#if defined(O_EXCL)&&defined(O_CREAT)&&defined(O_WRONLY)&&defined(O_TRUNC)
675 /* Use O_EXCL to avoid a race condition when another process tries to
676 write the same file. When that happens, our open() call fails,
677 which is just fine (since it's only a cache).
678 XXX If the file exists and is writable but the directory is not
679 writable, the file will never be written. Oh well.
680 */
681 int fd;
682 (void) unlink(filename);
Tim Peters42c83af2000-09-29 04:03:10 +0000683 fd = open(filename, O_EXCL|O_CREAT|O_WRONLY|O_TRUNC
684#ifdef O_BINARY
685 |O_BINARY /* necessary for Windows */
686#endif
Tim Peters50d8d372001-02-28 05:34:27 +0000687
Tim Peters42c83af2000-09-29 04:03:10 +0000688 , 0666);
Guido van Rossum55a83382000-09-20 20:31:38 +0000689 if (fd < 0)
690 return NULL;
691 return fdopen(fd, "wb");
692#else
693 /* Best we can do -- on Windows this can't happen anyway */
694 return fopen(filename, "wb");
695#endif
696}
697
698
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000699/* Write a compiled module to a file, placing the time of last
700 modification of its source into the header.
701 Errors are ignored, if a write error occurs an attempt is made to
702 remove the file. */
703
704static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000705write_compiled_module(PyCodeObject *co, char *cpathname, long mtime)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000706{
707 FILE *fp;
708
Guido van Rossum55a83382000-09-20 20:31:38 +0000709 fp = open_exclusive(cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000710 if (fp == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000711 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000712 PySys_WriteStderr(
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000713 "# can't create %s\n", cpathname);
714 return;
715 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000716 PyMarshal_WriteLongToFile(pyc_magic, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000717 /* First write a 0 for mtime */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000718 PyMarshal_WriteLongToFile(0L, fp);
719 PyMarshal_WriteObjectToFile((PyObject *)co, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000720 if (ferror(fp)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000721 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000722 PySys_WriteStderr("# can't write %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000723 /* Don't keep partial file */
724 fclose(fp);
725 (void) unlink(cpathname);
726 return;
727 }
728 /* Now write the true mtime */
729 fseek(fp, 4L, 0);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000730 PyMarshal_WriteLongToFile(mtime, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000731 fflush(fp);
732 fclose(fp);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000733 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000734 PySys_WriteStderr("# wrote %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000735#ifdef macintosh
Jack Jansencbf630f2000-07-11 21:59:16 +0000736 PyMac_setfiletype(cpathname, 'Pyth', 'PYC ');
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000737#endif
738}
739
740
741/* Load a source module from a given file and return its module
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000742 object WITH INCREMENTED REFERENCE COUNT. If there's a matching
743 byte-compiled file, use that instead. */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000744
Guido van Rossum79f25d91997-04-29 20:08:16 +0000745static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000746load_source_module(char *name, char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000747{
Fred Drake4c82b232000-06-30 16:18:57 +0000748 time_t mtime;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000749 FILE *fpc;
750 char buf[MAXPATHLEN+1];
751 char *cpathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000752 PyCodeObject *co;
753 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000754
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000755 mtime = PyOS_GetLastModificationTime(pathname, fp);
Fred Drakec63d3e92001-03-01 06:33:32 +0000756 if (mtime == (time_t)(-1))
Fred Drake4c82b232000-06-30 16:18:57 +0000757 return NULL;
758#if SIZEOF_TIME_T > 4
759 /* Python's .pyc timestamp handling presumes that the timestamp fits
760 in 4 bytes. This will be fine until sometime in the year 2038,
761 when a 4-byte signed time_t will overflow.
762 */
763 if (mtime >> 32) {
764 PyErr_SetString(PyExc_OverflowError,
Fred Drakec63d3e92001-03-01 06:33:32 +0000765 "modification time overflows a 4 byte field");
Fred Drake4c82b232000-06-30 16:18:57 +0000766 return NULL;
767 }
768#endif
Tim Peters36515e22001-11-18 04:06:29 +0000769 cpathname = make_compiled_pathname(pathname, buf,
Jeremy Hylton37832f02001-04-13 17:50:20 +0000770 (size_t)MAXPATHLEN + 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000771 if (cpathname != NULL &&
772 (fpc = check_compiled_module(pathname, mtime, cpathname))) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000773 co = read_compiled_module(cpathname, fpc);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000774 fclose(fpc);
775 if (co == NULL)
776 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000777 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000778 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000779 name, cpathname);
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000780 pathname = cpathname;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000781 }
782 else {
783 co = parse_source_module(pathname, fp);
784 if (co == NULL)
785 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000786 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000787 PySys_WriteStderr("import %s # from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000788 name, pathname);
789 write_compiled_module(co, cpathname, mtime);
790 }
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000791 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, pathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000792 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000793
794 return m;
795}
796
797
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000798/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000799static PyObject *load_module(char *, FILE *, char *, int);
800static struct filedescr *find_module(char *, PyObject *,
801 char *, size_t, FILE **);
802static struct _frozen *find_frozen(char *name);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000803
804/* Load a package and return its module object WITH INCREMENTED
805 REFERENCE COUNT */
806
807static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000808load_package(char *name, char *pathname)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000809{
810 PyObject *m, *d, *file, *path;
811 int err;
812 char buf[MAXPATHLEN+1];
813 FILE *fp = NULL;
814 struct filedescr *fdp;
815
816 m = PyImport_AddModule(name);
817 if (m == NULL)
818 return NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000819 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000820 PySys_WriteStderr("import %s # directory %s\n",
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000821 name, pathname);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000822 d = PyModule_GetDict(m);
823 file = PyString_FromString(pathname);
824 if (file == NULL)
825 return NULL;
826 path = Py_BuildValue("[O]", file);
827 if (path == NULL) {
828 Py_DECREF(file);
829 return NULL;
830 }
831 err = PyDict_SetItemString(d, "__file__", file);
832 if (err == 0)
833 err = PyDict_SetItemString(d, "__path__", path);
834 if (err != 0) {
835 m = NULL;
836 goto cleanup;
837 }
838 buf[0] = '\0';
839 fdp = find_module("__init__", path, buf, sizeof(buf), &fp);
840 if (fdp == NULL) {
841 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
842 PyErr_Clear();
843 }
844 else
845 m = NULL;
846 goto cleanup;
847 }
848 m = load_module(name, fp, buf, fdp->type);
849 if (fp != NULL)
850 fclose(fp);
851 cleanup:
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000852 Py_XDECREF(path);
853 Py_XDECREF(file);
854 return m;
855}
856
857
858/* Helper to test for built-in module */
859
860static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000861is_builtin(char *name)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000862{
863 int i;
Guido van Rossum771c6c81997-10-31 18:37:24 +0000864 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
865 if (strcmp(name, PyImport_Inittab[i].name) == 0) {
866 if (PyImport_Inittab[i].initfunc == NULL)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000867 return -1;
868 else
869 return 1;
870 }
871 }
872 return 0;
873}
874
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000875
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000876/* Search the path (default sys.path) for a module. Return the
877 corresponding filedescr struct, and (via return arguments) the
878 pathname and an open file. Return NULL if the module is not found. */
879
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000880#ifdef MS_COREDLL
Thomas Woutersb4bd21c2000-07-22 23:38:01 +0000881extern FILE *PyWin_FindRegisteredModule(const char *, struct filedescr **,
882 char *, int);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000883#endif
884
Tim Peters50d8d372001-02-28 05:34:27 +0000885static int case_ok(char *, int, int, char *);
Tim Petersdbd9ba62000-07-09 03:09:57 +0000886static int find_init_module(char *); /* Forward */
Guido van Rossum197346f1997-10-31 18:38:52 +0000887
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000888static struct filedescr *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000889find_module(char *realname, PyObject *path, char *buf, size_t buflen,
890 FILE **p_fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000891{
Fred Drake4c82b232000-06-30 16:18:57 +0000892 int i, npath;
893 size_t len, namelen;
Guido van Rossum80bb9651996-12-05 23:27:02 +0000894 struct filedescr *fdp = NULL;
Jack Jansenc88da1f2002-05-28 10:58:19 +0000895 char *filemode;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +0000896 FILE *fp = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +0000897#ifndef RISCOS
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000898 struct stat statbuf;
Guido van Rossum48a680c2001-03-02 06:34:14 +0000899#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +0000900 static struct filedescr fd_frozen = {"", "", PY_FROZEN};
901 static struct filedescr fd_builtin = {"", "", C_BUILTIN};
902 static struct filedescr fd_package = {"", "", PKG_DIRECTORY};
Guido van Rossum0506a431998-08-11 15:07:39 +0000903 char name[MAXPATHLEN+1];
Andrew MacIntyred9400542002-02-26 11:41:34 +0000904#if defined(PYOS_OS2)
905 size_t saved_len;
906 size_t saved_namelen;
907 char *saved_buf = NULL;
908#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000909
Fred Drake4c82b232000-06-30 16:18:57 +0000910 if (strlen(realname) > MAXPATHLEN) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +0000911 PyErr_SetString(PyExc_OverflowError,
912 "module name is too long");
Fred Drake4c82b232000-06-30 16:18:57 +0000913 return NULL;
914 }
Guido van Rossum0506a431998-08-11 15:07:39 +0000915 strcpy(name, realname);
916
917 if (path != NULL && PyString_Check(path)) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +0000918 /* The only type of submodule allowed inside a "frozen"
919 package are other frozen modules or packages. */
Guido van Rossum0506a431998-08-11 15:07:39 +0000920 if (PyString_Size(path) + 1 + strlen(name) >= (size_t)buflen) {
921 PyErr_SetString(PyExc_ImportError,
922 "full frozen module name too long");
923 return NULL;
924 }
925 strcpy(buf, PyString_AsString(path));
926 strcat(buf, ".");
927 strcat(buf, name);
928 strcpy(name, buf);
Jack Jansen550fdae2001-10-30 13:08:39 +0000929#ifdef macintosh
930 /* Freezing on the mac works different, and the modules are
931 ** actually on sys.path. So we don't take the quick exit but
932 ** continue with the normal flow.
933 */
934 path = NULL;
935#else
Guido van Rossum8f4d3312001-10-18 18:54:11 +0000936 if (find_frozen(name) != NULL) {
937 strcpy(buf, name);
938 return &fd_frozen;
939 }
940 PyErr_Format(PyExc_ImportError,
941 "No frozen submodule named %.200s", name);
942 return NULL;
Jack Jansen550fdae2001-10-30 13:08:39 +0000943#endif
Guido van Rossum0506a431998-08-11 15:07:39 +0000944 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000945 if (path == NULL) {
946 if (is_builtin(name)) {
Guido van Rossuma5568d31998-03-05 03:45:08 +0000947 strcpy(buf, name);
948 return &fd_builtin;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000949 }
Greg Ward201baee2001-10-04 14:52:06 +0000950 if ((find_frozen(name)) != NULL) {
Guido van Rossuma5568d31998-03-05 03:45:08 +0000951 strcpy(buf, name);
952 return &fd_frozen;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000953 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000954
Guido van Rossumac279101996-08-22 23:10:58 +0000955#ifdef MS_COREDLL
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000956 fp = PyWin_FindRegisteredModule(name, &fdp, buf, buflen);
957 if (fp != NULL) {
958 *p_fp = fp;
959 return fdp;
960 }
Guido van Rossuma5a3db71996-04-09 02:39:59 +0000961#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +0000962 path = PySys_GetObject("path");
963 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000964 if (path == NULL || !PyList_Check(path)) {
965 PyErr_SetString(PyExc_ImportError,
Guido van Rossuma5568d31998-03-05 03:45:08 +0000966 "sys.path must be a list of directory names");
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000967 return NULL;
968 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000969 npath = PyList_Size(path);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000970 namelen = strlen(name);
971 for (i = 0; i < npath; i++) {
Walter Dörwald3430d702002-06-17 10:43:59 +0000972 PyObject *copy = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000973 PyObject *v = PyList_GetItem(path, i);
Walter Dörwald3430d702002-06-17 10:43:59 +0000974#ifdef Py_USING_UNICODE
975 if (PyUnicode_Check(v)) {
976 copy = PyUnicode_Encode(PyUnicode_AS_UNICODE(v),
977 PyUnicode_GET_SIZE(v), Py_FileSystemDefaultEncoding, NULL);
978 if (copy == NULL)
979 return NULL;
980 v = copy;
981 }
982 else
983#endif
Guido van Rossum79f25d91997-04-29 20:08:16 +0000984 if (!PyString_Check(v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000985 continue;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000986 len = PyString_Size(v);
Walter Dörwald3430d702002-06-17 10:43:59 +0000987 if (len + 2 + namelen + MAXSUFFIXSIZE >= buflen) {
988 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000989 continue; /* Too long */
Walter Dörwald3430d702002-06-17 10:43:59 +0000990 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000991 strcpy(buf, PyString_AsString(v));
Walter Dörwald3430d702002-06-17 10:43:59 +0000992 if (strlen(buf) != len) {
993 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000994 continue; /* v contains '\0' */
Walter Dörwald3430d702002-06-17 10:43:59 +0000995 }
Jack Jansen9c96a921995-02-15 22:57:06 +0000996#ifdef macintosh
Tim Peters50d8d372001-02-28 05:34:27 +0000997 /*
Guido van Rossum741689d1997-08-12 14:53:39 +0000998 ** Speedup: each sys.path item is interned, and
999 ** FindResourceModule remembers which items refer to
1000 ** folders (so we don't have to bother trying to look
Tim Peters50d8d372001-02-28 05:34:27 +00001001 ** into them for resources).
Guido van Rossum741689d1997-08-12 14:53:39 +00001002 */
1003 PyString_InternInPlace(&PyList_GET_ITEM(path, i));
1004 v = PyList_GET_ITEM(path, i);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001005 if (PyMac_FindResourceModule((PyStringObject *)v, name, buf)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001006 static struct filedescr resfiledescr =
1007 {"", "", PY_RESOURCE};
Tim Peters50d8d372001-02-28 05:34:27 +00001008
Walter Dörwald3430d702002-06-17 10:43:59 +00001009 Py_XDECREF(copy);
Jack Jansen9c96a921995-02-15 22:57:06 +00001010 return &resfiledescr;
1011 }
Guido van Rossum0f84a341998-08-06 13:36:01 +00001012 if (PyMac_FindCodeResourceModule((PyStringObject *)v, name, buf)) {
1013 static struct filedescr resfiledescr =
1014 {"", "", PY_CODERESOURCE};
Tim Peters50d8d372001-02-28 05:34:27 +00001015
Walter Dörwald3430d702002-06-17 10:43:59 +00001016 Py_XDECREF(copy);
Guido van Rossum0f84a341998-08-06 13:36:01 +00001017 return &resfiledescr;
1018 }
Jack Jansen9c96a921995-02-15 22:57:06 +00001019#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001020 if (len > 0 && buf[len-1] != SEP
1021#ifdef ALTSEP
1022 && buf[len-1] != ALTSEP
1023#endif
1024 )
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001025 buf[len++] = SEP;
Guido van Rossum215c3402000-11-13 17:26:32 +00001026 strcpy(buf+len, name);
1027 len += namelen;
Tim Peters50d8d372001-02-28 05:34:27 +00001028
1029 /* Check for package import (buf holds a directory name,
1030 and there's an __init__ module in that directory */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001031#ifdef HAVE_STAT
Walter Dörwald3430d702002-06-17 10:43:59 +00001032 if (stat(buf, &statbuf) == 0 && /* it exists */
1033 S_ISDIR(statbuf.st_mode) && /* it's a directory */
1034 find_init_module(buf) && /* it has __init__.py */
1035 case_ok(buf, len, namelen, name)) { /* and case matches */
1036 Py_XDECREF(copy);
Tim Peterscab3f682001-04-29 22:21:25 +00001037 return &fd_package;
Walter Dörwald3430d702002-06-17 10:43:59 +00001038 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001039#else
1040 /* XXX How are you going to test for directories? */
Guido van Rossum48a680c2001-03-02 06:34:14 +00001041#ifdef RISCOS
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001042 if (isdir(buf) &&
1043 find_init_module(buf) &&
Walter Dörwald3430d702002-06-17 10:43:59 +00001044 case_ok(buf, len, namelen, name)) {
1045 Py_XDECREF(copy);
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001046 return &fd_package;
Walter Dörwald3430d702002-06-17 10:43:59 +00001047 }
Guido van Rossum48a680c2001-03-02 06:34:14 +00001048#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001049#endif
Guido van Rossum9a61dc91997-10-08 15:25:08 +00001050#ifdef macintosh
1051 fdp = PyMac_FindModuleExtension(buf, &len, name);
Jack Jansen4df3c522001-03-20 23:09:54 +00001052 if (fdp) {
Guido van Rossum9a61dc91997-10-08 15:25:08 +00001053#else
Andrew MacIntyred9400542002-02-26 11:41:34 +00001054#if defined(PYOS_OS2)
1055 /* take a snapshot of the module spec for restoration
1056 * after the 8 character DLL hackery
1057 */
1058 saved_buf = strdup(buf);
1059 saved_len = len;
1060 saved_namelen = namelen;
1061#endif /* PYOS_OS2 */
Guido van Rossum79f25d91997-04-29 20:08:16 +00001062 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
Andrew MacIntyred9400542002-02-26 11:41:34 +00001063#if defined(PYOS_OS2)
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001064 /* OS/2 limits DLLs to 8 character names (w/o
1065 extension)
Andrew MacIntyred9400542002-02-26 11:41:34 +00001066 * so if the name is longer than that and its a
1067 * dynamically loaded module we're going to try,
1068 * truncate the name before trying
1069 */
1070 if (strlen(realname) > 8) {
1071 /* is this an attempt to load a C extension? */
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001072 const struct filedescr *scan;
1073 scan = _PyImport_DynLoadFiletab;
Andrew MacIntyred9400542002-02-26 11:41:34 +00001074 while (scan->suffix != NULL) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001075 if (!strcmp(scan->suffix, fdp->suffix))
Andrew MacIntyred9400542002-02-26 11:41:34 +00001076 break;
1077 else
1078 scan++;
1079 }
1080 if (scan->suffix != NULL) {
1081 /* yes, so truncate the name */
1082 namelen = 8;
1083 len -= strlen(realname) - namelen;
1084 buf[len] = '\0';
1085 }
1086 }
1087#endif /* PYOS_OS2 */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001088 strcpy(buf+len, fdp->suffix);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001089 if (Py_VerboseFlag > 1)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001090 PySys_WriteStderr("# trying %s\n", buf);
Jack Jansen4df3c522001-03-20 23:09:54 +00001091#endif /* !macintosh */
Jack Jansenc88da1f2002-05-28 10:58:19 +00001092 filemode = fdp->mode;
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001093 if (filemode[0] == 'U')
1094 filemode = "r" PY_STDIOTEXTMODE;
Jack Jansenc88da1f2002-05-28 10:58:19 +00001095 fp = fopen(buf, filemode);
Tim Peters50d8d372001-02-28 05:34:27 +00001096 if (fp != NULL) {
1097 if (case_ok(buf, len, namelen, name))
1098 break;
1099 else { /* continue search */
1100 fclose(fp);
1101 fp = NULL;
Barry Warsaw914a0b12001-02-02 19:12:16 +00001102 }
Barry Warsaw914a0b12001-02-02 19:12:16 +00001103 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001104#if defined(PYOS_OS2)
1105 /* restore the saved snapshot */
1106 strcpy(buf, saved_buf);
1107 len = saved_len;
1108 namelen = saved_namelen;
1109#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001110 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001111#if defined(PYOS_OS2)
1112 /* don't need/want the module name snapshot anymore */
1113 if (saved_buf)
1114 {
1115 free(saved_buf);
1116 saved_buf = NULL;
1117 }
1118#endif
Walter Dörwald3430d702002-06-17 10:43:59 +00001119 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001120 if (fp != NULL)
1121 break;
1122 }
1123 if (fp == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001124 PyErr_Format(PyExc_ImportError,
1125 "No module named %.200s", name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001126 return NULL;
1127 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001128 *p_fp = fp;
1129 return fdp;
1130}
1131
Tim Petersd1e87a82001-03-01 18:12:00 +00001132/* case_ok(char* buf, int len, int namelen, char* name)
1133 * The arguments here are tricky, best shown by example:
1134 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1135 * ^ ^ ^ ^
1136 * |--------------------- buf ---------------------|
1137 * |------------------- len ------------------|
1138 * |------ name -------|
1139 * |----- namelen -----|
1140 * buf is the full path, but len only counts up to (& exclusive of) the
1141 * extension. name is the module name, also exclusive of extension.
1142 *
1143 * We've already done a successful stat() or fopen() on buf, so know that
1144 * there's some match, possibly case-insensitive.
1145 *
Tim Peters50d8d372001-02-28 05:34:27 +00001146 * case_ok() is to return 1 if there's a case-sensitive match for
1147 * name, else 0. case_ok() is also to return 1 if envar PYTHONCASEOK
1148 * exists.
Tim Petersd1e87a82001-03-01 18:12:00 +00001149 *
Tim Peters50d8d372001-02-28 05:34:27 +00001150 * case_ok() is used to implement case-sensitive import semantics even
1151 * on platforms with case-insensitive filesystems. It's trivial to implement
1152 * for case-sensitive filesystems. It's pretty much a cross-platform
1153 * nightmare for systems with case-insensitive filesystems.
1154 */
Guido van Rossum0980bd91998-02-13 17:18:36 +00001155
Tim Peters50d8d372001-02-28 05:34:27 +00001156/* First we may need a pile of platform-specific header files; the sequence
1157 * of #if's here should match the sequence in the body of case_ok().
1158 */
Martin v. Löwis6238d2b2002-06-30 15:26:10 +00001159#if defined(MS_WINDOWS) || defined(__CYGWIN__)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001160#include <windows.h>
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001161#ifdef __CYGWIN__
1162#include <sys/cygwin.h>
1163#endif
1164
Tim Peters50d8d372001-02-28 05:34:27 +00001165#elif defined(DJGPP)
1166#include <dir.h>
1167
1168#elif defined(macintosh)
1169#include <TextUtils.h>
Tim Peters50d8d372001-02-28 05:34:27 +00001170
Tim Petersd1e87a82001-03-01 18:12:00 +00001171#elif defined(__MACH__) && defined(__APPLE__) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001172#include <sys/types.h>
1173#include <dirent.h>
1174
Andrew MacIntyred9400542002-02-26 11:41:34 +00001175#elif defined(PYOS_OS2)
1176#define INCL_DOS
1177#define INCL_DOSERRORS
1178#define INCL_NOPMAPI
1179#include <os2.h>
1180
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001181#elif defined(RISCOS)
1182#include "oslib/osfscontrol.h"
Tim Peters50d8d372001-02-28 05:34:27 +00001183#endif
1184
Guido van Rossum0980bd91998-02-13 17:18:36 +00001185static int
Tim Peters50d8d372001-02-28 05:34:27 +00001186case_ok(char *buf, int len, int namelen, char *name)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001187{
Tim Peters50d8d372001-02-28 05:34:27 +00001188/* Pick a platform-specific implementation; the sequence of #if's here should
1189 * match the sequence just above.
1190 */
1191
Martin v. Löwis6238d2b2002-06-30 15:26:10 +00001192/* MS_WINDOWS || __CYGWIN__ */
1193#if defined(MS_WINDOWS) || defined(__CYGWIN__)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001194 WIN32_FIND_DATA data;
1195 HANDLE h;
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001196#ifdef __CYGWIN__
1197 char tempbuf[MAX_PATH];
1198#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001199
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001200 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001201 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001202
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001203#ifdef __CYGWIN__
1204 cygwin32_conv_to_win32_path(buf, tempbuf);
1205 h = FindFirstFile(tempbuf, &data);
1206#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001207 h = FindFirstFile(buf, &data);
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001208#endif
Guido van Rossum0980bd91998-02-13 17:18:36 +00001209 if (h == INVALID_HANDLE_VALUE) {
1210 PyErr_Format(PyExc_NameError,
1211 "Can't find file for module %.100s\n(filename %.300s)",
1212 name, buf);
1213 return 0;
1214 }
1215 FindClose(h);
Tim Peters50d8d372001-02-28 05:34:27 +00001216 return strncmp(data.cFileName, name, namelen) == 0;
1217
1218/* DJGPP */
1219#elif defined(DJGPP)
1220 struct ffblk ffblk;
1221 int done;
1222
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001223 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum323bf5e1998-06-24 03:54:06 +00001224 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001225
1226 done = findfirst(buf, &ffblk, FA_ARCH|FA_RDONLY|FA_HIDDEN|FA_DIREC);
1227 if (done) {
Guido van Rossum0980bd91998-02-13 17:18:36 +00001228 PyErr_Format(PyExc_NameError,
Tim Peters50d8d372001-02-28 05:34:27 +00001229 "Can't find file for module %.100s\n(filename %.300s)",
Guido van Rossum0980bd91998-02-13 17:18:36 +00001230 name, buf);
1231 return 0;
1232 }
Tim Peters50d8d372001-02-28 05:34:27 +00001233 return strncmp(ffblk.ff_name, name, namelen) == 0;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001234
Tim Peters50d8d372001-02-28 05:34:27 +00001235/* macintosh */
1236#elif defined(macintosh)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001237 FSSpec fss;
1238 OSErr err;
Tim Peters50d8d372001-02-28 05:34:27 +00001239
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001240 if (Py_GETENV("PYTHONCASEOK") != NULL)
Tim Peters50d8d372001-02-28 05:34:27 +00001241 return 1;
1242
Guido van Rossuma0f0a331998-09-14 13:40:53 +00001243 err = FSMakeFSSpec(0, 0, Pstring(buf), &fss);
Guido van Rossum0980bd91998-02-13 17:18:36 +00001244 if (err) {
1245 PyErr_Format(PyExc_NameError,
Guido van Rossuma0f0a331998-09-14 13:40:53 +00001246 "Can't find file for module %.100s\n(filename %.300s)",
1247 name, buf);
Guido van Rossum0980bd91998-02-13 17:18:36 +00001248 return 0;
1249 }
Tim Peters50d8d372001-02-28 05:34:27 +00001250 return fss.name[0] >= namelen &&
1251 strncmp(name, (char *)fss.name+1, namelen) == 0;
1252
Tim Peters677898a2001-03-02 03:28:03 +00001253/* new-fangled macintosh (macosx) */
Tim Petersd1e87a82001-03-01 18:12:00 +00001254#elif defined(__MACH__) && defined(__APPLE__) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001255 DIR *dirp;
1256 struct dirent *dp;
Tim Petersd1e87a82001-03-01 18:12:00 +00001257 char dirname[MAXPATHLEN + 1];
1258 const int dirlen = len - namelen - 1; /* don't want trailing SEP */
Tim Peters430f5d42001-03-01 01:30:56 +00001259
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001260 if (Py_GETENV("PYTHONCASEOK") != NULL)
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001261 return 1;
1262
Tim Petersd1e87a82001-03-01 18:12:00 +00001263 /* Copy the dir component into dirname; substitute "." if empty */
1264 if (dirlen <= 0) {
1265 dirname[0] = '.';
1266 dirname[1] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001267 }
1268 else {
Tim Petersd1e87a82001-03-01 18:12:00 +00001269 assert(dirlen <= MAXPATHLEN);
1270 memcpy(dirname, buf, dirlen);
1271 dirname[dirlen] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001272 }
1273 /* Open the directory and search the entries for an exact match. */
Tim Petersd1e87a82001-03-01 18:12:00 +00001274 dirp = opendir(dirname);
Tim Peters430f5d42001-03-01 01:30:56 +00001275 if (dirp) {
Tim Peters677898a2001-03-02 03:28:03 +00001276 char *nameWithExt = buf + len - namelen;
Tim Peters430f5d42001-03-01 01:30:56 +00001277 while ((dp = readdir(dirp)) != NULL) {
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001278 const int thislen =
Tim Peters430f5d42001-03-01 01:30:56 +00001279#ifdef _DIRENT_HAVE_D_NAMELEN
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001280 dp->d_namlen;
Tim Peters430f5d42001-03-01 01:30:56 +00001281#else
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001282 strlen(dp->d_name);
Tim Peters430f5d42001-03-01 01:30:56 +00001283#endif
Tim Petersd1e87a82001-03-01 18:12:00 +00001284 if (thislen >= namelen &&
Tim Peters677898a2001-03-02 03:28:03 +00001285 strcmp(dp->d_name, nameWithExt) == 0) {
Tim Peters430f5d42001-03-01 01:30:56 +00001286 (void)closedir(dirp);
1287 return 1; /* Found */
1288 }
1289 }
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001290 (void)closedir(dirp);
Tim Peters430f5d42001-03-01 01:30:56 +00001291 }
Tim Peters430f5d42001-03-01 01:30:56 +00001292 return 0 ; /* Not found */
Tim Peters430f5d42001-03-01 01:30:56 +00001293
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001294/* RISC OS */
1295#elif defined(RISCOS)
1296 char canon[MAXPATHLEN+1]; /* buffer for the canonical form of the path */
1297 char buf2[MAXPATHLEN+2];
1298 char *nameWithExt = buf+len-namelen;
1299 int canonlen;
1300 os_error *e;
1301
1302 if (Py_GETENV("PYTHONCASEOK") != NULL)
1303 return 1;
1304
1305 /* workaround:
1306 append wildcard, otherwise case of filename wouldn't be touched */
1307 strcpy(buf2, buf);
1308 strcat(buf2, "*");
1309
1310 e = xosfscontrol_canonicalise_path(buf2,canon,0,0,MAXPATHLEN+1,&canonlen);
1311 canonlen = MAXPATHLEN+1-canonlen;
1312 if (e || canonlen<=0 || canonlen>(MAXPATHLEN+1) )
1313 return 0;
1314 if (strcmp(nameWithExt, canon+canonlen-strlen(nameWithExt))==0)
1315 return 1; /* match */
1316
1317 return 0;
1318
Andrew MacIntyred9400542002-02-26 11:41:34 +00001319/* OS/2 */
1320#elif defined(PYOS_OS2)
1321 HDIR hdir = 1;
1322 ULONG srchcnt = 1;
1323 FILEFINDBUF3 ffbuf;
1324 APIRET rc;
1325
1326 if (getenv("PYTHONCASEOK") != NULL)
1327 return 1;
1328
1329 rc = DosFindFirst(buf,
1330 &hdir,
1331 FILE_READONLY | FILE_HIDDEN | FILE_SYSTEM | FILE_DIRECTORY,
1332 &ffbuf, sizeof(ffbuf),
1333 &srchcnt,
1334 FIL_STANDARD);
1335 if (rc != NO_ERROR)
1336 return 0;
1337 return strncmp(ffbuf.achName, name, namelen) == 0;
1338
Tim Peters50d8d372001-02-28 05:34:27 +00001339/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1340#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001341 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001342
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001343#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001344}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001345
Guido van Rossum0980bd91998-02-13 17:18:36 +00001346
Guido van Rossum197346f1997-10-31 18:38:52 +00001347#ifdef HAVE_STAT
1348/* Helper to look for __init__.py or __init__.py[co] in potential package */
1349static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001350find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001351{
Tim Peters0f9431f2001-07-05 03:47:53 +00001352 const size_t save_len = strlen(buf);
Fred Drake4c82b232000-06-30 16:18:57 +00001353 size_t i = save_len;
Tim Peters0f9431f2001-07-05 03:47:53 +00001354 char *pname; /* pointer to start of __init__ */
Guido van Rossum197346f1997-10-31 18:38:52 +00001355 struct stat statbuf;
1356
Tim Peters0f9431f2001-07-05 03:47:53 +00001357/* For calling case_ok(buf, len, namelen, name):
1358 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1359 * ^ ^ ^ ^
1360 * |--------------------- buf ---------------------|
1361 * |------------------- len ------------------|
1362 * |------ name -------|
1363 * |----- namelen -----|
1364 */
Guido van Rossum197346f1997-10-31 18:38:52 +00001365 if (save_len + 13 >= MAXPATHLEN)
1366 return 0;
1367 buf[i++] = SEP;
Tim Peters0f9431f2001-07-05 03:47:53 +00001368 pname = buf + i;
1369 strcpy(pname, "__init__.py");
Guido van Rossum197346f1997-10-31 18:38:52 +00001370 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001371 if (case_ok(buf,
1372 save_len + 9, /* len("/__init__") */
1373 8, /* len("__init__") */
1374 pname)) {
1375 buf[save_len] = '\0';
1376 return 1;
1377 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001378 }
Tim Peters0f9431f2001-07-05 03:47:53 +00001379 i += strlen(pname);
1380 strcpy(buf+i, Py_OptimizeFlag ? "o" : "c");
Guido van Rossum197346f1997-10-31 18:38:52 +00001381 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001382 if (case_ok(buf,
1383 save_len + 9, /* len("/__init__") */
1384 8, /* len("__init__") */
1385 pname)) {
1386 buf[save_len] = '\0';
1387 return 1;
1388 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001389 }
1390 buf[save_len] = '\0';
1391 return 0;
1392}
Guido van Rossum48a680c2001-03-02 06:34:14 +00001393
1394#else
1395
1396#ifdef RISCOS
1397static int
1398find_init_module(buf)
1399 char *buf;
1400{
1401 int save_len = strlen(buf);
1402 int i = save_len;
1403
1404 if (save_len + 13 >= MAXPATHLEN)
1405 return 0;
1406 buf[i++] = SEP;
1407 strcpy(buf+i, "__init__/py");
1408 if (isfile(buf)) {
1409 buf[save_len] = '\0';
1410 return 1;
1411 }
1412
1413 if (Py_OptimizeFlag)
1414 strcpy(buf+i, "o");
1415 else
1416 strcpy(buf+i, "c");
1417 if (isfile(buf)) {
1418 buf[save_len] = '\0';
1419 return 1;
1420 }
1421 buf[save_len] = '\0';
1422 return 0;
1423}
1424#endif /*RISCOS*/
1425
Guido van Rossum197346f1997-10-31 18:38:52 +00001426#endif /* HAVE_STAT */
1427
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001428
Tim Petersdbd9ba62000-07-09 03:09:57 +00001429static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001430
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001431/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001432 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001433
Guido van Rossum79f25d91997-04-29 20:08:16 +00001434static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001435load_module(char *name, FILE *fp, char *buf, int type)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001436{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001437 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001438 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001439 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001440
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001441 /* First check that there's an open file (if we need one) */
1442 switch (type) {
1443 case PY_SOURCE:
1444 case PY_COMPILED:
1445 if (fp == NULL) {
1446 PyErr_Format(PyExc_ValueError,
1447 "file object required for import (type code %d)",
1448 type);
1449 return NULL;
1450 }
1451 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001452
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001453 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001454
1455 case PY_SOURCE:
1456 m = load_source_module(name, buf, fp);
1457 break;
1458
1459 case PY_COMPILED:
1460 m = load_compiled_module(name, buf, fp);
1461 break;
1462
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001463#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001464 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001465 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001466 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001467#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001468
Jack Jansen9c96a921995-02-15 22:57:06 +00001469#ifdef macintosh
1470 case PY_RESOURCE:
1471 m = PyMac_LoadResourceModule(name, buf);
1472 break;
Guido van Rossum0f84a341998-08-06 13:36:01 +00001473 case PY_CODERESOURCE:
1474 m = PyMac_LoadCodeResourceModule(name, buf);
1475 break;
Jack Jansen9c96a921995-02-15 22:57:06 +00001476#endif
1477
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001478 case PKG_DIRECTORY:
1479 m = load_package(name, buf);
1480 break;
1481
1482 case C_BUILTIN:
1483 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001484 if (buf != NULL && buf[0] != '\0')
1485 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001486 if (type == C_BUILTIN)
1487 err = init_builtin(name);
1488 else
1489 err = PyImport_ImportFrozenModule(name);
1490 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001491 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001492 if (err == 0) {
1493 PyErr_Format(PyExc_ImportError,
1494 "Purported %s module %.200s not found",
1495 type == C_BUILTIN ?
1496 "builtin" : "frozen",
1497 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001498 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001499 }
1500 modules = PyImport_GetModuleDict();
1501 m = PyDict_GetItemString(modules, name);
1502 if (m == NULL) {
1503 PyErr_Format(
1504 PyExc_ImportError,
1505 "%s module %.200s not properly initialized",
1506 type == C_BUILTIN ?
1507 "builtin" : "frozen",
1508 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001509 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001510 }
1511 Py_INCREF(m);
1512 break;
1513
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001514 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001515 PyErr_Format(PyExc_ImportError,
1516 "Don't know how to import %.200s (type code %d)",
1517 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001518 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001519
1520 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001521
1522 return m;
1523}
1524
1525
1526/* Initialize a built-in module.
1527 Return 1 for succes, 0 if the module is not found, and -1 with
1528 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001529
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001530static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001531init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001532{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001533 struct _inittab *p;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001534
Greg Ward201baee2001-10-04 14:52:06 +00001535 if (_PyImport_FindExtension(name, name) != NULL)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001536 return 1;
1537
Guido van Rossum771c6c81997-10-31 18:37:24 +00001538 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001539 if (strcmp(name, p->name) == 0) {
1540 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001541 PyErr_Format(PyExc_ImportError,
1542 "Cannot re-init internal module %.200s",
1543 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001544 return -1;
1545 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001546 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001547 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001548 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001549 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001550 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001551 if (_PyImport_FixupExtension(name, name) == NULL)
1552 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001553 return 1;
1554 }
1555 }
1556 return 0;
1557}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001558
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001559
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001560/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001561
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001562static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001563find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001564{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001565 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001566
Guido van Rossum79f25d91997-04-29 20:08:16 +00001567 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001568 if (p->name == NULL)
1569 return NULL;
1570 if (strcmp(p->name, name) == 0)
1571 break;
1572 }
1573 return p;
1574}
1575
Guido van Rossum79f25d91997-04-29 20:08:16 +00001576static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001577get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001578{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001579 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001580 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001581
1582 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001583 PyErr_Format(PyExc_ImportError,
1584 "No such frozen object named %.200s",
1585 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001586 return NULL;
1587 }
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001588 if (p->code == NULL) {
1589 PyErr_Format(PyExc_ImportError,
1590 "Excluded frozen object named %.200s",
1591 name);
1592 return NULL;
1593 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001594 size = p->size;
1595 if (size < 0)
1596 size = -size;
1597 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001598}
1599
1600/* Initialize a frozen module.
1601 Return 1 for succes, 0 if the module is not found, and -1 with
1602 an exception set if the initialization failed.
1603 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001604
1605int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001606PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001607{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001608 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001609 PyObject *co;
1610 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001611 int ispackage;
1612 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001613
1614 if (p == NULL)
1615 return 0;
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001616 if (p->code == NULL) {
1617 PyErr_Format(PyExc_ImportError,
1618 "Excluded frozen object named %.200s",
1619 name);
1620 return -1;
1621 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001622 size = p->size;
1623 ispackage = (size < 0);
1624 if (ispackage)
1625 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001626 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001627 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001628 name, ispackage ? " package" : "");
1629 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001630 if (co == NULL)
1631 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001632 if (!PyCode_Check(co)) {
1633 Py_DECREF(co);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001634 PyErr_Format(PyExc_TypeError,
1635 "frozen object %.200s is not a code object",
1636 name);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001637 return -1;
1638 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001639 if (ispackage) {
1640 /* Set __path__ to the package name */
1641 PyObject *d, *s;
1642 int err;
1643 m = PyImport_AddModule(name);
1644 if (m == NULL)
1645 return -1;
1646 d = PyModule_GetDict(m);
1647 s = PyString_InternFromString(name);
1648 if (s == NULL)
1649 return -1;
1650 err = PyDict_SetItemString(d, "__path__", s);
1651 Py_DECREF(s);
1652 if (err != 0)
1653 return err;
1654 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001655 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum79f25d91997-04-29 20:08:16 +00001656 Py_DECREF(co);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001657 if (m == NULL)
1658 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001659 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001660 return 1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001661}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001662
1663
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001664/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001665 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001666
Guido van Rossum79f25d91997-04-29 20:08:16 +00001667PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001668PyImport_ImportModule(char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001669{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001670 PyObject *pname;
1671 PyObject *result;
1672
1673 pname = PyString_FromString(name);
1674 result = PyImport_Import(pname);
1675 Py_DECREF(pname);
1676 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001677}
1678
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001679/* Forward declarations for helper routines */
Tim Petersdbd9ba62000-07-09 03:09:57 +00001680static PyObject *get_parent(PyObject *globals, char *buf, int *p_buflen);
1681static PyObject *load_next(PyObject *mod, PyObject *altmod,
1682 char **p_name, char *buf, int *p_buflen);
1683static int mark_miss(char *name);
1684static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
1685 char *buf, int buflen, int recursive);
1686static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001687
1688/* The Magnum Opus of dotted-name import :-) */
1689
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001690static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001691import_module_ex(char *name, PyObject *globals, PyObject *locals,
1692 PyObject *fromlist)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001693{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001694 char buf[MAXPATHLEN+1];
1695 int buflen = 0;
1696 PyObject *parent, *head, *next, *tail;
1697
1698 parent = get_parent(globals, buf, &buflen);
1699 if (parent == NULL)
1700 return NULL;
1701
1702 head = load_next(parent, Py_None, &name, buf, &buflen);
1703 if (head == NULL)
1704 return NULL;
1705
1706 tail = head;
1707 Py_INCREF(tail);
1708 while (name) {
1709 next = load_next(tail, tail, &name, buf, &buflen);
1710 Py_DECREF(tail);
1711 if (next == NULL) {
1712 Py_DECREF(head);
1713 return NULL;
1714 }
1715 tail = next;
1716 }
1717
1718 if (fromlist != NULL) {
1719 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
1720 fromlist = NULL;
1721 }
1722
1723 if (fromlist == NULL) {
1724 Py_DECREF(tail);
1725 return head;
1726 }
1727
1728 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001729 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001730 Py_DECREF(tail);
1731 return NULL;
1732 }
1733
1734 return tail;
1735}
1736
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001737PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001738PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
1739 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001740{
1741 PyObject *result;
1742 lock_import();
Guido van Rossumd65911b1998-03-03 22:33:27 +00001743 result = import_module_ex(name, globals, locals, fromlist);
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001744 unlock_import();
1745 return result;
1746}
1747
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001748static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001749get_parent(PyObject *globals, char *buf, int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001750{
1751 static PyObject *namestr = NULL;
1752 static PyObject *pathstr = NULL;
1753 PyObject *modname, *modpath, *modules, *parent;
1754
1755 if (globals == NULL || !PyDict_Check(globals))
1756 return Py_None;
1757
1758 if (namestr == NULL) {
1759 namestr = PyString_InternFromString("__name__");
1760 if (namestr == NULL)
1761 return NULL;
1762 }
1763 if (pathstr == NULL) {
1764 pathstr = PyString_InternFromString("__path__");
1765 if (pathstr == NULL)
1766 return NULL;
1767 }
1768
1769 *buf = '\0';
1770 *p_buflen = 0;
1771 modname = PyDict_GetItem(globals, namestr);
1772 if (modname == NULL || !PyString_Check(modname))
1773 return Py_None;
1774
1775 modpath = PyDict_GetItem(globals, pathstr);
1776 if (modpath != NULL) {
1777 int len = PyString_GET_SIZE(modname);
1778 if (len > MAXPATHLEN) {
1779 PyErr_SetString(PyExc_ValueError,
1780 "Module name too long");
1781 return NULL;
1782 }
1783 strcpy(buf, PyString_AS_STRING(modname));
1784 *p_buflen = len;
1785 }
1786 else {
1787 char *start = PyString_AS_STRING(modname);
1788 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001789 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001790 if (lastdot == NULL)
1791 return Py_None;
1792 len = lastdot - start;
1793 if (len >= MAXPATHLEN) {
1794 PyErr_SetString(PyExc_ValueError,
1795 "Module name too long");
1796 return NULL;
1797 }
1798 strncpy(buf, start, len);
1799 buf[len] = '\0';
1800 *p_buflen = len;
1801 }
1802
1803 modules = PyImport_GetModuleDict();
1804 parent = PyDict_GetItemString(modules, buf);
1805 if (parent == NULL)
1806 parent = Py_None;
1807 return parent;
1808 /* We expect, but can't guarantee, if parent != None, that:
1809 - parent.__name__ == buf
1810 - parent.__dict__ is globals
1811 If this is violated... Who cares? */
1812}
1813
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001814/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001815static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001816load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
1817 int *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001818{
1819 char *name = *p_name;
1820 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00001821 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001822 char *p;
1823 PyObject *result;
1824
1825 if (dot == NULL) {
1826 *p_name = NULL;
1827 len = strlen(name);
1828 }
1829 else {
1830 *p_name = dot+1;
1831 len = dot-name;
1832 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00001833 if (len == 0) {
1834 PyErr_SetString(PyExc_ValueError,
1835 "Empty module name");
1836 return NULL;
1837 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001838
1839 p = buf + *p_buflen;
1840 if (p != buf)
1841 *p++ = '.';
1842 if (p+len-buf >= MAXPATHLEN) {
1843 PyErr_SetString(PyExc_ValueError,
1844 "Module name too long");
1845 return NULL;
1846 }
1847 strncpy(p, name, len);
1848 p[len] = '\0';
1849 *p_buflen = p+len-buf;
1850
1851 result = import_submodule(mod, p, buf);
1852 if (result == Py_None && altmod != mod) {
1853 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001854 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00001855 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001856 if (result != NULL && result != Py_None) {
1857 if (mark_miss(buf) != 0) {
1858 Py_DECREF(result);
1859 return NULL;
1860 }
1861 strncpy(buf, name, len);
1862 buf[len] = '\0';
1863 *p_buflen = len;
1864 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001865 }
1866 if (result == NULL)
1867 return NULL;
1868
1869 if (result == Py_None) {
1870 Py_DECREF(result);
1871 PyErr_Format(PyExc_ImportError,
1872 "No module named %.200s", name);
1873 return NULL;
1874 }
1875
1876 return result;
1877}
1878
1879static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001880mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00001881{
1882 PyObject *modules = PyImport_GetModuleDict();
1883 return PyDict_SetItemString(modules, name, Py_None);
1884}
1885
1886static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001887ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, int buflen,
1888 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001889{
1890 int i;
1891
1892 if (!PyObject_HasAttrString(mod, "__path__"))
1893 return 1;
1894
1895 for (i = 0; ; i++) {
1896 PyObject *item = PySequence_GetItem(fromlist, i);
1897 int hasit;
1898 if (item == NULL) {
1899 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
1900 PyErr_Clear();
1901 return 1;
1902 }
1903 return 0;
1904 }
1905 if (!PyString_Check(item)) {
1906 PyErr_SetString(PyExc_TypeError,
1907 "Item in ``from list'' not a string");
1908 Py_DECREF(item);
1909 return 0;
1910 }
1911 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00001912 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001913 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00001914 /* See if the package defines __all__ */
1915 if (recursive)
1916 continue; /* Avoid endless recursion */
1917 all = PyObject_GetAttrString(mod, "__all__");
1918 if (all == NULL)
1919 PyErr_Clear();
1920 else {
1921 if (!ensure_fromlist(mod, all, buf, buflen, 1))
1922 return 0;
1923 Py_DECREF(all);
1924 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001925 continue;
1926 }
1927 hasit = PyObject_HasAttr(mod, item);
1928 if (!hasit) {
1929 char *subname = PyString_AS_STRING(item);
1930 PyObject *submod;
1931 char *p;
1932 if (buflen + strlen(subname) >= MAXPATHLEN) {
1933 PyErr_SetString(PyExc_ValueError,
1934 "Module name too long");
1935 Py_DECREF(item);
1936 return 0;
1937 }
1938 p = buf + buflen;
1939 *p++ = '.';
1940 strcpy(p, subname);
1941 submod = import_submodule(mod, subname, buf);
1942 Py_XDECREF(submod);
1943 if (submod == NULL) {
1944 Py_DECREF(item);
1945 return 0;
1946 }
1947 }
1948 Py_DECREF(item);
1949 }
1950
Guido van Rossuma7f2e811997-10-03 15:33:32 +00001951 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001952}
1953
1954static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001955import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001956{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001957 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossumf48f11c2001-07-23 13:27:49 +00001958 PyObject *m, *res = NULL;
Guido van Rossum74e6a111994-08-29 12:54:38 +00001959
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001960 /* Require:
1961 if mod == None: subname == fullname
1962 else: mod.__name__ + "." + subname == fullname
1963 */
1964
Tim Peters50d8d372001-02-28 05:34:27 +00001965 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001966 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001967 }
1968 else {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001969 PyObject *path;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001970 char buf[MAXPATHLEN+1];
1971 struct filedescr *fdp;
1972 FILE *fp = NULL;
1973
Guido van Rossum9c0afe51998-05-19 15:09:05 +00001974 if (mod == Py_None)
1975 path = NULL;
1976 else {
1977 path = PyObject_GetAttrString(mod, "__path__");
1978 if (path == NULL) {
1979 PyErr_Clear();
1980 Py_INCREF(Py_None);
1981 return Py_None;
1982 }
1983 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001984
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001985 buf[0] = '\0';
Guido van Rossumb68cd421998-07-01 17:36:26 +00001986 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
1987 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001988 if (fdp == NULL) {
1989 if (!PyErr_ExceptionMatches(PyExc_ImportError))
1990 return NULL;
1991 PyErr_Clear();
1992 Py_INCREF(Py_None);
1993 return Py_None;
1994 }
1995 m = load_module(fullname, fp, buf, fdp->type);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001996 if (fp)
1997 fclose(fp);
Guido van Rossumf48f11c2001-07-23 13:27:49 +00001998 if (mod != Py_None) {
1999 /* Irrespective of the success of this load, make a
2000 reference to it in the parent package module.
2001 A copy gets saved in the modules dictionary
2002 under the full name, so get a reference from
2003 there, if need be. (The exception is when
2004 the load failed with a SyntaxError -- then
2005 there's no trace in sys.modules. In that case,
2006 of course, do nothing extra.) */
2007 res = m;
2008 if (res == NULL)
2009 res = PyDict_GetItemString(modules, fullname);
2010 if (res != NULL &&
2011 PyObject_SetAttrString(mod, subname, res) < 0) {
2012 Py_XDECREF(m);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002013 m = NULL;
2014 }
2015 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00002016 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002017
2018 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002019}
2020
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002021
2022/* Re-import a module of any kind and return its module object, WITH
2023 INCREMENTED REFERENCE COUNT */
2024
Guido van Rossum79f25d91997-04-29 20:08:16 +00002025PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002026PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002027{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002028 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum222ef561997-09-06 19:41:09 +00002029 PyObject *path = NULL;
2030 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002031 char buf[MAXPATHLEN+1];
2032 struct filedescr *fdp;
2033 FILE *fp = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002034
Guido van Rossum79f25d91997-04-29 20:08:16 +00002035 if (m == NULL || !PyModule_Check(m)) {
2036 PyErr_SetString(PyExc_TypeError,
2037 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002038 return NULL;
2039 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002040 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002041 if (name == NULL)
2042 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00002043 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002044 PyErr_Format(PyExc_ImportError,
2045 "reload(): module %.200s not in sys.modules",
2046 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002047 return NULL;
2048 }
Guido van Rossum222ef561997-09-06 19:41:09 +00002049 subname = strrchr(name, '.');
2050 if (subname == NULL)
2051 subname = name;
2052 else {
2053 PyObject *parentname, *parent;
2054 parentname = PyString_FromStringAndSize(name, (subname-name));
2055 if (parentname == NULL)
2056 return NULL;
2057 parent = PyDict_GetItem(modules, parentname);
Barry Warsaw38793331999-01-27 17:54:20 +00002058 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002059 if (parent == NULL) {
2060 PyErr_Format(PyExc_ImportError,
2061 "reload(): parent %.200s not in sys.modules",
2062 name);
2063 return NULL;
2064 }
2065 subname++;
2066 path = PyObject_GetAttrString(parent, "__path__");
2067 if (path == NULL)
2068 PyErr_Clear();
2069 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002070 buf[0] = '\0';
Guido van Rossum222ef561997-09-06 19:41:09 +00002071 fdp = find_module(subname, path, buf, MAXPATHLEN+1, &fp);
2072 Py_XDECREF(path);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002073 if (fdp == NULL)
2074 return NULL;
2075 m = load_module(name, fp, buf, fdp->type);
2076 if (fp)
2077 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002078 return m;
2079}
2080
2081
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002082/* Higher-level import emulator which emulates the "import" statement
2083 more accurately -- it invokes the __import__() function from the
2084 builtins of the current globals. This means that the import is
2085 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00002086 environment, e.g. by "rexec".
2087 A dummy list ["__doc__"] is passed as the 4th argument so that
2088 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
2089 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002090
2091PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002092PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002093{
2094 static PyObject *silly_list = NULL;
2095 static PyObject *builtins_str = NULL;
2096 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002097 PyObject *globals = NULL;
2098 PyObject *import = NULL;
2099 PyObject *builtins = NULL;
2100 PyObject *r = NULL;
2101
2102 /* Initialize constant string objects */
2103 if (silly_list == NULL) {
2104 import_str = PyString_InternFromString("__import__");
2105 if (import_str == NULL)
2106 return NULL;
2107 builtins_str = PyString_InternFromString("__builtins__");
2108 if (builtins_str == NULL)
2109 return NULL;
2110 silly_list = Py_BuildValue("[s]", "__doc__");
2111 if (silly_list == NULL)
2112 return NULL;
2113 }
2114
2115 /* Get the builtins from current globals */
2116 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002117 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00002118 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002119 builtins = PyObject_GetItem(globals, builtins_str);
2120 if (builtins == NULL)
2121 goto err;
2122 }
2123 else {
2124 /* No globals -- use standard builtins, and fake globals */
2125 PyErr_Clear();
2126
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002127 builtins = PyImport_ImportModuleEx("__builtin__",
2128 NULL, NULL, NULL);
2129 if (builtins == NULL)
2130 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002131 globals = Py_BuildValue("{OO}", builtins_str, builtins);
2132 if (globals == NULL)
2133 goto err;
2134 }
2135
2136 /* Get the __import__ function from the builtins */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002137 if (PyDict_Check(builtins)) {
Fred Drakea76ba6e2001-03-06 06:31:15 +00002138 import = PyObject_GetItem(builtins, import_str);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002139 if (import == NULL)
2140 PyErr_SetObject(PyExc_KeyError, import_str);
2141 }
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002142 else
Fred Drakea76ba6e2001-03-06 06:31:15 +00002143 import = PyObject_GetAttr(builtins, import_str);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002144 if (import == NULL)
2145 goto err;
2146
2147 /* Call the _import__ function with the proper argument list */
2148 r = PyObject_CallFunction(import, "OOOO",
2149 module_name, globals, globals, silly_list);
2150
2151 err:
2152 Py_XDECREF(globals);
2153 Py_XDECREF(builtins);
2154 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00002155
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002156 return r;
2157}
2158
2159
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002160/* Module 'imp' provides Python access to the primitives used for
2161 importing modules.
2162*/
2163
Guido van Rossum79f25d91997-04-29 20:08:16 +00002164static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002165imp_get_magic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002166{
2167 char buf[4];
2168
Guido van Rossum43713e52000-02-29 13:59:29 +00002169 if (!PyArg_ParseTuple(args, ":get_magic"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002170 return NULL;
Guido van Rossum96774c12000-05-01 20:19:08 +00002171 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
2172 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
2173 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
2174 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002175
Guido van Rossum79f25d91997-04-29 20:08:16 +00002176 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002177}
2178
Guido van Rossum79f25d91997-04-29 20:08:16 +00002179static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002180imp_get_suffixes(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002181{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002182 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002183 struct filedescr *fdp;
2184
Guido van Rossum43713e52000-02-29 13:59:29 +00002185 if (!PyArg_ParseTuple(args, ":get_suffixes"))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002186 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002187 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002188 if (list == NULL)
2189 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002190 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
2191 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002192 fdp->suffix, fdp->mode, fdp->type);
2193 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002194 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002195 return NULL;
2196 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002197 if (PyList_Append(list, item) < 0) {
2198 Py_DECREF(list);
2199 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002200 return NULL;
2201 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002202 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002203 }
2204 return list;
2205}
2206
Guido van Rossum79f25d91997-04-29 20:08:16 +00002207static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002208call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002209{
Tim Petersdbd9ba62000-07-09 03:09:57 +00002210 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002211 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002212 struct filedescr *fdp;
2213 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002214 FILE *fp = NULL;
2215
2216 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002217 if (path == Py_None)
2218 path = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002219 fdp = find_module(name, path, pathname, MAXPATHLEN+1, &fp);
2220 if (fdp == NULL)
2221 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002222 if (fp != NULL) {
2223 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
2224 if (fob == NULL) {
2225 fclose(fp);
2226 return NULL;
2227 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002228 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002229 else {
2230 fob = Py_None;
2231 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00002232 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002233 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002234 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002235 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002236 return ret;
2237}
2238
Guido van Rossum79f25d91997-04-29 20:08:16 +00002239static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002240imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002241{
2242 char *name;
2243 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002244 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002245 return NULL;
2246 return call_find_module(name, path);
2247}
2248
2249static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002250imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002251{
2252 char *name;
2253 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002254 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002255 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002256 return NULL;
2257 ret = init_builtin(name);
2258 if (ret < 0)
2259 return NULL;
2260 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002261 Py_INCREF(Py_None);
2262 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002263 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002264 m = PyImport_AddModule(name);
2265 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002266 return m;
2267}
2268
Guido van Rossum79f25d91997-04-29 20:08:16 +00002269static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002270imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002271{
2272 char *name;
2273 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002274 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002275 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002276 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002277 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002278 if (ret < 0)
2279 return NULL;
2280 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002281 Py_INCREF(Py_None);
2282 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002283 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002284 m = PyImport_AddModule(name);
2285 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002286 return m;
2287}
2288
Guido van Rossum79f25d91997-04-29 20:08:16 +00002289static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002290imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002291{
2292 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002293
Guido van Rossum43713e52000-02-29 13:59:29 +00002294 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002295 return NULL;
2296 return get_frozen_object(name);
2297}
2298
Guido van Rossum79f25d91997-04-29 20:08:16 +00002299static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002300imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002301{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002302 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002303 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002304 return NULL;
Guido van Rossum50ee94f2002-04-09 18:00:58 +00002305 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002306}
2307
Guido van Rossum79f25d91997-04-29 20:08:16 +00002308static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002309imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002310{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002311 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002312 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002313 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002314 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002315 p = find_frozen(name);
Guido van Rossumb8bff3f2002-04-07 06:34:38 +00002316 return PyBool_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002317}
2318
2319static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002320get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002321{
2322 FILE *fp;
2323 if (fob == NULL) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002324 if (mode[0] == 'U')
2325 mode = "r" PY_STDIOTEXTMODE;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002326 fp = fopen(pathname, mode);
2327 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002328 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002329 }
2330 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002331 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002332 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002333 PyErr_SetString(PyExc_ValueError,
2334 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002335 }
2336 return fp;
2337}
2338
Guido van Rossum79f25d91997-04-29 20:08:16 +00002339static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002340imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002341{
2342 char *name;
2343 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002344 PyObject *fob = NULL;
2345 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002346 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002347 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002348 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002349 return NULL;
2350 fp = get_file(pathname, fob, "rb");
2351 if (fp == NULL)
2352 return NULL;
2353 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002354 if (fob == NULL)
2355 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002356 return m;
2357}
2358
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002359#ifdef HAVE_DYNAMIC_LOADING
2360
Guido van Rossum79f25d91997-04-29 20:08:16 +00002361static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002362imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002363{
2364 char *name;
2365 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002366 PyObject *fob = NULL;
2367 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002368 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002369 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002370 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002371 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002372 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002373 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002374 if (fp == NULL)
2375 return NULL;
2376 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002377 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002378 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002379}
2380
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002381#endif /* HAVE_DYNAMIC_LOADING */
2382
Guido van Rossum79f25d91997-04-29 20:08:16 +00002383static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002384imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002385{
2386 char *name;
2387 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002388 PyObject *fob = NULL;
2389 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002390 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002391 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002392 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002393 return NULL;
2394 fp = get_file(pathname, fob, "r");
2395 if (fp == NULL)
2396 return NULL;
2397 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002398 if (fob == NULL)
2399 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002400 return m;
2401}
2402
Jack Jansen9c96a921995-02-15 22:57:06 +00002403#ifdef macintosh
Guido van Rossum79f25d91997-04-29 20:08:16 +00002404static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002405imp_load_resource(PyObject *self, PyObject *args)
Jack Jansen9c96a921995-02-15 22:57:06 +00002406{
2407 char *name;
2408 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002409 PyObject *m;
Jack Jansen9c96a921995-02-15 22:57:06 +00002410
Guido van Rossum43713e52000-02-29 13:59:29 +00002411 if (!PyArg_ParseTuple(args, "ss:load_resource", &name, &pathname))
Jack Jansen9c96a921995-02-15 22:57:06 +00002412 return NULL;
2413 m = PyMac_LoadResourceModule(name, pathname);
2414 return m;
2415}
2416#endif /* macintosh */
2417
Guido van Rossum79f25d91997-04-29 20:08:16 +00002418static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002419imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002420{
2421 char *name;
2422 PyObject *fob;
2423 char *pathname;
2424 char *suffix; /* Unused */
2425 char *mode;
2426 int type;
2427 FILE *fp;
2428
Guido van Rossum43713e52000-02-29 13:59:29 +00002429 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002430 &name, &fob, &pathname,
2431 &suffix, &mode, &type))
2432 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002433 if (*mode) {
2434 /* Mode must start with 'r' or 'U' and must not contain '+'.
2435 Implicit in this test is the assumption that the mode
2436 may contain other modifiers like 'b' or 't'. */
2437
2438 if (!(*mode == 'r' || *mode == 'U') || strchr(mode, '+')) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002439 PyErr_Format(PyExc_ValueError,
2440 "invalid file open mode %.200s", mode);
2441 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002442 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002443 }
2444 if (fob == Py_None)
2445 fp = NULL;
2446 else {
2447 if (!PyFile_Check(fob)) {
2448 PyErr_SetString(PyExc_ValueError,
2449 "load_module arg#2 should be a file or None");
2450 return NULL;
2451 }
2452 fp = get_file(pathname, fob, mode);
2453 if (fp == NULL)
2454 return NULL;
2455 }
2456 return load_module(name, fp, pathname, type);
2457}
2458
2459static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002460imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002461{
2462 char *name;
2463 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002464 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002465 return NULL;
2466 return load_package(name, pathname);
2467}
2468
2469static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002470imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002471{
2472 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002473 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002474 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002475 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002476}
2477
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002478/* Doc strings */
2479
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002480PyDoc_STRVAR(doc_imp,
2481"This module provides the components needed to build your own\n\
2482__import__ function. Undocumented functions are obsolete.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002483
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002484PyDoc_STRVAR(doc_find_module,
2485"find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002486Search for a module. If path is omitted or None, search for a\n\
2487built-in, frozen or special module and continue search in sys.path.\n\
2488The module name cannot contain '.'; to search for a submodule of a\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002489package, pass the submodule name and the package's __path__.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002490
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002491PyDoc_STRVAR(doc_load_module,
2492"load_module(name, file, filename, (suffix, mode, type)) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002493Load a module, given information returned by find_module().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002494The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002495
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002496PyDoc_STRVAR(doc_get_magic,
2497"get_magic() -> string\n\
2498Return the magic number for .pyc or .pyo files.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002499
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002500PyDoc_STRVAR(doc_get_suffixes,
2501"get_suffixes() -> [(suffix, mode, type), ...]\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002502Return a list of (suffix, mode, type) tuples describing the files\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002503that find_module() looks for.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002504
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002505PyDoc_STRVAR(doc_new_module,
2506"new_module(name) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002507Create a new module. Do not enter it in sys.modules.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002508The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002509
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002510PyDoc_STRVAR(doc_lock_held,
2511"lock_held() -> 0 or 1\n\
Tim Peters69232342001-08-30 05:16:13 +00002512Return 1 if the import lock is currently held.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002513On platforms without threads, return 0.");
Tim Peters69232342001-08-30 05:16:13 +00002514
Guido van Rossum79f25d91997-04-29 20:08:16 +00002515static PyMethodDef imp_methods[] = {
Neal Norwitz031829d2002-03-31 14:37:44 +00002516 {"find_module", imp_find_module, METH_VARARGS, doc_find_module},
2517 {"get_magic", imp_get_magic, METH_VARARGS, doc_get_magic},
2518 {"get_suffixes", imp_get_suffixes, METH_VARARGS, doc_get_suffixes},
2519 {"load_module", imp_load_module, METH_VARARGS, doc_load_module},
2520 {"new_module", imp_new_module, METH_VARARGS, doc_new_module},
2521 {"lock_held", imp_lock_held, METH_VARARGS, doc_lock_held},
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002522 /* The rest are obsolete */
Neal Norwitz031829d2002-03-31 14:37:44 +00002523 {"get_frozen_object", imp_get_frozen_object, METH_VARARGS},
2524 {"init_builtin", imp_init_builtin, METH_VARARGS},
2525 {"init_frozen", imp_init_frozen, METH_VARARGS},
2526 {"is_builtin", imp_is_builtin, METH_VARARGS},
2527 {"is_frozen", imp_is_frozen, METH_VARARGS},
2528 {"load_compiled", imp_load_compiled, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002529#ifdef HAVE_DYNAMIC_LOADING
Neal Norwitz031829d2002-03-31 14:37:44 +00002530 {"load_dynamic", imp_load_dynamic, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002531#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002532 {"load_package", imp_load_package, METH_VARARGS},
Jack Jansen9c96a921995-02-15 22:57:06 +00002533#ifdef macintosh
Neal Norwitz031829d2002-03-31 14:37:44 +00002534 {"load_resource", imp_load_resource, METH_VARARGS},
Jack Jansen9c96a921995-02-15 22:57:06 +00002535#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002536 {"load_source", imp_load_source, METH_VARARGS},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002537 {NULL, NULL} /* sentinel */
2538};
2539
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002540static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002541setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002542{
2543 PyObject *v;
2544 int err;
2545
2546 v = PyInt_FromLong((long)value);
2547 err = PyDict_SetItemString(d, name, v);
2548 Py_XDECREF(v);
2549 return err;
2550}
2551
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002552void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002553initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002554{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002555 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002556
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002557 m = Py_InitModule4("imp", imp_methods, doc_imp,
2558 NULL, PYTHON_API_VERSION);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002559 d = PyModule_GetDict(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002560
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002561 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
2562 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
2563 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
2564 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
2565 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
2566 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
2567 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
2568 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00002569 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002570
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002571 failure:
2572 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002573}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002574
2575
Guido van Rossumb18618d2000-05-03 23:44:39 +00002576/* API for embedding applications that want to add their own entries
2577 to the table of built-in modules. This should normally be called
2578 *before* Py_Initialize(). When the table resize fails, -1 is
2579 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002580
2581 After a similar function by Just van Rossum. */
2582
2583int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002584PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002585{
2586 static struct _inittab *our_copy = NULL;
2587 struct _inittab *p;
2588 int i, n;
2589
2590 /* Count the number of entries in both tables */
2591 for (n = 0; newtab[n].name != NULL; n++)
2592 ;
2593 if (n == 0)
2594 return 0; /* Nothing to do */
2595 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
2596 ;
2597
2598 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00002599 p = our_copy;
2600 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002601 if (p == NULL)
2602 return -1;
2603
2604 /* Copy the tables into the new memory */
2605 if (our_copy != PyImport_Inittab)
2606 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
2607 PyImport_Inittab = our_copy = p;
2608 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
2609
2610 return 0;
2611}
2612
2613/* Shorthand to add a single entry given a name and a function */
2614
2615int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002616PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00002617{
2618 struct _inittab newtab[2];
2619
2620 memset(newtab, '\0', sizeof newtab);
2621
2622 newtab[0].name = name;
2623 newtab[0].initfunc = initfunc;
2624
2625 return PyImport_ExtendInittab(newtab);
2626}