blob: a90729ae25920d600cd0f867f6425e4a4dd92268 [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
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00006#include "Python-ast.h"
Neal Norwitzadb69fc2005-12-17 20:54:49 +00007#include "pyarena.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00008#include "pythonrun.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00009#include "errcode.h"
Guido van Rossumc405b7b1991-06-04 19:39:42 +000010#include "marshal.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +000011#include "code.h"
Guido van Rossumc405b7b1991-06-04 19:39:42 +000012#include "compile.h"
Guido van Rossumff4949e1992-08-05 19:58:53 +000013#include "eval.h"
Guido van Rossumd8bac6d1992-02-26 15:19:13 +000014#include "osdefs.h"
Guido van Rossum1ae940a1995-01-02 19:04:15 +000015#include "importdl.h"
Guido van Rossumc405b7b1991-06-04 19:39:42 +000016
Guido van Rossum55a83382000-09-20 20:31:38 +000017#ifdef HAVE_FCNTL_H
18#include <fcntl.h>
19#endif
Anthony Baxterac6bd462006-04-13 02:06:09 +000020#ifdef __cplusplus
21extern "C" {
22#endif
Guido van Rossum55a83382000-09-20 20:31:38 +000023
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000024extern time_t PyOS_GetLastModificationTime(char *, FILE *);
25 /* In getmtime.c */
Guido van Rossum21d335e1993-10-15 13:01:11 +000026
Jeremy Hyltond4ceb312004-04-01 02:45:22 +000027/* Magic word to reject .pyc files generated by other Python versions.
28 It should change for each incompatible change to the bytecode.
29
30 The value of CR and LF is incorporated so if you ever read or write
Guido van Rossum7faeab31995-07-07 22:50:36 +000031 a .pyc file in text mode the magic number will be wrong; also, the
Tim Peters36515e22001-11-18 04:06:29 +000032 Apple MPW compiler swaps their values, botching string constants.
Marc-André Lemburgbd3be8f2002-02-07 11:33:49 +000033
Martin v. Löwisef82d2f2004-06-27 16:51:46 +000034 The magic numbers must be spaced apart atleast 2 values, as the
35 -U interpeter flag will cause MAGIC+1 being used. They have been
36 odd numbers for some time now.
Marc-André Lemburgbd3be8f2002-02-07 11:33:49 +000037
Jeremy Hyltond4ceb312004-04-01 02:45:22 +000038 There were a variety of old schemes for setting the magic number.
39 The current working scheme is to increment the previous value by
40 10.
Guido van Rossumf6894922002-08-31 15:16:14 +000041
Marc-André Lemburgbd3be8f2002-02-07 11:33:49 +000042 Known values:
43 Python 1.5: 20121
44 Python 1.5.1: 20121
45 Python 1.5.2: 20121
Skip Montanaro4ec3c262006-03-25 14:12:03 +000046 Python 1.6: 50428
Marc-André Lemburgbd3be8f2002-02-07 11:33:49 +000047 Python 2.0: 50823
48 Python 2.0.1: 50823
49 Python 2.1: 60202
50 Python 2.1.1: 60202
51 Python 2.1.2: 60202
52 Python 2.2: 60717
Neal Norwitz7fdcb412002-06-14 01:07:39 +000053 Python 2.3a0: 62011
Michael W. Hudsondd32a912002-08-15 14:59:02 +000054 Python 2.3a0: 62021
Guido van Rossumf6894922002-08-31 15:16:14 +000055 Python 2.3a0: 62011 (!)
Martin v. Löwisef82d2f2004-06-27 16:51:46 +000056 Python 2.4a0: 62041
Raymond Hettingerfd2d1f72004-08-23 23:37:48 +000057 Python 2.4a3: 62051
Raymond Hettinger2c31a052004-09-22 18:44:21 +000058 Python 2.4b1: 62061
Michael W. Hudsondf888462005-06-03 14:41:55 +000059 Python 2.5a0: 62071
Michael W. Hudsonaee2e282005-10-21 11:32:20 +000060 Python 2.5a0: 62081 (ast-branch)
Guido van Rossumc2e20742006-02-27 22:32:47 +000061 Python 2.5a0: 62091 (with)
Guido van Rossumf6694362006-03-10 02:28:35 +000062 Python 2.5a0: 62092 (changed WITH_CLEANUP opcode)
Neal Norwitz0d62a062006-07-30 06:53:31 +000063 Python 2.5b3: 62101 (fix wrong code: for x, in ...)
64 Python 2.5b3: 62111 (fix wrong code: x += yield)
Neal Norwitz9a70f952006-08-04 05:12:19 +000065 Python 2.5c1: 62121 (fix wrong lnotab with for loops and
66 storing constants that should have been removed)
Neal Norwitzdac090d2006-09-05 03:53:08 +000067 Python 2.5c2: 62131 (fix wrong code: for x, in ... in listcomp/genexp)
Michael W. Hudsonaee2e282005-10-21 11:32:20 +000068.
Tim Peters36515e22001-11-18 04:06:29 +000069*/
Neal Norwitzdac090d2006-09-05 03:53:08 +000070#define MAGIC (62131 | ((long)'\r'<<16) | ((long)'\n'<<24))
Guido van Rossum3ddee711991-12-16 13:06:34 +000071
Guido van Rossum96774c12000-05-01 20:19:08 +000072/* Magic word as global; note that _PyImport_Init() can change the
Jeremy Hylton9262b8a2000-06-30 04:59:17 +000073 value of this global to accommodate for alterations of how the
Guido van Rossum96774c12000-05-01 20:19:08 +000074 compiler works which are enabled by command line switches. */
75static long pyc_magic = MAGIC;
76
Guido van Rossum25ce5661997-08-02 03:10:38 +000077/* See _PyImport_FixupExtension() below */
78static PyObject *extensions = NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +000079
Guido van Rossum771c6c81997-10-31 18:37:24 +000080/* This table is defined in config.c: */
81extern struct _inittab _PyImport_Inittab[];
82
83struct _inittab *PyImport_Inittab = _PyImport_Inittab;
Guido van Rossum66f1fa81991-04-03 19:03:52 +000084
Guido van Rossumed1170e1999-12-20 21:23:41 +000085/* these tables define the module suffixes that Python recognizes */
86struct filedescr * _PyImport_Filetab = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +000087
88#ifdef RISCOS
89static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000090 {"/py", "U", PY_SOURCE},
Guido van Rossum48a680c2001-03-02 06:34:14 +000091 {"/pyc", "rb", PY_COMPILED},
92 {0, 0}
93};
94#else
Guido van Rossumed1170e1999-12-20 21:23:41 +000095static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000096 {".py", "U", PY_SOURCE},
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000097#ifdef MS_WINDOWS
Jack Jansenc88da1f2002-05-28 10:58:19 +000098 {".pyw", "U", PY_SOURCE},
Tim Peters36515e22001-11-18 04:06:29 +000099#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000100 {".pyc", "rb", PY_COMPILED},
101 {0, 0}
102};
Guido van Rossum48a680c2001-03-02 06:34:14 +0000103#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000104
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000105static PyTypeObject NullImporterType; /* Forward reference */
106
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000107/* Initialize things */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000108
109void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000110_PyImport_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000111{
Guido van Rossumed1170e1999-12-20 21:23:41 +0000112 const struct filedescr *scan;
113 struct filedescr *filetab;
114 int countD = 0;
115 int countS = 0;
116
117 /* prepare _PyImport_Filetab: copy entries from
118 _PyImport_DynLoadFiletab and _PyImport_StandardFiletab.
119 */
120 for (scan = _PyImport_DynLoadFiletab; scan->suffix != NULL; ++scan)
121 ++countD;
122 for (scan = _PyImport_StandardFiletab; scan->suffix != NULL; ++scan)
123 ++countS;
Guido van Rossumb18618d2000-05-03 23:44:39 +0000124 filetab = PyMem_NEW(struct filedescr, countD + countS + 1);
Neal Norwitze1fdb322006-07-21 05:32:28 +0000125 if (filetab == NULL)
Neal Norwitz33722ae2006-07-21 07:59:02 +0000126 Py_FatalError("Can't initialize import file table.");
Guido van Rossumed1170e1999-12-20 21:23:41 +0000127 memcpy(filetab, _PyImport_DynLoadFiletab,
128 countD * sizeof(struct filedescr));
129 memcpy(filetab + countD, _PyImport_StandardFiletab,
130 countS * sizeof(struct filedescr));
131 filetab[countD + countS].suffix = NULL;
132
133 _PyImport_Filetab = filetab;
134
Guido van Rossum0824f631997-03-11 18:37:35 +0000135 if (Py_OptimizeFlag) {
Guido van Rossumed1170e1999-12-20 21:23:41 +0000136 /* Replace ".pyc" with ".pyo" in _PyImport_Filetab */
137 for (; filetab->suffix != NULL; filetab++) {
Guido van Rossum48a680c2001-03-02 06:34:14 +0000138#ifndef RISCOS
Guido van Rossumed1170e1999-12-20 21:23:41 +0000139 if (strcmp(filetab->suffix, ".pyc") == 0)
140 filetab->suffix = ".pyo";
Guido van Rossum48a680c2001-03-02 06:34:14 +0000141#else
142 if (strcmp(filetab->suffix, "/pyc") == 0)
143 filetab->suffix = "/pyo";
144#endif
Guido van Rossum0824f631997-03-11 18:37:35 +0000145 }
146 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000147
148 if (Py_UnicodeFlag) {
149 /* Fix the pyc_magic so that byte compiled code created
150 using the all-Unicode method doesn't interfere with
151 code created in normal operation mode. */
152 pyc_magic = MAGIC + 1;
153 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000154}
155
Guido van Rossum25ce5661997-08-02 03:10:38 +0000156void
Just van Rossum52e14d62002-12-30 22:08:05 +0000157_PyImportHooks_Init(void)
158{
159 PyObject *v, *path_hooks = NULL, *zimpimport;
160 int err = 0;
161
162 /* adding sys.path_hooks and sys.path_importer_cache, setting up
163 zipimport */
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000164 if (PyType_Ready(&NullImporterType) < 0)
165 goto error;
Just van Rossum52e14d62002-12-30 22:08:05 +0000166
167 if (Py_VerboseFlag)
168 PySys_WriteStderr("# installing zipimport hook\n");
169
170 v = PyList_New(0);
171 if (v == NULL)
172 goto error;
173 err = PySys_SetObject("meta_path", v);
174 Py_DECREF(v);
175 if (err)
176 goto error;
177 v = PyDict_New();
178 if (v == NULL)
179 goto error;
180 err = PySys_SetObject("path_importer_cache", v);
181 Py_DECREF(v);
182 if (err)
183 goto error;
184 path_hooks = PyList_New(0);
185 if (path_hooks == NULL)
186 goto error;
187 err = PySys_SetObject("path_hooks", path_hooks);
188 if (err) {
189 error:
190 PyErr_Print();
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000191 Py_FatalError("initializing sys.meta_path, sys.path_hooks, "
192 "path_importer_cache, or NullImporter failed"
193 );
Just van Rossum52e14d62002-12-30 22:08:05 +0000194 }
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000195
Just van Rossum52e14d62002-12-30 22:08:05 +0000196 zimpimport = PyImport_ImportModule("zipimport");
197 if (zimpimport == NULL) {
198 PyErr_Clear(); /* No zip import module -- okay */
199 if (Py_VerboseFlag)
200 PySys_WriteStderr("# can't import zipimport\n");
201 }
202 else {
203 PyObject *zipimporter = PyObject_GetAttrString(zimpimport,
204 "zipimporter");
205 Py_DECREF(zimpimport);
206 if (zipimporter == NULL) {
207 PyErr_Clear(); /* No zipimporter object -- okay */
208 if (Py_VerboseFlag)
209 PySys_WriteStderr(
Fred Drake1e5fc552003-07-11 15:01:02 +0000210 "# can't import zipimport.zipimporter\n");
Just van Rossum52e14d62002-12-30 22:08:05 +0000211 }
212 else {
213 /* sys.path_hooks.append(zipimporter) */
214 err = PyList_Append(path_hooks, zipimporter);
215 Py_DECREF(zipimporter);
216 if (err)
217 goto error;
218 if (Py_VerboseFlag)
219 PySys_WriteStderr(
220 "# installed zipimport hook\n");
221 }
222 }
223 Py_DECREF(path_hooks);
224}
225
226void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000227_PyImport_Fini(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000228{
229 Py_XDECREF(extensions);
230 extensions = NULL;
Barry Warsaw84294482000-10-03 16:02:05 +0000231 PyMem_DEL(_PyImport_Filetab);
232 _PyImport_Filetab = NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000233}
234
235
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000236/* Locking primitives to prevent parallel imports of the same module
237 in different threads to return with a partially loaded module.
238 These calls are serialized by the global interpreter lock. */
239
240#ifdef WITH_THREAD
241
Guido van Rossum49b56061998-10-01 20:42:43 +0000242#include "pythread.h"
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000243
Guido van Rossum65d5b571998-12-21 19:32:43 +0000244static PyThread_type_lock import_lock = 0;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000245static long import_lock_thread = -1;
246static int import_lock_level = 0;
247
248static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000249lock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000250{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000251 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000252 if (me == -1)
253 return; /* Too bad */
Neal Norwitze1fdb322006-07-21 05:32:28 +0000254 if (import_lock == NULL) {
Guido van Rossum65d5b571998-12-21 19:32:43 +0000255 import_lock = PyThread_allocate_lock();
Neal Norwitze1fdb322006-07-21 05:32:28 +0000256 if (import_lock == NULL)
257 return; /* Nothing much we can do. */
258 }
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000259 if (import_lock_thread == me) {
260 import_lock_level++;
261 return;
262 }
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000263 if (import_lock_thread != -1 || !PyThread_acquire_lock(import_lock, 0))
264 {
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000265 PyThreadState *tstate = PyEval_SaveThread();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000266 PyThread_acquire_lock(import_lock, 1);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000267 PyEval_RestoreThread(tstate);
268 }
269 import_lock_thread = me;
270 import_lock_level = 1;
271}
272
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000273static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000274unlock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000275{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000276 long me = PyThread_get_thread_ident();
Neal Norwitze1fdb322006-07-21 05:32:28 +0000277 if (me == -1 || import_lock == NULL)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000278 return 0; /* Too bad */
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000279 if (import_lock_thread != me)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000280 return -1;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000281 import_lock_level--;
282 if (import_lock_level == 0) {
283 import_lock_thread = -1;
Guido van Rossum65d5b571998-12-21 19:32:43 +0000284 PyThread_release_lock(import_lock);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000285 }
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000286 return 1;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000287}
288
Guido van Rossum8ee3e5a2005-09-14 18:09:42 +0000289/* This function is called from PyOS_AfterFork to ensure that newly
290 created child processes do not share locks with the parent. */
291
292void
293_PyImport_ReInitLock(void)
294{
295#ifdef _AIX
296 if (import_lock != NULL)
297 import_lock = PyThread_allocate_lock();
298#endif
299}
300
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000301#else
302
303#define lock_import()
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000304#define unlock_import() 0
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000305
306#endif
307
Tim Peters69232342001-08-30 05:16:13 +0000308static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000309imp_lock_held(PyObject *self, PyObject *noargs)
Tim Peters69232342001-08-30 05:16:13 +0000310{
Tim Peters69232342001-08-30 05:16:13 +0000311#ifdef WITH_THREAD
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000312 return PyBool_FromLong(import_lock_thread != -1);
Tim Peters69232342001-08-30 05:16:13 +0000313#else
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000314 return PyBool_FromLong(0);
Tim Peters69232342001-08-30 05:16:13 +0000315#endif
316}
317
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000318static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000319imp_acquire_lock(PyObject *self, PyObject *noargs)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000320{
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000321#ifdef WITH_THREAD
322 lock_import();
323#endif
Neal Norwitz2294c0d2003-02-12 23:02:21 +0000324 Py_INCREF(Py_None);
325 return Py_None;
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000326}
327
328static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000329imp_release_lock(PyObject *self, PyObject *noargs)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000330{
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000331#ifdef WITH_THREAD
332 if (unlock_import() < 0) {
333 PyErr_SetString(PyExc_RuntimeError,
334 "not holding the import lock");
335 return NULL;
336 }
337#endif
Neal Norwitz2294c0d2003-02-12 23:02:21 +0000338 Py_INCREF(Py_None);
339 return Py_None;
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000340}
341
Guido van Rossum25ce5661997-08-02 03:10:38 +0000342/* Helper for sys */
343
344PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000345PyImport_GetModuleDict(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000346{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000347 PyInterpreterState *interp = PyThreadState_GET()->interp;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000348 if (interp->modules == NULL)
349 Py_FatalError("PyImport_GetModuleDict: no module dictionary!");
350 return interp->modules;
351}
352
Guido van Rossum3f5da241990-12-20 15:06:42 +0000353
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000354/* List of names to clear in sys */
355static char* sys_deletes[] = {
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000356 "path", "argv", "ps1", "ps2", "exitfunc",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000357 "exc_type", "exc_value", "exc_traceback",
358 "last_type", "last_value", "last_traceback",
Just van Rossum52e14d62002-12-30 22:08:05 +0000359 "path_hooks", "path_importer_cache", "meta_path",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000360 NULL
361};
362
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000363static char* sys_files[] = {
364 "stdin", "__stdin__",
365 "stdout", "__stdout__",
366 "stderr", "__stderr__",
367 NULL
368};
369
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000370
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000371/* Un-initialize things, as good as we can */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000372
Guido van Rossum3f5da241990-12-20 15:06:42 +0000373void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000374PyImport_Cleanup(void)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000375{
Martin v. Löwis18e16552006-02-15 17:27:45 +0000376 Py_ssize_t pos, ndone;
Guido van Rossum758eec01998-01-19 21:58:26 +0000377 char *name;
378 PyObject *key, *value, *dict;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000379 PyInterpreterState *interp = PyThreadState_GET()->interp;
Guido van Rossum758eec01998-01-19 21:58:26 +0000380 PyObject *modules = interp->modules;
381
382 if (modules == NULL)
383 return; /* Already done */
384
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000385 /* Delete some special variables first. These are common
386 places where user values hide and people complain when their
387 destructors fail. Since the modules containing them are
388 deleted *last* of all, they would come too late in the normal
389 destruction order. Sigh. */
390
391 value = PyDict_GetItemString(modules, "__builtin__");
392 if (value != NULL && PyModule_Check(value)) {
393 dict = PyModule_GetDict(value);
394 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000395 PySys_WriteStderr("# clear __builtin__._\n");
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000396 PyDict_SetItemString(dict, "_", Py_None);
397 }
398 value = PyDict_GetItemString(modules, "sys");
399 if (value != NULL && PyModule_Check(value)) {
400 char **p;
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000401 PyObject *v;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000402 dict = PyModule_GetDict(value);
403 for (p = sys_deletes; *p != NULL; p++) {
404 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000405 PySys_WriteStderr("# clear sys.%s\n", *p);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000406 PyDict_SetItemString(dict, *p, Py_None);
407 }
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000408 for (p = sys_files; *p != NULL; p+=2) {
409 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000410 PySys_WriteStderr("# restore sys.%s\n", *p);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000411 v = PyDict_GetItemString(dict, *(p+1));
412 if (v == NULL)
413 v = Py_None;
414 PyDict_SetItemString(dict, *p, v);
415 }
416 }
417
418 /* First, delete __main__ */
419 value = PyDict_GetItemString(modules, "__main__");
420 if (value != NULL && PyModule_Check(value)) {
421 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000422 PySys_WriteStderr("# cleanup __main__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000423 _PyModule_Clear(value);
424 PyDict_SetItemString(modules, "__main__", Py_None);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000425 }
426
Guido van Rossum758eec01998-01-19 21:58:26 +0000427 /* The special treatment of __builtin__ here is because even
428 when it's not referenced as a module, its dictionary is
429 referenced by almost every module's __builtins__. Since
430 deleting a module clears its dictionary (even if there are
431 references left to it), we need to delete the __builtin__
432 module last. Likewise, we don't delete sys until the very
433 end because it is implicitly referenced (e.g. by print).
434
435 Also note that we 'delete' modules by replacing their entry
436 in the modules dict with None, rather than really deleting
437 them; this avoids a rehash of the modules dictionary and
438 also marks them as "non existent" so they won't be
439 re-imported. */
440
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000441 /* Next, repeatedly delete modules with a reference count of
Guido van Rossum758eec01998-01-19 21:58:26 +0000442 one (skipping __builtin__ and sys) and delete them */
443 do {
444 ndone = 0;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000445 pos = 0;
Guido van Rossum758eec01998-01-19 21:58:26 +0000446 while (PyDict_Next(modules, &pos, &key, &value)) {
447 if (value->ob_refcnt != 1)
448 continue;
Guido van Rossum566373e1998-10-01 15:24:50 +0000449 if (PyString_Check(key) && PyModule_Check(value)) {
450 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000451 if (strcmp(name, "__builtin__") == 0)
452 continue;
453 if (strcmp(name, "sys") == 0)
454 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000455 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000456 PySys_WriteStderr(
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000457 "# cleanup[1] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000458 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000459 PyDict_SetItem(modules, key, Py_None);
460 ndone++;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000461 }
462 }
Guido van Rossum758eec01998-01-19 21:58:26 +0000463 } while (ndone > 0);
464
Guido van Rossum758eec01998-01-19 21:58:26 +0000465 /* Next, delete all modules (still skipping __builtin__ and sys) */
466 pos = 0;
467 while (PyDict_Next(modules, &pos, &key, &value)) {
Guido van Rossum566373e1998-10-01 15:24:50 +0000468 if (PyString_Check(key) && PyModule_Check(value)) {
469 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000470 if (strcmp(name, "__builtin__") == 0)
471 continue;
472 if (strcmp(name, "sys") == 0)
473 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000474 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000475 PySys_WriteStderr("# cleanup[2] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000476 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000477 PyDict_SetItem(modules, key, Py_None);
478 }
479 }
480
481 /* Next, delete sys and __builtin__ (in that order) */
482 value = PyDict_GetItemString(modules, "sys");
483 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000484 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000485 PySys_WriteStderr("# cleanup sys\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000486 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000487 PyDict_SetItemString(modules, "sys", Py_None);
488 }
489 value = PyDict_GetItemString(modules, "__builtin__");
490 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000491 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000492 PySys_WriteStderr("# cleanup __builtin__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000493 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000494 PyDict_SetItemString(modules, "__builtin__", Py_None);
495 }
496
497 /* Finally, clear and delete the modules directory */
498 PyDict_Clear(modules);
499 interp->modules = NULL;
500 Py_DECREF(modules);
Guido van Rossum8d15b5d1990-10-26 14:58:58 +0000501}
Guido van Rossum7f133ed1991-02-19 12:23:57 +0000502
503
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000504/* Helper for pythonrun.c -- return magic number */
505
506long
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000507PyImport_GetMagicNumber(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000508{
Guido van Rossum96774c12000-05-01 20:19:08 +0000509 return pyc_magic;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000510}
511
512
Guido van Rossum25ce5661997-08-02 03:10:38 +0000513/* Magic for extension modules (built-in as well as dynamically
514 loaded). To prevent initializing an extension module more than
515 once, we keep a static dictionary 'extensions' keyed by module name
516 (for built-in modules) or by filename (for dynamically loaded
Barry Warsaw92883382001-08-13 23:05:44 +0000517 modules), containing these modules. A copy of the module's
Guido van Rossum25ce5661997-08-02 03:10:38 +0000518 dictionary is stored by calling _PyImport_FixupExtension()
519 immediately after the module initialization function succeeds. A
520 copy can be retrieved from there by calling
521 _PyImport_FindExtension(). */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000522
Guido van Rossum79f25d91997-04-29 20:08:16 +0000523PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000524_PyImport_FixupExtension(char *name, char *filename)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000525{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000526 PyObject *modules, *mod, *dict, *copy;
527 if (extensions == NULL) {
528 extensions = PyDict_New();
529 if (extensions == NULL)
530 return NULL;
531 }
532 modules = PyImport_GetModuleDict();
533 mod = PyDict_GetItemString(modules, name);
534 if (mod == NULL || !PyModule_Check(mod)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000535 PyErr_Format(PyExc_SystemError,
536 "_PyImport_FixupExtension: module %.200s not loaded", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000537 return NULL;
538 }
539 dict = PyModule_GetDict(mod);
540 if (dict == NULL)
541 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000542 copy = PyDict_Copy(dict);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000543 if (copy == NULL)
544 return NULL;
545 PyDict_SetItemString(extensions, filename, copy);
546 Py_DECREF(copy);
547 return copy;
548}
549
550PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000551_PyImport_FindExtension(char *name, char *filename)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000552{
Fred Drake9cd0efc2001-10-25 21:38:59 +0000553 PyObject *dict, *mod, *mdict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000554 if (extensions == NULL)
555 return NULL;
556 dict = PyDict_GetItemString(extensions, filename);
557 if (dict == NULL)
558 return NULL;
559 mod = PyImport_AddModule(name);
560 if (mod == NULL)
561 return NULL;
562 mdict = PyModule_GetDict(mod);
563 if (mdict == NULL)
564 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000565 if (PyDict_Update(mdict, dict))
Guido van Rossum25ce5661997-08-02 03:10:38 +0000566 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000567 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000568 PySys_WriteStderr("import %s # previously loaded (%s)\n",
Guido van Rossum25ce5661997-08-02 03:10:38 +0000569 name, filename);
570 return mod;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000571}
572
573
574/* Get the module object corresponding to a module name.
575 First check the modules dictionary if there's one there,
Walter Dörwaldf0dfc7a2003-10-20 14:01:56 +0000576 if not, create a new one and insert it in the modules dictionary.
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000577 Because the former action is most common, THIS DOES NOT RETURN A
578 'NEW' REFERENCE! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000579
Guido van Rossum79f25d91997-04-29 20:08:16 +0000580PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000581PyImport_AddModule(const char *name)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000582{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000583 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000584 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000585
Guido van Rossum25ce5661997-08-02 03:10:38 +0000586 if ((m = PyDict_GetItemString(modules, name)) != NULL &&
Guido van Rossum79f25d91997-04-29 20:08:16 +0000587 PyModule_Check(m))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000588 return m;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000589 m = PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000590 if (m == NULL)
591 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000592 if (PyDict_SetItemString(modules, name, m) != 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000593 Py_DECREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000594 return NULL;
595 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000596 Py_DECREF(m); /* Yes, it still exists, in modules! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000597
598 return m;
599}
600
Tim Peters1cd70172004-08-02 03:52:12 +0000601/* Remove name from sys.modules, if it's there. */
602static void
603_RemoveModule(const char *name)
604{
605 PyObject *modules = PyImport_GetModuleDict();
606 if (PyDict_GetItemString(modules, name) == NULL)
607 return;
608 if (PyDict_DelItemString(modules, name) < 0)
609 Py_FatalError("import: deleting existing key in"
610 "sys.modules failed");
611}
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000612
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000613/* Execute a code object in a module and return the module object
Tim Peters1cd70172004-08-02 03:52:12 +0000614 * WITH INCREMENTED REFERENCE COUNT. If an error occurs, name is
615 * removed from sys.modules, to avoid leaving damaged module objects
616 * in sys.modules. The caller may wish to restore the original
617 * module object (if any) in this case; PyImport_ReloadModule is an
618 * example.
619 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000620PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000621PyImport_ExecCodeModule(char *name, PyObject *co)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000622{
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000623 return PyImport_ExecCodeModuleEx(name, co, (char *)NULL);
624}
625
626PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000627PyImport_ExecCodeModuleEx(char *name, PyObject *co, char *pathname)
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000628{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000629 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000630 PyObject *m, *d, *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000631
Guido van Rossum79f25d91997-04-29 20:08:16 +0000632 m = PyImport_AddModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000633 if (m == NULL)
634 return NULL;
Jeremy Hyltonecd91292004-01-02 23:25:32 +0000635 /* If the module is being reloaded, we get the old module back
636 and re-use its dict to exec the new code. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000637 d = PyModule_GetDict(m);
638 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
639 if (PyDict_SetItemString(d, "__builtins__",
640 PyEval_GetBuiltins()) != 0)
Tim Peters1cd70172004-08-02 03:52:12 +0000641 goto error;
Guido van Rossum6135a871995-01-09 17:53:26 +0000642 }
Guido van Rossum9c9a07c1996-05-16 20:43:40 +0000643 /* Remember the filename as the __file__ attribute */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000644 v = NULL;
645 if (pathname != NULL) {
646 v = PyString_FromString(pathname);
647 if (v == NULL)
648 PyErr_Clear();
649 }
650 if (v == NULL) {
651 v = ((PyCodeObject *)co)->co_filename;
652 Py_INCREF(v);
653 }
654 if (PyDict_SetItemString(d, "__file__", v) != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000655 PyErr_Clear(); /* Not important enough to report */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000656 Py_DECREF(v);
657
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000658 v = PyEval_EvalCode((PyCodeObject *)co, d, d);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000659 if (v == NULL)
Tim Peters1cd70172004-08-02 03:52:12 +0000660 goto error;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000661 Py_DECREF(v);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000662
Guido van Rossum25ce5661997-08-02 03:10:38 +0000663 if ((m = PyDict_GetItemString(modules, name)) == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000664 PyErr_Format(PyExc_ImportError,
665 "Loaded module %.200s not found in sys.modules",
666 name);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000667 return NULL;
668 }
669
Guido van Rossum79f25d91997-04-29 20:08:16 +0000670 Py_INCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000671
672 return m;
Tim Peters1cd70172004-08-02 03:52:12 +0000673
674 error:
675 _RemoveModule(name);
676 return NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000677}
678
679
680/* Given a pathname for a Python source file, fill a buffer with the
681 pathname for the corresponding compiled file. Return the pathname
682 for the compiled file, or NULL if there's no space in the buffer.
683 Doesn't set an exception. */
684
685static char *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000686make_compiled_pathname(char *pathname, char *buf, size_t buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000687{
Tim Petersc1731372001-08-04 08:12:36 +0000688 size_t len = strlen(pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000689 if (len+2 > buflen)
690 return NULL;
Tim Petersc1731372001-08-04 08:12:36 +0000691
Martin v. Löwis6238d2b2002-06-30 15:26:10 +0000692#ifdef MS_WINDOWS
Tim Petersc1731372001-08-04 08:12:36 +0000693 /* Treat .pyw as if it were .py. The case of ".pyw" must match
694 that used in _PyImport_StandardFiletab. */
695 if (len >= 4 && strcmp(&pathname[len-4], ".pyw") == 0)
696 --len; /* pretend 'w' isn't there */
697#endif
698 memcpy(buf, pathname, len);
699 buf[len] = Py_OptimizeFlag ? 'o' : 'c';
700 buf[len+1] = '\0';
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000701
702 return buf;
703}
704
705
706/* Given a pathname for a Python source file, its time of last
707 modification, and a pathname for a compiled file, check whether the
708 compiled file represents the same version of the source. If so,
709 return a FILE pointer for the compiled file, positioned just after
710 the header; if not, return NULL.
711 Doesn't set an exception. */
712
713static FILE *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000714check_compiled_module(char *pathname, time_t mtime, char *cpathname)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000715{
716 FILE *fp;
717 long magic;
718 long pyc_mtime;
719
720 fp = fopen(cpathname, "rb");
721 if (fp == NULL)
722 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000723 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000724 if (magic != pyc_magic) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000725 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000726 PySys_WriteStderr("# %s has bad magic\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000727 fclose(fp);
728 return NULL;
729 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000730 pyc_mtime = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000731 if (pyc_mtime != mtime) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000732 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000733 PySys_WriteStderr("# %s has bad mtime\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000734 fclose(fp);
735 return NULL;
736 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000737 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000738 PySys_WriteStderr("# %s matches %s\n", cpathname, pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000739 return fp;
740}
741
742
743/* Read a code object from a file and check it for validity */
744
Guido van Rossum79f25d91997-04-29 20:08:16 +0000745static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000746read_compiled_module(char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000747{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000748 PyObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000749
Tim Petersd9b9ac82001-01-28 00:27:39 +0000750 co = PyMarshal_ReadLastObjectFromFile(fp);
Armin Rigo01ab2792004-03-26 15:09:27 +0000751 if (co == NULL)
752 return NULL;
753 if (!PyCode_Check(co)) {
754 PyErr_Format(PyExc_ImportError,
755 "Non-code object in %.200s", cpathname);
756 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000757 return NULL;
758 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000759 return (PyCodeObject *)co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000760}
761
762
763/* Load a module from a compiled file, execute it, and return its
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000764 module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000765
Guido van Rossum79f25d91997-04-29 20:08:16 +0000766static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000767load_compiled_module(char *name, char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000768{
769 long magic;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000770 PyCodeObject *co;
771 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000772
Guido van Rossum79f25d91997-04-29 20:08:16 +0000773 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000774 if (magic != pyc_magic) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000775 PyErr_Format(PyExc_ImportError,
776 "Bad magic number in %.200s", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000777 return NULL;
778 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000779 (void) PyMarshal_ReadLongFromFile(fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000780 co = read_compiled_module(cpathname, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000781 if (co == NULL)
782 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000783 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000784 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000785 name, cpathname);
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000786 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000787 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000788
789 return m;
790}
791
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000792/* Parse a source file and return the corresponding code object */
793
Guido van Rossum79f25d91997-04-29 20:08:16 +0000794static PyCodeObject *
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000795parse_source_module(const char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000796{
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000797 PyCodeObject *co = NULL;
798 mod_ty mod;
Neal Norwitz2a399b02006-09-11 04:28:16 +0000799 PyArena *arena = PyArena_New();
800 if (arena == NULL)
801 return NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000802
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000803 mod = PyParser_ASTFromFile(fp, pathname, Py_file_input, 0, 0, 0,
Neal Norwitzadb69fc2005-12-17 20:54:49 +0000804 NULL, arena);
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000805 if (mod) {
Neal Norwitzadb69fc2005-12-17 20:54:49 +0000806 co = PyAST_Compile(mod, pathname, NULL, arena);
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000807 }
Neal Norwitz2a399b02006-09-11 04:28:16 +0000808 PyArena_Free(arena);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000809 return co;
810}
811
812
Guido van Rossum55a83382000-09-20 20:31:38 +0000813/* Helper to open a bytecode file for writing in exclusive mode */
814
815static FILE *
816open_exclusive(char *filename)
817{
818#if defined(O_EXCL)&&defined(O_CREAT)&&defined(O_WRONLY)&&defined(O_TRUNC)
819 /* Use O_EXCL to avoid a race condition when another process tries to
820 write the same file. When that happens, our open() call fails,
821 which is just fine (since it's only a cache).
822 XXX If the file exists and is writable but the directory is not
823 writable, the file will never be written. Oh well.
824 */
825 int fd;
826 (void) unlink(filename);
Tim Peters42c83af2000-09-29 04:03:10 +0000827 fd = open(filename, O_EXCL|O_CREAT|O_WRONLY|O_TRUNC
828#ifdef O_BINARY
829 |O_BINARY /* necessary for Windows */
830#endif
Martin v. Löwis79acb9e2002-12-06 12:48:53 +0000831#ifdef __VMS
Martin v. Löwis18e16552006-02-15 17:27:45 +0000832 , 0666, "ctxt=bin", "shr=nil"
Martin v. Löwis79acb9e2002-12-06 12:48:53 +0000833#else
Martin v. Löwis18e16552006-02-15 17:27:45 +0000834 , 0666
Martin v. Löwis79acb9e2002-12-06 12:48:53 +0000835#endif
Martin v. Löwis18e16552006-02-15 17:27:45 +0000836 );
Guido van Rossum55a83382000-09-20 20:31:38 +0000837 if (fd < 0)
838 return NULL;
839 return fdopen(fd, "wb");
840#else
841 /* Best we can do -- on Windows this can't happen anyway */
842 return fopen(filename, "wb");
843#endif
844}
845
846
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000847/* Write a compiled module to a file, placing the time of last
848 modification of its source into the header.
849 Errors are ignored, if a write error occurs an attempt is made to
850 remove the file. */
851
852static void
Martin v. Löwis18e16552006-02-15 17:27:45 +0000853write_compiled_module(PyCodeObject *co, char *cpathname, time_t mtime)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000854{
855 FILE *fp;
856
Guido van Rossum55a83382000-09-20 20:31:38 +0000857 fp = open_exclusive(cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000858 if (fp == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000859 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000860 PySys_WriteStderr(
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000861 "# can't create %s\n", cpathname);
862 return;
863 }
Martin v. Löwisef82d2f2004-06-27 16:51:46 +0000864 PyMarshal_WriteLongToFile(pyc_magic, fp, Py_MARSHAL_VERSION);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000865 /* First write a 0 for mtime */
Martin v. Löwisef82d2f2004-06-27 16:51:46 +0000866 PyMarshal_WriteLongToFile(0L, fp, Py_MARSHAL_VERSION);
867 PyMarshal_WriteObjectToFile((PyObject *)co, fp, Py_MARSHAL_VERSION);
Armin Rigo01ab2792004-03-26 15:09:27 +0000868 if (fflush(fp) != 0 || ferror(fp)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000869 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000870 PySys_WriteStderr("# can't write %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000871 /* Don't keep partial file */
872 fclose(fp);
873 (void) unlink(cpathname);
874 return;
875 }
876 /* Now write the true mtime */
877 fseek(fp, 4L, 0);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000878 assert(mtime < LONG_MAX);
Martin v. Löwis725507b2006-03-07 12:08:51 +0000879 PyMarshal_WriteLongToFile((long)mtime, fp, Py_MARSHAL_VERSION);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000880 fflush(fp);
881 fclose(fp);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000882 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000883 PySys_WriteStderr("# wrote %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000884}
885
886
887/* Load a source module from a given file and return its module
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000888 object WITH INCREMENTED REFERENCE COUNT. If there's a matching
889 byte-compiled file, use that instead. */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000890
Guido van Rossum79f25d91997-04-29 20:08:16 +0000891static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000892load_source_module(char *name, char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000893{
Fred Drake4c82b232000-06-30 16:18:57 +0000894 time_t mtime;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000895 FILE *fpc;
896 char buf[MAXPATHLEN+1];
897 char *cpathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000898 PyCodeObject *co;
899 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000900
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000901 mtime = PyOS_GetLastModificationTime(pathname, fp);
Neal Norwitz708e51a2005-10-03 04:48:15 +0000902 if (mtime == (time_t)(-1)) {
903 PyErr_Format(PyExc_RuntimeError,
904 "unable to get modification time from '%s'",
905 pathname);
Fred Drake4c82b232000-06-30 16:18:57 +0000906 return NULL;
Neal Norwitz708e51a2005-10-03 04:48:15 +0000907 }
Fred Drake4c82b232000-06-30 16:18:57 +0000908#if SIZEOF_TIME_T > 4
909 /* Python's .pyc timestamp handling presumes that the timestamp fits
910 in 4 bytes. This will be fine until sometime in the year 2038,
911 when a 4-byte signed time_t will overflow.
912 */
913 if (mtime >> 32) {
914 PyErr_SetString(PyExc_OverflowError,
Fred Drakec63d3e92001-03-01 06:33:32 +0000915 "modification time overflows a 4 byte field");
Fred Drake4c82b232000-06-30 16:18:57 +0000916 return NULL;
917 }
918#endif
Tim Peters36515e22001-11-18 04:06:29 +0000919 cpathname = make_compiled_pathname(pathname, buf,
Jeremy Hylton37832f02001-04-13 17:50:20 +0000920 (size_t)MAXPATHLEN + 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000921 if (cpathname != NULL &&
922 (fpc = check_compiled_module(pathname, mtime, cpathname))) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000923 co = read_compiled_module(cpathname, fpc);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000924 fclose(fpc);
925 if (co == NULL)
926 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000927 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000928 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000929 name, cpathname);
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000930 pathname = cpathname;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000931 }
932 else {
933 co = parse_source_module(pathname, fp);
934 if (co == NULL)
935 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000936 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000937 PySys_WriteStderr("import %s # from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000938 name, pathname);
Neal Norwitz3cb31ac2006-08-13 18:10:47 +0000939 if (cpathname)
940 write_compiled_module(co, cpathname, mtime);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000941 }
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000942 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, pathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000943 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000944
945 return m;
946}
947
948
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000949/* Forward */
Just van Rossum52e14d62002-12-30 22:08:05 +0000950static PyObject *load_module(char *, FILE *, char *, int, PyObject *);
951static struct filedescr *find_module(char *, char *, PyObject *,
952 char *, size_t, FILE **, PyObject **);
Tim Petersdbd9ba62000-07-09 03:09:57 +0000953static struct _frozen *find_frozen(char *name);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000954
955/* Load a package and return its module object WITH INCREMENTED
956 REFERENCE COUNT */
957
958static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000959load_package(char *name, char *pathname)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000960{
Tim Peters1cd70172004-08-02 03:52:12 +0000961 PyObject *m, *d;
962 PyObject *file = NULL;
963 PyObject *path = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000964 int err;
965 char buf[MAXPATHLEN+1];
966 FILE *fp = NULL;
967 struct filedescr *fdp;
968
969 m = PyImport_AddModule(name);
970 if (m == NULL)
971 return NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000972 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000973 PySys_WriteStderr("import %s # directory %s\n",
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000974 name, pathname);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000975 d = PyModule_GetDict(m);
976 file = PyString_FromString(pathname);
977 if (file == NULL)
Tim Peters1cd70172004-08-02 03:52:12 +0000978 goto error;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000979 path = Py_BuildValue("[O]", file);
Tim Peters1cd70172004-08-02 03:52:12 +0000980 if (path == NULL)
981 goto error;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000982 err = PyDict_SetItemString(d, "__file__", file);
983 if (err == 0)
984 err = PyDict_SetItemString(d, "__path__", path);
Tim Peters1cd70172004-08-02 03:52:12 +0000985 if (err != 0)
986 goto error;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000987 buf[0] = '\0';
Just van Rossum52e14d62002-12-30 22:08:05 +0000988 fdp = find_module(name, "__init__", path, buf, sizeof(buf), &fp, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000989 if (fdp == NULL) {
990 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
991 PyErr_Clear();
Thomas Heller25653242004-06-07 15:04:10 +0000992 Py_INCREF(m);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000993 }
994 else
995 m = NULL;
996 goto cleanup;
997 }
Just van Rossum52e14d62002-12-30 22:08:05 +0000998 m = load_module(name, fp, buf, fdp->type, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000999 if (fp != NULL)
1000 fclose(fp);
Tim Peters1cd70172004-08-02 03:52:12 +00001001 goto cleanup;
1002
1003 error:
1004 m = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001005 cleanup:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001006 Py_XDECREF(path);
1007 Py_XDECREF(file);
1008 return m;
1009}
1010
1011
1012/* Helper to test for built-in module */
1013
1014static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001015is_builtin(char *name)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001016{
1017 int i;
Guido van Rossum771c6c81997-10-31 18:37:24 +00001018 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
1019 if (strcmp(name, PyImport_Inittab[i].name) == 0) {
1020 if (PyImport_Inittab[i].initfunc == NULL)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001021 return -1;
1022 else
1023 return 1;
1024 }
1025 }
1026 return 0;
1027}
1028
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001029
Just van Rossum52e14d62002-12-30 22:08:05 +00001030/* Return an importer object for a sys.path/pkg.__path__ item 'p',
1031 possibly by fetching it from the path_importer_cache dict. If it
Brett Cannon94b69f62006-09-28 22:10:14 +00001032 wasn't yet cached, traverse path_hooks until a hook is found
Just van Rossum52e14d62002-12-30 22:08:05 +00001033 that can handle the path item. Return None if no hook could;
1034 this tells our caller it should fall back to the builtin
1035 import mechanism. Cache the result in path_importer_cache.
1036 Returns a borrowed reference. */
1037
1038static PyObject *
1039get_path_importer(PyObject *path_importer_cache, PyObject *path_hooks,
1040 PyObject *p)
1041{
1042 PyObject *importer;
Martin v. Löwis725507b2006-03-07 12:08:51 +00001043 Py_ssize_t j, nhooks;
Just van Rossum52e14d62002-12-30 22:08:05 +00001044
1045 /* These conditions are the caller's responsibility: */
1046 assert(PyList_Check(path_hooks));
1047 assert(PyDict_Check(path_importer_cache));
1048
1049 nhooks = PyList_Size(path_hooks);
1050 if (nhooks < 0)
1051 return NULL; /* Shouldn't happen */
1052
1053 importer = PyDict_GetItem(path_importer_cache, p);
1054 if (importer != NULL)
1055 return importer;
1056
1057 /* set path_importer_cache[p] to None to avoid recursion */
1058 if (PyDict_SetItem(path_importer_cache, p, Py_None) != 0)
1059 return NULL;
1060
1061 for (j = 0; j < nhooks; j++) {
1062 PyObject *hook = PyList_GetItem(path_hooks, j);
1063 if (hook == NULL)
1064 return NULL;
Georg Brandl684fd0c2006-05-25 19:15:31 +00001065 importer = PyObject_CallFunctionObjArgs(hook, p, NULL);
Just van Rossum52e14d62002-12-30 22:08:05 +00001066 if (importer != NULL)
1067 break;
1068
1069 if (!PyErr_ExceptionMatches(PyExc_ImportError)) {
1070 return NULL;
1071 }
1072 PyErr_Clear();
1073 }
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00001074 if (importer == NULL) {
1075 importer = PyObject_CallFunctionObjArgs(
1076 (PyObject *)&NullImporterType, p, NULL
1077 );
1078 if (importer == NULL) {
1079 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
1080 PyErr_Clear();
1081 return Py_None;
1082 }
1083 }
1084 }
1085 if (importer != NULL) {
Just van Rossum52e14d62002-12-30 22:08:05 +00001086 int err = PyDict_SetItem(path_importer_cache, p, importer);
1087 Py_DECREF(importer);
1088 if (err != 0)
1089 return NULL;
1090 }
1091 return importer;
1092}
1093
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001094/* Search the path (default sys.path) for a module. Return the
1095 corresponding filedescr struct, and (via return arguments) the
1096 pathname and an open file. Return NULL if the module is not found. */
1097
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001098#ifdef MS_COREDLL
Thomas Woutersb4bd21c2000-07-22 23:38:01 +00001099extern FILE *PyWin_FindRegisteredModule(const char *, struct filedescr **,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001100 char *, Py_ssize_t);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001101#endif
1102
Martin v. Löwis18e16552006-02-15 17:27:45 +00001103static int case_ok(char *, Py_ssize_t, Py_ssize_t, char *);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001104static int find_init_module(char *); /* Forward */
Just van Rossum52e14d62002-12-30 22:08:05 +00001105static struct filedescr importhookdescr = {"", "", IMP_HOOK};
Guido van Rossum197346f1997-10-31 18:38:52 +00001106
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001107static struct filedescr *
Just van Rossum52e14d62002-12-30 22:08:05 +00001108find_module(char *fullname, char *subname, PyObject *path, char *buf,
1109 size_t buflen, FILE **p_fp, PyObject **p_loader)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001110{
Martin v. Löwis725507b2006-03-07 12:08:51 +00001111 Py_ssize_t i, npath;
Fred Drake4c82b232000-06-30 16:18:57 +00001112 size_t len, namelen;
Guido van Rossum80bb9651996-12-05 23:27:02 +00001113 struct filedescr *fdp = NULL;
Jack Jansenc88da1f2002-05-28 10:58:19 +00001114 char *filemode;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001115 FILE *fp = NULL;
Just van Rossum52e14d62002-12-30 22:08:05 +00001116 PyObject *path_hooks, *path_importer_cache;
Guido van Rossum48a680c2001-03-02 06:34:14 +00001117#ifndef RISCOS
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001118 struct stat statbuf;
Guido van Rossum48a680c2001-03-02 06:34:14 +00001119#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +00001120 static struct filedescr fd_frozen = {"", "", PY_FROZEN};
1121 static struct filedescr fd_builtin = {"", "", C_BUILTIN};
1122 static struct filedescr fd_package = {"", "", PKG_DIRECTORY};
Guido van Rossum0506a431998-08-11 15:07:39 +00001123 char name[MAXPATHLEN+1];
Andrew MacIntyred9400542002-02-26 11:41:34 +00001124#if defined(PYOS_OS2)
1125 size_t saved_len;
1126 size_t saved_namelen;
1127 char *saved_buf = NULL;
1128#endif
Just van Rossum52e14d62002-12-30 22:08:05 +00001129 if (p_loader != NULL)
1130 *p_loader = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001131
Just van Rossum52e14d62002-12-30 22:08:05 +00001132 if (strlen(subname) > MAXPATHLEN) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001133 PyErr_SetString(PyExc_OverflowError,
1134 "module name is too long");
Fred Drake4c82b232000-06-30 16:18:57 +00001135 return NULL;
1136 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001137 strcpy(name, subname);
1138
1139 /* sys.meta_path import hook */
1140 if (p_loader != NULL) {
1141 PyObject *meta_path;
1142
1143 meta_path = PySys_GetObject("meta_path");
1144 if (meta_path == NULL || !PyList_Check(meta_path)) {
1145 PyErr_SetString(PyExc_ImportError,
1146 "sys.meta_path must be a list of "
1147 "import hooks");
1148 return NULL;
1149 }
1150 Py_INCREF(meta_path); /* zap guard */
1151 npath = PyList_Size(meta_path);
1152 for (i = 0; i < npath; i++) {
1153 PyObject *loader;
1154 PyObject *hook = PyList_GetItem(meta_path, i);
1155 loader = PyObject_CallMethod(hook, "find_module",
1156 "sO", fullname,
1157 path != NULL ?
1158 path : Py_None);
1159 if (loader == NULL) {
1160 Py_DECREF(meta_path);
1161 return NULL; /* true error */
1162 }
1163 if (loader != Py_None) {
1164 /* a loader was found */
1165 *p_loader = loader;
1166 Py_DECREF(meta_path);
1167 return &importhookdescr;
1168 }
1169 Py_DECREF(loader);
1170 }
1171 Py_DECREF(meta_path);
1172 }
Guido van Rossum0506a431998-08-11 15:07:39 +00001173
1174 if (path != NULL && PyString_Check(path)) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001175 /* The only type of submodule allowed inside a "frozen"
1176 package are other frozen modules or packages. */
Guido van Rossum0506a431998-08-11 15:07:39 +00001177 if (PyString_Size(path) + 1 + strlen(name) >= (size_t)buflen) {
1178 PyErr_SetString(PyExc_ImportError,
1179 "full frozen module name too long");
1180 return NULL;
1181 }
1182 strcpy(buf, PyString_AsString(path));
1183 strcat(buf, ".");
1184 strcat(buf, name);
1185 strcpy(name, buf);
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001186 if (find_frozen(name) != NULL) {
1187 strcpy(buf, name);
1188 return &fd_frozen;
1189 }
1190 PyErr_Format(PyExc_ImportError,
1191 "No frozen submodule named %.200s", name);
1192 return NULL;
Guido van Rossum0506a431998-08-11 15:07:39 +00001193 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001194 if (path == NULL) {
1195 if (is_builtin(name)) {
Guido van Rossuma5568d31998-03-05 03:45:08 +00001196 strcpy(buf, name);
1197 return &fd_builtin;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001198 }
Greg Ward201baee2001-10-04 14:52:06 +00001199 if ((find_frozen(name)) != NULL) {
Guido van Rossuma5568d31998-03-05 03:45:08 +00001200 strcpy(buf, name);
1201 return &fd_frozen;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001202 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001203
Guido van Rossumac279101996-08-22 23:10:58 +00001204#ifdef MS_COREDLL
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001205 fp = PyWin_FindRegisteredModule(name, &fdp, buf, buflen);
1206 if (fp != NULL) {
1207 *p_fp = fp;
1208 return fdp;
1209 }
Guido van Rossuma5a3db71996-04-09 02:39:59 +00001210#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +00001211 path = PySys_GetObject("path");
1212 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001213 if (path == NULL || !PyList_Check(path)) {
1214 PyErr_SetString(PyExc_ImportError,
Guido van Rossuma5568d31998-03-05 03:45:08 +00001215 "sys.path must be a list of directory names");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001216 return NULL;
1217 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001218
1219 path_hooks = PySys_GetObject("path_hooks");
1220 if (path_hooks == NULL || !PyList_Check(path_hooks)) {
1221 PyErr_SetString(PyExc_ImportError,
1222 "sys.path_hooks must be a list of "
1223 "import hooks");
1224 return NULL;
1225 }
1226 path_importer_cache = PySys_GetObject("path_importer_cache");
1227 if (path_importer_cache == NULL ||
1228 !PyDict_Check(path_importer_cache)) {
1229 PyErr_SetString(PyExc_ImportError,
1230 "sys.path_importer_cache must be a dict");
1231 return NULL;
1232 }
1233
Guido van Rossum79f25d91997-04-29 20:08:16 +00001234 npath = PyList_Size(path);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001235 namelen = strlen(name);
1236 for (i = 0; i < npath; i++) {
Walter Dörwald3430d702002-06-17 10:43:59 +00001237 PyObject *copy = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001238 PyObject *v = PyList_GetItem(path, i);
Neal Norwitz3cb31ac2006-08-13 18:10:47 +00001239 if (!v)
1240 return NULL;
Walter Dörwald3430d702002-06-17 10:43:59 +00001241#ifdef Py_USING_UNICODE
1242 if (PyUnicode_Check(v)) {
1243 copy = PyUnicode_Encode(PyUnicode_AS_UNICODE(v),
1244 PyUnicode_GET_SIZE(v), Py_FileSystemDefaultEncoding, NULL);
1245 if (copy == NULL)
1246 return NULL;
1247 v = copy;
1248 }
1249 else
1250#endif
Guido van Rossum79f25d91997-04-29 20:08:16 +00001251 if (!PyString_Check(v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001252 continue;
Neal Norwitz2aa9a5d2006-03-20 01:53:23 +00001253 len = PyString_GET_SIZE(v);
Walter Dörwald3430d702002-06-17 10:43:59 +00001254 if (len + 2 + namelen + MAXSUFFIXSIZE >= buflen) {
1255 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001256 continue; /* Too long */
Walter Dörwald3430d702002-06-17 10:43:59 +00001257 }
Neal Norwitz2aa9a5d2006-03-20 01:53:23 +00001258 strcpy(buf, PyString_AS_STRING(v));
Walter Dörwald3430d702002-06-17 10:43:59 +00001259 if (strlen(buf) != len) {
1260 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001261 continue; /* v contains '\0' */
Walter Dörwald3430d702002-06-17 10:43:59 +00001262 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001263
1264 /* sys.path_hooks import hook */
1265 if (p_loader != NULL) {
1266 PyObject *importer;
1267
1268 importer = get_path_importer(path_importer_cache,
1269 path_hooks, v);
Neal Norwitza4df11d2006-07-06 04:28:59 +00001270 if (importer == NULL) {
1271 Py_XDECREF(copy);
Just van Rossum52e14d62002-12-30 22:08:05 +00001272 return NULL;
Neal Norwitza4df11d2006-07-06 04:28:59 +00001273 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001274 /* Note: importer is a borrowed reference */
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00001275 if (importer != Py_None) {
Just van Rossum52e14d62002-12-30 22:08:05 +00001276 PyObject *loader;
1277 loader = PyObject_CallMethod(importer,
1278 "find_module",
1279 "s", fullname);
Neal Norwitza4df11d2006-07-06 04:28:59 +00001280 Py_XDECREF(copy);
Just van Rossum52e14d62002-12-30 22:08:05 +00001281 if (loader == NULL)
1282 return NULL; /* error */
1283 if (loader != Py_None) {
1284 /* a loader was found */
1285 *p_loader = loader;
1286 return &importhookdescr;
1287 }
1288 Py_DECREF(loader);
Georg Brandlf4ef1162006-05-26 18:03:31 +00001289 continue;
Just van Rossum52e14d62002-12-30 22:08:05 +00001290 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001291 }
Georg Brandlf4ef1162006-05-26 18:03:31 +00001292 /* no hook was found, use builtin import */
Just van Rossum52e14d62002-12-30 22:08:05 +00001293
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001294 if (len > 0 && buf[len-1] != SEP
1295#ifdef ALTSEP
1296 && buf[len-1] != ALTSEP
1297#endif
1298 )
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001299 buf[len++] = SEP;
Guido van Rossum215c3402000-11-13 17:26:32 +00001300 strcpy(buf+len, name);
1301 len += namelen;
Tim Peters50d8d372001-02-28 05:34:27 +00001302
1303 /* Check for package import (buf holds a directory name,
1304 and there's an __init__ module in that directory */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001305#ifdef HAVE_STAT
Walter Dörwald3430d702002-06-17 10:43:59 +00001306 if (stat(buf, &statbuf) == 0 && /* it exists */
1307 S_ISDIR(statbuf.st_mode) && /* it's a directory */
Thomas Wouters9df4e6f2006-04-27 23:13:20 +00001308 case_ok(buf, len, namelen, name)) { /* case matches */
1309 if (find_init_module(buf)) { /* and has __init__.py */
1310 Py_XDECREF(copy);
1311 return &fd_package;
1312 }
1313 else {
1314 char warnstr[MAXPATHLEN+80];
1315 sprintf(warnstr, "Not importing directory "
1316 "'%.*s': missing __init__.py",
1317 MAXPATHLEN, buf);
1318 if (PyErr_Warn(PyExc_ImportWarning,
1319 warnstr)) {
1320 Py_XDECREF(copy);
1321 return NULL;
1322 }
1323 }
Walter Dörwald3430d702002-06-17 10:43:59 +00001324 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001325#else
1326 /* XXX How are you going to test for directories? */
Guido van Rossum48a680c2001-03-02 06:34:14 +00001327#ifdef RISCOS
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001328 if (isdir(buf) &&
Walter Dörwald3430d702002-06-17 10:43:59 +00001329 case_ok(buf, len, namelen, name)) {
Thomas Wouters9df4e6f2006-04-27 23:13:20 +00001330 if (find_init_module(buf)) {
1331 Py_XDECREF(copy);
1332 return &fd_package;
1333 }
1334 else {
1335 char warnstr[MAXPATHLEN+80];
1336 sprintf(warnstr, "Not importing directory "
1337 "'%.*s': missing __init__.py",
1338 MAXPATHLEN, buf);
1339 if (PyErr_Warn(PyExc_ImportWarning,
1340 warnstr)) {
1341 Py_XDECREF(copy);
1342 return NULL;
1343 }
Walter Dörwald3430d702002-06-17 10:43:59 +00001344 }
Guido van Rossum48a680c2001-03-02 06:34:14 +00001345#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001346#endif
Andrew MacIntyred9400542002-02-26 11:41:34 +00001347#if defined(PYOS_OS2)
1348 /* take a snapshot of the module spec for restoration
1349 * after the 8 character DLL hackery
1350 */
1351 saved_buf = strdup(buf);
1352 saved_len = len;
1353 saved_namelen = namelen;
1354#endif /* PYOS_OS2 */
Guido van Rossum79f25d91997-04-29 20:08:16 +00001355 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
Andrew MacIntyred9400542002-02-26 11:41:34 +00001356#if defined(PYOS_OS2)
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001357 /* OS/2 limits DLLs to 8 character names (w/o
1358 extension)
Andrew MacIntyred9400542002-02-26 11:41:34 +00001359 * so if the name is longer than that and its a
1360 * dynamically loaded module we're going to try,
1361 * truncate the name before trying
1362 */
Just van Rossum52e14d62002-12-30 22:08:05 +00001363 if (strlen(subname) > 8) {
Andrew MacIntyred9400542002-02-26 11:41:34 +00001364 /* is this an attempt to load a C extension? */
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001365 const struct filedescr *scan;
1366 scan = _PyImport_DynLoadFiletab;
Andrew MacIntyred9400542002-02-26 11:41:34 +00001367 while (scan->suffix != NULL) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001368 if (!strcmp(scan->suffix, fdp->suffix))
Andrew MacIntyred9400542002-02-26 11:41:34 +00001369 break;
1370 else
1371 scan++;
1372 }
1373 if (scan->suffix != NULL) {
1374 /* yes, so truncate the name */
1375 namelen = 8;
Just van Rossum52e14d62002-12-30 22:08:05 +00001376 len -= strlen(subname) - namelen;
Andrew MacIntyred9400542002-02-26 11:41:34 +00001377 buf[len] = '\0';
1378 }
1379 }
1380#endif /* PYOS_OS2 */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001381 strcpy(buf+len, fdp->suffix);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001382 if (Py_VerboseFlag > 1)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001383 PySys_WriteStderr("# trying %s\n", buf);
Jack Jansenc88da1f2002-05-28 10:58:19 +00001384 filemode = fdp->mode;
Tim Peters86c7d2f2004-08-01 23:24:21 +00001385 if (filemode[0] == 'U')
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001386 filemode = "r" PY_STDIOTEXTMODE;
Jack Jansenc88da1f2002-05-28 10:58:19 +00001387 fp = fopen(buf, filemode);
Tim Peters50d8d372001-02-28 05:34:27 +00001388 if (fp != NULL) {
1389 if (case_ok(buf, len, namelen, name))
1390 break;
1391 else { /* continue search */
1392 fclose(fp);
1393 fp = NULL;
Barry Warsaw914a0b12001-02-02 19:12:16 +00001394 }
Barry Warsaw914a0b12001-02-02 19:12:16 +00001395 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001396#if defined(PYOS_OS2)
1397 /* restore the saved snapshot */
1398 strcpy(buf, saved_buf);
1399 len = saved_len;
1400 namelen = saved_namelen;
1401#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001402 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001403#if defined(PYOS_OS2)
1404 /* don't need/want the module name snapshot anymore */
1405 if (saved_buf)
1406 {
1407 free(saved_buf);
1408 saved_buf = NULL;
1409 }
1410#endif
Walter Dörwald3430d702002-06-17 10:43:59 +00001411 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001412 if (fp != NULL)
1413 break;
1414 }
1415 if (fp == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001416 PyErr_Format(PyExc_ImportError,
1417 "No module named %.200s", name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001418 return NULL;
1419 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001420 *p_fp = fp;
1421 return fdp;
1422}
1423
Raymond Hettingerdb29e0f2004-10-07 06:46:25 +00001424/* Helpers for main.c
1425 * Find the source file corresponding to a named module
1426 */
1427struct filedescr *
1428_PyImport_FindModule(const char *name, PyObject *path, char *buf,
1429 size_t buflen, FILE **p_fp, PyObject **p_loader)
1430{
1431 return find_module((char *) name, (char *) name, path,
1432 buf, buflen, p_fp, p_loader);
1433}
1434
1435PyAPI_FUNC(int) _PyImport_IsScript(struct filedescr * fd)
1436{
1437 return fd->type == PY_SOURCE || fd->type == PY_COMPILED;
1438}
1439
Martin v. Löwis18e16552006-02-15 17:27:45 +00001440/* case_ok(char* buf, Py_ssize_t len, Py_ssize_t namelen, char* name)
Tim Petersd1e87a82001-03-01 18:12:00 +00001441 * The arguments here are tricky, best shown by example:
1442 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1443 * ^ ^ ^ ^
1444 * |--------------------- buf ---------------------|
1445 * |------------------- len ------------------|
1446 * |------ name -------|
1447 * |----- namelen -----|
1448 * buf is the full path, but len only counts up to (& exclusive of) the
1449 * extension. name is the module name, also exclusive of extension.
1450 *
1451 * We've already done a successful stat() or fopen() on buf, so know that
1452 * there's some match, possibly case-insensitive.
1453 *
Tim Peters50d8d372001-02-28 05:34:27 +00001454 * case_ok() is to return 1 if there's a case-sensitive match for
1455 * name, else 0. case_ok() is also to return 1 if envar PYTHONCASEOK
1456 * exists.
Tim Petersd1e87a82001-03-01 18:12:00 +00001457 *
Tim Peters50d8d372001-02-28 05:34:27 +00001458 * case_ok() is used to implement case-sensitive import semantics even
1459 * on platforms with case-insensitive filesystems. It's trivial to implement
1460 * for case-sensitive filesystems. It's pretty much a cross-platform
1461 * nightmare for systems with case-insensitive filesystems.
1462 */
Guido van Rossum0980bd91998-02-13 17:18:36 +00001463
Tim Peters50d8d372001-02-28 05:34:27 +00001464/* First we may need a pile of platform-specific header files; the sequence
1465 * of #if's here should match the sequence in the body of case_ok().
1466 */
Jason Tishler7961aa62005-05-20 00:56:54 +00001467#if defined(MS_WINDOWS)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001468#include <windows.h>
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001469
Tim Peters50d8d372001-02-28 05:34:27 +00001470#elif defined(DJGPP)
1471#include <dir.h>
1472
Jason Tishler7961aa62005-05-20 00:56:54 +00001473#elif (defined(__MACH__) && defined(__APPLE__) || defined(__CYGWIN__)) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001474#include <sys/types.h>
1475#include <dirent.h>
1476
Andrew MacIntyred9400542002-02-26 11:41:34 +00001477#elif defined(PYOS_OS2)
1478#define INCL_DOS
1479#define INCL_DOSERRORS
1480#define INCL_NOPMAPI
1481#include <os2.h>
1482
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001483#elif defined(RISCOS)
1484#include "oslib/osfscontrol.h"
Tim Peters50d8d372001-02-28 05:34:27 +00001485#endif
1486
Guido van Rossum0980bd91998-02-13 17:18:36 +00001487static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00001488case_ok(char *buf, Py_ssize_t len, Py_ssize_t namelen, char *name)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001489{
Tim Peters50d8d372001-02-28 05:34:27 +00001490/* Pick a platform-specific implementation; the sequence of #if's here should
1491 * match the sequence just above.
1492 */
1493
Jason Tishler7961aa62005-05-20 00:56:54 +00001494/* MS_WINDOWS */
1495#if defined(MS_WINDOWS)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001496 WIN32_FIND_DATA data;
1497 HANDLE h;
Tim Peters50d8d372001-02-28 05:34:27 +00001498
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001499 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001500 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001501
Guido van Rossum0980bd91998-02-13 17:18:36 +00001502 h = FindFirstFile(buf, &data);
1503 if (h == INVALID_HANDLE_VALUE) {
1504 PyErr_Format(PyExc_NameError,
1505 "Can't find file for module %.100s\n(filename %.300s)",
1506 name, buf);
1507 return 0;
1508 }
1509 FindClose(h);
Tim Peters50d8d372001-02-28 05:34:27 +00001510 return strncmp(data.cFileName, name, namelen) == 0;
1511
1512/* DJGPP */
1513#elif defined(DJGPP)
1514 struct ffblk ffblk;
1515 int done;
1516
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001517 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum323bf5e1998-06-24 03:54:06 +00001518 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001519
1520 done = findfirst(buf, &ffblk, FA_ARCH|FA_RDONLY|FA_HIDDEN|FA_DIREC);
1521 if (done) {
Guido van Rossum0980bd91998-02-13 17:18:36 +00001522 PyErr_Format(PyExc_NameError,
Tim Peters50d8d372001-02-28 05:34:27 +00001523 "Can't find file for module %.100s\n(filename %.300s)",
Guido van Rossum0980bd91998-02-13 17:18:36 +00001524 name, buf);
1525 return 0;
1526 }
Tim Peters50d8d372001-02-28 05:34:27 +00001527 return strncmp(ffblk.ff_name, name, namelen) == 0;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001528
Jason Tishler7961aa62005-05-20 00:56:54 +00001529/* new-fangled macintosh (macosx) or Cygwin */
1530#elif (defined(__MACH__) && defined(__APPLE__) || defined(__CYGWIN__)) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001531 DIR *dirp;
1532 struct dirent *dp;
Tim Petersd1e87a82001-03-01 18:12:00 +00001533 char dirname[MAXPATHLEN + 1];
1534 const int dirlen = len - namelen - 1; /* don't want trailing SEP */
Tim Peters430f5d42001-03-01 01:30:56 +00001535
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001536 if (Py_GETENV("PYTHONCASEOK") != NULL)
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001537 return 1;
1538
Tim Petersd1e87a82001-03-01 18:12:00 +00001539 /* Copy the dir component into dirname; substitute "." if empty */
1540 if (dirlen <= 0) {
1541 dirname[0] = '.';
1542 dirname[1] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001543 }
1544 else {
Tim Petersd1e87a82001-03-01 18:12:00 +00001545 assert(dirlen <= MAXPATHLEN);
1546 memcpy(dirname, buf, dirlen);
1547 dirname[dirlen] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001548 }
1549 /* Open the directory and search the entries for an exact match. */
Tim Petersd1e87a82001-03-01 18:12:00 +00001550 dirp = opendir(dirname);
Tim Peters430f5d42001-03-01 01:30:56 +00001551 if (dirp) {
Tim Peters677898a2001-03-02 03:28:03 +00001552 char *nameWithExt = buf + len - namelen;
Tim Peters430f5d42001-03-01 01:30:56 +00001553 while ((dp = readdir(dirp)) != NULL) {
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001554 const int thislen =
Tim Peters430f5d42001-03-01 01:30:56 +00001555#ifdef _DIRENT_HAVE_D_NAMELEN
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001556 dp->d_namlen;
Tim Peters430f5d42001-03-01 01:30:56 +00001557#else
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001558 strlen(dp->d_name);
Tim Peters430f5d42001-03-01 01:30:56 +00001559#endif
Tim Petersd1e87a82001-03-01 18:12:00 +00001560 if (thislen >= namelen &&
Tim Peters677898a2001-03-02 03:28:03 +00001561 strcmp(dp->d_name, nameWithExt) == 0) {
Tim Peters430f5d42001-03-01 01:30:56 +00001562 (void)closedir(dirp);
1563 return 1; /* Found */
1564 }
1565 }
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001566 (void)closedir(dirp);
Tim Peters430f5d42001-03-01 01:30:56 +00001567 }
Tim Peters430f5d42001-03-01 01:30:56 +00001568 return 0 ; /* Not found */
Tim Peters430f5d42001-03-01 01:30:56 +00001569
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001570/* RISC OS */
1571#elif defined(RISCOS)
1572 char canon[MAXPATHLEN+1]; /* buffer for the canonical form of the path */
1573 char buf2[MAXPATHLEN+2];
1574 char *nameWithExt = buf+len-namelen;
1575 int canonlen;
1576 os_error *e;
1577
1578 if (Py_GETENV("PYTHONCASEOK") != NULL)
1579 return 1;
1580
1581 /* workaround:
1582 append wildcard, otherwise case of filename wouldn't be touched */
1583 strcpy(buf2, buf);
1584 strcat(buf2, "*");
1585
1586 e = xosfscontrol_canonicalise_path(buf2,canon,0,0,MAXPATHLEN+1,&canonlen);
1587 canonlen = MAXPATHLEN+1-canonlen;
1588 if (e || canonlen<=0 || canonlen>(MAXPATHLEN+1) )
1589 return 0;
1590 if (strcmp(nameWithExt, canon+canonlen-strlen(nameWithExt))==0)
1591 return 1; /* match */
1592
1593 return 0;
1594
Andrew MacIntyred9400542002-02-26 11:41:34 +00001595/* OS/2 */
1596#elif defined(PYOS_OS2)
1597 HDIR hdir = 1;
1598 ULONG srchcnt = 1;
1599 FILEFINDBUF3 ffbuf;
1600 APIRET rc;
1601
1602 if (getenv("PYTHONCASEOK") != NULL)
1603 return 1;
1604
1605 rc = DosFindFirst(buf,
1606 &hdir,
1607 FILE_READONLY | FILE_HIDDEN | FILE_SYSTEM | FILE_DIRECTORY,
1608 &ffbuf, sizeof(ffbuf),
1609 &srchcnt,
1610 FIL_STANDARD);
1611 if (rc != NO_ERROR)
1612 return 0;
1613 return strncmp(ffbuf.achName, name, namelen) == 0;
1614
Tim Peters50d8d372001-02-28 05:34:27 +00001615/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1616#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001617 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001618
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001619#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001620}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001621
Guido van Rossum0980bd91998-02-13 17:18:36 +00001622
Guido van Rossum197346f1997-10-31 18:38:52 +00001623#ifdef HAVE_STAT
1624/* Helper to look for __init__.py or __init__.py[co] in potential package */
1625static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001626find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001627{
Tim Peters0f9431f2001-07-05 03:47:53 +00001628 const size_t save_len = strlen(buf);
Fred Drake4c82b232000-06-30 16:18:57 +00001629 size_t i = save_len;
Tim Peters0f9431f2001-07-05 03:47:53 +00001630 char *pname; /* pointer to start of __init__ */
Guido van Rossum197346f1997-10-31 18:38:52 +00001631 struct stat statbuf;
1632
Tim Peters0f9431f2001-07-05 03:47:53 +00001633/* For calling case_ok(buf, len, namelen, name):
1634 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1635 * ^ ^ ^ ^
1636 * |--------------------- buf ---------------------|
1637 * |------------------- len ------------------|
1638 * |------ name -------|
1639 * |----- namelen -----|
1640 */
Guido van Rossum197346f1997-10-31 18:38:52 +00001641 if (save_len + 13 >= MAXPATHLEN)
1642 return 0;
1643 buf[i++] = SEP;
Tim Peters0f9431f2001-07-05 03:47:53 +00001644 pname = buf + i;
1645 strcpy(pname, "__init__.py");
Guido van Rossum197346f1997-10-31 18:38:52 +00001646 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001647 if (case_ok(buf,
1648 save_len + 9, /* len("/__init__") */
1649 8, /* len("__init__") */
1650 pname)) {
1651 buf[save_len] = '\0';
1652 return 1;
1653 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001654 }
Tim Peters0f9431f2001-07-05 03:47:53 +00001655 i += strlen(pname);
1656 strcpy(buf+i, Py_OptimizeFlag ? "o" : "c");
Guido van Rossum197346f1997-10-31 18:38:52 +00001657 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001658 if (case_ok(buf,
1659 save_len + 9, /* len("/__init__") */
1660 8, /* len("__init__") */
1661 pname)) {
1662 buf[save_len] = '\0';
1663 return 1;
1664 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001665 }
1666 buf[save_len] = '\0';
1667 return 0;
1668}
Guido van Rossum48a680c2001-03-02 06:34:14 +00001669
1670#else
1671
1672#ifdef RISCOS
1673static int
1674find_init_module(buf)
1675 char *buf;
1676{
1677 int save_len = strlen(buf);
1678 int i = save_len;
1679
1680 if (save_len + 13 >= MAXPATHLEN)
1681 return 0;
1682 buf[i++] = SEP;
1683 strcpy(buf+i, "__init__/py");
1684 if (isfile(buf)) {
1685 buf[save_len] = '\0';
1686 return 1;
1687 }
1688
1689 if (Py_OptimizeFlag)
1690 strcpy(buf+i, "o");
1691 else
1692 strcpy(buf+i, "c");
1693 if (isfile(buf)) {
1694 buf[save_len] = '\0';
1695 return 1;
1696 }
1697 buf[save_len] = '\0';
1698 return 0;
1699}
1700#endif /*RISCOS*/
1701
Guido van Rossum197346f1997-10-31 18:38:52 +00001702#endif /* HAVE_STAT */
1703
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001704
Tim Petersdbd9ba62000-07-09 03:09:57 +00001705static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001706
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001707/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001708 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001709
Guido van Rossum79f25d91997-04-29 20:08:16 +00001710static PyObject *
Just van Rossum52e14d62002-12-30 22:08:05 +00001711load_module(char *name, FILE *fp, char *buf, int type, PyObject *loader)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001712{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001713 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001714 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001715 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001716
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001717 /* First check that there's an open file (if we need one) */
1718 switch (type) {
1719 case PY_SOURCE:
1720 case PY_COMPILED:
1721 if (fp == NULL) {
1722 PyErr_Format(PyExc_ValueError,
1723 "file object required for import (type code %d)",
1724 type);
1725 return NULL;
1726 }
1727 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001728
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001729 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001730
1731 case PY_SOURCE:
1732 m = load_source_module(name, buf, fp);
1733 break;
1734
1735 case PY_COMPILED:
1736 m = load_compiled_module(name, buf, fp);
1737 break;
1738
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001739#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001740 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001741 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001742 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001743#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001744
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001745 case PKG_DIRECTORY:
1746 m = load_package(name, buf);
1747 break;
1748
1749 case C_BUILTIN:
1750 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001751 if (buf != NULL && buf[0] != '\0')
1752 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001753 if (type == C_BUILTIN)
1754 err = init_builtin(name);
1755 else
1756 err = PyImport_ImportFrozenModule(name);
1757 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001758 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001759 if (err == 0) {
1760 PyErr_Format(PyExc_ImportError,
1761 "Purported %s module %.200s not found",
1762 type == C_BUILTIN ?
1763 "builtin" : "frozen",
1764 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001765 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001766 }
1767 modules = PyImport_GetModuleDict();
1768 m = PyDict_GetItemString(modules, name);
1769 if (m == NULL) {
1770 PyErr_Format(
1771 PyExc_ImportError,
1772 "%s module %.200s not properly initialized",
1773 type == C_BUILTIN ?
1774 "builtin" : "frozen",
1775 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001776 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001777 }
1778 Py_INCREF(m);
1779 break;
1780
Just van Rossum52e14d62002-12-30 22:08:05 +00001781 case IMP_HOOK: {
1782 if (loader == NULL) {
1783 PyErr_SetString(PyExc_ImportError,
1784 "import hook without loader");
1785 return NULL;
1786 }
1787 m = PyObject_CallMethod(loader, "load_module", "s", name);
1788 break;
1789 }
1790
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001791 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001792 PyErr_Format(PyExc_ImportError,
1793 "Don't know how to import %.200s (type code %d)",
1794 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001795 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001796
1797 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001798
1799 return m;
1800}
1801
1802
1803/* Initialize a built-in module.
Brett Cannon5a9aa4f2006-10-03 21:58:55 +00001804 Return 1 for success, 0 if the module is not found, and -1 with
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001805 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001806
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001807static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001808init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001809{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001810 struct _inittab *p;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001811
Greg Ward201baee2001-10-04 14:52:06 +00001812 if (_PyImport_FindExtension(name, name) != NULL)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001813 return 1;
1814
Guido van Rossum771c6c81997-10-31 18:37:24 +00001815 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001816 if (strcmp(name, p->name) == 0) {
1817 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001818 PyErr_Format(PyExc_ImportError,
1819 "Cannot re-init internal module %.200s",
1820 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001821 return -1;
1822 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001823 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001824 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001825 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001826 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001827 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001828 if (_PyImport_FixupExtension(name, name) == NULL)
1829 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001830 return 1;
1831 }
1832 }
1833 return 0;
1834}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001835
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001836
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001837/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001838
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001839static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001840find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001841{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001842 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001843
Guido van Rossum79f25d91997-04-29 20:08:16 +00001844 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001845 if (p->name == NULL)
1846 return NULL;
1847 if (strcmp(p->name, name) == 0)
1848 break;
1849 }
1850 return p;
1851}
1852
Guido van Rossum79f25d91997-04-29 20:08:16 +00001853static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001854get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001855{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001856 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001857 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001858
1859 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001860 PyErr_Format(PyExc_ImportError,
1861 "No such frozen object named %.200s",
1862 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001863 return NULL;
1864 }
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001865 if (p->code == NULL) {
1866 PyErr_Format(PyExc_ImportError,
1867 "Excluded frozen object named %.200s",
1868 name);
1869 return NULL;
1870 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001871 size = p->size;
1872 if (size < 0)
1873 size = -size;
1874 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001875}
1876
1877/* Initialize a frozen module.
1878 Return 1 for succes, 0 if the module is not found, and -1 with
1879 an exception set if the initialization failed.
1880 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001881
1882int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001883PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001884{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001885 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001886 PyObject *co;
1887 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001888 int ispackage;
1889 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001890
1891 if (p == NULL)
1892 return 0;
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001893 if (p->code == NULL) {
1894 PyErr_Format(PyExc_ImportError,
1895 "Excluded frozen object named %.200s",
1896 name);
1897 return -1;
1898 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001899 size = p->size;
1900 ispackage = (size < 0);
1901 if (ispackage)
1902 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001903 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001904 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001905 name, ispackage ? " package" : "");
1906 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001907 if (co == NULL)
1908 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001909 if (!PyCode_Check(co)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001910 PyErr_Format(PyExc_TypeError,
1911 "frozen object %.200s is not a code object",
1912 name);
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001913 goto err_return;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001914 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001915 if (ispackage) {
1916 /* Set __path__ to the package name */
1917 PyObject *d, *s;
1918 int err;
1919 m = PyImport_AddModule(name);
1920 if (m == NULL)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001921 goto err_return;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001922 d = PyModule_GetDict(m);
1923 s = PyString_InternFromString(name);
1924 if (s == NULL)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001925 goto err_return;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001926 err = PyDict_SetItemString(d, "__path__", s);
1927 Py_DECREF(s);
1928 if (err != 0)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001929 goto err_return;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001930 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001931 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001932 if (m == NULL)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001933 goto err_return;
1934 Py_DECREF(co);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001935 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001936 return 1;
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001937err_return:
1938 Py_DECREF(co);
1939 return -1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001940}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001941
1942
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001943/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001944 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001945
Guido van Rossum79f25d91997-04-29 20:08:16 +00001946PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001947PyImport_ImportModule(const char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001948{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001949 PyObject *pname;
1950 PyObject *result;
1951
1952 pname = PyString_FromString(name);
Neal Norwitza11e4c12003-03-23 14:31:01 +00001953 if (pname == NULL)
1954 return NULL;
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001955 result = PyImport_Import(pname);
1956 Py_DECREF(pname);
1957 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001958}
1959
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001960/* Forward declarations for helper routines */
Thomas Woutersf7f438b2006-02-28 16:09:29 +00001961static PyObject *get_parent(PyObject *globals, char *buf,
1962 Py_ssize_t *p_buflen, int level);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001963static PyObject *load_next(PyObject *mod, PyObject *altmod,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001964 char **p_name, char *buf, Py_ssize_t *p_buflen);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001965static int mark_miss(char *name);
1966static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001967 char *buf, Py_ssize_t buflen, int recursive);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001968static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001969
1970/* The Magnum Opus of dotted-name import :-) */
1971
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001972static PyObject *
Thomas Woutersf7f438b2006-02-28 16:09:29 +00001973import_module_level(char *name, PyObject *globals, PyObject *locals,
1974 PyObject *fromlist, int level)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001975{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001976 char buf[MAXPATHLEN+1];
Martin v. Löwis18e16552006-02-15 17:27:45 +00001977 Py_ssize_t buflen = 0;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001978 PyObject *parent, *head, *next, *tail;
1979
Thomas Woutersf7f438b2006-02-28 16:09:29 +00001980 parent = get_parent(globals, buf, &buflen, level);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001981 if (parent == NULL)
1982 return NULL;
1983
1984 head = load_next(parent, Py_None, &name, buf, &buflen);
1985 if (head == NULL)
1986 return NULL;
1987
1988 tail = head;
1989 Py_INCREF(tail);
1990 while (name) {
1991 next = load_next(tail, tail, &name, buf, &buflen);
1992 Py_DECREF(tail);
1993 if (next == NULL) {
1994 Py_DECREF(head);
1995 return NULL;
1996 }
1997 tail = next;
1998 }
Thomas Wouters8ddab272006-04-04 16:17:02 +00001999 if (tail == Py_None) {
2000 /* If tail is Py_None, both get_parent and load_next found
2001 an empty module name: someone called __import__("") or
2002 doctored faulty bytecode */
Thomas Wouters4bdaa272006-04-05 13:39:37 +00002003 Py_DECREF(tail);
2004 Py_DECREF(head);
Thomas Wouters8ddab272006-04-04 16:17:02 +00002005 PyErr_SetString(PyExc_ValueError,
2006 "Empty module name");
2007 return NULL;
2008 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002009
2010 if (fromlist != NULL) {
2011 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
2012 fromlist = NULL;
2013 }
2014
2015 if (fromlist == NULL) {
2016 Py_DECREF(tail);
2017 return head;
2018 }
2019
2020 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002021 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002022 Py_DECREF(tail);
2023 return NULL;
2024 }
2025
2026 return tail;
2027}
2028
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002029/* For DLL compatibility */
2030#undef PyImport_ImportModuleEx
Guido van Rossum75acc9c1998-03-03 22:26:50 +00002031PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002032PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
2033 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00002034{
2035 PyObject *result;
2036 lock_import();
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002037 result = import_module_level(name, globals, locals, fromlist, -1);
2038 if (unlock_import() < 0) {
2039 Py_XDECREF(result);
2040 PyErr_SetString(PyExc_RuntimeError,
2041 "not holding the import lock");
2042 return NULL;
2043 }
2044 return result;
2045}
2046#define PyImport_ImportModuleEx(n, g, l, f) \
2047 PyImport_ImportModuleLevel(n, g, l, f, -1);
2048
2049PyObject *
2050PyImport_ImportModuleLevel(char *name, PyObject *globals, PyObject *locals,
2051 PyObject *fromlist, int level)
2052{
2053 PyObject *result;
2054 lock_import();
2055 result = import_module_level(name, globals, locals, fromlist, level);
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002056 if (unlock_import() < 0) {
2057 Py_XDECREF(result);
2058 PyErr_SetString(PyExc_RuntimeError,
2059 "not holding the import lock");
2060 return NULL;
2061 }
Guido van Rossum75acc9c1998-03-03 22:26:50 +00002062 return result;
2063}
2064
Fred Drake87590902004-05-28 20:21:36 +00002065/* Return the package that an import is being performed in. If globals comes
2066 from the module foo.bar.bat (not itself a package), this returns the
2067 sys.modules entry for foo.bar. If globals is from a package's __init__.py,
Georg Brandl5f6861d2006-05-28 21:57:35 +00002068 the package's entry in sys.modules is returned, as a borrowed reference.
Fred Drake87590902004-05-28 20:21:36 +00002069
2070 The *name* of the returned package is returned in buf, with the length of
2071 the name in *p_buflen.
2072
2073 If globals doesn't come from a package or a module in a package, or a
2074 corresponding entry is not found in sys.modules, Py_None is returned.
2075*/
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002076static PyObject *
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002077get_parent(PyObject *globals, char *buf, Py_ssize_t *p_buflen, int level)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002078{
2079 static PyObject *namestr = NULL;
2080 static PyObject *pathstr = NULL;
2081 PyObject *modname, *modpath, *modules, *parent;
2082
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002083 if (globals == NULL || !PyDict_Check(globals) || !level)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002084 return Py_None;
2085
2086 if (namestr == NULL) {
2087 namestr = PyString_InternFromString("__name__");
2088 if (namestr == NULL)
2089 return NULL;
2090 }
2091 if (pathstr == NULL) {
2092 pathstr = PyString_InternFromString("__path__");
2093 if (pathstr == NULL)
2094 return NULL;
2095 }
2096
2097 *buf = '\0';
2098 *p_buflen = 0;
2099 modname = PyDict_GetItem(globals, namestr);
2100 if (modname == NULL || !PyString_Check(modname))
2101 return Py_None;
2102
2103 modpath = PyDict_GetItem(globals, pathstr);
2104 if (modpath != NULL) {
Martin v. Löwis725507b2006-03-07 12:08:51 +00002105 Py_ssize_t len = PyString_GET_SIZE(modname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002106 if (len > MAXPATHLEN) {
2107 PyErr_SetString(PyExc_ValueError,
2108 "Module name too long");
2109 return NULL;
2110 }
2111 strcpy(buf, PyString_AS_STRING(modname));
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002112 }
2113 else {
2114 char *start = PyString_AS_STRING(modname);
2115 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00002116 size_t len;
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002117 if (lastdot == NULL && level > 0) {
2118 PyErr_SetString(PyExc_ValueError,
Georg Brandl98775df2006-09-06 06:09:31 +00002119 "Attempted relative import in non-package");
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002120 return NULL;
2121 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002122 if (lastdot == NULL)
2123 return Py_None;
2124 len = lastdot - start;
2125 if (len >= MAXPATHLEN) {
2126 PyErr_SetString(PyExc_ValueError,
2127 "Module name too long");
2128 return NULL;
2129 }
2130 strncpy(buf, start, len);
2131 buf[len] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002132 }
2133
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002134 while (--level > 0) {
2135 char *dot = strrchr(buf, '.');
2136 if (dot == NULL) {
2137 PyErr_SetString(PyExc_ValueError,
Georg Brandl98775df2006-09-06 06:09:31 +00002138 "Attempted relative import beyond "
2139 "toplevel package");
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002140 return NULL;
2141 }
2142 *dot = '\0';
2143 }
2144 *p_buflen = strlen(buf);
2145
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002146 modules = PyImport_GetModuleDict();
2147 parent = PyDict_GetItemString(modules, buf);
2148 if (parent == NULL)
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002149 PyErr_Format(PyExc_SystemError,
2150 "Parent module '%.200s' not loaded", buf);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002151 return parent;
2152 /* We expect, but can't guarantee, if parent != None, that:
2153 - parent.__name__ == buf
2154 - parent.__dict__ is globals
2155 If this is violated... Who cares? */
2156}
2157
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002158/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002159static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002160load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
Martin v. Löwis18e16552006-02-15 17:27:45 +00002161 Py_ssize_t *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002162{
2163 char *name = *p_name;
2164 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00002165 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002166 char *p;
2167 PyObject *result;
2168
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002169 if (strlen(name) == 0) {
Thomas Wouters8ddab272006-04-04 16:17:02 +00002170 /* completely empty module name should only happen in
2171 'from . import' (or '__import__("")')*/
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002172 Py_INCREF(mod);
2173 *p_name = NULL;
2174 return mod;
2175 }
2176
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002177 if (dot == NULL) {
2178 *p_name = NULL;
2179 len = strlen(name);
2180 }
2181 else {
2182 *p_name = dot+1;
2183 len = dot-name;
2184 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00002185 if (len == 0) {
2186 PyErr_SetString(PyExc_ValueError,
2187 "Empty module name");
2188 return NULL;
2189 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002190
2191 p = buf + *p_buflen;
2192 if (p != buf)
2193 *p++ = '.';
2194 if (p+len-buf >= MAXPATHLEN) {
2195 PyErr_SetString(PyExc_ValueError,
2196 "Module name too long");
2197 return NULL;
2198 }
2199 strncpy(p, name, len);
2200 p[len] = '\0';
2201 *p_buflen = p+len-buf;
2202
2203 result = import_submodule(mod, p, buf);
2204 if (result == Py_None && altmod != mod) {
2205 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002206 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00002207 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002208 if (result != NULL && result != Py_None) {
2209 if (mark_miss(buf) != 0) {
2210 Py_DECREF(result);
2211 return NULL;
2212 }
2213 strncpy(buf, name, len);
2214 buf[len] = '\0';
2215 *p_buflen = len;
2216 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002217 }
2218 if (result == NULL)
2219 return NULL;
2220
2221 if (result == Py_None) {
2222 Py_DECREF(result);
2223 PyErr_Format(PyExc_ImportError,
2224 "No module named %.200s", name);
2225 return NULL;
2226 }
2227
2228 return result;
2229}
2230
2231static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002232mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002233{
2234 PyObject *modules = PyImport_GetModuleDict();
2235 return PyDict_SetItemString(modules, name, Py_None);
2236}
2237
2238static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00002239ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, Py_ssize_t buflen,
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002240 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002241{
2242 int i;
2243
2244 if (!PyObject_HasAttrString(mod, "__path__"))
2245 return 1;
2246
2247 for (i = 0; ; i++) {
2248 PyObject *item = PySequence_GetItem(fromlist, i);
2249 int hasit;
2250 if (item == NULL) {
2251 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
2252 PyErr_Clear();
2253 return 1;
2254 }
2255 return 0;
2256 }
2257 if (!PyString_Check(item)) {
2258 PyErr_SetString(PyExc_TypeError,
2259 "Item in ``from list'' not a string");
2260 Py_DECREF(item);
2261 return 0;
2262 }
2263 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00002264 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002265 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002266 /* See if the package defines __all__ */
2267 if (recursive)
2268 continue; /* Avoid endless recursion */
2269 all = PyObject_GetAttrString(mod, "__all__");
2270 if (all == NULL)
2271 PyErr_Clear();
2272 else {
Martin v. Löwis83969ee2004-03-23 16:28:13 +00002273 int ret = ensure_fromlist(mod, all, buf, buflen, 1);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002274 Py_DECREF(all);
Martin v. Löwis83969ee2004-03-23 16:28:13 +00002275 if (!ret)
2276 return 0;
Guido van Rossum9905ef91997-09-08 16:07:11 +00002277 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002278 continue;
2279 }
2280 hasit = PyObject_HasAttr(mod, item);
2281 if (!hasit) {
2282 char *subname = PyString_AS_STRING(item);
2283 PyObject *submod;
2284 char *p;
2285 if (buflen + strlen(subname) >= MAXPATHLEN) {
2286 PyErr_SetString(PyExc_ValueError,
2287 "Module name too long");
2288 Py_DECREF(item);
2289 return 0;
2290 }
2291 p = buf + buflen;
2292 *p++ = '.';
2293 strcpy(p, subname);
2294 submod = import_submodule(mod, subname, buf);
2295 Py_XDECREF(submod);
2296 if (submod == NULL) {
2297 Py_DECREF(item);
2298 return 0;
2299 }
2300 }
2301 Py_DECREF(item);
2302 }
2303
Guido van Rossuma7f2e811997-10-03 15:33:32 +00002304 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002305}
2306
Neil Schemenauer00b09662003-06-16 21:03:07 +00002307static int
2308add_submodule(PyObject *mod, PyObject *submod, char *fullname, char *subname,
2309 PyObject *modules)
2310{
2311 if (mod == Py_None)
2312 return 1;
2313 /* Irrespective of the success of this load, make a
2314 reference to it in the parent package module. A copy gets
2315 saved in the modules dictionary under the full name, so get a
2316 reference from there, if need be. (The exception is when the
2317 load failed with a SyntaxError -- then there's no trace in
2318 sys.modules. In that case, of course, do nothing extra.) */
2319 if (submod == NULL) {
2320 submod = PyDict_GetItemString(modules, fullname);
2321 if (submod == NULL)
2322 return 1;
2323 }
2324 if (PyModule_Check(mod)) {
2325 /* We can't use setattr here since it can give a
2326 * spurious warning if the submodule name shadows a
2327 * builtin name */
2328 PyObject *dict = PyModule_GetDict(mod);
2329 if (!dict)
2330 return 0;
2331 if (PyDict_SetItemString(dict, subname, submod) < 0)
2332 return 0;
2333 }
2334 else {
2335 if (PyObject_SetAttrString(mod, subname, submod) < 0)
2336 return 0;
2337 }
2338 return 1;
2339}
2340
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002341static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002342import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002343{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002344 PyObject *modules = PyImport_GetModuleDict();
Neil Schemenauer00b09662003-06-16 21:03:07 +00002345 PyObject *m = NULL;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002346
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002347 /* Require:
2348 if mod == None: subname == fullname
2349 else: mod.__name__ + "." + subname == fullname
2350 */
2351
Tim Peters50d8d372001-02-28 05:34:27 +00002352 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002353 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00002354 }
2355 else {
Just van Rossum52e14d62002-12-30 22:08:05 +00002356 PyObject *path, *loader = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002357 char buf[MAXPATHLEN+1];
2358 struct filedescr *fdp;
2359 FILE *fp = NULL;
2360
Guido van Rossum9c0afe51998-05-19 15:09:05 +00002361 if (mod == Py_None)
2362 path = NULL;
2363 else {
2364 path = PyObject_GetAttrString(mod, "__path__");
2365 if (path == NULL) {
2366 PyErr_Clear();
2367 Py_INCREF(Py_None);
2368 return Py_None;
2369 }
2370 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002371
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002372 buf[0] = '\0';
Just van Rossum52e14d62002-12-30 22:08:05 +00002373 fdp = find_module(fullname, subname, path, buf, MAXPATHLEN+1,
2374 &fp, &loader);
Guido van Rossumb68cd421998-07-01 17:36:26 +00002375 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002376 if (fdp == NULL) {
2377 if (!PyErr_ExceptionMatches(PyExc_ImportError))
2378 return NULL;
2379 PyErr_Clear();
2380 Py_INCREF(Py_None);
2381 return Py_None;
2382 }
Just van Rossum52e14d62002-12-30 22:08:05 +00002383 m = load_module(fullname, fp, buf, fdp->type, loader);
2384 Py_XDECREF(loader);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002385 if (fp)
2386 fclose(fp);
Neil Schemenauer00b09662003-06-16 21:03:07 +00002387 if (!add_submodule(mod, m, fullname, subname, modules)) {
2388 Py_XDECREF(m);
2389 m = NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002390 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00002391 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002392
2393 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002394}
2395
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002396
2397/* Re-import a module of any kind and return its module object, WITH
2398 INCREMENTED REFERENCE COUNT */
2399
Guido van Rossum79f25d91997-04-29 20:08:16 +00002400PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002401PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002402{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002403 PyObject *modules = PyImport_GetModuleDict();
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002404 PyObject *path = NULL, *loader = NULL;
Guido van Rossum222ef561997-09-06 19:41:09 +00002405 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002406 char buf[MAXPATHLEN+1];
2407 struct filedescr *fdp;
2408 FILE *fp = NULL;
Tim Peters1cd70172004-08-02 03:52:12 +00002409 PyObject *newm;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002410
Guido van Rossum79f25d91997-04-29 20:08:16 +00002411 if (m == NULL || !PyModule_Check(m)) {
2412 PyErr_SetString(PyExc_TypeError,
2413 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002414 return NULL;
2415 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002416 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002417 if (name == NULL)
2418 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00002419 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002420 PyErr_Format(PyExc_ImportError,
2421 "reload(): module %.200s not in sys.modules",
2422 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002423 return NULL;
2424 }
Guido van Rossum222ef561997-09-06 19:41:09 +00002425 subname = strrchr(name, '.');
2426 if (subname == NULL)
2427 subname = name;
2428 else {
2429 PyObject *parentname, *parent;
2430 parentname = PyString_FromStringAndSize(name, (subname-name));
2431 if (parentname == NULL)
2432 return NULL;
2433 parent = PyDict_GetItem(modules, parentname);
2434 if (parent == NULL) {
2435 PyErr_Format(PyExc_ImportError,
2436 "reload(): parent %.200s not in sys.modules",
Georg Brandl0c55f292005-09-14 06:56:20 +00002437 PyString_AS_STRING(parentname));
2438 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002439 return NULL;
2440 }
Georg Brandl0c55f292005-09-14 06:56:20 +00002441 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002442 subname++;
2443 path = PyObject_GetAttrString(parent, "__path__");
2444 if (path == NULL)
2445 PyErr_Clear();
2446 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002447 buf[0] = '\0';
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002448 fdp = find_module(name, subname, path, buf, MAXPATHLEN+1, &fp, &loader);
Guido van Rossum222ef561997-09-06 19:41:09 +00002449 Py_XDECREF(path);
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002450
2451 if (fdp == NULL) {
2452 Py_XDECREF(loader);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002453 return NULL;
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002454 }
2455
2456 newm = load_module(name, fp, buf, fdp->type, loader);
2457 Py_XDECREF(loader);
2458
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002459 if (fp)
2460 fclose(fp);
Tim Peters1cd70172004-08-02 03:52:12 +00002461 if (newm == NULL) {
2462 /* load_module probably removed name from modules because of
2463 * the error. Put back the original module object. We're
2464 * going to return NULL in this case regardless of whether
2465 * replacing name succeeds, so the return value is ignored.
2466 */
2467 PyDict_SetItemString(modules, name, m);
2468 }
2469 return newm;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002470}
2471
2472
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002473/* Higher-level import emulator which emulates the "import" statement
2474 more accurately -- it invokes the __import__() function from the
2475 builtins of the current globals. This means that the import is
2476 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00002477 environment, e.g. by "rexec".
2478 A dummy list ["__doc__"] is passed as the 4th argument so that
2479 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
2480 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002481
2482PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002483PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002484{
2485 static PyObject *silly_list = NULL;
2486 static PyObject *builtins_str = NULL;
2487 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002488 PyObject *globals = NULL;
2489 PyObject *import = NULL;
2490 PyObject *builtins = NULL;
2491 PyObject *r = NULL;
2492
2493 /* Initialize constant string objects */
2494 if (silly_list == NULL) {
2495 import_str = PyString_InternFromString("__import__");
2496 if (import_str == NULL)
2497 return NULL;
2498 builtins_str = PyString_InternFromString("__builtins__");
2499 if (builtins_str == NULL)
2500 return NULL;
2501 silly_list = Py_BuildValue("[s]", "__doc__");
2502 if (silly_list == NULL)
2503 return NULL;
2504 }
2505
2506 /* Get the builtins from current globals */
2507 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002508 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00002509 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002510 builtins = PyObject_GetItem(globals, builtins_str);
2511 if (builtins == NULL)
2512 goto err;
2513 }
2514 else {
2515 /* No globals -- use standard builtins, and fake globals */
2516 PyErr_Clear();
2517
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002518 builtins = PyImport_ImportModuleLevel("__builtin__",
2519 NULL, NULL, NULL, 0);
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002520 if (builtins == NULL)
2521 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002522 globals = Py_BuildValue("{OO}", builtins_str, builtins);
2523 if (globals == NULL)
2524 goto err;
2525 }
2526
2527 /* Get the __import__ function from the builtins */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002528 if (PyDict_Check(builtins)) {
Fred Drakea76ba6e2001-03-06 06:31:15 +00002529 import = PyObject_GetItem(builtins, import_str);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002530 if (import == NULL)
2531 PyErr_SetObject(PyExc_KeyError, import_str);
2532 }
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002533 else
Fred Drakea76ba6e2001-03-06 06:31:15 +00002534 import = PyObject_GetAttr(builtins, import_str);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002535 if (import == NULL)
2536 goto err;
2537
2538 /* Call the _import__ function with the proper argument list */
Georg Brandl684fd0c2006-05-25 19:15:31 +00002539 r = PyObject_CallFunctionObjArgs(import, module_name, globals,
2540 globals, silly_list, NULL);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002541
2542 err:
2543 Py_XDECREF(globals);
2544 Py_XDECREF(builtins);
2545 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00002546
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002547 return r;
2548}
2549
2550
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002551/* Module 'imp' provides Python access to the primitives used for
2552 importing modules.
2553*/
2554
Guido van Rossum79f25d91997-04-29 20:08:16 +00002555static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002556imp_get_magic(PyObject *self, PyObject *noargs)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002557{
2558 char buf[4];
2559
Guido van Rossum96774c12000-05-01 20:19:08 +00002560 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
2561 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
2562 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
2563 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002564
Guido van Rossum79f25d91997-04-29 20:08:16 +00002565 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002566}
2567
Guido van Rossum79f25d91997-04-29 20:08:16 +00002568static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002569imp_get_suffixes(PyObject *self, PyObject *noargs)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002570{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002571 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002572 struct filedescr *fdp;
2573
Guido van Rossum79f25d91997-04-29 20:08:16 +00002574 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002575 if (list == NULL)
2576 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002577 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
2578 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002579 fdp->suffix, fdp->mode, fdp->type);
2580 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002581 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002582 return NULL;
2583 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002584 if (PyList_Append(list, item) < 0) {
2585 Py_DECREF(list);
2586 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002587 return NULL;
2588 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002589 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002590 }
2591 return list;
2592}
2593
Guido van Rossum79f25d91997-04-29 20:08:16 +00002594static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002595call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002596{
Tim Petersdbd9ba62000-07-09 03:09:57 +00002597 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002598 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002599 struct filedescr *fdp;
2600 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002601 FILE *fp = NULL;
2602
2603 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002604 if (path == Py_None)
2605 path = NULL;
Just van Rossum52e14d62002-12-30 22:08:05 +00002606 fdp = find_module(NULL, name, path, pathname, MAXPATHLEN+1, &fp, NULL);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002607 if (fdp == NULL)
2608 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002609 if (fp != NULL) {
2610 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
2611 if (fob == NULL) {
2612 fclose(fp);
2613 return NULL;
2614 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002615 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002616 else {
2617 fob = Py_None;
2618 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00002619 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002620 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002621 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002622 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002623 return ret;
2624}
2625
Guido van Rossum79f25d91997-04-29 20:08:16 +00002626static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002627imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002628{
2629 char *name;
2630 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002631 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002632 return NULL;
2633 return call_find_module(name, path);
2634}
2635
2636static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002637imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002638{
2639 char *name;
2640 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002641 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002642 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002643 return NULL;
2644 ret = init_builtin(name);
2645 if (ret < 0)
2646 return NULL;
2647 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002648 Py_INCREF(Py_None);
2649 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002650 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002651 m = PyImport_AddModule(name);
2652 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002653 return m;
2654}
2655
Guido van Rossum79f25d91997-04-29 20:08:16 +00002656static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002657imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002658{
2659 char *name;
2660 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002661 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002662 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002663 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002664 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002665 if (ret < 0)
2666 return NULL;
2667 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002668 Py_INCREF(Py_None);
2669 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002670 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002671 m = PyImport_AddModule(name);
2672 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002673 return m;
2674}
2675
Guido van Rossum79f25d91997-04-29 20:08:16 +00002676static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002677imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002678{
2679 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002680
Guido van Rossum43713e52000-02-29 13:59:29 +00002681 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002682 return NULL;
2683 return get_frozen_object(name);
2684}
2685
Guido van Rossum79f25d91997-04-29 20:08:16 +00002686static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002687imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002688{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002689 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002690 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002691 return NULL;
Guido van Rossum50ee94f2002-04-09 18:00:58 +00002692 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002693}
2694
Guido van Rossum79f25d91997-04-29 20:08:16 +00002695static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002696imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002697{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002698 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002699 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002700 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002701 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002702 p = find_frozen(name);
Guido van Rossumb8bff3f2002-04-07 06:34:38 +00002703 return PyBool_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002704}
2705
2706static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002707get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002708{
2709 FILE *fp;
2710 if (fob == NULL) {
Tim Peters86c7d2f2004-08-01 23:24:21 +00002711 if (mode[0] == 'U')
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002712 mode = "r" PY_STDIOTEXTMODE;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002713 fp = fopen(pathname, mode);
2714 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002715 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002716 }
2717 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002718 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002719 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002720 PyErr_SetString(PyExc_ValueError,
2721 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002722 }
2723 return fp;
2724}
2725
Guido van Rossum79f25d91997-04-29 20:08:16 +00002726static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002727imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002728{
2729 char *name;
2730 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002731 PyObject *fob = NULL;
2732 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002733 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002734 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002735 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002736 return NULL;
2737 fp = get_file(pathname, fob, "rb");
2738 if (fp == NULL)
2739 return NULL;
2740 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002741 if (fob == NULL)
2742 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002743 return m;
2744}
2745
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002746#ifdef HAVE_DYNAMIC_LOADING
2747
Guido van Rossum79f25d91997-04-29 20:08:16 +00002748static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002749imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002750{
2751 char *name;
2752 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002753 PyObject *fob = NULL;
2754 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002755 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002756 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002757 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002758 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002759 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002760 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002761 if (fp == NULL)
2762 return NULL;
2763 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002764 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002765 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002766}
2767
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002768#endif /* HAVE_DYNAMIC_LOADING */
2769
Guido van Rossum79f25d91997-04-29 20:08:16 +00002770static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002771imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002772{
2773 char *name;
2774 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002775 PyObject *fob = NULL;
2776 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002777 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002778 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002779 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002780 return NULL;
2781 fp = get_file(pathname, fob, "r");
2782 if (fp == NULL)
2783 return NULL;
2784 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002785 if (fob == NULL)
2786 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002787 return m;
2788}
2789
Guido van Rossum79f25d91997-04-29 20:08:16 +00002790static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002791imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002792{
2793 char *name;
2794 PyObject *fob;
2795 char *pathname;
2796 char *suffix; /* Unused */
2797 char *mode;
2798 int type;
2799 FILE *fp;
2800
Guido van Rossum43713e52000-02-29 13:59:29 +00002801 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002802 &name, &fob, &pathname,
2803 &suffix, &mode, &type))
2804 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002805 if (*mode) {
2806 /* Mode must start with 'r' or 'U' and must not contain '+'.
2807 Implicit in this test is the assumption that the mode
2808 may contain other modifiers like 'b' or 't'. */
2809
2810 if (!(*mode == 'r' || *mode == 'U') || strchr(mode, '+')) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002811 PyErr_Format(PyExc_ValueError,
2812 "invalid file open mode %.200s", mode);
2813 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002814 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002815 }
2816 if (fob == Py_None)
2817 fp = NULL;
2818 else {
2819 if (!PyFile_Check(fob)) {
2820 PyErr_SetString(PyExc_ValueError,
2821 "load_module arg#2 should be a file or None");
2822 return NULL;
2823 }
2824 fp = get_file(pathname, fob, mode);
2825 if (fp == NULL)
2826 return NULL;
2827 }
Just van Rossum52e14d62002-12-30 22:08:05 +00002828 return load_module(name, fp, pathname, type, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002829}
2830
2831static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002832imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002833{
2834 char *name;
2835 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002836 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002837 return NULL;
2838 return load_package(name, pathname);
2839}
2840
2841static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002842imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002843{
2844 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002845 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002846 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002847 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002848}
2849
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002850/* Doc strings */
2851
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002852PyDoc_STRVAR(doc_imp,
2853"This module provides the components needed to build your own\n\
2854__import__ function. Undocumented functions are obsolete.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002855
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002856PyDoc_STRVAR(doc_find_module,
2857"find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002858Search for a module. If path is omitted or None, search for a\n\
2859built-in, frozen or special module and continue search in sys.path.\n\
2860The module name cannot contain '.'; to search for a submodule of a\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002861package, pass the submodule name and the package's __path__.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002862
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002863PyDoc_STRVAR(doc_load_module,
2864"load_module(name, file, filename, (suffix, mode, type)) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002865Load a module, given information returned by find_module().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002866The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002867
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002868PyDoc_STRVAR(doc_get_magic,
2869"get_magic() -> string\n\
2870Return the magic number for .pyc or .pyo files.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002871
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002872PyDoc_STRVAR(doc_get_suffixes,
2873"get_suffixes() -> [(suffix, mode, type), ...]\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002874Return a list of (suffix, mode, type) tuples describing the files\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002875that find_module() looks for.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002876
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002877PyDoc_STRVAR(doc_new_module,
2878"new_module(name) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002879Create a new module. Do not enter it in sys.modules.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002880The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002881
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002882PyDoc_STRVAR(doc_lock_held,
Tim Petersa7c65092004-08-01 23:26:05 +00002883"lock_held() -> boolean\n\
2884Return True if the import lock is currently held, else False.\n\
2885On platforms without threads, return False.");
Tim Peters69232342001-08-30 05:16:13 +00002886
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002887PyDoc_STRVAR(doc_acquire_lock,
2888"acquire_lock() -> None\n\
Neal Norwitz2294c0d2003-02-12 23:02:21 +00002889Acquires the interpreter's import lock for the current thread.\n\
2890This lock should be used by import hooks to ensure thread-safety\n\
2891when importing modules.\n\
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002892On platforms without threads, this function does nothing.");
2893
2894PyDoc_STRVAR(doc_release_lock,
2895"release_lock() -> None\n\
2896Release the interpreter's import lock.\n\
2897On platforms without threads, this function does nothing.");
2898
Guido van Rossum79f25d91997-04-29 20:08:16 +00002899static PyMethodDef imp_methods[] = {
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002900 {"find_module", imp_find_module, METH_VARARGS, doc_find_module},
2901 {"get_magic", imp_get_magic, METH_NOARGS, doc_get_magic},
2902 {"get_suffixes", imp_get_suffixes, METH_NOARGS, doc_get_suffixes},
2903 {"load_module", imp_load_module, METH_VARARGS, doc_load_module},
2904 {"new_module", imp_new_module, METH_VARARGS, doc_new_module},
2905 {"lock_held", imp_lock_held, METH_NOARGS, doc_lock_held},
2906 {"acquire_lock", imp_acquire_lock, METH_NOARGS, doc_acquire_lock},
2907 {"release_lock", imp_release_lock, METH_NOARGS, doc_release_lock},
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002908 /* The rest are obsolete */
Neal Norwitz031829d2002-03-31 14:37:44 +00002909 {"get_frozen_object", imp_get_frozen_object, METH_VARARGS},
2910 {"init_builtin", imp_init_builtin, METH_VARARGS},
2911 {"init_frozen", imp_init_frozen, METH_VARARGS},
2912 {"is_builtin", imp_is_builtin, METH_VARARGS},
2913 {"is_frozen", imp_is_frozen, METH_VARARGS},
2914 {"load_compiled", imp_load_compiled, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002915#ifdef HAVE_DYNAMIC_LOADING
Neal Norwitz031829d2002-03-31 14:37:44 +00002916 {"load_dynamic", imp_load_dynamic, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002917#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002918 {"load_package", imp_load_package, METH_VARARGS},
Neal Norwitz031829d2002-03-31 14:37:44 +00002919 {"load_source", imp_load_source, METH_VARARGS},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002920 {NULL, NULL} /* sentinel */
2921};
2922
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002923static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002924setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002925{
2926 PyObject *v;
2927 int err;
2928
2929 v = PyInt_FromLong((long)value);
2930 err = PyDict_SetItemString(d, name, v);
2931 Py_XDECREF(v);
2932 return err;
2933}
2934
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00002935typedef struct {
2936 PyObject_HEAD
2937} NullImporter;
2938
2939static int
2940NullImporter_init(NullImporter *self, PyObject *args, PyObject *kwds)
2941{
2942 char *path;
2943
2944 if (!_PyArg_NoKeywords("NullImporter()", kwds))
2945 return -1;
2946
2947 if (!PyArg_ParseTuple(args, "s:NullImporter",
2948 &path))
2949 return -1;
2950
2951 if (strlen(path) == 0) {
2952 PyErr_SetString(PyExc_ImportError, "empty pathname");
2953 return -1;
2954 } else {
2955#ifndef RISCOS
2956 struct stat statbuf;
2957 int rv;
2958
2959 rv = stat(path, &statbuf);
2960 if (rv == 0) {
2961 /* it exists */
2962 if (S_ISDIR(statbuf.st_mode)) {
2963 /* it's a directory */
2964 PyErr_SetString(PyExc_ImportError,
2965 "existing directory");
2966 return -1;
2967 }
2968 }
2969#else
2970 if (object_exists(path)) {
2971 /* it exists */
2972 if (isdir(path)) {
2973 /* it's a directory */
2974 PyErr_SetString(PyExc_ImportError,
2975 "existing directory");
2976 return -1;
2977 }
2978 }
2979#endif
2980 }
2981 return 0;
2982}
2983
2984static PyObject *
2985NullImporter_find_module(NullImporter *self, PyObject *args)
2986{
2987 Py_RETURN_NONE;
2988}
2989
2990static PyMethodDef NullImporter_methods[] = {
2991 {"find_module", (PyCFunction)NullImporter_find_module, METH_VARARGS,
2992 "Always return None"
2993 },
2994 {NULL} /* Sentinel */
2995};
2996
2997
2998static PyTypeObject NullImporterType = {
2999 PyObject_HEAD_INIT(NULL)
3000 0, /*ob_size*/
3001 "imp.NullImporter", /*tp_name*/
3002 sizeof(NullImporter), /*tp_basicsize*/
3003 0, /*tp_itemsize*/
3004 0, /*tp_dealloc*/
3005 0, /*tp_print*/
3006 0, /*tp_getattr*/
3007 0, /*tp_setattr*/
3008 0, /*tp_compare*/
3009 0, /*tp_repr*/
3010 0, /*tp_as_number*/
3011 0, /*tp_as_sequence*/
3012 0, /*tp_as_mapping*/
3013 0, /*tp_hash */
3014 0, /*tp_call*/
3015 0, /*tp_str*/
3016 0, /*tp_getattro*/
3017 0, /*tp_setattro*/
3018 0, /*tp_as_buffer*/
3019 Py_TPFLAGS_DEFAULT, /*tp_flags*/
3020 "Null importer object", /* tp_doc */
3021 0, /* tp_traverse */
3022 0, /* tp_clear */
3023 0, /* tp_richcompare */
3024 0, /* tp_weaklistoffset */
3025 0, /* tp_iter */
3026 0, /* tp_iternext */
3027 NullImporter_methods, /* tp_methods */
3028 0, /* tp_members */
3029 0, /* tp_getset */
3030 0, /* tp_base */
3031 0, /* tp_dict */
3032 0, /* tp_descr_get */
3033 0, /* tp_descr_set */
3034 0, /* tp_dictoffset */
3035 (initproc)NullImporter_init, /* tp_init */
3036 0, /* tp_alloc */
3037 PyType_GenericNew /* tp_new */
3038};
3039
3040
Jason Tishler6bc06ec2003-09-04 11:59:50 +00003041PyMODINIT_FUNC
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003042initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003043{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003044 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003045
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00003046 if (PyType_Ready(&NullImporterType) < 0)
3047 goto failure;
3048
Guido van Rossum0207e6d1997-09-09 22:04:42 +00003049 m = Py_InitModule4("imp", imp_methods, doc_imp,
3050 NULL, PYTHON_API_VERSION);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00003051 if (m == NULL)
3052 goto failure;
Guido van Rossum79f25d91997-04-29 20:08:16 +00003053 d = PyModule_GetDict(m);
Neal Norwitz3cb31ac2006-08-13 18:10:47 +00003054 if (d == NULL)
3055 goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003056
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003057 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
3058 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
3059 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
3060 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
3061 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
3062 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
3063 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
3064 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00003065 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Just van Rossum52e14d62002-12-30 22:08:05 +00003066 if (setint(d, "IMP_HOOK", IMP_HOOK) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003067
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00003068 Py_INCREF(&NullImporterType);
3069 PyModule_AddObject(m, "NullImporter", (PyObject *)&NullImporterType);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003070 failure:
3071 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003072}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003073
3074
Guido van Rossumb18618d2000-05-03 23:44:39 +00003075/* API for embedding applications that want to add their own entries
3076 to the table of built-in modules. This should normally be called
3077 *before* Py_Initialize(). When the table resize fails, -1 is
3078 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003079
3080 After a similar function by Just van Rossum. */
3081
3082int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003083PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003084{
3085 static struct _inittab *our_copy = NULL;
3086 struct _inittab *p;
3087 int i, n;
3088
3089 /* Count the number of entries in both tables */
3090 for (n = 0; newtab[n].name != NULL; n++)
3091 ;
3092 if (n == 0)
3093 return 0; /* Nothing to do */
3094 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
3095 ;
3096
3097 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00003098 p = our_copy;
3099 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003100 if (p == NULL)
3101 return -1;
3102
3103 /* Copy the tables into the new memory */
3104 if (our_copy != PyImport_Inittab)
3105 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
3106 PyImport_Inittab = our_copy = p;
3107 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
3108
3109 return 0;
3110}
3111
3112/* Shorthand to add a single entry given a name and a function */
3113
3114int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003115PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003116{
3117 struct _inittab newtab[2];
3118
3119 memset(newtab, '\0', sizeof newtab);
3120
3121 newtab[0].name = name;
3122 newtab[0].initfunc = initfunc;
3123
3124 return PyImport_ExtendInittab(newtab);
3125}
Anthony Baxterac6bd462006-04-13 02:06:09 +00003126
3127#ifdef __cplusplus
3128}
3129#endif