blob: 45c5507aa9f79b53b9b9dc1c4c85655286715d77 [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)
Neal Norwitzcbeb6872006-10-14 21:33:38 +000068 Python 2.6a0: 62141 (peephole optimizations)
Michael W. Hudsonaee2e282005-10-21 11:32:20 +000069.
Tim Peters36515e22001-11-18 04:06:29 +000070*/
Neal Norwitzcbeb6872006-10-14 21:33:38 +000071#define MAGIC (62141 | ((long)'\r'<<16) | ((long)'\n'<<24))
Guido van Rossum3ddee711991-12-16 13:06:34 +000072
Guido van Rossum96774c12000-05-01 20:19:08 +000073/* Magic word as global; note that _PyImport_Init() can change the
Jeremy Hylton9262b8a2000-06-30 04:59:17 +000074 value of this global to accommodate for alterations of how the
Guido van Rossum96774c12000-05-01 20:19:08 +000075 compiler works which are enabled by command line switches. */
76static long pyc_magic = MAGIC;
77
Guido van Rossum25ce5661997-08-02 03:10:38 +000078/* See _PyImport_FixupExtension() below */
79static PyObject *extensions = NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +000080
Guido van Rossum771c6c81997-10-31 18:37:24 +000081/* This table is defined in config.c: */
82extern struct _inittab _PyImport_Inittab[];
83
84struct _inittab *PyImport_Inittab = _PyImport_Inittab;
Guido van Rossum66f1fa81991-04-03 19:03:52 +000085
Guido van Rossumed1170e1999-12-20 21:23:41 +000086/* these tables define the module suffixes that Python recognizes */
87struct filedescr * _PyImport_Filetab = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +000088
89#ifdef RISCOS
90static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000091 {"/py", "U", PY_SOURCE},
Guido van Rossum48a680c2001-03-02 06:34:14 +000092 {"/pyc", "rb", PY_COMPILED},
93 {0, 0}
94};
95#else
Guido van Rossumed1170e1999-12-20 21:23:41 +000096static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000097 {".py", "U", PY_SOURCE},
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000098#ifdef MS_WINDOWS
Jack Jansenc88da1f2002-05-28 10:58:19 +000099 {".pyw", "U", PY_SOURCE},
Tim Peters36515e22001-11-18 04:06:29 +0000100#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000101 {".pyc", "rb", PY_COMPILED},
102 {0, 0}
103};
Guido van Rossum48a680c2001-03-02 06:34:14 +0000104#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000105
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000106static PyTypeObject NullImporterType; /* Forward reference */
107
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000108/* Initialize things */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000109
110void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000111_PyImport_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000112{
Guido van Rossumed1170e1999-12-20 21:23:41 +0000113 const struct filedescr *scan;
114 struct filedescr *filetab;
115 int countD = 0;
116 int countS = 0;
117
118 /* prepare _PyImport_Filetab: copy entries from
119 _PyImport_DynLoadFiletab and _PyImport_StandardFiletab.
120 */
121 for (scan = _PyImport_DynLoadFiletab; scan->suffix != NULL; ++scan)
122 ++countD;
123 for (scan = _PyImport_StandardFiletab; scan->suffix != NULL; ++scan)
124 ++countS;
Guido van Rossumb18618d2000-05-03 23:44:39 +0000125 filetab = PyMem_NEW(struct filedescr, countD + countS + 1);
Neal Norwitze1fdb322006-07-21 05:32:28 +0000126 if (filetab == NULL)
Neal Norwitz33722ae2006-07-21 07:59:02 +0000127 Py_FatalError("Can't initialize import file table.");
Guido van Rossumed1170e1999-12-20 21:23:41 +0000128 memcpy(filetab, _PyImport_DynLoadFiletab,
129 countD * sizeof(struct filedescr));
130 memcpy(filetab + countD, _PyImport_StandardFiletab,
131 countS * sizeof(struct filedescr));
132 filetab[countD + countS].suffix = NULL;
133
134 _PyImport_Filetab = filetab;
135
Guido van Rossum0824f631997-03-11 18:37:35 +0000136 if (Py_OptimizeFlag) {
Guido van Rossumed1170e1999-12-20 21:23:41 +0000137 /* Replace ".pyc" with ".pyo" in _PyImport_Filetab */
138 for (; filetab->suffix != NULL; filetab++) {
Guido van Rossum48a680c2001-03-02 06:34:14 +0000139#ifndef RISCOS
Guido van Rossumed1170e1999-12-20 21:23:41 +0000140 if (strcmp(filetab->suffix, ".pyc") == 0)
141 filetab->suffix = ".pyo";
Guido van Rossum48a680c2001-03-02 06:34:14 +0000142#else
143 if (strcmp(filetab->suffix, "/pyc") == 0)
144 filetab->suffix = "/pyo";
145#endif
Guido van Rossum0824f631997-03-11 18:37:35 +0000146 }
147 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000148
149 if (Py_UnicodeFlag) {
150 /* Fix the pyc_magic so that byte compiled code created
151 using the all-Unicode method doesn't interfere with
152 code created in normal operation mode. */
153 pyc_magic = MAGIC + 1;
154 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000155}
156
Guido van Rossum25ce5661997-08-02 03:10:38 +0000157void
Just van Rossum52e14d62002-12-30 22:08:05 +0000158_PyImportHooks_Init(void)
159{
160 PyObject *v, *path_hooks = NULL, *zimpimport;
161 int err = 0;
162
163 /* adding sys.path_hooks and sys.path_importer_cache, setting up
164 zipimport */
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000165 if (PyType_Ready(&NullImporterType) < 0)
166 goto error;
Just van Rossum52e14d62002-12-30 22:08:05 +0000167
168 if (Py_VerboseFlag)
169 PySys_WriteStderr("# installing zipimport hook\n");
170
171 v = PyList_New(0);
172 if (v == NULL)
173 goto error;
174 err = PySys_SetObject("meta_path", v);
175 Py_DECREF(v);
176 if (err)
177 goto error;
178 v = PyDict_New();
179 if (v == NULL)
180 goto error;
181 err = PySys_SetObject("path_importer_cache", v);
182 Py_DECREF(v);
183 if (err)
184 goto error;
185 path_hooks = PyList_New(0);
186 if (path_hooks == NULL)
187 goto error;
188 err = PySys_SetObject("path_hooks", path_hooks);
189 if (err) {
190 error:
191 PyErr_Print();
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000192 Py_FatalError("initializing sys.meta_path, sys.path_hooks, "
193 "path_importer_cache, or NullImporter failed"
194 );
Just van Rossum52e14d62002-12-30 22:08:05 +0000195 }
Phillip J. Ebyf7575d02006-07-28 21:12:07 +0000196
Just van Rossum52e14d62002-12-30 22:08:05 +0000197 zimpimport = PyImport_ImportModule("zipimport");
198 if (zimpimport == NULL) {
199 PyErr_Clear(); /* No zip import module -- okay */
200 if (Py_VerboseFlag)
201 PySys_WriteStderr("# can't import zipimport\n");
202 }
203 else {
204 PyObject *zipimporter = PyObject_GetAttrString(zimpimport,
205 "zipimporter");
206 Py_DECREF(zimpimport);
207 if (zipimporter == NULL) {
208 PyErr_Clear(); /* No zipimporter object -- okay */
209 if (Py_VerboseFlag)
210 PySys_WriteStderr(
Fred Drake1e5fc552003-07-11 15:01:02 +0000211 "# can't import zipimport.zipimporter\n");
Just van Rossum52e14d62002-12-30 22:08:05 +0000212 }
213 else {
214 /* sys.path_hooks.append(zipimporter) */
215 err = PyList_Append(path_hooks, zipimporter);
216 Py_DECREF(zipimporter);
217 if (err)
218 goto error;
219 if (Py_VerboseFlag)
220 PySys_WriteStderr(
221 "# installed zipimport hook\n");
222 }
223 }
224 Py_DECREF(path_hooks);
225}
226
227void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000228_PyImport_Fini(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000229{
230 Py_XDECREF(extensions);
231 extensions = NULL;
Barry Warsaw84294482000-10-03 16:02:05 +0000232 PyMem_DEL(_PyImport_Filetab);
233 _PyImport_Filetab = NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000234}
235
236
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000237/* Locking primitives to prevent parallel imports of the same module
238 in different threads to return with a partially loaded module.
239 These calls are serialized by the global interpreter lock. */
240
241#ifdef WITH_THREAD
242
Guido van Rossum49b56061998-10-01 20:42:43 +0000243#include "pythread.h"
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000244
Guido van Rossum65d5b571998-12-21 19:32:43 +0000245static PyThread_type_lock import_lock = 0;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000246static long import_lock_thread = -1;
247static int import_lock_level = 0;
248
249static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000250lock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000251{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000252 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000253 if (me == -1)
254 return; /* Too bad */
Neal Norwitze1fdb322006-07-21 05:32:28 +0000255 if (import_lock == NULL) {
Guido van Rossum65d5b571998-12-21 19:32:43 +0000256 import_lock = PyThread_allocate_lock();
Neal Norwitze1fdb322006-07-21 05:32:28 +0000257 if (import_lock == NULL)
258 return; /* Nothing much we can do. */
259 }
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000260 if (import_lock_thread == me) {
261 import_lock_level++;
262 return;
263 }
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000264 if (import_lock_thread != -1 || !PyThread_acquire_lock(import_lock, 0))
265 {
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000266 PyThreadState *tstate = PyEval_SaveThread();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000267 PyThread_acquire_lock(import_lock, 1);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000268 PyEval_RestoreThread(tstate);
269 }
270 import_lock_thread = me;
271 import_lock_level = 1;
272}
273
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000274static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000275unlock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000276{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000277 long me = PyThread_get_thread_ident();
Neal Norwitze1fdb322006-07-21 05:32:28 +0000278 if (me == -1 || import_lock == NULL)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000279 return 0; /* Too bad */
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000280 if (import_lock_thread != me)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000281 return -1;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000282 import_lock_level--;
283 if (import_lock_level == 0) {
284 import_lock_thread = -1;
Guido van Rossum65d5b571998-12-21 19:32:43 +0000285 PyThread_release_lock(import_lock);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000286 }
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000287 return 1;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000288}
289
Guido van Rossum8ee3e5a2005-09-14 18:09:42 +0000290/* This function is called from PyOS_AfterFork to ensure that newly
291 created child processes do not share locks with the parent. */
292
293void
294_PyImport_ReInitLock(void)
295{
296#ifdef _AIX
297 if (import_lock != NULL)
298 import_lock = PyThread_allocate_lock();
299#endif
300}
301
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000302#else
303
304#define lock_import()
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000305#define unlock_import() 0
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000306
307#endif
308
Tim Peters69232342001-08-30 05:16:13 +0000309static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000310imp_lock_held(PyObject *self, PyObject *noargs)
Tim Peters69232342001-08-30 05:16:13 +0000311{
Tim Peters69232342001-08-30 05:16:13 +0000312#ifdef WITH_THREAD
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000313 return PyBool_FromLong(import_lock_thread != -1);
Tim Peters69232342001-08-30 05:16:13 +0000314#else
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000315 return PyBool_FromLong(0);
Tim Peters69232342001-08-30 05:16:13 +0000316#endif
317}
318
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000319static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000320imp_acquire_lock(PyObject *self, PyObject *noargs)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000321{
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000322#ifdef WITH_THREAD
323 lock_import();
324#endif
Neal Norwitz2294c0d2003-02-12 23:02:21 +0000325 Py_INCREF(Py_None);
326 return Py_None;
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000327}
328
329static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000330imp_release_lock(PyObject *self, PyObject *noargs)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000331{
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000332#ifdef WITH_THREAD
333 if (unlock_import() < 0) {
334 PyErr_SetString(PyExc_RuntimeError,
335 "not holding the import lock");
336 return NULL;
337 }
338#endif
Neal Norwitz2294c0d2003-02-12 23:02:21 +0000339 Py_INCREF(Py_None);
340 return Py_None;
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000341}
342
Guido van Rossum25ce5661997-08-02 03:10:38 +0000343/* Helper for sys */
344
345PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000346PyImport_GetModuleDict(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000347{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000348 PyInterpreterState *interp = PyThreadState_GET()->interp;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000349 if (interp->modules == NULL)
350 Py_FatalError("PyImport_GetModuleDict: no module dictionary!");
351 return interp->modules;
352}
353
Guido van Rossum3f5da241990-12-20 15:06:42 +0000354
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000355/* List of names to clear in sys */
356static char* sys_deletes[] = {
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000357 "path", "argv", "ps1", "ps2", "exitfunc",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000358 "exc_type", "exc_value", "exc_traceback",
359 "last_type", "last_value", "last_traceback",
Just van Rossum52e14d62002-12-30 22:08:05 +0000360 "path_hooks", "path_importer_cache", "meta_path",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000361 NULL
362};
363
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000364static char* sys_files[] = {
365 "stdin", "__stdin__",
366 "stdout", "__stdout__",
367 "stderr", "__stderr__",
368 NULL
369};
370
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000371
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000372/* Un-initialize things, as good as we can */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000373
Guido van Rossum3f5da241990-12-20 15:06:42 +0000374void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000375PyImport_Cleanup(void)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000376{
Martin v. Löwis18e16552006-02-15 17:27:45 +0000377 Py_ssize_t pos, ndone;
Guido van Rossum758eec01998-01-19 21:58:26 +0000378 char *name;
379 PyObject *key, *value, *dict;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000380 PyInterpreterState *interp = PyThreadState_GET()->interp;
Guido van Rossum758eec01998-01-19 21:58:26 +0000381 PyObject *modules = interp->modules;
382
383 if (modules == NULL)
384 return; /* Already done */
385
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000386 /* Delete some special variables first. These are common
387 places where user values hide and people complain when their
388 destructors fail. Since the modules containing them are
389 deleted *last* of all, they would come too late in the normal
390 destruction order. Sigh. */
391
392 value = PyDict_GetItemString(modules, "__builtin__");
393 if (value != NULL && PyModule_Check(value)) {
394 dict = PyModule_GetDict(value);
395 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000396 PySys_WriteStderr("# clear __builtin__._\n");
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000397 PyDict_SetItemString(dict, "_", Py_None);
398 }
399 value = PyDict_GetItemString(modules, "sys");
400 if (value != NULL && PyModule_Check(value)) {
401 char **p;
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000402 PyObject *v;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000403 dict = PyModule_GetDict(value);
404 for (p = sys_deletes; *p != NULL; p++) {
405 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000406 PySys_WriteStderr("# clear sys.%s\n", *p);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000407 PyDict_SetItemString(dict, *p, Py_None);
408 }
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000409 for (p = sys_files; *p != NULL; p+=2) {
410 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000411 PySys_WriteStderr("# restore sys.%s\n", *p);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000412 v = PyDict_GetItemString(dict, *(p+1));
413 if (v == NULL)
414 v = Py_None;
415 PyDict_SetItemString(dict, *p, v);
416 }
417 }
418
419 /* First, delete __main__ */
420 value = PyDict_GetItemString(modules, "__main__");
421 if (value != NULL && PyModule_Check(value)) {
422 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000423 PySys_WriteStderr("# cleanup __main__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000424 _PyModule_Clear(value);
425 PyDict_SetItemString(modules, "__main__", Py_None);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000426 }
427
Guido van Rossum758eec01998-01-19 21:58:26 +0000428 /* The special treatment of __builtin__ here is because even
429 when it's not referenced as a module, its dictionary is
430 referenced by almost every module's __builtins__. Since
431 deleting a module clears its dictionary (even if there are
432 references left to it), we need to delete the __builtin__
433 module last. Likewise, we don't delete sys until the very
434 end because it is implicitly referenced (e.g. by print).
435
436 Also note that we 'delete' modules by replacing their entry
437 in the modules dict with None, rather than really deleting
438 them; this avoids a rehash of the modules dictionary and
439 also marks them as "non existent" so they won't be
440 re-imported. */
441
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000442 /* Next, repeatedly delete modules with a reference count of
Guido van Rossum758eec01998-01-19 21:58:26 +0000443 one (skipping __builtin__ and sys) and delete them */
444 do {
445 ndone = 0;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000446 pos = 0;
Guido van Rossum758eec01998-01-19 21:58:26 +0000447 while (PyDict_Next(modules, &pos, &key, &value)) {
448 if (value->ob_refcnt != 1)
449 continue;
Guido van Rossum566373e1998-10-01 15:24:50 +0000450 if (PyString_Check(key) && PyModule_Check(value)) {
451 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000452 if (strcmp(name, "__builtin__") == 0)
453 continue;
454 if (strcmp(name, "sys") == 0)
455 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000456 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000457 PySys_WriteStderr(
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000458 "# cleanup[1] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000459 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000460 PyDict_SetItem(modules, key, Py_None);
461 ndone++;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000462 }
463 }
Guido van Rossum758eec01998-01-19 21:58:26 +0000464 } while (ndone > 0);
465
Guido van Rossum758eec01998-01-19 21:58:26 +0000466 /* Next, delete all modules (still skipping __builtin__ and sys) */
467 pos = 0;
468 while (PyDict_Next(modules, &pos, &key, &value)) {
Guido van Rossum566373e1998-10-01 15:24:50 +0000469 if (PyString_Check(key) && PyModule_Check(value)) {
470 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000471 if (strcmp(name, "__builtin__") == 0)
472 continue;
473 if (strcmp(name, "sys") == 0)
474 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000475 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000476 PySys_WriteStderr("# cleanup[2] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000477 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000478 PyDict_SetItem(modules, key, Py_None);
479 }
480 }
481
482 /* Next, delete sys and __builtin__ (in that order) */
483 value = PyDict_GetItemString(modules, "sys");
484 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000485 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000486 PySys_WriteStderr("# cleanup sys\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000487 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000488 PyDict_SetItemString(modules, "sys", Py_None);
489 }
490 value = PyDict_GetItemString(modules, "__builtin__");
491 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000492 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000493 PySys_WriteStderr("# cleanup __builtin__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000494 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000495 PyDict_SetItemString(modules, "__builtin__", Py_None);
496 }
497
498 /* Finally, clear and delete the modules directory */
499 PyDict_Clear(modules);
500 interp->modules = NULL;
501 Py_DECREF(modules);
Guido van Rossum8d15b5d1990-10-26 14:58:58 +0000502}
Guido van Rossum7f133ed1991-02-19 12:23:57 +0000503
504
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000505/* Helper for pythonrun.c -- return magic number */
506
507long
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000508PyImport_GetMagicNumber(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000509{
Guido van Rossum96774c12000-05-01 20:19:08 +0000510 return pyc_magic;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000511}
512
513
Guido van Rossum25ce5661997-08-02 03:10:38 +0000514/* Magic for extension modules (built-in as well as dynamically
515 loaded). To prevent initializing an extension module more than
516 once, we keep a static dictionary 'extensions' keyed by module name
517 (for built-in modules) or by filename (for dynamically loaded
Barry Warsaw92883382001-08-13 23:05:44 +0000518 modules), containing these modules. A copy of the module's
Guido van Rossum25ce5661997-08-02 03:10:38 +0000519 dictionary is stored by calling _PyImport_FixupExtension()
520 immediately after the module initialization function succeeds. A
521 copy can be retrieved from there by calling
522 _PyImport_FindExtension(). */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000523
Guido van Rossum79f25d91997-04-29 20:08:16 +0000524PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000525_PyImport_FixupExtension(char *name, char *filename)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000526{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000527 PyObject *modules, *mod, *dict, *copy;
528 if (extensions == NULL) {
529 extensions = PyDict_New();
530 if (extensions == NULL)
531 return NULL;
532 }
533 modules = PyImport_GetModuleDict();
534 mod = PyDict_GetItemString(modules, name);
535 if (mod == NULL || !PyModule_Check(mod)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000536 PyErr_Format(PyExc_SystemError,
537 "_PyImport_FixupExtension: module %.200s not loaded", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000538 return NULL;
539 }
540 dict = PyModule_GetDict(mod);
541 if (dict == NULL)
542 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000543 copy = PyDict_Copy(dict);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000544 if (copy == NULL)
545 return NULL;
546 PyDict_SetItemString(extensions, filename, copy);
547 Py_DECREF(copy);
548 return copy;
549}
550
551PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000552_PyImport_FindExtension(char *name, char *filename)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000553{
Fred Drake9cd0efc2001-10-25 21:38:59 +0000554 PyObject *dict, *mod, *mdict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000555 if (extensions == NULL)
556 return NULL;
557 dict = PyDict_GetItemString(extensions, filename);
558 if (dict == NULL)
559 return NULL;
560 mod = PyImport_AddModule(name);
561 if (mod == NULL)
562 return NULL;
563 mdict = PyModule_GetDict(mod);
564 if (mdict == NULL)
565 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000566 if (PyDict_Update(mdict, dict))
Guido van Rossum25ce5661997-08-02 03:10:38 +0000567 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000568 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000569 PySys_WriteStderr("import %s # previously loaded (%s)\n",
Guido van Rossum25ce5661997-08-02 03:10:38 +0000570 name, filename);
571 return mod;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000572}
573
574
575/* Get the module object corresponding to a module name.
576 First check the modules dictionary if there's one there,
Walter Dörwaldf0dfc7a2003-10-20 14:01:56 +0000577 if not, create a new one and insert it in the modules dictionary.
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000578 Because the former action is most common, THIS DOES NOT RETURN A
579 'NEW' REFERENCE! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000580
Guido van Rossum79f25d91997-04-29 20:08:16 +0000581PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000582PyImport_AddModule(const char *name)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000583{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000584 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000585 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000586
Guido van Rossum25ce5661997-08-02 03:10:38 +0000587 if ((m = PyDict_GetItemString(modules, name)) != NULL &&
Guido van Rossum79f25d91997-04-29 20:08:16 +0000588 PyModule_Check(m))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000589 return m;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000590 m = PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000591 if (m == NULL)
592 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000593 if (PyDict_SetItemString(modules, name, m) != 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000594 Py_DECREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000595 return NULL;
596 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000597 Py_DECREF(m); /* Yes, it still exists, in modules! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000598
599 return m;
600}
601
Tim Peters1cd70172004-08-02 03:52:12 +0000602/* Remove name from sys.modules, if it's there. */
603static void
604_RemoveModule(const char *name)
605{
606 PyObject *modules = PyImport_GetModuleDict();
607 if (PyDict_GetItemString(modules, name) == NULL)
608 return;
609 if (PyDict_DelItemString(modules, name) < 0)
610 Py_FatalError("import: deleting existing key in"
611 "sys.modules failed");
612}
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000613
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000614/* Execute a code object in a module and return the module object
Tim Peters1cd70172004-08-02 03:52:12 +0000615 * WITH INCREMENTED REFERENCE COUNT. If an error occurs, name is
616 * removed from sys.modules, to avoid leaving damaged module objects
617 * in sys.modules. The caller may wish to restore the original
618 * module object (if any) in this case; PyImport_ReloadModule is an
619 * example.
620 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000621PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000622PyImport_ExecCodeModule(char *name, PyObject *co)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000623{
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000624 return PyImport_ExecCodeModuleEx(name, co, (char *)NULL);
625}
626
627PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000628PyImport_ExecCodeModuleEx(char *name, PyObject *co, char *pathname)
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000629{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000630 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000631 PyObject *m, *d, *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000632
Guido van Rossum79f25d91997-04-29 20:08:16 +0000633 m = PyImport_AddModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000634 if (m == NULL)
635 return NULL;
Jeremy Hyltonecd91292004-01-02 23:25:32 +0000636 /* If the module is being reloaded, we get the old module back
637 and re-use its dict to exec the new code. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000638 d = PyModule_GetDict(m);
639 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
640 if (PyDict_SetItemString(d, "__builtins__",
641 PyEval_GetBuiltins()) != 0)
Tim Peters1cd70172004-08-02 03:52:12 +0000642 goto error;
Guido van Rossum6135a871995-01-09 17:53:26 +0000643 }
Guido van Rossum9c9a07c1996-05-16 20:43:40 +0000644 /* Remember the filename as the __file__ attribute */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000645 v = NULL;
646 if (pathname != NULL) {
647 v = PyString_FromString(pathname);
648 if (v == NULL)
649 PyErr_Clear();
650 }
651 if (v == NULL) {
652 v = ((PyCodeObject *)co)->co_filename;
653 Py_INCREF(v);
654 }
655 if (PyDict_SetItemString(d, "__file__", v) != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000656 PyErr_Clear(); /* Not important enough to report */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000657 Py_DECREF(v);
658
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000659 v = PyEval_EvalCode((PyCodeObject *)co, d, d);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000660 if (v == NULL)
Tim Peters1cd70172004-08-02 03:52:12 +0000661 goto error;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000662 Py_DECREF(v);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000663
Guido van Rossum25ce5661997-08-02 03:10:38 +0000664 if ((m = PyDict_GetItemString(modules, name)) == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000665 PyErr_Format(PyExc_ImportError,
666 "Loaded module %.200s not found in sys.modules",
667 name);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000668 return NULL;
669 }
670
Guido van Rossum79f25d91997-04-29 20:08:16 +0000671 Py_INCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000672
673 return m;
Tim Peters1cd70172004-08-02 03:52:12 +0000674
675 error:
676 _RemoveModule(name);
677 return NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000678}
679
680
681/* Given a pathname for a Python source file, fill a buffer with the
682 pathname for the corresponding compiled file. Return the pathname
683 for the compiled file, or NULL if there's no space in the buffer.
684 Doesn't set an exception. */
685
686static char *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000687make_compiled_pathname(char *pathname, char *buf, size_t buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000688{
Tim Petersc1731372001-08-04 08:12:36 +0000689 size_t len = strlen(pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000690 if (len+2 > buflen)
691 return NULL;
Tim Petersc1731372001-08-04 08:12:36 +0000692
Martin v. Löwis6238d2b2002-06-30 15:26:10 +0000693#ifdef MS_WINDOWS
Tim Petersc1731372001-08-04 08:12:36 +0000694 /* Treat .pyw as if it were .py. The case of ".pyw" must match
695 that used in _PyImport_StandardFiletab. */
696 if (len >= 4 && strcmp(&pathname[len-4], ".pyw") == 0)
697 --len; /* pretend 'w' isn't there */
698#endif
699 memcpy(buf, pathname, len);
700 buf[len] = Py_OptimizeFlag ? 'o' : 'c';
701 buf[len+1] = '\0';
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000702
703 return buf;
704}
705
706
707/* Given a pathname for a Python source file, its time of last
708 modification, and a pathname for a compiled file, check whether the
709 compiled file represents the same version of the source. If so,
710 return a FILE pointer for the compiled file, positioned just after
711 the header; if not, return NULL.
712 Doesn't set an exception. */
713
714static FILE *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000715check_compiled_module(char *pathname, time_t mtime, char *cpathname)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000716{
717 FILE *fp;
718 long magic;
719 long pyc_mtime;
720
721 fp = fopen(cpathname, "rb");
722 if (fp == NULL)
723 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000724 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000725 if (magic != pyc_magic) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000726 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000727 PySys_WriteStderr("# %s has bad magic\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000728 fclose(fp);
729 return NULL;
730 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000731 pyc_mtime = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000732 if (pyc_mtime != mtime) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000733 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000734 PySys_WriteStderr("# %s has bad mtime\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000735 fclose(fp);
736 return NULL;
737 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000738 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000739 PySys_WriteStderr("# %s matches %s\n", cpathname, pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000740 return fp;
741}
742
743
744/* Read a code object from a file and check it for validity */
745
Guido van Rossum79f25d91997-04-29 20:08:16 +0000746static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000747read_compiled_module(char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000748{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000749 PyObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000750
Tim Petersd9b9ac82001-01-28 00:27:39 +0000751 co = PyMarshal_ReadLastObjectFromFile(fp);
Armin Rigo01ab2792004-03-26 15:09:27 +0000752 if (co == NULL)
753 return NULL;
754 if (!PyCode_Check(co)) {
755 PyErr_Format(PyExc_ImportError,
756 "Non-code object in %.200s", cpathname);
757 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000758 return NULL;
759 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000760 return (PyCodeObject *)co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000761}
762
763
764/* Load a module from a compiled file, execute it, and return its
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000765 module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000766
Guido van Rossum79f25d91997-04-29 20:08:16 +0000767static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000768load_compiled_module(char *name, char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000769{
770 long magic;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000771 PyCodeObject *co;
772 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000773
Guido van Rossum79f25d91997-04-29 20:08:16 +0000774 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000775 if (magic != pyc_magic) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000776 PyErr_Format(PyExc_ImportError,
777 "Bad magic number in %.200s", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000778 return NULL;
779 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000780 (void) PyMarshal_ReadLongFromFile(fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000781 co = read_compiled_module(cpathname, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000782 if (co == NULL)
783 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000784 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000785 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000786 name, cpathname);
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000787 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000788 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000789
790 return m;
791}
792
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000793/* Parse a source file and return the corresponding code object */
794
Guido van Rossum79f25d91997-04-29 20:08:16 +0000795static PyCodeObject *
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000796parse_source_module(const char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000797{
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000798 PyCodeObject *co = NULL;
799 mod_ty mod;
Neal Norwitz2a399b02006-09-11 04:28:16 +0000800 PyArena *arena = PyArena_New();
801 if (arena == NULL)
802 return NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000803
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000804 mod = PyParser_ASTFromFile(fp, pathname, Py_file_input, 0, 0, 0,
Neal Norwitzadb69fc2005-12-17 20:54:49 +0000805 NULL, arena);
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000806 if (mod) {
Neal Norwitzadb69fc2005-12-17 20:54:49 +0000807 co = PyAST_Compile(mod, pathname, NULL, arena);
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000808 }
Neal Norwitz2a399b02006-09-11 04:28:16 +0000809 PyArena_Free(arena);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000810 return co;
811}
812
813
Guido van Rossum55a83382000-09-20 20:31:38 +0000814/* Helper to open a bytecode file for writing in exclusive mode */
815
816static FILE *
817open_exclusive(char *filename)
818{
819#if defined(O_EXCL)&&defined(O_CREAT)&&defined(O_WRONLY)&&defined(O_TRUNC)
820 /* Use O_EXCL to avoid a race condition when another process tries to
821 write the same file. When that happens, our open() call fails,
822 which is just fine (since it's only a cache).
823 XXX If the file exists and is writable but the directory is not
824 writable, the file will never be written. Oh well.
825 */
826 int fd;
827 (void) unlink(filename);
Tim Peters42c83af2000-09-29 04:03:10 +0000828 fd = open(filename, O_EXCL|O_CREAT|O_WRONLY|O_TRUNC
829#ifdef O_BINARY
830 |O_BINARY /* necessary for Windows */
831#endif
Martin v. Löwis79acb9e2002-12-06 12:48:53 +0000832#ifdef __VMS
Martin v. Löwis18e16552006-02-15 17:27:45 +0000833 , 0666, "ctxt=bin", "shr=nil"
Martin v. Löwis79acb9e2002-12-06 12:48:53 +0000834#else
Martin v. Löwis18e16552006-02-15 17:27:45 +0000835 , 0666
Martin v. Löwis79acb9e2002-12-06 12:48:53 +0000836#endif
Martin v. Löwis18e16552006-02-15 17:27:45 +0000837 );
Guido van Rossum55a83382000-09-20 20:31:38 +0000838 if (fd < 0)
839 return NULL;
840 return fdopen(fd, "wb");
841#else
842 /* Best we can do -- on Windows this can't happen anyway */
843 return fopen(filename, "wb");
844#endif
845}
846
847
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000848/* Write a compiled module to a file, placing the time of last
849 modification of its source into the header.
850 Errors are ignored, if a write error occurs an attempt is made to
851 remove the file. */
852
853static void
Martin v. Löwis18e16552006-02-15 17:27:45 +0000854write_compiled_module(PyCodeObject *co, char *cpathname, time_t mtime)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000855{
856 FILE *fp;
857
Guido van Rossum55a83382000-09-20 20:31:38 +0000858 fp = open_exclusive(cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000859 if (fp == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000860 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000861 PySys_WriteStderr(
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000862 "# can't create %s\n", cpathname);
863 return;
864 }
Martin v. Löwisef82d2f2004-06-27 16:51:46 +0000865 PyMarshal_WriteLongToFile(pyc_magic, fp, Py_MARSHAL_VERSION);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000866 /* First write a 0 for mtime */
Martin v. Löwisef82d2f2004-06-27 16:51:46 +0000867 PyMarshal_WriteLongToFile(0L, fp, Py_MARSHAL_VERSION);
868 PyMarshal_WriteObjectToFile((PyObject *)co, fp, Py_MARSHAL_VERSION);
Armin Rigo01ab2792004-03-26 15:09:27 +0000869 if (fflush(fp) != 0 || ferror(fp)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000870 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000871 PySys_WriteStderr("# can't write %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000872 /* Don't keep partial file */
873 fclose(fp);
874 (void) unlink(cpathname);
875 return;
876 }
877 /* Now write the true mtime */
878 fseek(fp, 4L, 0);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000879 assert(mtime < LONG_MAX);
Martin v. Löwis725507b2006-03-07 12:08:51 +0000880 PyMarshal_WriteLongToFile((long)mtime, fp, Py_MARSHAL_VERSION);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000881 fflush(fp);
882 fclose(fp);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000883 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000884 PySys_WriteStderr("# wrote %s\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000885}
886
887
888/* Load a source module from a given file and return its module
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000889 object WITH INCREMENTED REFERENCE COUNT. If there's a matching
890 byte-compiled file, use that instead. */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000891
Guido van Rossum79f25d91997-04-29 20:08:16 +0000892static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000893load_source_module(char *name, char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000894{
Fred Drake4c82b232000-06-30 16:18:57 +0000895 time_t mtime;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000896 FILE *fpc;
897 char buf[MAXPATHLEN+1];
898 char *cpathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000899 PyCodeObject *co;
900 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000901
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000902 mtime = PyOS_GetLastModificationTime(pathname, fp);
Neal Norwitz708e51a2005-10-03 04:48:15 +0000903 if (mtime == (time_t)(-1)) {
904 PyErr_Format(PyExc_RuntimeError,
905 "unable to get modification time from '%s'",
906 pathname);
Fred Drake4c82b232000-06-30 16:18:57 +0000907 return NULL;
Neal Norwitz708e51a2005-10-03 04:48:15 +0000908 }
Fred Drake4c82b232000-06-30 16:18:57 +0000909#if SIZEOF_TIME_T > 4
910 /* Python's .pyc timestamp handling presumes that the timestamp fits
911 in 4 bytes. This will be fine until sometime in the year 2038,
912 when a 4-byte signed time_t will overflow.
913 */
914 if (mtime >> 32) {
915 PyErr_SetString(PyExc_OverflowError,
Fred Drakec63d3e92001-03-01 06:33:32 +0000916 "modification time overflows a 4 byte field");
Fred Drake4c82b232000-06-30 16:18:57 +0000917 return NULL;
918 }
919#endif
Tim Peters36515e22001-11-18 04:06:29 +0000920 cpathname = make_compiled_pathname(pathname, buf,
Jeremy Hylton37832f02001-04-13 17:50:20 +0000921 (size_t)MAXPATHLEN + 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000922 if (cpathname != NULL &&
923 (fpc = check_compiled_module(pathname, mtime, cpathname))) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000924 co = read_compiled_module(cpathname, fpc);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000925 fclose(fpc);
926 if (co == NULL)
927 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000928 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000929 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000930 name, cpathname);
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000931 pathname = cpathname;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000932 }
933 else {
934 co = parse_source_module(pathname, fp);
935 if (co == NULL)
936 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000937 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000938 PySys_WriteStderr("import %s # from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000939 name, pathname);
Neal Norwitz3cb31ac2006-08-13 18:10:47 +0000940 if (cpathname)
941 write_compiled_module(co, cpathname, mtime);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000942 }
Guido van Rossumafd3dae1998-08-25 18:44:34 +0000943 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, pathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000944 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000945
946 return m;
947}
948
949
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000950/* Forward */
Just van Rossum52e14d62002-12-30 22:08:05 +0000951static PyObject *load_module(char *, FILE *, char *, int, PyObject *);
952static struct filedescr *find_module(char *, char *, PyObject *,
953 char *, size_t, FILE **, PyObject **);
Tim Petersdbd9ba62000-07-09 03:09:57 +0000954static struct _frozen *find_frozen(char *name);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000955
956/* Load a package and return its module object WITH INCREMENTED
957 REFERENCE COUNT */
958
959static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000960load_package(char *name, char *pathname)
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000961{
Tim Peters1cd70172004-08-02 03:52:12 +0000962 PyObject *m, *d;
963 PyObject *file = NULL;
964 PyObject *path = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000965 int err;
966 char buf[MAXPATHLEN+1];
967 FILE *fp = NULL;
968 struct filedescr *fdp;
969
970 m = PyImport_AddModule(name);
971 if (m == NULL)
972 return NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000973 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000974 PySys_WriteStderr("import %s # directory %s\n",
Guido van Rossum17fc85f1997-09-06 18:52:03 +0000975 name, pathname);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000976 d = PyModule_GetDict(m);
977 file = PyString_FromString(pathname);
978 if (file == NULL)
Tim Peters1cd70172004-08-02 03:52:12 +0000979 goto error;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000980 path = Py_BuildValue("[O]", file);
Tim Peters1cd70172004-08-02 03:52:12 +0000981 if (path == NULL)
982 goto error;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000983 err = PyDict_SetItemString(d, "__file__", file);
984 if (err == 0)
985 err = PyDict_SetItemString(d, "__path__", path);
Tim Peters1cd70172004-08-02 03:52:12 +0000986 if (err != 0)
987 goto error;
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000988 buf[0] = '\0';
Just van Rossum52e14d62002-12-30 22:08:05 +0000989 fdp = find_module(name, "__init__", path, buf, sizeof(buf), &fp, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000990 if (fdp == NULL) {
991 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
992 PyErr_Clear();
Thomas Heller25653242004-06-07 15:04:10 +0000993 Py_INCREF(m);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000994 }
995 else
996 m = NULL;
997 goto cleanup;
998 }
Just van Rossum52e14d62002-12-30 22:08:05 +0000999 m = load_module(name, fp, buf, fdp->type, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001000 if (fp != NULL)
1001 fclose(fp);
Tim Peters1cd70172004-08-02 03:52:12 +00001002 goto cleanup;
1003
1004 error:
1005 m = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001006 cleanup:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001007 Py_XDECREF(path);
1008 Py_XDECREF(file);
1009 return m;
1010}
1011
1012
1013/* Helper to test for built-in module */
1014
1015static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001016is_builtin(char *name)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001017{
1018 int i;
Guido van Rossum771c6c81997-10-31 18:37:24 +00001019 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
1020 if (strcmp(name, PyImport_Inittab[i].name) == 0) {
1021 if (PyImport_Inittab[i].initfunc == NULL)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001022 return -1;
1023 else
1024 return 1;
1025 }
1026 }
1027 return 0;
1028}
1029
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001030
Just van Rossum52e14d62002-12-30 22:08:05 +00001031/* Return an importer object for a sys.path/pkg.__path__ item 'p',
1032 possibly by fetching it from the path_importer_cache dict. If it
Brett Cannon94b69f62006-09-28 22:10:14 +00001033 wasn't yet cached, traverse path_hooks until a hook is found
Just van Rossum52e14d62002-12-30 22:08:05 +00001034 that can handle the path item. Return None if no hook could;
1035 this tells our caller it should fall back to the builtin
1036 import mechanism. Cache the result in path_importer_cache.
1037 Returns a borrowed reference. */
1038
1039static PyObject *
1040get_path_importer(PyObject *path_importer_cache, PyObject *path_hooks,
1041 PyObject *p)
1042{
1043 PyObject *importer;
Martin v. Löwis725507b2006-03-07 12:08:51 +00001044 Py_ssize_t j, nhooks;
Just van Rossum52e14d62002-12-30 22:08:05 +00001045
1046 /* These conditions are the caller's responsibility: */
1047 assert(PyList_Check(path_hooks));
1048 assert(PyDict_Check(path_importer_cache));
1049
1050 nhooks = PyList_Size(path_hooks);
1051 if (nhooks < 0)
1052 return NULL; /* Shouldn't happen */
1053
1054 importer = PyDict_GetItem(path_importer_cache, p);
1055 if (importer != NULL)
1056 return importer;
1057
1058 /* set path_importer_cache[p] to None to avoid recursion */
1059 if (PyDict_SetItem(path_importer_cache, p, Py_None) != 0)
1060 return NULL;
1061
1062 for (j = 0; j < nhooks; j++) {
1063 PyObject *hook = PyList_GetItem(path_hooks, j);
1064 if (hook == NULL)
1065 return NULL;
Georg Brandl684fd0c2006-05-25 19:15:31 +00001066 importer = PyObject_CallFunctionObjArgs(hook, p, NULL);
Just van Rossum52e14d62002-12-30 22:08:05 +00001067 if (importer != NULL)
1068 break;
1069
1070 if (!PyErr_ExceptionMatches(PyExc_ImportError)) {
1071 return NULL;
1072 }
1073 PyErr_Clear();
1074 }
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00001075 if (importer == NULL) {
1076 importer = PyObject_CallFunctionObjArgs(
1077 (PyObject *)&NullImporterType, p, NULL
1078 );
1079 if (importer == NULL) {
1080 if (PyErr_ExceptionMatches(PyExc_ImportError)) {
1081 PyErr_Clear();
1082 return Py_None;
1083 }
1084 }
1085 }
1086 if (importer != NULL) {
Just van Rossum52e14d62002-12-30 22:08:05 +00001087 int err = PyDict_SetItem(path_importer_cache, p, importer);
1088 Py_DECREF(importer);
1089 if (err != 0)
1090 return NULL;
1091 }
1092 return importer;
1093}
1094
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001095/* Search the path (default sys.path) for a module. Return the
1096 corresponding filedescr struct, and (via return arguments) the
1097 pathname and an open file. Return NULL if the module is not found. */
1098
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001099#ifdef MS_COREDLL
Thomas Woutersb4bd21c2000-07-22 23:38:01 +00001100extern FILE *PyWin_FindRegisteredModule(const char *, struct filedescr **,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001101 char *, Py_ssize_t);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001102#endif
1103
Martin v. Löwis18e16552006-02-15 17:27:45 +00001104static int case_ok(char *, Py_ssize_t, Py_ssize_t, char *);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001105static int find_init_module(char *); /* Forward */
Just van Rossum52e14d62002-12-30 22:08:05 +00001106static struct filedescr importhookdescr = {"", "", IMP_HOOK};
Guido van Rossum197346f1997-10-31 18:38:52 +00001107
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001108static struct filedescr *
Just van Rossum52e14d62002-12-30 22:08:05 +00001109find_module(char *fullname, char *subname, PyObject *path, char *buf,
1110 size_t buflen, FILE **p_fp, PyObject **p_loader)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001111{
Martin v. Löwis725507b2006-03-07 12:08:51 +00001112 Py_ssize_t i, npath;
Fred Drake4c82b232000-06-30 16:18:57 +00001113 size_t len, namelen;
Guido van Rossum80bb9651996-12-05 23:27:02 +00001114 struct filedescr *fdp = NULL;
Jack Jansenc88da1f2002-05-28 10:58:19 +00001115 char *filemode;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001116 FILE *fp = NULL;
Just van Rossum52e14d62002-12-30 22:08:05 +00001117 PyObject *path_hooks, *path_importer_cache;
Guido van Rossum48a680c2001-03-02 06:34:14 +00001118#ifndef RISCOS
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001119 struct stat statbuf;
Guido van Rossum48a680c2001-03-02 06:34:14 +00001120#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +00001121 static struct filedescr fd_frozen = {"", "", PY_FROZEN};
1122 static struct filedescr fd_builtin = {"", "", C_BUILTIN};
1123 static struct filedescr fd_package = {"", "", PKG_DIRECTORY};
Guido van Rossum0506a431998-08-11 15:07:39 +00001124 char name[MAXPATHLEN+1];
Andrew MacIntyred9400542002-02-26 11:41:34 +00001125#if defined(PYOS_OS2)
1126 size_t saved_len;
1127 size_t saved_namelen;
1128 char *saved_buf = NULL;
1129#endif
Just van Rossum52e14d62002-12-30 22:08:05 +00001130 if (p_loader != NULL)
1131 *p_loader = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001132
Just van Rossum52e14d62002-12-30 22:08:05 +00001133 if (strlen(subname) > MAXPATHLEN) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001134 PyErr_SetString(PyExc_OverflowError,
1135 "module name is too long");
Fred Drake4c82b232000-06-30 16:18:57 +00001136 return NULL;
1137 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001138 strcpy(name, subname);
1139
1140 /* sys.meta_path import hook */
1141 if (p_loader != NULL) {
1142 PyObject *meta_path;
1143
1144 meta_path = PySys_GetObject("meta_path");
1145 if (meta_path == NULL || !PyList_Check(meta_path)) {
1146 PyErr_SetString(PyExc_ImportError,
1147 "sys.meta_path must be a list of "
1148 "import hooks");
1149 return NULL;
1150 }
1151 Py_INCREF(meta_path); /* zap guard */
1152 npath = PyList_Size(meta_path);
1153 for (i = 0; i < npath; i++) {
1154 PyObject *loader;
1155 PyObject *hook = PyList_GetItem(meta_path, i);
1156 loader = PyObject_CallMethod(hook, "find_module",
1157 "sO", fullname,
1158 path != NULL ?
1159 path : Py_None);
1160 if (loader == NULL) {
1161 Py_DECREF(meta_path);
1162 return NULL; /* true error */
1163 }
1164 if (loader != Py_None) {
1165 /* a loader was found */
1166 *p_loader = loader;
1167 Py_DECREF(meta_path);
1168 return &importhookdescr;
1169 }
1170 Py_DECREF(loader);
1171 }
1172 Py_DECREF(meta_path);
1173 }
Guido van Rossum0506a431998-08-11 15:07:39 +00001174
1175 if (path != NULL && PyString_Check(path)) {
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001176 /* The only type of submodule allowed inside a "frozen"
1177 package are other frozen modules or packages. */
Guido van Rossum0506a431998-08-11 15:07:39 +00001178 if (PyString_Size(path) + 1 + strlen(name) >= (size_t)buflen) {
1179 PyErr_SetString(PyExc_ImportError,
1180 "full frozen module name too long");
1181 return NULL;
1182 }
1183 strcpy(buf, PyString_AsString(path));
1184 strcat(buf, ".");
1185 strcat(buf, name);
1186 strcpy(name, buf);
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001187 if (find_frozen(name) != NULL) {
1188 strcpy(buf, name);
1189 return &fd_frozen;
1190 }
1191 PyErr_Format(PyExc_ImportError,
1192 "No frozen submodule named %.200s", name);
1193 return NULL;
Guido van Rossum0506a431998-08-11 15:07:39 +00001194 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001195 if (path == NULL) {
1196 if (is_builtin(name)) {
Guido van Rossuma5568d31998-03-05 03:45:08 +00001197 strcpy(buf, name);
1198 return &fd_builtin;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001199 }
Greg Ward201baee2001-10-04 14:52:06 +00001200 if ((find_frozen(name)) != NULL) {
Guido van Rossuma5568d31998-03-05 03:45:08 +00001201 strcpy(buf, name);
1202 return &fd_frozen;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001203 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001204
Guido van Rossumac279101996-08-22 23:10:58 +00001205#ifdef MS_COREDLL
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001206 fp = PyWin_FindRegisteredModule(name, &fdp, buf, buflen);
1207 if (fp != NULL) {
1208 *p_fp = fp;
1209 return fdp;
1210 }
Guido van Rossuma5a3db71996-04-09 02:39:59 +00001211#endif
Guido van Rossuma5568d31998-03-05 03:45:08 +00001212 path = PySys_GetObject("path");
1213 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001214 if (path == NULL || !PyList_Check(path)) {
1215 PyErr_SetString(PyExc_ImportError,
Guido van Rossuma5568d31998-03-05 03:45:08 +00001216 "sys.path must be a list of directory names");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001217 return NULL;
1218 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001219
1220 path_hooks = PySys_GetObject("path_hooks");
1221 if (path_hooks == NULL || !PyList_Check(path_hooks)) {
1222 PyErr_SetString(PyExc_ImportError,
1223 "sys.path_hooks must be a list of "
1224 "import hooks");
1225 return NULL;
1226 }
1227 path_importer_cache = PySys_GetObject("path_importer_cache");
1228 if (path_importer_cache == NULL ||
1229 !PyDict_Check(path_importer_cache)) {
1230 PyErr_SetString(PyExc_ImportError,
1231 "sys.path_importer_cache must be a dict");
1232 return NULL;
1233 }
1234
Guido van Rossum79f25d91997-04-29 20:08:16 +00001235 npath = PyList_Size(path);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001236 namelen = strlen(name);
1237 for (i = 0; i < npath; i++) {
Walter Dörwald3430d702002-06-17 10:43:59 +00001238 PyObject *copy = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001239 PyObject *v = PyList_GetItem(path, i);
Neal Norwitz3cb31ac2006-08-13 18:10:47 +00001240 if (!v)
1241 return NULL;
Walter Dörwald3430d702002-06-17 10:43:59 +00001242#ifdef Py_USING_UNICODE
1243 if (PyUnicode_Check(v)) {
1244 copy = PyUnicode_Encode(PyUnicode_AS_UNICODE(v),
1245 PyUnicode_GET_SIZE(v), Py_FileSystemDefaultEncoding, NULL);
1246 if (copy == NULL)
1247 return NULL;
1248 v = copy;
1249 }
1250 else
1251#endif
Guido van Rossum79f25d91997-04-29 20:08:16 +00001252 if (!PyString_Check(v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001253 continue;
Neal Norwitz2aa9a5d2006-03-20 01:53:23 +00001254 len = PyString_GET_SIZE(v);
Walter Dörwald3430d702002-06-17 10:43:59 +00001255 if (len + 2 + namelen + MAXSUFFIXSIZE >= buflen) {
1256 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001257 continue; /* Too long */
Walter Dörwald3430d702002-06-17 10:43:59 +00001258 }
Neal Norwitz2aa9a5d2006-03-20 01:53:23 +00001259 strcpy(buf, PyString_AS_STRING(v));
Walter Dörwald3430d702002-06-17 10:43:59 +00001260 if (strlen(buf) != len) {
1261 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001262 continue; /* v contains '\0' */
Walter Dörwald3430d702002-06-17 10:43:59 +00001263 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001264
1265 /* sys.path_hooks import hook */
1266 if (p_loader != NULL) {
1267 PyObject *importer;
1268
1269 importer = get_path_importer(path_importer_cache,
1270 path_hooks, v);
Neal Norwitza4df11d2006-07-06 04:28:59 +00001271 if (importer == NULL) {
1272 Py_XDECREF(copy);
Just van Rossum52e14d62002-12-30 22:08:05 +00001273 return NULL;
Neal Norwitza4df11d2006-07-06 04:28:59 +00001274 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001275 /* Note: importer is a borrowed reference */
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00001276 if (importer != Py_None) {
Just van Rossum52e14d62002-12-30 22:08:05 +00001277 PyObject *loader;
1278 loader = PyObject_CallMethod(importer,
1279 "find_module",
1280 "s", fullname);
Neal Norwitza4df11d2006-07-06 04:28:59 +00001281 Py_XDECREF(copy);
Just van Rossum52e14d62002-12-30 22:08:05 +00001282 if (loader == NULL)
1283 return NULL; /* error */
1284 if (loader != Py_None) {
1285 /* a loader was found */
1286 *p_loader = loader;
1287 return &importhookdescr;
1288 }
1289 Py_DECREF(loader);
Georg Brandlf4ef1162006-05-26 18:03:31 +00001290 continue;
Just van Rossum52e14d62002-12-30 22:08:05 +00001291 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001292 }
Georg Brandlf4ef1162006-05-26 18:03:31 +00001293 /* no hook was found, use builtin import */
Just van Rossum52e14d62002-12-30 22:08:05 +00001294
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001295 if (len > 0 && buf[len-1] != SEP
1296#ifdef ALTSEP
1297 && buf[len-1] != ALTSEP
1298#endif
1299 )
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001300 buf[len++] = SEP;
Guido van Rossum215c3402000-11-13 17:26:32 +00001301 strcpy(buf+len, name);
1302 len += namelen;
Tim Peters50d8d372001-02-28 05:34:27 +00001303
1304 /* Check for package import (buf holds a directory name,
1305 and there's an __init__ module in that directory */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001306#ifdef HAVE_STAT
Walter Dörwald3430d702002-06-17 10:43:59 +00001307 if (stat(buf, &statbuf) == 0 && /* it exists */
1308 S_ISDIR(statbuf.st_mode) && /* it's a directory */
Thomas Wouters9df4e6f2006-04-27 23:13:20 +00001309 case_ok(buf, len, namelen, name)) { /* case matches */
1310 if (find_init_module(buf)) { /* and has __init__.py */
1311 Py_XDECREF(copy);
1312 return &fd_package;
1313 }
1314 else {
1315 char warnstr[MAXPATHLEN+80];
1316 sprintf(warnstr, "Not importing directory "
1317 "'%.*s': missing __init__.py",
1318 MAXPATHLEN, buf);
1319 if (PyErr_Warn(PyExc_ImportWarning,
1320 warnstr)) {
1321 Py_XDECREF(copy);
1322 return NULL;
1323 }
1324 }
Walter Dörwald3430d702002-06-17 10:43:59 +00001325 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001326#else
1327 /* XXX How are you going to test for directories? */
Guido van Rossum48a680c2001-03-02 06:34:14 +00001328#ifdef RISCOS
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001329 if (isdir(buf) &&
Walter Dörwald3430d702002-06-17 10:43:59 +00001330 case_ok(buf, len, namelen, name)) {
Thomas Wouters9df4e6f2006-04-27 23:13:20 +00001331 if (find_init_module(buf)) {
1332 Py_XDECREF(copy);
1333 return &fd_package;
1334 }
1335 else {
1336 char warnstr[MAXPATHLEN+80];
1337 sprintf(warnstr, "Not importing directory "
1338 "'%.*s': missing __init__.py",
1339 MAXPATHLEN, buf);
1340 if (PyErr_Warn(PyExc_ImportWarning,
1341 warnstr)) {
1342 Py_XDECREF(copy);
1343 return NULL;
1344 }
Walter Dörwald3430d702002-06-17 10:43:59 +00001345 }
Guido van Rossum48a680c2001-03-02 06:34:14 +00001346#endif
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001347#endif
Andrew MacIntyred9400542002-02-26 11:41:34 +00001348#if defined(PYOS_OS2)
1349 /* take a snapshot of the module spec for restoration
1350 * after the 8 character DLL hackery
1351 */
1352 saved_buf = strdup(buf);
1353 saved_len = len;
1354 saved_namelen = namelen;
1355#endif /* PYOS_OS2 */
Guido van Rossum79f25d91997-04-29 20:08:16 +00001356 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
Andrew MacIntyred9400542002-02-26 11:41:34 +00001357#if defined(PYOS_OS2)
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001358 /* OS/2 limits DLLs to 8 character names (w/o
1359 extension)
Andrew MacIntyred9400542002-02-26 11:41:34 +00001360 * so if the name is longer than that and its a
1361 * dynamically loaded module we're going to try,
1362 * truncate the name before trying
1363 */
Just van Rossum52e14d62002-12-30 22:08:05 +00001364 if (strlen(subname) > 8) {
Andrew MacIntyred9400542002-02-26 11:41:34 +00001365 /* is this an attempt to load a C extension? */
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001366 const struct filedescr *scan;
1367 scan = _PyImport_DynLoadFiletab;
Andrew MacIntyred9400542002-02-26 11:41:34 +00001368 while (scan->suffix != NULL) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001369 if (!strcmp(scan->suffix, fdp->suffix))
Andrew MacIntyred9400542002-02-26 11:41:34 +00001370 break;
1371 else
1372 scan++;
1373 }
1374 if (scan->suffix != NULL) {
1375 /* yes, so truncate the name */
1376 namelen = 8;
Just van Rossum52e14d62002-12-30 22:08:05 +00001377 len -= strlen(subname) - namelen;
Andrew MacIntyred9400542002-02-26 11:41:34 +00001378 buf[len] = '\0';
1379 }
1380 }
1381#endif /* PYOS_OS2 */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001382 strcpy(buf+len, fdp->suffix);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001383 if (Py_VerboseFlag > 1)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001384 PySys_WriteStderr("# trying %s\n", buf);
Jack Jansenc88da1f2002-05-28 10:58:19 +00001385 filemode = fdp->mode;
Tim Peters86c7d2f2004-08-01 23:24:21 +00001386 if (filemode[0] == 'U')
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00001387 filemode = "r" PY_STDIOTEXTMODE;
Jack Jansenc88da1f2002-05-28 10:58:19 +00001388 fp = fopen(buf, filemode);
Tim Peters50d8d372001-02-28 05:34:27 +00001389 if (fp != NULL) {
1390 if (case_ok(buf, len, namelen, name))
1391 break;
1392 else { /* continue search */
1393 fclose(fp);
1394 fp = NULL;
Barry Warsaw914a0b12001-02-02 19:12:16 +00001395 }
Barry Warsaw914a0b12001-02-02 19:12:16 +00001396 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001397#if defined(PYOS_OS2)
1398 /* restore the saved snapshot */
1399 strcpy(buf, saved_buf);
1400 len = saved_len;
1401 namelen = saved_namelen;
1402#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001403 }
Andrew MacIntyred9400542002-02-26 11:41:34 +00001404#if defined(PYOS_OS2)
1405 /* don't need/want the module name snapshot anymore */
1406 if (saved_buf)
1407 {
1408 free(saved_buf);
1409 saved_buf = NULL;
1410 }
1411#endif
Walter Dörwald3430d702002-06-17 10:43:59 +00001412 Py_XDECREF(copy);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001413 if (fp != NULL)
1414 break;
1415 }
1416 if (fp == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001417 PyErr_Format(PyExc_ImportError,
1418 "No module named %.200s", name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001419 return NULL;
1420 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001421 *p_fp = fp;
1422 return fdp;
1423}
1424
Raymond Hettingerdb29e0f2004-10-07 06:46:25 +00001425/* Helpers for main.c
1426 * Find the source file corresponding to a named module
1427 */
1428struct filedescr *
1429_PyImport_FindModule(const char *name, PyObject *path, char *buf,
1430 size_t buflen, FILE **p_fp, PyObject **p_loader)
1431{
1432 return find_module((char *) name, (char *) name, path,
1433 buf, buflen, p_fp, p_loader);
1434}
1435
1436PyAPI_FUNC(int) _PyImport_IsScript(struct filedescr * fd)
1437{
1438 return fd->type == PY_SOURCE || fd->type == PY_COMPILED;
1439}
1440
Martin v. Löwis18e16552006-02-15 17:27:45 +00001441/* case_ok(char* buf, Py_ssize_t len, Py_ssize_t namelen, char* name)
Tim Petersd1e87a82001-03-01 18:12:00 +00001442 * The arguments here are tricky, best shown by example:
1443 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1444 * ^ ^ ^ ^
1445 * |--------------------- buf ---------------------|
1446 * |------------------- len ------------------|
1447 * |------ name -------|
1448 * |----- namelen -----|
1449 * buf is the full path, but len only counts up to (& exclusive of) the
1450 * extension. name is the module name, also exclusive of extension.
1451 *
1452 * We've already done a successful stat() or fopen() on buf, so know that
1453 * there's some match, possibly case-insensitive.
1454 *
Tim Peters50d8d372001-02-28 05:34:27 +00001455 * case_ok() is to return 1 if there's a case-sensitive match for
1456 * name, else 0. case_ok() is also to return 1 if envar PYTHONCASEOK
1457 * exists.
Tim Petersd1e87a82001-03-01 18:12:00 +00001458 *
Tim Peters50d8d372001-02-28 05:34:27 +00001459 * case_ok() is used to implement case-sensitive import semantics even
1460 * on platforms with case-insensitive filesystems. It's trivial to implement
1461 * for case-sensitive filesystems. It's pretty much a cross-platform
1462 * nightmare for systems with case-insensitive filesystems.
1463 */
Guido van Rossum0980bd91998-02-13 17:18:36 +00001464
Tim Peters50d8d372001-02-28 05:34:27 +00001465/* First we may need a pile of platform-specific header files; the sequence
1466 * of #if's here should match the sequence in the body of case_ok().
1467 */
Jason Tishler7961aa62005-05-20 00:56:54 +00001468#if defined(MS_WINDOWS)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001469#include <windows.h>
Guido van Rossum4c3f57c2001-01-10 20:40:46 +00001470
Tim Peters50d8d372001-02-28 05:34:27 +00001471#elif defined(DJGPP)
1472#include <dir.h>
1473
Jason Tishler7961aa62005-05-20 00:56:54 +00001474#elif (defined(__MACH__) && defined(__APPLE__) || defined(__CYGWIN__)) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001475#include <sys/types.h>
1476#include <dirent.h>
1477
Andrew MacIntyred9400542002-02-26 11:41:34 +00001478#elif defined(PYOS_OS2)
1479#define INCL_DOS
1480#define INCL_DOSERRORS
1481#define INCL_NOPMAPI
1482#include <os2.h>
1483
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001484#elif defined(RISCOS)
1485#include "oslib/osfscontrol.h"
Tim Peters50d8d372001-02-28 05:34:27 +00001486#endif
1487
Guido van Rossum0980bd91998-02-13 17:18:36 +00001488static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00001489case_ok(char *buf, Py_ssize_t len, Py_ssize_t namelen, char *name)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001490{
Tim Peters50d8d372001-02-28 05:34:27 +00001491/* Pick a platform-specific implementation; the sequence of #if's here should
1492 * match the sequence just above.
1493 */
1494
Jason Tishler7961aa62005-05-20 00:56:54 +00001495/* MS_WINDOWS */
1496#if defined(MS_WINDOWS)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001497 WIN32_FIND_DATA data;
1498 HANDLE h;
Tim Peters50d8d372001-02-28 05:34:27 +00001499
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001500 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum0980bd91998-02-13 17:18:36 +00001501 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001502
Guido van Rossum0980bd91998-02-13 17:18:36 +00001503 h = FindFirstFile(buf, &data);
1504 if (h == INVALID_HANDLE_VALUE) {
1505 PyErr_Format(PyExc_NameError,
1506 "Can't find file for module %.100s\n(filename %.300s)",
1507 name, buf);
1508 return 0;
1509 }
1510 FindClose(h);
Tim Peters50d8d372001-02-28 05:34:27 +00001511 return strncmp(data.cFileName, name, namelen) == 0;
1512
1513/* DJGPP */
1514#elif defined(DJGPP)
1515 struct ffblk ffblk;
1516 int done;
1517
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001518 if (Py_GETENV("PYTHONCASEOK") != NULL)
Guido van Rossum323bf5e1998-06-24 03:54:06 +00001519 return 1;
Tim Peters50d8d372001-02-28 05:34:27 +00001520
1521 done = findfirst(buf, &ffblk, FA_ARCH|FA_RDONLY|FA_HIDDEN|FA_DIREC);
1522 if (done) {
Guido van Rossum0980bd91998-02-13 17:18:36 +00001523 PyErr_Format(PyExc_NameError,
Tim Peters50d8d372001-02-28 05:34:27 +00001524 "Can't find file for module %.100s\n(filename %.300s)",
Guido van Rossum0980bd91998-02-13 17:18:36 +00001525 name, buf);
1526 return 0;
1527 }
Tim Peters50d8d372001-02-28 05:34:27 +00001528 return strncmp(ffblk.ff_name, name, namelen) == 0;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001529
Jason Tishler7961aa62005-05-20 00:56:54 +00001530/* new-fangled macintosh (macosx) or Cygwin */
1531#elif (defined(__MACH__) && defined(__APPLE__) || defined(__CYGWIN__)) && defined(HAVE_DIRENT_H)
Tim Peters430f5d42001-03-01 01:30:56 +00001532 DIR *dirp;
1533 struct dirent *dp;
Tim Petersd1e87a82001-03-01 18:12:00 +00001534 char dirname[MAXPATHLEN + 1];
1535 const int dirlen = len - namelen - 1; /* don't want trailing SEP */
Tim Peters430f5d42001-03-01 01:30:56 +00001536
Neil Schemenauer7d4bb9f2001-07-23 16:30:27 +00001537 if (Py_GETENV("PYTHONCASEOK") != NULL)
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001538 return 1;
1539
Tim Petersd1e87a82001-03-01 18:12:00 +00001540 /* Copy the dir component into dirname; substitute "." if empty */
1541 if (dirlen <= 0) {
1542 dirname[0] = '.';
1543 dirname[1] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001544 }
1545 else {
Tim Petersd1e87a82001-03-01 18:12:00 +00001546 assert(dirlen <= MAXPATHLEN);
1547 memcpy(dirname, buf, dirlen);
1548 dirname[dirlen] = '\0';
Tim Peters430f5d42001-03-01 01:30:56 +00001549 }
1550 /* Open the directory and search the entries for an exact match. */
Tim Petersd1e87a82001-03-01 18:12:00 +00001551 dirp = opendir(dirname);
Tim Peters430f5d42001-03-01 01:30:56 +00001552 if (dirp) {
Tim Peters677898a2001-03-02 03:28:03 +00001553 char *nameWithExt = buf + len - namelen;
Tim Peters430f5d42001-03-01 01:30:56 +00001554 while ((dp = readdir(dirp)) != NULL) {
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001555 const int thislen =
Tim Peters430f5d42001-03-01 01:30:56 +00001556#ifdef _DIRENT_HAVE_D_NAMELEN
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001557 dp->d_namlen;
Tim Peters430f5d42001-03-01 01:30:56 +00001558#else
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001559 strlen(dp->d_name);
Tim Peters430f5d42001-03-01 01:30:56 +00001560#endif
Tim Petersd1e87a82001-03-01 18:12:00 +00001561 if (thislen >= namelen &&
Tim Peters677898a2001-03-02 03:28:03 +00001562 strcmp(dp->d_name, nameWithExt) == 0) {
Tim Peters430f5d42001-03-01 01:30:56 +00001563 (void)closedir(dirp);
1564 return 1; /* Found */
1565 }
1566 }
Tim Petersdbe6ebb2001-03-01 08:47:29 +00001567 (void)closedir(dirp);
Tim Peters430f5d42001-03-01 01:30:56 +00001568 }
Tim Peters430f5d42001-03-01 01:30:56 +00001569 return 0 ; /* Not found */
Tim Peters430f5d42001-03-01 01:30:56 +00001570
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001571/* RISC OS */
1572#elif defined(RISCOS)
1573 char canon[MAXPATHLEN+1]; /* buffer for the canonical form of the path */
1574 char buf2[MAXPATHLEN+2];
1575 char *nameWithExt = buf+len-namelen;
1576 int canonlen;
1577 os_error *e;
1578
1579 if (Py_GETENV("PYTHONCASEOK") != NULL)
1580 return 1;
1581
1582 /* workaround:
1583 append wildcard, otherwise case of filename wouldn't be touched */
1584 strcpy(buf2, buf);
1585 strcat(buf2, "*");
1586
1587 e = xosfscontrol_canonicalise_path(buf2,canon,0,0,MAXPATHLEN+1,&canonlen);
1588 canonlen = MAXPATHLEN+1-canonlen;
1589 if (e || canonlen<=0 || canonlen>(MAXPATHLEN+1) )
1590 return 0;
1591 if (strcmp(nameWithExt, canon+canonlen-strlen(nameWithExt))==0)
1592 return 1; /* match */
1593
1594 return 0;
1595
Andrew MacIntyred9400542002-02-26 11:41:34 +00001596/* OS/2 */
1597#elif defined(PYOS_OS2)
1598 HDIR hdir = 1;
1599 ULONG srchcnt = 1;
1600 FILEFINDBUF3 ffbuf;
1601 APIRET rc;
1602
1603 if (getenv("PYTHONCASEOK") != NULL)
1604 return 1;
1605
1606 rc = DosFindFirst(buf,
1607 &hdir,
1608 FILE_READONLY | FILE_HIDDEN | FILE_SYSTEM | FILE_DIRECTORY,
1609 &ffbuf, sizeof(ffbuf),
1610 &srchcnt,
1611 FIL_STANDARD);
1612 if (rc != NO_ERROR)
1613 return 0;
1614 return strncmp(ffbuf.achName, name, namelen) == 0;
1615
Tim Peters50d8d372001-02-28 05:34:27 +00001616/* assuming it's a case-sensitive filesystem, so there's nothing to do! */
1617#else
Guido van Rossum0980bd91998-02-13 17:18:36 +00001618 return 1;
Guido van Rossum0980bd91998-02-13 17:18:36 +00001619
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001620#endif
Tim Peters50d8d372001-02-28 05:34:27 +00001621}
Guido van Rossum4d1b3b91998-02-13 23:27:59 +00001622
Guido van Rossum0980bd91998-02-13 17:18:36 +00001623
Guido van Rossum197346f1997-10-31 18:38:52 +00001624#ifdef HAVE_STAT
1625/* Helper to look for __init__.py or __init__.py[co] in potential package */
1626static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001627find_init_module(char *buf)
Guido van Rossum197346f1997-10-31 18:38:52 +00001628{
Tim Peters0f9431f2001-07-05 03:47:53 +00001629 const size_t save_len = strlen(buf);
Fred Drake4c82b232000-06-30 16:18:57 +00001630 size_t i = save_len;
Tim Peters0f9431f2001-07-05 03:47:53 +00001631 char *pname; /* pointer to start of __init__ */
Guido van Rossum197346f1997-10-31 18:38:52 +00001632 struct stat statbuf;
1633
Tim Peters0f9431f2001-07-05 03:47:53 +00001634/* For calling case_ok(buf, len, namelen, name):
1635 * /a/b/c/d/e/f/g/h/i/j/k/some_long_module_name.py\0
1636 * ^ ^ ^ ^
1637 * |--------------------- buf ---------------------|
1638 * |------------------- len ------------------|
1639 * |------ name -------|
1640 * |----- namelen -----|
1641 */
Guido van Rossum197346f1997-10-31 18:38:52 +00001642 if (save_len + 13 >= MAXPATHLEN)
1643 return 0;
1644 buf[i++] = SEP;
Tim Peters0f9431f2001-07-05 03:47:53 +00001645 pname = buf + i;
1646 strcpy(pname, "__init__.py");
Guido van Rossum197346f1997-10-31 18:38:52 +00001647 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001648 if (case_ok(buf,
1649 save_len + 9, /* len("/__init__") */
1650 8, /* len("__init__") */
1651 pname)) {
1652 buf[save_len] = '\0';
1653 return 1;
1654 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001655 }
Tim Peters0f9431f2001-07-05 03:47:53 +00001656 i += strlen(pname);
1657 strcpy(buf+i, Py_OptimizeFlag ? "o" : "c");
Guido van Rossum197346f1997-10-31 18:38:52 +00001658 if (stat(buf, &statbuf) == 0) {
Tim Peters0f9431f2001-07-05 03:47:53 +00001659 if (case_ok(buf,
1660 save_len + 9, /* len("/__init__") */
1661 8, /* len("__init__") */
1662 pname)) {
1663 buf[save_len] = '\0';
1664 return 1;
1665 }
Guido van Rossum197346f1997-10-31 18:38:52 +00001666 }
1667 buf[save_len] = '\0';
1668 return 0;
1669}
Guido van Rossum48a680c2001-03-02 06:34:14 +00001670
1671#else
1672
1673#ifdef RISCOS
1674static int
1675find_init_module(buf)
1676 char *buf;
1677{
1678 int save_len = strlen(buf);
1679 int i = save_len;
1680
1681 if (save_len + 13 >= MAXPATHLEN)
1682 return 0;
1683 buf[i++] = SEP;
1684 strcpy(buf+i, "__init__/py");
1685 if (isfile(buf)) {
1686 buf[save_len] = '\0';
1687 return 1;
1688 }
1689
1690 if (Py_OptimizeFlag)
1691 strcpy(buf+i, "o");
1692 else
1693 strcpy(buf+i, "c");
1694 if (isfile(buf)) {
1695 buf[save_len] = '\0';
1696 return 1;
1697 }
1698 buf[save_len] = '\0';
1699 return 0;
1700}
1701#endif /*RISCOS*/
1702
Guido van Rossum197346f1997-10-31 18:38:52 +00001703#endif /* HAVE_STAT */
1704
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001705
Tim Petersdbd9ba62000-07-09 03:09:57 +00001706static int init_builtin(char *); /* Forward */
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001707
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001708/* Load an external module using the default search path and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001709 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001710
Guido van Rossum79f25d91997-04-29 20:08:16 +00001711static PyObject *
Just van Rossum52e14d62002-12-30 22:08:05 +00001712load_module(char *name, FILE *fp, char *buf, int type, PyObject *loader)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001713{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001714 PyObject *modules;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001715 PyObject *m;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001716 int err;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001717
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001718 /* First check that there's an open file (if we need one) */
1719 switch (type) {
1720 case PY_SOURCE:
1721 case PY_COMPILED:
1722 if (fp == NULL) {
1723 PyErr_Format(PyExc_ValueError,
1724 "file object required for import (type code %d)",
1725 type);
1726 return NULL;
1727 }
1728 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001729
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001730 switch (type) {
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001731
1732 case PY_SOURCE:
1733 m = load_source_module(name, buf, fp);
1734 break;
1735
1736 case PY_COMPILED:
1737 m = load_compiled_module(name, buf, fp);
1738 break;
1739
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001740#ifdef HAVE_DYNAMIC_LOADING
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001741 case C_EXTENSION:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001742 m = _PyImport_LoadDynamicModule(name, buf, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001743 break;
Guido van Rossum96a8fb71999-12-22 14:09:35 +00001744#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001745
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001746 case PKG_DIRECTORY:
1747 m = load_package(name, buf);
1748 break;
1749
1750 case C_BUILTIN:
1751 case PY_FROZEN:
Guido van Rossuma5568d31998-03-05 03:45:08 +00001752 if (buf != NULL && buf[0] != '\0')
1753 name = buf;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001754 if (type == C_BUILTIN)
1755 err = init_builtin(name);
1756 else
1757 err = PyImport_ImportFrozenModule(name);
1758 if (err < 0)
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001759 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001760 if (err == 0) {
1761 PyErr_Format(PyExc_ImportError,
1762 "Purported %s module %.200s not found",
1763 type == C_BUILTIN ?
1764 "builtin" : "frozen",
1765 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001766 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001767 }
1768 modules = PyImport_GetModuleDict();
1769 m = PyDict_GetItemString(modules, name);
1770 if (m == NULL) {
1771 PyErr_Format(
1772 PyExc_ImportError,
1773 "%s module %.200s not properly initialized",
1774 type == C_BUILTIN ?
1775 "builtin" : "frozen",
1776 name);
Guido van Rossuma86f77d1997-09-09 18:53:47 +00001777 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001778 }
1779 Py_INCREF(m);
1780 break;
1781
Just van Rossum52e14d62002-12-30 22:08:05 +00001782 case IMP_HOOK: {
1783 if (loader == NULL) {
1784 PyErr_SetString(PyExc_ImportError,
1785 "import hook without loader");
1786 return NULL;
1787 }
1788 m = PyObject_CallMethod(loader, "load_module", "s", name);
1789 break;
1790 }
1791
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001792 default:
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001793 PyErr_Format(PyExc_ImportError,
1794 "Don't know how to import %.200s (type code %d)",
1795 name, type);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001796 m = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001797
1798 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001799
1800 return m;
1801}
1802
1803
1804/* Initialize a built-in module.
Brett Cannon5a9aa4f2006-10-03 21:58:55 +00001805 Return 1 for success, 0 if the module is not found, and -1 with
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001806 an exception set if the initialization failed. */
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001807
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001808static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001809init_builtin(char *name)
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001810{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001811 struct _inittab *p;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001812
Greg Ward201baee2001-10-04 14:52:06 +00001813 if (_PyImport_FindExtension(name, name) != NULL)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001814 return 1;
1815
Guido van Rossum771c6c81997-10-31 18:37:24 +00001816 for (p = PyImport_Inittab; p->name != NULL; p++) {
Guido van Rossum25ce5661997-08-02 03:10:38 +00001817 if (strcmp(name, p->name) == 0) {
1818 if (p->initfunc == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001819 PyErr_Format(PyExc_ImportError,
1820 "Cannot re-init internal module %.200s",
1821 name);
Guido van Rossum74e6a111994-08-29 12:54:38 +00001822 return -1;
1823 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001824 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001825 PySys_WriteStderr("import %s # builtin\n", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001826 (*p->initfunc)();
Guido van Rossum79f25d91997-04-29 20:08:16 +00001827 if (PyErr_Occurred())
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001828 return -1;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001829 if (_PyImport_FixupExtension(name, name) == NULL)
1830 return -1;
Guido van Rossum7f133ed1991-02-19 12:23:57 +00001831 return 1;
1832 }
1833 }
1834 return 0;
1835}
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001836
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001837
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001838/* Frozen modules */
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001839
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001840static struct _frozen *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001841find_frozen(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001842{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001843 struct _frozen *p;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001844
Guido van Rossum79f25d91997-04-29 20:08:16 +00001845 for (p = PyImport_FrozenModules; ; p++) {
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001846 if (p->name == NULL)
1847 return NULL;
1848 if (strcmp(p->name, name) == 0)
1849 break;
1850 }
1851 return p;
1852}
1853
Guido van Rossum79f25d91997-04-29 20:08:16 +00001854static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001855get_frozen_object(char *name)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001856{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001857 struct _frozen *p = find_frozen(name);
Guido van Rossuma5568d31998-03-05 03:45:08 +00001858 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001859
1860 if (p == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001861 PyErr_Format(PyExc_ImportError,
1862 "No such frozen object named %.200s",
1863 name);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001864 return NULL;
1865 }
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001866 if (p->code == NULL) {
1867 PyErr_Format(PyExc_ImportError,
1868 "Excluded frozen object named %.200s",
1869 name);
1870 return NULL;
1871 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001872 size = p->size;
1873 if (size < 0)
1874 size = -size;
1875 return PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001876}
1877
1878/* Initialize a frozen module.
1879 Return 1 for succes, 0 if the module is not found, and -1 with
1880 an exception set if the initialization failed.
1881 This function is also used from frozenmain.c */
Guido van Rossum0b344901995-02-07 15:35:27 +00001882
1883int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001884PyImport_ImportFrozenModule(char *name)
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001885{
Guido van Rossumcfd0a221996-06-17 17:06:34 +00001886 struct _frozen *p = find_frozen(name);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001887 PyObject *co;
1888 PyObject *m;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001889 int ispackage;
1890 int size;
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00001891
1892 if (p == NULL)
1893 return 0;
Guido van Rossum8f4d3312001-10-18 18:54:11 +00001894 if (p->code == NULL) {
1895 PyErr_Format(PyExc_ImportError,
1896 "Excluded frozen object named %.200s",
1897 name);
1898 return -1;
1899 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001900 size = p->size;
1901 ispackage = (size < 0);
1902 if (ispackage)
1903 size = -size;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001904 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +00001905 PySys_WriteStderr("import %s # frozen%s\n",
Guido van Rossuma5568d31998-03-05 03:45:08 +00001906 name, ispackage ? " package" : "");
1907 co = PyMarshal_ReadObjectFromString((char *)p->code, size);
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001908 if (co == NULL)
1909 return -1;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001910 if (!PyCode_Check(co)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001911 PyErr_Format(PyExc_TypeError,
1912 "frozen object %.200s is not a code object",
1913 name);
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001914 goto err_return;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001915 }
Guido van Rossuma5568d31998-03-05 03:45:08 +00001916 if (ispackage) {
1917 /* Set __path__ to the package name */
1918 PyObject *d, *s;
1919 int err;
1920 m = PyImport_AddModule(name);
1921 if (m == NULL)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001922 goto err_return;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001923 d = PyModule_GetDict(m);
1924 s = PyString_InternFromString(name);
1925 if (s == NULL)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001926 goto err_return;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001927 err = PyDict_SetItemString(d, "__path__", s);
1928 Py_DECREF(s);
1929 if (err != 0)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001930 goto err_return;
Guido van Rossuma5568d31998-03-05 03:45:08 +00001931 }
Guido van Rossume32bf6e1998-02-11 05:53:02 +00001932 m = PyImport_ExecCodeModuleEx(name, co, "<frozen>");
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001933 if (m == NULL)
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001934 goto err_return;
1935 Py_DECREF(co);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001936 Py_DECREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001937 return 1;
Neal Norwitzc0cde4d2006-07-16 02:17:36 +00001938err_return:
1939 Py_DECREF(co);
1940 return -1;
Guido van Rossumf56e3db1993-04-01 20:59:32 +00001941}
Guido van Rossum74e6a111994-08-29 12:54:38 +00001942
1943
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001944/* Import a module, either built-in, frozen, or external, and return
Guido van Rossum7f9fa971995-01-20 16:53:12 +00001945 its module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum74e6a111994-08-29 12:54:38 +00001946
Guido van Rossum79f25d91997-04-29 20:08:16 +00001947PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001948PyImport_ImportModule(const char *name)
Guido van Rossum74e6a111994-08-29 12:54:38 +00001949{
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001950 PyObject *pname;
1951 PyObject *result;
1952
1953 pname = PyString_FromString(name);
Neal Norwitza11e4c12003-03-23 14:31:01 +00001954 if (pname == NULL)
1955 return NULL;
Marc-André Lemburg3c61c352001-02-09 19:40:15 +00001956 result = PyImport_Import(pname);
1957 Py_DECREF(pname);
1958 return result;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001959}
1960
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001961/* Forward declarations for helper routines */
Thomas Woutersf7f438b2006-02-28 16:09:29 +00001962static PyObject *get_parent(PyObject *globals, char *buf,
1963 Py_ssize_t *p_buflen, int level);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001964static PyObject *load_next(PyObject *mod, PyObject *altmod,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001965 char **p_name, char *buf, Py_ssize_t *p_buflen);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001966static int mark_miss(char *name);
1967static int ensure_fromlist(PyObject *mod, PyObject *fromlist,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001968 char *buf, Py_ssize_t buflen, int recursive);
Tim Petersdbd9ba62000-07-09 03:09:57 +00001969static PyObject * import_submodule(PyObject *mod, char *name, char *fullname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001970
1971/* The Magnum Opus of dotted-name import :-) */
1972
Guido van Rossum75acc9c1998-03-03 22:26:50 +00001973static PyObject *
Thomas Woutersf7f438b2006-02-28 16:09:29 +00001974import_module_level(char *name, PyObject *globals, PyObject *locals,
1975 PyObject *fromlist, int level)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00001976{
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001977 char buf[MAXPATHLEN+1];
Martin v. Löwis18e16552006-02-15 17:27:45 +00001978 Py_ssize_t buflen = 0;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001979 PyObject *parent, *head, *next, *tail;
1980
Thomas Woutersf7f438b2006-02-28 16:09:29 +00001981 parent = get_parent(globals, buf, &buflen, level);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00001982 if (parent == NULL)
1983 return NULL;
1984
1985 head = load_next(parent, Py_None, &name, buf, &buflen);
1986 if (head == NULL)
1987 return NULL;
1988
1989 tail = head;
1990 Py_INCREF(tail);
1991 while (name) {
1992 next = load_next(tail, tail, &name, buf, &buflen);
1993 Py_DECREF(tail);
1994 if (next == NULL) {
1995 Py_DECREF(head);
1996 return NULL;
1997 }
1998 tail = next;
1999 }
Thomas Wouters8ddab272006-04-04 16:17:02 +00002000 if (tail == Py_None) {
2001 /* If tail is Py_None, both get_parent and load_next found
2002 an empty module name: someone called __import__("") or
2003 doctored faulty bytecode */
Thomas Wouters4bdaa272006-04-05 13:39:37 +00002004 Py_DECREF(tail);
2005 Py_DECREF(head);
Thomas Wouters8ddab272006-04-04 16:17:02 +00002006 PyErr_SetString(PyExc_ValueError,
2007 "Empty module name");
2008 return NULL;
2009 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002010
2011 if (fromlist != NULL) {
2012 if (fromlist == Py_None || !PyObject_IsTrue(fromlist))
2013 fromlist = NULL;
2014 }
2015
2016 if (fromlist == NULL) {
2017 Py_DECREF(tail);
2018 return head;
2019 }
2020
2021 Py_DECREF(head);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002022 if (!ensure_fromlist(tail, fromlist, buf, buflen, 0)) {
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002023 Py_DECREF(tail);
2024 return NULL;
2025 }
2026
2027 return tail;
2028}
2029
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002030/* For DLL compatibility */
2031#undef PyImport_ImportModuleEx
Guido van Rossum75acc9c1998-03-03 22:26:50 +00002032PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002033PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals,
2034 PyObject *fromlist)
Guido van Rossum75acc9c1998-03-03 22:26:50 +00002035{
2036 PyObject *result;
2037 lock_import();
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002038 result = import_module_level(name, globals, locals, fromlist, -1);
2039 if (unlock_import() < 0) {
2040 Py_XDECREF(result);
2041 PyErr_SetString(PyExc_RuntimeError,
2042 "not holding the import lock");
2043 return NULL;
2044 }
2045 return result;
2046}
2047#define PyImport_ImportModuleEx(n, g, l, f) \
2048 PyImport_ImportModuleLevel(n, g, l, f, -1);
2049
2050PyObject *
2051PyImport_ImportModuleLevel(char *name, PyObject *globals, PyObject *locals,
2052 PyObject *fromlist, int level)
2053{
2054 PyObject *result;
2055 lock_import();
2056 result = import_module_level(name, globals, locals, fromlist, level);
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002057 if (unlock_import() < 0) {
2058 Py_XDECREF(result);
2059 PyErr_SetString(PyExc_RuntimeError,
2060 "not holding the import lock");
2061 return NULL;
2062 }
Guido van Rossum75acc9c1998-03-03 22:26:50 +00002063 return result;
2064}
2065
Fred Drake87590902004-05-28 20:21:36 +00002066/* Return the package that an import is being performed in. If globals comes
2067 from the module foo.bar.bat (not itself a package), this returns the
2068 sys.modules entry for foo.bar. If globals is from a package's __init__.py,
Georg Brandl5f6861d2006-05-28 21:57:35 +00002069 the package's entry in sys.modules is returned, as a borrowed reference.
Fred Drake87590902004-05-28 20:21:36 +00002070
2071 The *name* of the returned package is returned in buf, with the length of
2072 the name in *p_buflen.
2073
2074 If globals doesn't come from a package or a module in a package, or a
2075 corresponding entry is not found in sys.modules, Py_None is returned.
2076*/
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002077static PyObject *
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002078get_parent(PyObject *globals, char *buf, Py_ssize_t *p_buflen, int level)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002079{
2080 static PyObject *namestr = NULL;
2081 static PyObject *pathstr = NULL;
2082 PyObject *modname, *modpath, *modules, *parent;
2083
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002084 if (globals == NULL || !PyDict_Check(globals) || !level)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002085 return Py_None;
2086
2087 if (namestr == NULL) {
2088 namestr = PyString_InternFromString("__name__");
2089 if (namestr == NULL)
2090 return NULL;
2091 }
2092 if (pathstr == NULL) {
2093 pathstr = PyString_InternFromString("__path__");
2094 if (pathstr == NULL)
2095 return NULL;
2096 }
2097
2098 *buf = '\0';
2099 *p_buflen = 0;
2100 modname = PyDict_GetItem(globals, namestr);
2101 if (modname == NULL || !PyString_Check(modname))
2102 return Py_None;
2103
2104 modpath = PyDict_GetItem(globals, pathstr);
2105 if (modpath != NULL) {
Martin v. Löwis725507b2006-03-07 12:08:51 +00002106 Py_ssize_t len = PyString_GET_SIZE(modname);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002107 if (len > MAXPATHLEN) {
2108 PyErr_SetString(PyExc_ValueError,
2109 "Module name too long");
2110 return NULL;
2111 }
2112 strcpy(buf, PyString_AS_STRING(modname));
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002113 }
2114 else {
2115 char *start = PyString_AS_STRING(modname);
2116 char *lastdot = strrchr(start, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00002117 size_t len;
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002118 if (lastdot == NULL && level > 0) {
2119 PyErr_SetString(PyExc_ValueError,
Georg Brandl98775df2006-09-06 06:09:31 +00002120 "Attempted relative import in non-package");
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002121 return NULL;
2122 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002123 if (lastdot == NULL)
2124 return Py_None;
2125 len = lastdot - start;
2126 if (len >= MAXPATHLEN) {
2127 PyErr_SetString(PyExc_ValueError,
2128 "Module name too long");
2129 return NULL;
2130 }
2131 strncpy(buf, start, len);
2132 buf[len] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002133 }
2134
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002135 while (--level > 0) {
2136 char *dot = strrchr(buf, '.');
2137 if (dot == NULL) {
2138 PyErr_SetString(PyExc_ValueError,
Georg Brandl98775df2006-09-06 06:09:31 +00002139 "Attempted relative import beyond "
2140 "toplevel package");
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002141 return NULL;
2142 }
2143 *dot = '\0';
2144 }
2145 *p_buflen = strlen(buf);
2146
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002147 modules = PyImport_GetModuleDict();
2148 parent = PyDict_GetItemString(modules, buf);
2149 if (parent == NULL)
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002150 PyErr_Format(PyExc_SystemError,
2151 "Parent module '%.200s' not loaded", buf);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002152 return parent;
2153 /* We expect, but can't guarantee, if parent != None, that:
2154 - parent.__name__ == buf
2155 - parent.__dict__ is globals
2156 If this is violated... Who cares? */
2157}
2158
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002159/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002160static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002161load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
Martin v. Löwis18e16552006-02-15 17:27:45 +00002162 Py_ssize_t *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002163{
2164 char *name = *p_name;
2165 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00002166 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002167 char *p;
2168 PyObject *result;
2169
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002170 if (strlen(name) == 0) {
Thomas Wouters8ddab272006-04-04 16:17:02 +00002171 /* completely empty module name should only happen in
2172 'from . import' (or '__import__("")')*/
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002173 Py_INCREF(mod);
2174 *p_name = NULL;
2175 return mod;
2176 }
2177
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002178 if (dot == NULL) {
2179 *p_name = NULL;
2180 len = strlen(name);
2181 }
2182 else {
2183 *p_name = dot+1;
2184 len = dot-name;
2185 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00002186 if (len == 0) {
2187 PyErr_SetString(PyExc_ValueError,
2188 "Empty module name");
2189 return NULL;
2190 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002191
2192 p = buf + *p_buflen;
2193 if (p != buf)
2194 *p++ = '.';
2195 if (p+len-buf >= MAXPATHLEN) {
2196 PyErr_SetString(PyExc_ValueError,
2197 "Module name too long");
2198 return NULL;
2199 }
2200 strncpy(p, name, len);
2201 p[len] = '\0';
2202 *p_buflen = p+len-buf;
2203
2204 result = import_submodule(mod, p, buf);
2205 if (result == Py_None && altmod != mod) {
2206 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002207 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00002208 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002209 if (result != NULL && result != Py_None) {
2210 if (mark_miss(buf) != 0) {
2211 Py_DECREF(result);
2212 return NULL;
2213 }
2214 strncpy(buf, name, len);
2215 buf[len] = '\0';
2216 *p_buflen = len;
2217 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002218 }
2219 if (result == NULL)
2220 return NULL;
2221
2222 if (result == Py_None) {
2223 Py_DECREF(result);
2224 PyErr_Format(PyExc_ImportError,
2225 "No module named %.200s", name);
2226 return NULL;
2227 }
2228
2229 return result;
2230}
2231
2232static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002233mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002234{
2235 PyObject *modules = PyImport_GetModuleDict();
2236 return PyDict_SetItemString(modules, name, Py_None);
2237}
2238
2239static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00002240ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, Py_ssize_t buflen,
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002241 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002242{
2243 int i;
2244
2245 if (!PyObject_HasAttrString(mod, "__path__"))
2246 return 1;
2247
2248 for (i = 0; ; i++) {
2249 PyObject *item = PySequence_GetItem(fromlist, i);
2250 int hasit;
2251 if (item == NULL) {
2252 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
2253 PyErr_Clear();
2254 return 1;
2255 }
2256 return 0;
2257 }
2258 if (!PyString_Check(item)) {
2259 PyErr_SetString(PyExc_TypeError,
2260 "Item in ``from list'' not a string");
2261 Py_DECREF(item);
2262 return 0;
2263 }
2264 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00002265 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002266 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002267 /* See if the package defines __all__ */
2268 if (recursive)
2269 continue; /* Avoid endless recursion */
2270 all = PyObject_GetAttrString(mod, "__all__");
2271 if (all == NULL)
2272 PyErr_Clear();
2273 else {
Martin v. Löwis83969ee2004-03-23 16:28:13 +00002274 int ret = ensure_fromlist(mod, all, buf, buflen, 1);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002275 Py_DECREF(all);
Martin v. Löwis83969ee2004-03-23 16:28:13 +00002276 if (!ret)
2277 return 0;
Guido van Rossum9905ef91997-09-08 16:07:11 +00002278 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002279 continue;
2280 }
2281 hasit = PyObject_HasAttr(mod, item);
2282 if (!hasit) {
2283 char *subname = PyString_AS_STRING(item);
2284 PyObject *submod;
2285 char *p;
2286 if (buflen + strlen(subname) >= MAXPATHLEN) {
2287 PyErr_SetString(PyExc_ValueError,
2288 "Module name too long");
2289 Py_DECREF(item);
2290 return 0;
2291 }
2292 p = buf + buflen;
2293 *p++ = '.';
2294 strcpy(p, subname);
2295 submod = import_submodule(mod, subname, buf);
2296 Py_XDECREF(submod);
2297 if (submod == NULL) {
2298 Py_DECREF(item);
2299 return 0;
2300 }
2301 }
2302 Py_DECREF(item);
2303 }
2304
Guido van Rossuma7f2e811997-10-03 15:33:32 +00002305 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002306}
2307
Neil Schemenauer00b09662003-06-16 21:03:07 +00002308static int
2309add_submodule(PyObject *mod, PyObject *submod, char *fullname, char *subname,
2310 PyObject *modules)
2311{
2312 if (mod == Py_None)
2313 return 1;
2314 /* Irrespective of the success of this load, make a
2315 reference to it in the parent package module. A copy gets
2316 saved in the modules dictionary under the full name, so get a
2317 reference from there, if need be. (The exception is when the
2318 load failed with a SyntaxError -- then there's no trace in
2319 sys.modules. In that case, of course, do nothing extra.) */
2320 if (submod == NULL) {
2321 submod = PyDict_GetItemString(modules, fullname);
2322 if (submod == NULL)
2323 return 1;
2324 }
2325 if (PyModule_Check(mod)) {
2326 /* We can't use setattr here since it can give a
2327 * spurious warning if the submodule name shadows a
2328 * builtin name */
2329 PyObject *dict = PyModule_GetDict(mod);
2330 if (!dict)
2331 return 0;
2332 if (PyDict_SetItemString(dict, subname, submod) < 0)
2333 return 0;
2334 }
2335 else {
2336 if (PyObject_SetAttrString(mod, subname, submod) < 0)
2337 return 0;
2338 }
2339 return 1;
2340}
2341
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002342static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002343import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002344{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002345 PyObject *modules = PyImport_GetModuleDict();
Neil Schemenauer00b09662003-06-16 21:03:07 +00002346 PyObject *m = NULL;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002347
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002348 /* Require:
2349 if mod == None: subname == fullname
2350 else: mod.__name__ + "." + subname == fullname
2351 */
2352
Tim Peters50d8d372001-02-28 05:34:27 +00002353 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002354 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00002355 }
2356 else {
Just van Rossum52e14d62002-12-30 22:08:05 +00002357 PyObject *path, *loader = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002358 char buf[MAXPATHLEN+1];
2359 struct filedescr *fdp;
2360 FILE *fp = NULL;
2361
Guido van Rossum9c0afe51998-05-19 15:09:05 +00002362 if (mod == Py_None)
2363 path = NULL;
2364 else {
2365 path = PyObject_GetAttrString(mod, "__path__");
2366 if (path == NULL) {
2367 PyErr_Clear();
2368 Py_INCREF(Py_None);
2369 return Py_None;
2370 }
2371 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002372
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002373 buf[0] = '\0';
Just van Rossum52e14d62002-12-30 22:08:05 +00002374 fdp = find_module(fullname, subname, path, buf, MAXPATHLEN+1,
2375 &fp, &loader);
Guido van Rossumb68cd421998-07-01 17:36:26 +00002376 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002377 if (fdp == NULL) {
2378 if (!PyErr_ExceptionMatches(PyExc_ImportError))
2379 return NULL;
2380 PyErr_Clear();
2381 Py_INCREF(Py_None);
2382 return Py_None;
2383 }
Just van Rossum52e14d62002-12-30 22:08:05 +00002384 m = load_module(fullname, fp, buf, fdp->type, loader);
2385 Py_XDECREF(loader);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002386 if (fp)
2387 fclose(fp);
Neil Schemenauer00b09662003-06-16 21:03:07 +00002388 if (!add_submodule(mod, m, fullname, subname, modules)) {
2389 Py_XDECREF(m);
2390 m = NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002391 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00002392 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002393
2394 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002395}
2396
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002397
2398/* Re-import a module of any kind and return its module object, WITH
2399 INCREMENTED REFERENCE COUNT */
2400
Guido van Rossum79f25d91997-04-29 20:08:16 +00002401PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002402PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002403{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002404 PyObject *modules = PyImport_GetModuleDict();
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002405 PyObject *path = NULL, *loader = NULL;
Guido van Rossum222ef561997-09-06 19:41:09 +00002406 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002407 char buf[MAXPATHLEN+1];
2408 struct filedescr *fdp;
2409 FILE *fp = NULL;
Tim Peters1cd70172004-08-02 03:52:12 +00002410 PyObject *newm;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002411
Guido van Rossum79f25d91997-04-29 20:08:16 +00002412 if (m == NULL || !PyModule_Check(m)) {
2413 PyErr_SetString(PyExc_TypeError,
2414 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002415 return NULL;
2416 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002417 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002418 if (name == NULL)
2419 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00002420 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002421 PyErr_Format(PyExc_ImportError,
2422 "reload(): module %.200s not in sys.modules",
2423 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002424 return NULL;
2425 }
Guido van Rossum222ef561997-09-06 19:41:09 +00002426 subname = strrchr(name, '.');
2427 if (subname == NULL)
2428 subname = name;
2429 else {
2430 PyObject *parentname, *parent;
2431 parentname = PyString_FromStringAndSize(name, (subname-name));
2432 if (parentname == NULL)
2433 return NULL;
2434 parent = PyDict_GetItem(modules, parentname);
2435 if (parent == NULL) {
2436 PyErr_Format(PyExc_ImportError,
2437 "reload(): parent %.200s not in sys.modules",
Georg Brandl0c55f292005-09-14 06:56:20 +00002438 PyString_AS_STRING(parentname));
2439 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002440 return NULL;
2441 }
Georg Brandl0c55f292005-09-14 06:56:20 +00002442 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002443 subname++;
2444 path = PyObject_GetAttrString(parent, "__path__");
2445 if (path == NULL)
2446 PyErr_Clear();
2447 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002448 buf[0] = '\0';
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002449 fdp = find_module(name, subname, path, buf, MAXPATHLEN+1, &fp, &loader);
Guido van Rossum222ef561997-09-06 19:41:09 +00002450 Py_XDECREF(path);
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002451
2452 if (fdp == NULL) {
2453 Py_XDECREF(loader);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002454 return NULL;
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002455 }
2456
2457 newm = load_module(name, fp, buf, fdp->type, loader);
2458 Py_XDECREF(loader);
2459
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002460 if (fp)
2461 fclose(fp);
Tim Peters1cd70172004-08-02 03:52:12 +00002462 if (newm == NULL) {
2463 /* load_module probably removed name from modules because of
2464 * the error. Put back the original module object. We're
2465 * going to return NULL in this case regardless of whether
2466 * replacing name succeeds, so the return value is ignored.
2467 */
2468 PyDict_SetItemString(modules, name, m);
2469 }
2470 return newm;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002471}
2472
2473
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002474/* Higher-level import emulator which emulates the "import" statement
2475 more accurately -- it invokes the __import__() function from the
2476 builtins of the current globals. This means that the import is
2477 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00002478 environment, e.g. by "rexec".
2479 A dummy list ["__doc__"] is passed as the 4th argument so that
2480 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
2481 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002482
2483PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002484PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002485{
2486 static PyObject *silly_list = NULL;
2487 static PyObject *builtins_str = NULL;
2488 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002489 PyObject *globals = NULL;
2490 PyObject *import = NULL;
2491 PyObject *builtins = NULL;
2492 PyObject *r = NULL;
2493
2494 /* Initialize constant string objects */
2495 if (silly_list == NULL) {
2496 import_str = PyString_InternFromString("__import__");
2497 if (import_str == NULL)
2498 return NULL;
2499 builtins_str = PyString_InternFromString("__builtins__");
2500 if (builtins_str == NULL)
2501 return NULL;
2502 silly_list = Py_BuildValue("[s]", "__doc__");
2503 if (silly_list == NULL)
2504 return NULL;
2505 }
2506
2507 /* Get the builtins from current globals */
2508 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002509 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00002510 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002511 builtins = PyObject_GetItem(globals, builtins_str);
2512 if (builtins == NULL)
2513 goto err;
2514 }
2515 else {
2516 /* No globals -- use standard builtins, and fake globals */
2517 PyErr_Clear();
2518
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002519 builtins = PyImport_ImportModuleLevel("__builtin__",
2520 NULL, NULL, NULL, 0);
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002521 if (builtins == NULL)
2522 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002523 globals = Py_BuildValue("{OO}", builtins_str, builtins);
2524 if (globals == NULL)
2525 goto err;
2526 }
2527
2528 /* Get the __import__ function from the builtins */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002529 if (PyDict_Check(builtins)) {
Fred Drakea76ba6e2001-03-06 06:31:15 +00002530 import = PyObject_GetItem(builtins, import_str);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002531 if (import == NULL)
2532 PyErr_SetObject(PyExc_KeyError, import_str);
2533 }
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002534 else
Fred Drakea76ba6e2001-03-06 06:31:15 +00002535 import = PyObject_GetAttr(builtins, import_str);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002536 if (import == NULL)
2537 goto err;
2538
2539 /* Call the _import__ function with the proper argument list */
Georg Brandl684fd0c2006-05-25 19:15:31 +00002540 r = PyObject_CallFunctionObjArgs(import, module_name, globals,
2541 globals, silly_list, NULL);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002542
2543 err:
2544 Py_XDECREF(globals);
2545 Py_XDECREF(builtins);
2546 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00002547
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002548 return r;
2549}
2550
2551
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002552/* Module 'imp' provides Python access to the primitives used for
2553 importing modules.
2554*/
2555
Guido van Rossum79f25d91997-04-29 20:08:16 +00002556static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002557imp_get_magic(PyObject *self, PyObject *noargs)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002558{
2559 char buf[4];
2560
Guido van Rossum96774c12000-05-01 20:19:08 +00002561 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
2562 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
2563 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
2564 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002565
Guido van Rossum79f25d91997-04-29 20:08:16 +00002566 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002567}
2568
Guido van Rossum79f25d91997-04-29 20:08:16 +00002569static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002570imp_get_suffixes(PyObject *self, PyObject *noargs)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002571{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002572 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002573 struct filedescr *fdp;
2574
Guido van Rossum79f25d91997-04-29 20:08:16 +00002575 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002576 if (list == NULL)
2577 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002578 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
2579 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002580 fdp->suffix, fdp->mode, fdp->type);
2581 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002582 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002583 return NULL;
2584 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002585 if (PyList_Append(list, item) < 0) {
2586 Py_DECREF(list);
2587 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002588 return NULL;
2589 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002590 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002591 }
2592 return list;
2593}
2594
Guido van Rossum79f25d91997-04-29 20:08:16 +00002595static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002596call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002597{
Tim Petersdbd9ba62000-07-09 03:09:57 +00002598 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002599 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002600 struct filedescr *fdp;
2601 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002602 FILE *fp = NULL;
2603
2604 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002605 if (path == Py_None)
2606 path = NULL;
Just van Rossum52e14d62002-12-30 22:08:05 +00002607 fdp = find_module(NULL, name, path, pathname, MAXPATHLEN+1, &fp, NULL);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002608 if (fdp == NULL)
2609 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002610 if (fp != NULL) {
2611 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
2612 if (fob == NULL) {
2613 fclose(fp);
2614 return NULL;
2615 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002616 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002617 else {
2618 fob = Py_None;
2619 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00002620 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002621 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002622 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002623 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002624 return ret;
2625}
2626
Guido van Rossum79f25d91997-04-29 20:08:16 +00002627static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002628imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002629{
2630 char *name;
2631 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002632 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002633 return NULL;
2634 return call_find_module(name, path);
2635}
2636
2637static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002638imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002639{
2640 char *name;
2641 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002642 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002643 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002644 return NULL;
2645 ret = init_builtin(name);
2646 if (ret < 0)
2647 return NULL;
2648 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002649 Py_INCREF(Py_None);
2650 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002651 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002652 m = PyImport_AddModule(name);
2653 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002654 return m;
2655}
2656
Guido van Rossum79f25d91997-04-29 20:08:16 +00002657static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002658imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002659{
2660 char *name;
2661 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002662 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002663 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002664 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002665 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002666 if (ret < 0)
2667 return NULL;
2668 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002669 Py_INCREF(Py_None);
2670 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002671 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002672 m = PyImport_AddModule(name);
2673 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002674 return m;
2675}
2676
Guido van Rossum79f25d91997-04-29 20:08:16 +00002677static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002678imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002679{
2680 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002681
Guido van Rossum43713e52000-02-29 13:59:29 +00002682 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002683 return NULL;
2684 return get_frozen_object(name);
2685}
2686
Guido van Rossum79f25d91997-04-29 20:08:16 +00002687static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002688imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002689{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002690 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002691 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002692 return NULL;
Guido van Rossum50ee94f2002-04-09 18:00:58 +00002693 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002694}
2695
Guido van Rossum79f25d91997-04-29 20:08:16 +00002696static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002697imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002698{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002699 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002700 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002701 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002702 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002703 p = find_frozen(name);
Guido van Rossumb8bff3f2002-04-07 06:34:38 +00002704 return PyBool_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002705}
2706
2707static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002708get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002709{
2710 FILE *fp;
2711 if (fob == NULL) {
Tim Peters86c7d2f2004-08-01 23:24:21 +00002712 if (mode[0] == 'U')
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002713 mode = "r" PY_STDIOTEXTMODE;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002714 fp = fopen(pathname, mode);
2715 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002716 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002717 }
2718 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002719 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002720 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002721 PyErr_SetString(PyExc_ValueError,
2722 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002723 }
2724 return fp;
2725}
2726
Guido van Rossum79f25d91997-04-29 20:08:16 +00002727static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002728imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002729{
2730 char *name;
2731 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002732 PyObject *fob = NULL;
2733 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002734 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002735 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002736 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002737 return NULL;
2738 fp = get_file(pathname, fob, "rb");
2739 if (fp == NULL)
2740 return NULL;
2741 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002742 if (fob == NULL)
2743 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002744 return m;
2745}
2746
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002747#ifdef HAVE_DYNAMIC_LOADING
2748
Guido van Rossum79f25d91997-04-29 20:08:16 +00002749static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002750imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002751{
2752 char *name;
2753 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002754 PyObject *fob = NULL;
2755 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002756 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002757 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002758 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002759 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002760 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002761 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002762 if (fp == NULL)
2763 return NULL;
2764 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002765 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002766 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002767}
2768
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002769#endif /* HAVE_DYNAMIC_LOADING */
2770
Guido van Rossum79f25d91997-04-29 20:08:16 +00002771static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002772imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002773{
2774 char *name;
2775 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002776 PyObject *fob = NULL;
2777 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002778 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002779 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002780 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002781 return NULL;
2782 fp = get_file(pathname, fob, "r");
2783 if (fp == NULL)
2784 return NULL;
2785 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002786 if (fob == NULL)
2787 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002788 return m;
2789}
2790
Guido van Rossum79f25d91997-04-29 20:08:16 +00002791static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002792imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002793{
2794 char *name;
2795 PyObject *fob;
2796 char *pathname;
2797 char *suffix; /* Unused */
2798 char *mode;
2799 int type;
2800 FILE *fp;
2801
Guido van Rossum43713e52000-02-29 13:59:29 +00002802 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002803 &name, &fob, &pathname,
2804 &suffix, &mode, &type))
2805 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002806 if (*mode) {
2807 /* Mode must start with 'r' or 'U' and must not contain '+'.
2808 Implicit in this test is the assumption that the mode
2809 may contain other modifiers like 'b' or 't'. */
2810
2811 if (!(*mode == 'r' || *mode == 'U') || strchr(mode, '+')) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002812 PyErr_Format(PyExc_ValueError,
2813 "invalid file open mode %.200s", mode);
2814 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002815 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002816 }
2817 if (fob == Py_None)
2818 fp = NULL;
2819 else {
2820 if (!PyFile_Check(fob)) {
2821 PyErr_SetString(PyExc_ValueError,
2822 "load_module arg#2 should be a file or None");
2823 return NULL;
2824 }
2825 fp = get_file(pathname, fob, mode);
2826 if (fp == NULL)
2827 return NULL;
2828 }
Just van Rossum52e14d62002-12-30 22:08:05 +00002829 return load_module(name, fp, pathname, type, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002830}
2831
2832static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002833imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002834{
2835 char *name;
2836 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002837 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002838 return NULL;
2839 return load_package(name, pathname);
2840}
2841
2842static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002843imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002844{
2845 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002846 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002847 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002848 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002849}
2850
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002851/* Doc strings */
2852
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002853PyDoc_STRVAR(doc_imp,
2854"This module provides the components needed to build your own\n\
2855__import__ function. Undocumented functions are obsolete.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002856
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002857PyDoc_STRVAR(doc_find_module,
2858"find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002859Search for a module. If path is omitted or None, search for a\n\
2860built-in, frozen or special module and continue search in sys.path.\n\
2861The module name cannot contain '.'; to search for a submodule of a\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002862package, pass the submodule name and the package's __path__.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002863
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002864PyDoc_STRVAR(doc_load_module,
2865"load_module(name, file, filename, (suffix, mode, type)) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002866Load a module, given information returned by find_module().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002867The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002868
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002869PyDoc_STRVAR(doc_get_magic,
2870"get_magic() -> string\n\
2871Return the magic number for .pyc or .pyo files.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002872
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002873PyDoc_STRVAR(doc_get_suffixes,
2874"get_suffixes() -> [(suffix, mode, type), ...]\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002875Return a list of (suffix, mode, type) tuples describing the files\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002876that find_module() looks for.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002877
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002878PyDoc_STRVAR(doc_new_module,
2879"new_module(name) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002880Create a new module. Do not enter it in sys.modules.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002881The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002882
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002883PyDoc_STRVAR(doc_lock_held,
Tim Petersa7c65092004-08-01 23:26:05 +00002884"lock_held() -> boolean\n\
2885Return True if the import lock is currently held, else False.\n\
2886On platforms without threads, return False.");
Tim Peters69232342001-08-30 05:16:13 +00002887
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002888PyDoc_STRVAR(doc_acquire_lock,
2889"acquire_lock() -> None\n\
Neal Norwitz2294c0d2003-02-12 23:02:21 +00002890Acquires the interpreter's import lock for the current thread.\n\
2891This lock should be used by import hooks to ensure thread-safety\n\
2892when importing modules.\n\
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002893On platforms without threads, this function does nothing.");
2894
2895PyDoc_STRVAR(doc_release_lock,
2896"release_lock() -> None\n\
2897Release the interpreter's import lock.\n\
2898On platforms without threads, this function does nothing.");
2899
Guido van Rossum79f25d91997-04-29 20:08:16 +00002900static PyMethodDef imp_methods[] = {
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002901 {"find_module", imp_find_module, METH_VARARGS, doc_find_module},
2902 {"get_magic", imp_get_magic, METH_NOARGS, doc_get_magic},
2903 {"get_suffixes", imp_get_suffixes, METH_NOARGS, doc_get_suffixes},
2904 {"load_module", imp_load_module, METH_VARARGS, doc_load_module},
2905 {"new_module", imp_new_module, METH_VARARGS, doc_new_module},
2906 {"lock_held", imp_lock_held, METH_NOARGS, doc_lock_held},
2907 {"acquire_lock", imp_acquire_lock, METH_NOARGS, doc_acquire_lock},
2908 {"release_lock", imp_release_lock, METH_NOARGS, doc_release_lock},
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002909 /* The rest are obsolete */
Neal Norwitz031829d2002-03-31 14:37:44 +00002910 {"get_frozen_object", imp_get_frozen_object, METH_VARARGS},
2911 {"init_builtin", imp_init_builtin, METH_VARARGS},
2912 {"init_frozen", imp_init_frozen, METH_VARARGS},
2913 {"is_builtin", imp_is_builtin, METH_VARARGS},
2914 {"is_frozen", imp_is_frozen, METH_VARARGS},
2915 {"load_compiled", imp_load_compiled, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002916#ifdef HAVE_DYNAMIC_LOADING
Neal Norwitz031829d2002-03-31 14:37:44 +00002917 {"load_dynamic", imp_load_dynamic, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002918#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002919 {"load_package", imp_load_package, METH_VARARGS},
Neal Norwitz031829d2002-03-31 14:37:44 +00002920 {"load_source", imp_load_source, METH_VARARGS},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002921 {NULL, NULL} /* sentinel */
2922};
2923
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002924static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002925setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002926{
2927 PyObject *v;
2928 int err;
2929
2930 v = PyInt_FromLong((long)value);
2931 err = PyDict_SetItemString(d, name, v);
2932 Py_XDECREF(v);
2933 return err;
2934}
2935
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00002936typedef struct {
2937 PyObject_HEAD
2938} NullImporter;
2939
2940static int
2941NullImporter_init(NullImporter *self, PyObject *args, PyObject *kwds)
2942{
2943 char *path;
2944
2945 if (!_PyArg_NoKeywords("NullImporter()", kwds))
2946 return -1;
2947
2948 if (!PyArg_ParseTuple(args, "s:NullImporter",
2949 &path))
2950 return -1;
2951
2952 if (strlen(path) == 0) {
2953 PyErr_SetString(PyExc_ImportError, "empty pathname");
2954 return -1;
2955 } else {
2956#ifndef RISCOS
2957 struct stat statbuf;
2958 int rv;
2959
2960 rv = stat(path, &statbuf);
2961 if (rv == 0) {
2962 /* it exists */
2963 if (S_ISDIR(statbuf.st_mode)) {
2964 /* it's a directory */
2965 PyErr_SetString(PyExc_ImportError,
2966 "existing directory");
2967 return -1;
2968 }
2969 }
2970#else
2971 if (object_exists(path)) {
2972 /* it exists */
2973 if (isdir(path)) {
2974 /* it's a directory */
2975 PyErr_SetString(PyExc_ImportError,
2976 "existing directory");
2977 return -1;
2978 }
2979 }
2980#endif
2981 }
2982 return 0;
2983}
2984
2985static PyObject *
2986NullImporter_find_module(NullImporter *self, PyObject *args)
2987{
2988 Py_RETURN_NONE;
2989}
2990
2991static PyMethodDef NullImporter_methods[] = {
2992 {"find_module", (PyCFunction)NullImporter_find_module, METH_VARARGS,
2993 "Always return None"
2994 },
2995 {NULL} /* Sentinel */
2996};
2997
2998
2999static PyTypeObject NullImporterType = {
3000 PyObject_HEAD_INIT(NULL)
3001 0, /*ob_size*/
3002 "imp.NullImporter", /*tp_name*/
3003 sizeof(NullImporter), /*tp_basicsize*/
3004 0, /*tp_itemsize*/
3005 0, /*tp_dealloc*/
3006 0, /*tp_print*/
3007 0, /*tp_getattr*/
3008 0, /*tp_setattr*/
3009 0, /*tp_compare*/
3010 0, /*tp_repr*/
3011 0, /*tp_as_number*/
3012 0, /*tp_as_sequence*/
3013 0, /*tp_as_mapping*/
3014 0, /*tp_hash */
3015 0, /*tp_call*/
3016 0, /*tp_str*/
3017 0, /*tp_getattro*/
3018 0, /*tp_setattro*/
3019 0, /*tp_as_buffer*/
3020 Py_TPFLAGS_DEFAULT, /*tp_flags*/
3021 "Null importer object", /* tp_doc */
3022 0, /* tp_traverse */
3023 0, /* tp_clear */
3024 0, /* tp_richcompare */
3025 0, /* tp_weaklistoffset */
3026 0, /* tp_iter */
3027 0, /* tp_iternext */
3028 NullImporter_methods, /* tp_methods */
3029 0, /* tp_members */
3030 0, /* tp_getset */
3031 0, /* tp_base */
3032 0, /* tp_dict */
3033 0, /* tp_descr_get */
3034 0, /* tp_descr_set */
3035 0, /* tp_dictoffset */
3036 (initproc)NullImporter_init, /* tp_init */
3037 0, /* tp_alloc */
3038 PyType_GenericNew /* tp_new */
3039};
3040
3041
Jason Tishler6bc06ec2003-09-04 11:59:50 +00003042PyMODINIT_FUNC
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003043initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003044{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003045 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003046
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00003047 if (PyType_Ready(&NullImporterType) < 0)
3048 goto failure;
3049
Guido van Rossum0207e6d1997-09-09 22:04:42 +00003050 m = Py_InitModule4("imp", imp_methods, doc_imp,
3051 NULL, PYTHON_API_VERSION);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00003052 if (m == NULL)
3053 goto failure;
Guido van Rossum79f25d91997-04-29 20:08:16 +00003054 d = PyModule_GetDict(m);
Neal Norwitz3cb31ac2006-08-13 18:10:47 +00003055 if (d == NULL)
3056 goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003057
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003058 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
3059 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
3060 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
3061 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
3062 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
3063 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
3064 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
3065 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00003066 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Just van Rossum52e14d62002-12-30 22:08:05 +00003067 if (setint(d, "IMP_HOOK", IMP_HOOK) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003068
Phillip J. Ebyf7575d02006-07-28 21:12:07 +00003069 Py_INCREF(&NullImporterType);
3070 PyModule_AddObject(m, "NullImporter", (PyObject *)&NullImporterType);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003071 failure:
3072 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003073}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003074
3075
Guido van Rossumb18618d2000-05-03 23:44:39 +00003076/* API for embedding applications that want to add their own entries
3077 to the table of built-in modules. This should normally be called
3078 *before* Py_Initialize(). When the table resize fails, -1 is
3079 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003080
3081 After a similar function by Just van Rossum. */
3082
3083int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003084PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003085{
3086 static struct _inittab *our_copy = NULL;
3087 struct _inittab *p;
3088 int i, n;
3089
3090 /* Count the number of entries in both tables */
3091 for (n = 0; newtab[n].name != NULL; n++)
3092 ;
3093 if (n == 0)
3094 return 0; /* Nothing to do */
3095 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
3096 ;
3097
3098 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00003099 p = our_copy;
3100 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003101 if (p == NULL)
3102 return -1;
3103
3104 /* Copy the tables into the new memory */
3105 if (our_copy != PyImport_Inittab)
3106 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
3107 PyImport_Inittab = our_copy = p;
3108 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
3109
3110 return 0;
3111}
3112
3113/* Shorthand to add a single entry given a name and a function */
3114
3115int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003116PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003117{
3118 struct _inittab newtab[2];
3119
3120 memset(newtab, '\0', sizeof newtab);
3121
3122 newtab[0].name = name;
3123 newtab[0].initfunc = initfunc;
3124
3125 return PyImport_ExtendInittab(newtab);
3126}
Anthony Baxterac6bd462006-04-13 02:06:09 +00003127
3128#ifdef __cplusplus
3129}
3130#endif