blob: 4c6c05a2cdeb99d99bb4f1c2d97631c22dfc1448 [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
Thomas Wouters49fd7fa2006-04-21 10:40:58 +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
Guido van Rossum45aecf42006-03-15 04:58:47 +000034 The magic numbers must be spaced apart at least 2 values, as the
Martin v. Löwisef82d2f2004-06-27 16:51:46 +000035 -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
Thomas Wouters49fd7fa2006-04-21 10:40:58 +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)
Thomas Wouters0e3f5912006-08-11 14:57:12 +000063 Python 2.5b3: 62101 (fix wrong code: for x, in ...)
64 Python 2.5b3: 62111 (fix wrong code: x += yield)
65 Python 2.5c1: 62121 (fix wrong lnotab with for loops and
66 storing constants that should have been removed)
Guido van Rossum45aecf42006-03-15 04:58:47 +000067 Python 3000: 3000
Brett Cannone2e23ef2006-08-25 05:05:30 +000068 3010 (removed UNARY_CONVERT)
Guido van Rossum86e58e22006-08-28 15:27:34 +000069 3020 (added BUILD_SET)
Guido van Rossum4f72a782006-10-27 23:31:49 +000070 3030 (added keyword-only parameters)
Michael W. Hudsonaee2e282005-10-21 11:32:20 +000071.
Tim Peters36515e22001-11-18 04:06:29 +000072*/
Guido van Rossum4f72a782006-10-27 23:31:49 +000073#define MAGIC (3030 | ((long)'\r'<<16) | ((long)'\n'<<24))
Guido van Rossum3ddee711991-12-16 13:06:34 +000074
Guido van Rossum96774c12000-05-01 20:19:08 +000075/* Magic word as global; note that _PyImport_Init() can change the
Jeremy Hylton9262b8a2000-06-30 04:59:17 +000076 value of this global to accommodate for alterations of how the
Guido van Rossum96774c12000-05-01 20:19:08 +000077 compiler works which are enabled by command line switches. */
78static long pyc_magic = MAGIC;
79
Guido van Rossum25ce5661997-08-02 03:10:38 +000080/* See _PyImport_FixupExtension() below */
81static PyObject *extensions = NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +000082
Guido van Rossum771c6c81997-10-31 18:37:24 +000083/* This table is defined in config.c: */
84extern struct _inittab _PyImport_Inittab[];
85
86struct _inittab *PyImport_Inittab = _PyImport_Inittab;
Guido van Rossum66f1fa81991-04-03 19:03:52 +000087
Guido van Rossumed1170e1999-12-20 21:23:41 +000088/* these tables define the module suffixes that Python recognizes */
89struct filedescr * _PyImport_Filetab = NULL;
Guido van Rossum48a680c2001-03-02 06:34:14 +000090
91#ifdef RISCOS
92static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000093 {"/py", "U", PY_SOURCE},
Guido van Rossum48a680c2001-03-02 06:34:14 +000094 {"/pyc", "rb", PY_COMPILED},
95 {0, 0}
96};
97#else
Guido van Rossumed1170e1999-12-20 21:23:41 +000098static const struct filedescr _PyImport_StandardFiletab[] = {
Jack Jansenc88da1f2002-05-28 10:58:19 +000099 {".py", "U", PY_SOURCE},
Martin v. Löwis6238d2b2002-06-30 15:26:10 +0000100#ifdef MS_WINDOWS
Jack Jansenc88da1f2002-05-28 10:58:19 +0000101 {".pyw", "U", PY_SOURCE},
Tim Peters36515e22001-11-18 04:06:29 +0000102#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000103 {".pyc", "rb", PY_COMPILED},
104 {0, 0}
105};
Guido van Rossum48a680c2001-03-02 06:34:14 +0000106#endif
Guido van Rossumed1170e1999-12-20 21:23:41 +0000107
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000108static PyTypeObject NullImporterType; /* Forward reference */
109
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000110/* Initialize things */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000111
112void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000113_PyImport_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000114{
Guido van Rossumed1170e1999-12-20 21:23:41 +0000115 const struct filedescr *scan;
116 struct filedescr *filetab;
117 int countD = 0;
118 int countS = 0;
119
120 /* prepare _PyImport_Filetab: copy entries from
121 _PyImport_DynLoadFiletab and _PyImport_StandardFiletab.
122 */
123 for (scan = _PyImport_DynLoadFiletab; scan->suffix != NULL; ++scan)
124 ++countD;
125 for (scan = _PyImport_StandardFiletab; scan->suffix != NULL; ++scan)
126 ++countS;
Guido van Rossumb18618d2000-05-03 23:44:39 +0000127 filetab = PyMem_NEW(struct filedescr, countD + countS + 1);
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000128 if (filetab == NULL)
129 Py_FatalError("Can't initialize import file table.");
Guido van Rossumed1170e1999-12-20 21:23:41 +0000130 memcpy(filetab, _PyImport_DynLoadFiletab,
131 countD * sizeof(struct filedescr));
132 memcpy(filetab + countD, _PyImport_StandardFiletab,
133 countS * sizeof(struct filedescr));
134 filetab[countD + countS].suffix = NULL;
135
136 _PyImport_Filetab = filetab;
137
Guido van Rossum0824f631997-03-11 18:37:35 +0000138 if (Py_OptimizeFlag) {
Guido van Rossumed1170e1999-12-20 21:23:41 +0000139 /* Replace ".pyc" with ".pyo" in _PyImport_Filetab */
140 for (; filetab->suffix != NULL; filetab++) {
Guido van Rossum48a680c2001-03-02 06:34:14 +0000141#ifndef RISCOS
Guido van Rossumed1170e1999-12-20 21:23:41 +0000142 if (strcmp(filetab->suffix, ".pyc") == 0)
143 filetab->suffix = ".pyo";
Guido van Rossum48a680c2001-03-02 06:34:14 +0000144#else
145 if (strcmp(filetab->suffix, "/pyc") == 0)
146 filetab->suffix = "/pyo";
147#endif
Guido van Rossum0824f631997-03-11 18:37:35 +0000148 }
149 }
Guido van Rossum96774c12000-05-01 20:19:08 +0000150
151 if (Py_UnicodeFlag) {
152 /* Fix the pyc_magic so that byte compiled code created
153 using the all-Unicode method doesn't interfere with
154 code created in normal operation mode. */
155 pyc_magic = MAGIC + 1;
156 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000157}
158
Guido van Rossum25ce5661997-08-02 03:10:38 +0000159void
Just van Rossum52e14d62002-12-30 22:08:05 +0000160_PyImportHooks_Init(void)
161{
162 PyObject *v, *path_hooks = NULL, *zimpimport;
163 int err = 0;
164
165 /* adding sys.path_hooks and sys.path_importer_cache, setting up
166 zipimport */
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000167 if (PyType_Ready(&NullImporterType) < 0)
168 goto error;
Just van Rossum52e14d62002-12-30 22:08:05 +0000169
170 if (Py_VerboseFlag)
171 PySys_WriteStderr("# installing zipimport hook\n");
172
173 v = PyList_New(0);
174 if (v == NULL)
175 goto error;
176 err = PySys_SetObject("meta_path", v);
177 Py_DECREF(v);
178 if (err)
179 goto error;
180 v = PyDict_New();
181 if (v == NULL)
182 goto error;
183 err = PySys_SetObject("path_importer_cache", v);
184 Py_DECREF(v);
185 if (err)
186 goto error;
187 path_hooks = PyList_New(0);
188 if (path_hooks == NULL)
189 goto error;
190 err = PySys_SetObject("path_hooks", path_hooks);
191 if (err) {
192 error:
193 PyErr_Print();
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000194 Py_FatalError("initializing sys.meta_path, sys.path_hooks, "
195 "path_importer_cache, or NullImporter failed"
196 );
Just van Rossum52e14d62002-12-30 22:08:05 +0000197 }
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000198
Just van Rossum52e14d62002-12-30 22:08:05 +0000199 zimpimport = PyImport_ImportModule("zipimport");
200 if (zimpimport == NULL) {
201 PyErr_Clear(); /* No zip import module -- okay */
202 if (Py_VerboseFlag)
203 PySys_WriteStderr("# can't import zipimport\n");
204 }
205 else {
206 PyObject *zipimporter = PyObject_GetAttrString(zimpimport,
207 "zipimporter");
208 Py_DECREF(zimpimport);
209 if (zipimporter == NULL) {
210 PyErr_Clear(); /* No zipimporter object -- okay */
211 if (Py_VerboseFlag)
212 PySys_WriteStderr(
Fred Drake1e5fc552003-07-11 15:01:02 +0000213 "# can't import zipimport.zipimporter\n");
Just van Rossum52e14d62002-12-30 22:08:05 +0000214 }
215 else {
216 /* sys.path_hooks.append(zipimporter) */
217 err = PyList_Append(path_hooks, zipimporter);
218 Py_DECREF(zipimporter);
219 if (err)
220 goto error;
221 if (Py_VerboseFlag)
222 PySys_WriteStderr(
223 "# installed zipimport hook\n");
224 }
225 }
226 Py_DECREF(path_hooks);
227}
228
229void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000230_PyImport_Fini(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000231{
232 Py_XDECREF(extensions);
233 extensions = NULL;
Barry Warsaw84294482000-10-03 16:02:05 +0000234 PyMem_DEL(_PyImport_Filetab);
235 _PyImport_Filetab = NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000236}
237
238
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000239/* Locking primitives to prevent parallel imports of the same module
240 in different threads to return with a partially loaded module.
241 These calls are serialized by the global interpreter lock. */
242
243#ifdef WITH_THREAD
244
Guido van Rossum49b56061998-10-01 20:42:43 +0000245#include "pythread.h"
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000246
Guido van Rossum65d5b571998-12-21 19:32:43 +0000247static PyThread_type_lock import_lock = 0;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000248static long import_lock_thread = -1;
249static int import_lock_level = 0;
250
251static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000252lock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000253{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000254 long me = PyThread_get_thread_ident();
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000255 if (me == -1)
256 return; /* Too bad */
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000257 if (import_lock == NULL) {
Guido van Rossum65d5b571998-12-21 19:32:43 +0000258 import_lock = PyThread_allocate_lock();
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000259 if (import_lock == NULL)
260 return; /* Nothing much we can do. */
261 }
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000262 if (import_lock_thread == me) {
263 import_lock_level++;
264 return;
265 }
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000266 if (import_lock_thread != -1 || !PyThread_acquire_lock(import_lock, 0))
267 {
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000268 PyThreadState *tstate = PyEval_SaveThread();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000269 PyThread_acquire_lock(import_lock, 1);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000270 PyEval_RestoreThread(tstate);
271 }
272 import_lock_thread = me;
273 import_lock_level = 1;
274}
275
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000276static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000277unlock_import(void)
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000278{
Guido van Rossum65d5b571998-12-21 19:32:43 +0000279 long me = PyThread_get_thread_ident();
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000280 if (me == -1 || import_lock == NULL)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000281 return 0; /* Too bad */
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000282 if (import_lock_thread != me)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000283 return -1;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000284 import_lock_level--;
285 if (import_lock_level == 0) {
286 import_lock_thread = -1;
Guido van Rossum65d5b571998-12-21 19:32:43 +0000287 PyThread_release_lock(import_lock);
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000288 }
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000289 return 1;
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000290}
291
Guido van Rossum8ee3e5a2005-09-14 18:09:42 +0000292/* This function is called from PyOS_AfterFork to ensure that newly
293 created child processes do not share locks with the parent. */
294
295void
296_PyImport_ReInitLock(void)
297{
298#ifdef _AIX
299 if (import_lock != NULL)
300 import_lock = PyThread_allocate_lock();
301#endif
302}
303
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000304#else
305
306#define lock_import()
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000307#define unlock_import() 0
Guido van Rossum75acc9c1998-03-03 22:26:50 +0000308
309#endif
310
Tim Peters69232342001-08-30 05:16:13 +0000311static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000312imp_lock_held(PyObject *self, PyObject *noargs)
Tim Peters69232342001-08-30 05:16:13 +0000313{
Tim Peters69232342001-08-30 05:16:13 +0000314#ifdef WITH_THREAD
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000315 return PyBool_FromLong(import_lock_thread != -1);
Tim Peters69232342001-08-30 05:16:13 +0000316#else
Guido van Rossumb8bff3f2002-04-07 06:34:38 +0000317 return PyBool_FromLong(0);
Tim Peters69232342001-08-30 05:16:13 +0000318#endif
319}
320
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000321static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000322imp_acquire_lock(PyObject *self, PyObject *noargs)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000323{
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000324#ifdef WITH_THREAD
325 lock_import();
326#endif
Neal Norwitz2294c0d2003-02-12 23:02:21 +0000327 Py_INCREF(Py_None);
328 return Py_None;
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000329}
330
331static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +0000332imp_release_lock(PyObject *self, PyObject *noargs)
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000333{
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000334#ifdef WITH_THREAD
335 if (unlock_import() < 0) {
336 PyErr_SetString(PyExc_RuntimeError,
337 "not holding the import lock");
338 return NULL;
339 }
340#endif
Neal Norwitz2294c0d2003-02-12 23:02:21 +0000341 Py_INCREF(Py_None);
342 return Py_None;
Guido van Rossumc4f4ca92003-02-12 21:46:11 +0000343}
344
Guido van Rossum25ce5661997-08-02 03:10:38 +0000345/* Helper for sys */
346
347PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000348PyImport_GetModuleDict(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000349{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000350 PyInterpreterState *interp = PyThreadState_GET()->interp;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000351 if (interp->modules == NULL)
352 Py_FatalError("PyImport_GetModuleDict: no module dictionary!");
353 return interp->modules;
354}
355
Guido van Rossum3f5da241990-12-20 15:06:42 +0000356
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000357/* List of names to clear in sys */
358static char* sys_deletes[] = {
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000359 "path", "argv", "ps1", "ps2", "exitfunc",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000360 "exc_type", "exc_value", "exc_traceback",
361 "last_type", "last_value", "last_traceback",
Just van Rossum52e14d62002-12-30 22:08:05 +0000362 "path_hooks", "path_importer_cache", "meta_path",
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000363 NULL
364};
365
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000366static char* sys_files[] = {
367 "stdin", "__stdin__",
368 "stdout", "__stdout__",
369 "stderr", "__stderr__",
370 NULL
371};
372
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000373
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000374/* Un-initialize things, as good as we can */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000375
Guido van Rossum3f5da241990-12-20 15:06:42 +0000376void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000377PyImport_Cleanup(void)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000378{
Martin v. Löwis18e16552006-02-15 17:27:45 +0000379 Py_ssize_t pos, ndone;
Guido van Rossum758eec01998-01-19 21:58:26 +0000380 char *name;
381 PyObject *key, *value, *dict;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000382 PyInterpreterState *interp = PyThreadState_GET()->interp;
Guido van Rossum758eec01998-01-19 21:58:26 +0000383 PyObject *modules = interp->modules;
384
385 if (modules == NULL)
386 return; /* Already done */
387
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000388 /* Delete some special variables first. These are common
389 places where user values hide and people complain when their
390 destructors fail. Since the modules containing them are
391 deleted *last* of all, they would come too late in the normal
392 destruction order. Sigh. */
393
394 value = PyDict_GetItemString(modules, "__builtin__");
395 if (value != NULL && PyModule_Check(value)) {
396 dict = PyModule_GetDict(value);
397 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000398 PySys_WriteStderr("# clear __builtin__._\n");
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000399 PyDict_SetItemString(dict, "_", Py_None);
400 }
401 value = PyDict_GetItemString(modules, "sys");
402 if (value != NULL && PyModule_Check(value)) {
403 char **p;
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000404 PyObject *v;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000405 dict = PyModule_GetDict(value);
406 for (p = sys_deletes; *p != NULL; p++) {
407 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000408 PySys_WriteStderr("# clear sys.%s\n", *p);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000409 PyDict_SetItemString(dict, *p, Py_None);
410 }
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000411 for (p = sys_files; *p != NULL; p+=2) {
412 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000413 PySys_WriteStderr("# restore sys.%s\n", *p);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000414 v = PyDict_GetItemString(dict, *(p+1));
415 if (v == NULL)
416 v = Py_None;
417 PyDict_SetItemString(dict, *p, v);
418 }
419 }
420
421 /* First, delete __main__ */
422 value = PyDict_GetItemString(modules, "__main__");
423 if (value != NULL && PyModule_Check(value)) {
424 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000425 PySys_WriteStderr("# cleanup __main__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000426 _PyModule_Clear(value);
427 PyDict_SetItemString(modules, "__main__", Py_None);
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000428 }
429
Guido van Rossum758eec01998-01-19 21:58:26 +0000430 /* The special treatment of __builtin__ here is because even
431 when it's not referenced as a module, its dictionary is
432 referenced by almost every module's __builtins__. Since
433 deleting a module clears its dictionary (even if there are
434 references left to it), we need to delete the __builtin__
435 module last. Likewise, we don't delete sys until the very
436 end because it is implicitly referenced (e.g. by print).
437
438 Also note that we 'delete' modules by replacing their entry
439 in the modules dict with None, rather than really deleting
440 them; this avoids a rehash of the modules dictionary and
441 also marks them as "non existent" so they won't be
442 re-imported. */
443
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000444 /* Next, repeatedly delete modules with a reference count of
Guido van Rossum758eec01998-01-19 21:58:26 +0000445 one (skipping __builtin__ and sys) and delete them */
446 do {
447 ndone = 0;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000448 pos = 0;
Guido van Rossum758eec01998-01-19 21:58:26 +0000449 while (PyDict_Next(modules, &pos, &key, &value)) {
450 if (value->ob_refcnt != 1)
451 continue;
Guido van Rossum566373e1998-10-01 15:24:50 +0000452 if (PyString_Check(key) && PyModule_Check(value)) {
453 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000454 if (strcmp(name, "__builtin__") == 0)
455 continue;
456 if (strcmp(name, "sys") == 0)
457 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000458 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000459 PySys_WriteStderr(
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000460 "# cleanup[1] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000461 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000462 PyDict_SetItem(modules, key, Py_None);
463 ndone++;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000464 }
465 }
Guido van Rossum758eec01998-01-19 21:58:26 +0000466 } while (ndone > 0);
467
Guido van Rossum758eec01998-01-19 21:58:26 +0000468 /* Next, delete all modules (still skipping __builtin__ and sys) */
469 pos = 0;
470 while (PyDict_Next(modules, &pos, &key, &value)) {
Guido van Rossum566373e1998-10-01 15:24:50 +0000471 if (PyString_Check(key) && PyModule_Check(value)) {
472 name = PyString_AS_STRING(key);
Guido van Rossum758eec01998-01-19 21:58:26 +0000473 if (strcmp(name, "__builtin__") == 0)
474 continue;
475 if (strcmp(name, "sys") == 0)
476 continue;
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000477 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000478 PySys_WriteStderr("# cleanup[2] %s\n", name);
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000479 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000480 PyDict_SetItem(modules, key, Py_None);
481 }
482 }
483
484 /* Next, delete sys and __builtin__ (in that order) */
485 value = PyDict_GetItemString(modules, "sys");
486 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000487 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000488 PySys_WriteStderr("# cleanup sys\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000489 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000490 PyDict_SetItemString(modules, "sys", Py_None);
491 }
492 value = PyDict_GetItemString(modules, "__builtin__");
493 if (value != NULL && PyModule_Check(value)) {
Guido van Rossuma0fec2b1998-02-06 17:16:02 +0000494 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000495 PySys_WriteStderr("# cleanup __builtin__\n");
Guido van Rossum05f9dce1998-02-19 20:58:44 +0000496 _PyModule_Clear(value);
Guido van Rossum758eec01998-01-19 21:58:26 +0000497 PyDict_SetItemString(modules, "__builtin__", Py_None);
498 }
499
500 /* Finally, clear and delete the modules directory */
501 PyDict_Clear(modules);
502 interp->modules = NULL;
503 Py_DECREF(modules);
Guido van Rossum8d15b5d1990-10-26 14:58:58 +0000504}
Guido van Rossum7f133ed1991-02-19 12:23:57 +0000505
506
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000507/* Helper for pythonrun.c -- return magic number */
508
509long
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000510PyImport_GetMagicNumber(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000511{
Guido van Rossum96774c12000-05-01 20:19:08 +0000512 return pyc_magic;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000513}
514
515
Guido van Rossum25ce5661997-08-02 03:10:38 +0000516/* Magic for extension modules (built-in as well as dynamically
517 loaded). To prevent initializing an extension module more than
518 once, we keep a static dictionary 'extensions' keyed by module name
519 (for built-in modules) or by filename (for dynamically loaded
Barry Warsaw92883382001-08-13 23:05:44 +0000520 modules), containing these modules. A copy of the module's
Guido van Rossum25ce5661997-08-02 03:10:38 +0000521 dictionary is stored by calling _PyImport_FixupExtension()
522 immediately after the module initialization function succeeds. A
523 copy can be retrieved from there by calling
524 _PyImport_FindExtension(). */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000525
Guido van Rossum79f25d91997-04-29 20:08:16 +0000526PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000527_PyImport_FixupExtension(char *name, char *filename)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000528{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000529 PyObject *modules, *mod, *dict, *copy;
530 if (extensions == NULL) {
531 extensions = PyDict_New();
532 if (extensions == NULL)
533 return NULL;
534 }
535 modules = PyImport_GetModuleDict();
536 mod = PyDict_GetItemString(modules, name);
537 if (mod == NULL || !PyModule_Check(mod)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000538 PyErr_Format(PyExc_SystemError,
539 "_PyImport_FixupExtension: module %.200s not loaded", name);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000540 return NULL;
541 }
542 dict = PyModule_GetDict(mod);
543 if (dict == NULL)
544 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000545 copy = PyDict_Copy(dict);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000546 if (copy == NULL)
547 return NULL;
548 PyDict_SetItemString(extensions, filename, copy);
549 Py_DECREF(copy);
550 return copy;
551}
552
553PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000554_PyImport_FindExtension(char *name, char *filename)
Guido van Rossum25ce5661997-08-02 03:10:38 +0000555{
Fred Drake9cd0efc2001-10-25 21:38:59 +0000556 PyObject *dict, *mod, *mdict;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000557 if (extensions == NULL)
558 return NULL;
559 dict = PyDict_GetItemString(extensions, filename);
560 if (dict == NULL)
561 return NULL;
562 mod = PyImport_AddModule(name);
563 if (mod == NULL)
564 return NULL;
565 mdict = PyModule_GetDict(mod);
566 if (mdict == NULL)
567 return NULL;
Fred Drake9cd0efc2001-10-25 21:38:59 +0000568 if (PyDict_Update(mdict, dict))
Guido van Rossum25ce5661997-08-02 03:10:38 +0000569 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000570 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000571 PySys_WriteStderr("import %s # previously loaded (%s)\n",
Guido van Rossum25ce5661997-08-02 03:10:38 +0000572 name, filename);
573 return mod;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000574}
575
576
577/* Get the module object corresponding to a module name.
578 First check the modules dictionary if there's one there,
Walter Dörwaldf0dfc7a2003-10-20 14:01:56 +0000579 if not, create a new one and insert it in the modules dictionary.
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000580 Because the former action is most common, THIS DOES NOT RETURN A
581 'NEW' REFERENCE! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000582
Guido van Rossum79f25d91997-04-29 20:08:16 +0000583PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000584PyImport_AddModule(const char *name)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000585{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000586 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000587 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000588
Guido van Rossum25ce5661997-08-02 03:10:38 +0000589 if ((m = PyDict_GetItemString(modules, name)) != NULL &&
Guido van Rossum79f25d91997-04-29 20:08:16 +0000590 PyModule_Check(m))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000591 return m;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000592 m = PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000593 if (m == NULL)
594 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000595 if (PyDict_SetItemString(modules, name, m) != 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000596 Py_DECREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000597 return NULL;
598 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000599 Py_DECREF(m); /* Yes, it still exists, in modules! */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000600
601 return m;
602}
603
Tim Peters1cd70172004-08-02 03:52:12 +0000604/* Remove name from sys.modules, if it's there. */
605static void
606_RemoveModule(const char *name)
607{
608 PyObject *modules = PyImport_GetModuleDict();
609 if (PyDict_GetItemString(modules, name) == NULL)
610 return;
611 if (PyDict_DelItemString(modules, name) < 0)
612 Py_FatalError("import: deleting existing key in"
613 "sys.modules failed");
614}
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000615
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000616/* Execute a code object in a module and return the module object
Tim Peters1cd70172004-08-02 03:52:12 +0000617 * WITH INCREMENTED REFERENCE COUNT. If an error occurs, name is
618 * removed from sys.modules, to avoid leaving damaged module objects
619 * in sys.modules. The caller may wish to restore the original
620 * module object (if any) in this case; PyImport_ReloadModule is an
621 * example.
622 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000623PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000624PyImport_ExecCodeModule(char *name, PyObject *co)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000625{
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000626 return PyImport_ExecCodeModuleEx(name, co, (char *)NULL);
627}
628
629PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000630PyImport_ExecCodeModuleEx(char *name, PyObject *co, char *pathname)
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000631{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000632 PyObject *modules = PyImport_GetModuleDict();
Guido van Rossum79f25d91997-04-29 20:08:16 +0000633 PyObject *m, *d, *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000634
Guido van Rossum79f25d91997-04-29 20:08:16 +0000635 m = PyImport_AddModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000636 if (m == NULL)
637 return NULL;
Jeremy Hyltonecd91292004-01-02 23:25:32 +0000638 /* If the module is being reloaded, we get the old module back
639 and re-use its dict to exec the new code. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000640 d = PyModule_GetDict(m);
641 if (PyDict_GetItemString(d, "__builtins__") == NULL) {
642 if (PyDict_SetItemString(d, "__builtins__",
643 PyEval_GetBuiltins()) != 0)
Tim Peters1cd70172004-08-02 03:52:12 +0000644 goto error;
Guido van Rossum6135a871995-01-09 17:53:26 +0000645 }
Guido van Rossum9c9a07c1996-05-16 20:43:40 +0000646 /* Remember the filename as the __file__ attribute */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000647 v = NULL;
648 if (pathname != NULL) {
649 v = PyString_FromString(pathname);
650 if (v == NULL)
651 PyErr_Clear();
652 }
653 if (v == NULL) {
654 v = ((PyCodeObject *)co)->co_filename;
655 Py_INCREF(v);
656 }
657 if (PyDict_SetItemString(d, "__file__", v) != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000658 PyErr_Clear(); /* Not important enough to report */
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000659 Py_DECREF(v);
660
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000661 v = PyEval_EvalCode((PyCodeObject *)co, d, d);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000662 if (v == NULL)
Tim Peters1cd70172004-08-02 03:52:12 +0000663 goto error;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000664 Py_DECREF(v);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000665
Guido van Rossum25ce5661997-08-02 03:10:38 +0000666 if ((m = PyDict_GetItemString(modules, name)) == NULL) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000667 PyErr_Format(PyExc_ImportError,
668 "Loaded module %.200s not found in sys.modules",
669 name);
Guido van Rossumb65e85c1997-07-10 18:00:45 +0000670 return NULL;
671 }
672
Guido van Rossum79f25d91997-04-29 20:08:16 +0000673 Py_INCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000674
675 return m;
Tim Peters1cd70172004-08-02 03:52:12 +0000676
677 error:
678 _RemoveModule(name);
679 return NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000680}
681
682
683/* Given a pathname for a Python source file, fill a buffer with the
684 pathname for the corresponding compiled file. Return the pathname
685 for the compiled file, or NULL if there's no space in the buffer.
686 Doesn't set an exception. */
687
688static char *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000689make_compiled_pathname(char *pathname, char *buf, size_t buflen)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000690{
Tim Petersc1731372001-08-04 08:12:36 +0000691 size_t len = strlen(pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000692 if (len+2 > buflen)
693 return NULL;
Tim Petersc1731372001-08-04 08:12:36 +0000694
Martin v. Löwis6238d2b2002-06-30 15:26:10 +0000695#ifdef MS_WINDOWS
Tim Petersc1731372001-08-04 08:12:36 +0000696 /* Treat .pyw as if it were .py. The case of ".pyw" must match
697 that used in _PyImport_StandardFiletab. */
698 if (len >= 4 && strcmp(&pathname[len-4], ".pyw") == 0)
699 --len; /* pretend 'w' isn't there */
700#endif
701 memcpy(buf, pathname, len);
702 buf[len] = Py_OptimizeFlag ? 'o' : 'c';
703 buf[len+1] = '\0';
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000704
705 return buf;
706}
707
708
709/* Given a pathname for a Python source file, its time of last
710 modification, and a pathname for a compiled file, check whether the
711 compiled file represents the same version of the source. If so,
712 return a FILE pointer for the compiled file, positioned just after
713 the header; if not, return NULL.
714 Doesn't set an exception. */
715
716static FILE *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000717check_compiled_module(char *pathname, time_t mtime, char *cpathname)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000718{
719 FILE *fp;
720 long magic;
721 long pyc_mtime;
722
723 fp = fopen(cpathname, "rb");
724 if (fp == NULL)
725 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000726 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000727 if (magic != pyc_magic) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000728 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000729 PySys_WriteStderr("# %s has bad magic\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000730 fclose(fp);
731 return NULL;
732 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000733 pyc_mtime = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000734 if (pyc_mtime != mtime) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000735 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000736 PySys_WriteStderr("# %s has bad mtime\n", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000737 fclose(fp);
738 return NULL;
739 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000740 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000741 PySys_WriteStderr("# %s matches %s\n", cpathname, pathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000742 return fp;
743}
744
745
746/* Read a code object from a file and check it for validity */
747
Guido van Rossum79f25d91997-04-29 20:08:16 +0000748static PyCodeObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000749read_compiled_module(char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000750{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000751 PyObject *co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000752
Tim Petersd9b9ac82001-01-28 00:27:39 +0000753 co = PyMarshal_ReadLastObjectFromFile(fp);
Armin Rigo01ab2792004-03-26 15:09:27 +0000754 if (co == NULL)
755 return NULL;
756 if (!PyCode_Check(co)) {
757 PyErr_Format(PyExc_ImportError,
758 "Non-code object in %.200s", cpathname);
759 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000760 return NULL;
761 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000762 return (PyCodeObject *)co;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000763}
764
765
766/* Load a module from a compiled file, execute it, and return its
Guido van Rossum7f9fa971995-01-20 16:53:12 +0000767 module object WITH INCREMENTED REFERENCE COUNT */
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000768
Guido van Rossum79f25d91997-04-29 20:08:16 +0000769static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000770load_compiled_module(char *name, char *cpathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000771{
772 long magic;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000773 PyCodeObject *co;
774 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000775
Guido van Rossum79f25d91997-04-29 20:08:16 +0000776 magic = PyMarshal_ReadLongFromFile(fp);
Guido van Rossum96774c12000-05-01 20:19:08 +0000777 if (magic != pyc_magic) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000778 PyErr_Format(PyExc_ImportError,
779 "Bad magic number in %.200s", cpathname);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000780 return NULL;
781 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000782 (void) PyMarshal_ReadLongFromFile(fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +0000783 co = read_compiled_module(cpathname, fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000784 if (co == NULL)
785 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000786 if (Py_VerboseFlag)
Guido van Rossum2f3667a1998-10-12 18:23:55 +0000787 PySys_WriteStderr("import %s # precompiled from %s\n",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000788 name, cpathname);
Guido van Rossume32bf6e1998-02-11 05:53:02 +0000789 m = PyImport_ExecCodeModuleEx(name, (PyObject *)co, cpathname);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000790 Py_DECREF(co);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000791
792 return m;
793}
794
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000795/* Parse a source file and return the corresponding code object */
796
Guido van Rossum79f25d91997-04-29 20:08:16 +0000797static PyCodeObject *
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000798parse_source_module(const char *pathname, FILE *fp)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000799{
Jeremy Hylton3e0055f2005-10-20 19:59:25 +0000800 PyCodeObject *co = NULL;
801 mod_ty mod;
Neal Norwitzadb69fc2005-12-17 20:54:49 +0000802 PyArena *arena = PyArena_New();
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 Norwitzadb69fc2005-12-17 20:54:49 +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);
Thomas Wouters00ee7ba2006-08-21 19:07:27 +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
1033 wasn't yet cached, traverse path_hooks until it a hook is found
1034 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;
Thomas Wouters477c8d52006-05-27 19:21:47 +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 }
Thomas Wouters0e3f5912006-08-11 14:57:12 +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);
Thomas Wouters00ee7ba2006-08-21 19:07:27 +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;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +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 }
Thomas Wouters49fd7fa2006-04-21 10:40:58 +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);
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001271 if (importer == NULL) {
Thomas Wouters477c8d52006-05-27 19:21:47 +00001272 Py_XDECREF(copy);
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001273 return NULL;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001274 }
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001275 /* Note: importer is a borrowed reference */
1276 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);
Thomas Wouters0e3f5912006-08-11 14:57:12 +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);
Thomas Wouters477c8d52006-05-27 19:21:47 +00001290 continue;
Just van Rossum52e14d62002-12-30 22:08:05 +00001291 }
Just van Rossum52e14d62002-12-30 22:08:05 +00001292 }
Thomas Wouters477c8d52006-05-27 19:21:47 +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 Wouters477c8d52006-05-27 19:21:47 +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 Wouters477c8d52006-05-27 19:21:47 +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.
1805 Return 1 for succes, 0 if the module is not found, and -1 with
1806 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);
Thomas Wouters0e3f5912006-08-11 14:57:12 +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)
Thomas Wouters0e3f5912006-08-11 14:57:12 +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)
Thomas Wouters0e3f5912006-08-11 14:57:12 +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)
Thomas Wouters0e3f5912006-08-11 14:57:12 +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)
Thomas Wouters0e3f5912006-08-11 14:57:12 +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;
Thomas Wouters0e3f5912006-08-11 14:57:12 +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 Wouters49fd7fa2006-04-21 10:40:58 +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 */
2004 Py_DECREF(tail);
2005 Py_DECREF(head);
2006 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,
Thomas Wouters4d70c3d2006-06-08 14:42:34 +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,
2120 "Relative importpath too deep");
2121 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,
2139 "Relative importpath too deep");
2140 return NULL;
2141 }
2142 *dot = '\0';
2143 }
2144 *p_buflen = strlen(buf);
2145
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002146 modules = PyImport_GetModuleDict();
2147 parent = PyDict_GetItemString(modules, buf);
2148 if (parent == NULL)
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002149 PyErr_Format(PyExc_SystemError,
2150 "Parent module '%.200s' not loaded", buf);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002151 return parent;
2152 /* We expect, but can't guarantee, if parent != None, that:
2153 - parent.__name__ == buf
2154 - parent.__dict__ is globals
2155 If this is violated... Who cares? */
2156}
2157
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002158/* altmod is either None or same as mod */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002159static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002160load_next(PyObject *mod, PyObject *altmod, char **p_name, char *buf,
Martin v. Löwis18e16552006-02-15 17:27:45 +00002161 Py_ssize_t *p_buflen)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002162{
2163 char *name = *p_name;
2164 char *dot = strchr(name, '.');
Fred Drake4c82b232000-06-30 16:18:57 +00002165 size_t len;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002166 char *p;
2167 PyObject *result;
2168
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002169 if (strlen(name) == 0) {
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002170 /* completely empty module name should only happen in
2171 'from . import' (or '__import__("")')*/
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002172 Py_INCREF(mod);
2173 *p_name = NULL;
2174 return mod;
2175 }
2176
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002177 if (dot == NULL) {
2178 *p_name = NULL;
2179 len = strlen(name);
2180 }
2181 else {
2182 *p_name = dot+1;
2183 len = dot-name;
2184 }
Guido van Rossum111c20b1998-04-11 17:38:22 +00002185 if (len == 0) {
2186 PyErr_SetString(PyExc_ValueError,
2187 "Empty module name");
2188 return NULL;
2189 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002190
2191 p = buf + *p_buflen;
2192 if (p != buf)
2193 *p++ = '.';
2194 if (p+len-buf >= MAXPATHLEN) {
2195 PyErr_SetString(PyExc_ValueError,
2196 "Module name too long");
2197 return NULL;
2198 }
2199 strncpy(p, name, len);
2200 p[len] = '\0';
2201 *p_buflen = p+len-buf;
2202
2203 result = import_submodule(mod, p, buf);
2204 if (result == Py_None && altmod != mod) {
2205 Py_DECREF(result);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002206 /* Here, altmod must be None and mod must not be None */
Guido van Rossum0c819451997-09-07 06:16:57 +00002207 result = import_submodule(altmod, p, p);
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002208 if (result != NULL && result != Py_None) {
2209 if (mark_miss(buf) != 0) {
2210 Py_DECREF(result);
2211 return NULL;
2212 }
2213 strncpy(buf, name, len);
2214 buf[len] = '\0';
2215 *p_buflen = len;
2216 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002217 }
2218 if (result == NULL)
2219 return NULL;
2220
2221 if (result == Py_None) {
2222 Py_DECREF(result);
2223 PyErr_Format(PyExc_ImportError,
2224 "No module named %.200s", name);
2225 return NULL;
2226 }
2227
2228 return result;
2229}
2230
2231static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002232mark_miss(char *name)
Guido van Rossumf5f5fdb1997-09-06 20:29:52 +00002233{
2234 PyObject *modules = PyImport_GetModuleDict();
2235 return PyDict_SetItemString(modules, name, Py_None);
2236}
2237
2238static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00002239ensure_fromlist(PyObject *mod, PyObject *fromlist, char *buf, Py_ssize_t buflen,
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002240 int recursive)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002241{
2242 int i;
2243
2244 if (!PyObject_HasAttrString(mod, "__path__"))
2245 return 1;
2246
2247 for (i = 0; ; i++) {
2248 PyObject *item = PySequence_GetItem(fromlist, i);
2249 int hasit;
2250 if (item == NULL) {
2251 if (PyErr_ExceptionMatches(PyExc_IndexError)) {
2252 PyErr_Clear();
2253 return 1;
2254 }
2255 return 0;
2256 }
2257 if (!PyString_Check(item)) {
2258 PyErr_SetString(PyExc_TypeError,
2259 "Item in ``from list'' not a string");
2260 Py_DECREF(item);
2261 return 0;
2262 }
2263 if (PyString_AS_STRING(item)[0] == '*') {
Guido van Rossum9905ef91997-09-08 16:07:11 +00002264 PyObject *all;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002265 Py_DECREF(item);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002266 /* See if the package defines __all__ */
2267 if (recursive)
2268 continue; /* Avoid endless recursion */
2269 all = PyObject_GetAttrString(mod, "__all__");
2270 if (all == NULL)
2271 PyErr_Clear();
2272 else {
Martin v. Löwis83969ee2004-03-23 16:28:13 +00002273 int ret = ensure_fromlist(mod, all, buf, buflen, 1);
Guido van Rossum9905ef91997-09-08 16:07:11 +00002274 Py_DECREF(all);
Martin v. Löwis83969ee2004-03-23 16:28:13 +00002275 if (!ret)
2276 return 0;
Guido van Rossum9905ef91997-09-08 16:07:11 +00002277 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002278 continue;
2279 }
2280 hasit = PyObject_HasAttr(mod, item);
2281 if (!hasit) {
2282 char *subname = PyString_AS_STRING(item);
2283 PyObject *submod;
2284 char *p;
2285 if (buflen + strlen(subname) >= MAXPATHLEN) {
2286 PyErr_SetString(PyExc_ValueError,
2287 "Module name too long");
2288 Py_DECREF(item);
2289 return 0;
2290 }
2291 p = buf + buflen;
2292 *p++ = '.';
2293 strcpy(p, subname);
2294 submod = import_submodule(mod, subname, buf);
2295 Py_XDECREF(submod);
2296 if (submod == NULL) {
2297 Py_DECREF(item);
2298 return 0;
2299 }
2300 }
2301 Py_DECREF(item);
2302 }
2303
Guido van Rossuma7f2e811997-10-03 15:33:32 +00002304 /* NOTREACHED */
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002305}
2306
Neil Schemenauer00b09662003-06-16 21:03:07 +00002307static int
2308add_submodule(PyObject *mod, PyObject *submod, char *fullname, char *subname,
2309 PyObject *modules)
2310{
2311 if (mod == Py_None)
2312 return 1;
2313 /* Irrespective of the success of this load, make a
2314 reference to it in the parent package module. A copy gets
2315 saved in the modules dictionary under the full name, so get a
2316 reference from there, if need be. (The exception is when the
2317 load failed with a SyntaxError -- then there's no trace in
2318 sys.modules. In that case, of course, do nothing extra.) */
2319 if (submod == NULL) {
2320 submod = PyDict_GetItemString(modules, fullname);
2321 if (submod == NULL)
2322 return 1;
2323 }
2324 if (PyModule_Check(mod)) {
2325 /* We can't use setattr here since it can give a
2326 * spurious warning if the submodule name shadows a
2327 * builtin name */
2328 PyObject *dict = PyModule_GetDict(mod);
2329 if (!dict)
2330 return 0;
2331 if (PyDict_SetItemString(dict, subname, submod) < 0)
2332 return 0;
2333 }
2334 else {
2335 if (PyObject_SetAttrString(mod, subname, submod) < 0)
2336 return 0;
2337 }
2338 return 1;
2339}
2340
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002341static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002342import_submodule(PyObject *mod, char *subname, char *fullname)
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002343{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002344 PyObject *modules = PyImport_GetModuleDict();
Neil Schemenauer00b09662003-06-16 21:03:07 +00002345 PyObject *m = NULL;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002346
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002347 /* Require:
2348 if mod == None: subname == fullname
2349 else: mod.__name__ + "." + subname == fullname
2350 */
2351
Tim Peters50d8d372001-02-28 05:34:27 +00002352 if ((m = PyDict_GetItemString(modules, fullname)) != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002353 Py_INCREF(m);
Guido van Rossum7f9fa971995-01-20 16:53:12 +00002354 }
2355 else {
Just van Rossum52e14d62002-12-30 22:08:05 +00002356 PyObject *path, *loader = NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002357 char buf[MAXPATHLEN+1];
2358 struct filedescr *fdp;
2359 FILE *fp = NULL;
2360
Guido van Rossum9c0afe51998-05-19 15:09:05 +00002361 if (mod == Py_None)
2362 path = NULL;
2363 else {
2364 path = PyObject_GetAttrString(mod, "__path__");
2365 if (path == NULL) {
2366 PyErr_Clear();
2367 Py_INCREF(Py_None);
2368 return Py_None;
2369 }
2370 }
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002371
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002372 buf[0] = '\0';
Just van Rossum52e14d62002-12-30 22:08:05 +00002373 fdp = find_module(fullname, subname, path, buf, MAXPATHLEN+1,
2374 &fp, &loader);
Guido van Rossumb68cd421998-07-01 17:36:26 +00002375 Py_XDECREF(path);
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002376 if (fdp == NULL) {
2377 if (!PyErr_ExceptionMatches(PyExc_ImportError))
2378 return NULL;
2379 PyErr_Clear();
2380 Py_INCREF(Py_None);
2381 return Py_None;
2382 }
Just van Rossum52e14d62002-12-30 22:08:05 +00002383 m = load_module(fullname, fp, buf, fdp->type, loader);
2384 Py_XDECREF(loader);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002385 if (fp)
2386 fclose(fp);
Neil Schemenauer00b09662003-06-16 21:03:07 +00002387 if (!add_submodule(mod, m, fullname, subname, modules)) {
2388 Py_XDECREF(m);
2389 m = NULL;
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002390 }
Guido van Rossum74e6a111994-08-29 12:54:38 +00002391 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002392
2393 return m;
Guido van Rossum74e6a111994-08-29 12:54:38 +00002394}
2395
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002396
2397/* Re-import a module of any kind and return its module object, WITH
2398 INCREMENTED REFERENCE COUNT */
2399
Guido van Rossum79f25d91997-04-29 20:08:16 +00002400PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002401PyImport_ReloadModule(PyObject *m)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002402{
Guido van Rossum25ce5661997-08-02 03:10:38 +00002403 PyObject *modules = PyImport_GetModuleDict();
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002404 PyObject *path = NULL, *loader = NULL;
Guido van Rossum222ef561997-09-06 19:41:09 +00002405 char *name, *subname;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002406 char buf[MAXPATHLEN+1];
2407 struct filedescr *fdp;
2408 FILE *fp = NULL;
Tim Peters1cd70172004-08-02 03:52:12 +00002409 PyObject *newm;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002410
Guido van Rossum79f25d91997-04-29 20:08:16 +00002411 if (m == NULL || !PyModule_Check(m)) {
2412 PyErr_SetString(PyExc_TypeError,
2413 "reload() argument must be module");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002414 return NULL;
2415 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002416 name = PyModule_GetName(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002417 if (name == NULL)
2418 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +00002419 if (m != PyDict_GetItemString(modules, name)) {
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002420 PyErr_Format(PyExc_ImportError,
2421 "reload(): module %.200s not in sys.modules",
2422 name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002423 return NULL;
2424 }
Guido van Rossum222ef561997-09-06 19:41:09 +00002425 subname = strrchr(name, '.');
2426 if (subname == NULL)
2427 subname = name;
2428 else {
2429 PyObject *parentname, *parent;
2430 parentname = PyString_FromStringAndSize(name, (subname-name));
2431 if (parentname == NULL)
2432 return NULL;
2433 parent = PyDict_GetItem(modules, parentname);
2434 if (parent == NULL) {
2435 PyErr_Format(PyExc_ImportError,
2436 "reload(): parent %.200s not in sys.modules",
Georg Brandl0c55f292005-09-14 06:56:20 +00002437 PyString_AS_STRING(parentname));
2438 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002439 return NULL;
2440 }
Georg Brandl0c55f292005-09-14 06:56:20 +00002441 Py_DECREF(parentname);
Guido van Rossum222ef561997-09-06 19:41:09 +00002442 subname++;
2443 path = PyObject_GetAttrString(parent, "__path__");
2444 if (path == NULL)
2445 PyErr_Clear();
2446 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002447 buf[0] = '\0';
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002448 fdp = find_module(name, subname, path, buf, MAXPATHLEN+1, &fp, &loader);
Guido van Rossum222ef561997-09-06 19:41:09 +00002449 Py_XDECREF(path);
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002450
2451 if (fdp == NULL) {
2452 Py_XDECREF(loader);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002453 return NULL;
Phillip J. Eby7ec642a2004-09-23 04:37:36 +00002454 }
2455
2456 newm = load_module(name, fp, buf, fdp->type, loader);
2457 Py_XDECREF(loader);
2458
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002459 if (fp)
2460 fclose(fp);
Tim Peters1cd70172004-08-02 03:52:12 +00002461 if (newm == NULL) {
2462 /* load_module probably removed name from modules because of
2463 * the error. Put back the original module object. We're
2464 * going to return NULL in this case regardless of whether
2465 * replacing name succeeds, so the return value is ignored.
2466 */
2467 PyDict_SetItemString(modules, name, m);
2468 }
2469 return newm;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002470}
2471
2472
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002473/* Higher-level import emulator which emulates the "import" statement
2474 more accurately -- it invokes the __import__() function from the
2475 builtins of the current globals. This means that the import is
2476 done using whatever import hooks are installed in the current
Guido van Rossum6058eb41998-12-21 19:51:00 +00002477 environment, e.g. by "rexec".
2478 A dummy list ["__doc__"] is passed as the 4th argument so that
2479 e.g. PyImport_Import(PyString_FromString("win32com.client.gencache"))
2480 will return <module "gencache"> instead of <module "win32com">. */
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002481
2482PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002483PyImport_Import(PyObject *module_name)
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002484{
2485 static PyObject *silly_list = NULL;
2486 static PyObject *builtins_str = NULL;
2487 static PyObject *import_str = NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002488 PyObject *globals = NULL;
2489 PyObject *import = NULL;
2490 PyObject *builtins = NULL;
2491 PyObject *r = NULL;
2492
2493 /* Initialize constant string objects */
2494 if (silly_list == NULL) {
2495 import_str = PyString_InternFromString("__import__");
2496 if (import_str == NULL)
2497 return NULL;
2498 builtins_str = PyString_InternFromString("__builtins__");
2499 if (builtins_str == NULL)
2500 return NULL;
2501 silly_list = Py_BuildValue("[s]", "__doc__");
2502 if (silly_list == NULL)
2503 return NULL;
2504 }
2505
2506 /* Get the builtins from current globals */
2507 globals = PyEval_GetGlobals();
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002508 if (globals != NULL) {
Guido van Rossum66468561998-10-22 15:46:50 +00002509 Py_INCREF(globals);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002510 builtins = PyObject_GetItem(globals, builtins_str);
2511 if (builtins == NULL)
2512 goto err;
2513 }
2514 else {
2515 /* No globals -- use standard builtins, and fake globals */
2516 PyErr_Clear();
2517
Thomas Woutersf7f438b2006-02-28 16:09:29 +00002518 builtins = PyImport_ImportModuleLevel("__builtin__",
2519 NULL, NULL, NULL, 0);
Guido van Rossum85cd1d62001-02-20 21:43:24 +00002520 if (builtins == NULL)
2521 return NULL;
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002522 globals = Py_BuildValue("{OO}", builtins_str, builtins);
2523 if (globals == NULL)
2524 goto err;
2525 }
2526
2527 /* Get the __import__ function from the builtins */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002528 if (PyDict_Check(builtins)) {
Fred Drakea76ba6e2001-03-06 06:31:15 +00002529 import = PyObject_GetItem(builtins, import_str);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002530 if (import == NULL)
2531 PyErr_SetObject(PyExc_KeyError, import_str);
2532 }
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002533 else
Fred Drakea76ba6e2001-03-06 06:31:15 +00002534 import = PyObject_GetAttr(builtins, import_str);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002535 if (import == NULL)
2536 goto err;
2537
2538 /* Call the _import__ function with the proper argument list */
Thomas Wouters477c8d52006-05-27 19:21:47 +00002539 r = PyObject_CallFunctionObjArgs(import, module_name, globals,
2540 globals, silly_list, NULL);
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002541
2542 err:
2543 Py_XDECREF(globals);
2544 Py_XDECREF(builtins);
2545 Py_XDECREF(import);
Tim Peters50d8d372001-02-28 05:34:27 +00002546
Guido van Rossumd47a0a81997-08-14 20:11:26 +00002547 return r;
2548}
2549
2550
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002551/* Module 'imp' provides Python access to the primitives used for
2552 importing modules.
2553*/
2554
Guido van Rossum79f25d91997-04-29 20:08:16 +00002555static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002556imp_get_magic(PyObject *self, PyObject *noargs)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002557{
2558 char buf[4];
2559
Guido van Rossum96774c12000-05-01 20:19:08 +00002560 buf[0] = (char) ((pyc_magic >> 0) & 0xff);
2561 buf[1] = (char) ((pyc_magic >> 8) & 0xff);
2562 buf[2] = (char) ((pyc_magic >> 16) & 0xff);
2563 buf[3] = (char) ((pyc_magic >> 24) & 0xff);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002564
Guido van Rossum79f25d91997-04-29 20:08:16 +00002565 return PyString_FromStringAndSize(buf, 4);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002566}
2567
Guido van Rossum79f25d91997-04-29 20:08:16 +00002568static PyObject *
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002569imp_get_suffixes(PyObject *self, PyObject *noargs)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002570{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002571 PyObject *list;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002572 struct filedescr *fdp;
2573
Guido van Rossum79f25d91997-04-29 20:08:16 +00002574 list = PyList_New(0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002575 if (list == NULL)
2576 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002577 for (fdp = _PyImport_Filetab; fdp->suffix != NULL; fdp++) {
2578 PyObject *item = Py_BuildValue("ssi",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002579 fdp->suffix, fdp->mode, fdp->type);
2580 if (item == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002581 Py_DECREF(list);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002582 return NULL;
2583 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002584 if (PyList_Append(list, item) < 0) {
2585 Py_DECREF(list);
2586 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002587 return NULL;
2588 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002589 Py_DECREF(item);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002590 }
2591 return list;
2592}
2593
Guido van Rossum79f25d91997-04-29 20:08:16 +00002594static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002595call_find_module(char *name, PyObject *path)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002596{
Tim Petersdbd9ba62000-07-09 03:09:57 +00002597 extern int fclose(FILE *);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002598 PyObject *fob, *ret;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002599 struct filedescr *fdp;
2600 char pathname[MAXPATHLEN+1];
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002601 FILE *fp = NULL;
2602
2603 pathname[0] = '\0';
Guido van Rossum17fc85f1997-09-06 18:52:03 +00002604 if (path == Py_None)
2605 path = NULL;
Just van Rossum52e14d62002-12-30 22:08:05 +00002606 fdp = find_module(NULL, name, path, pathname, MAXPATHLEN+1, &fp, NULL);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002607 if (fdp == NULL)
2608 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002609 if (fp != NULL) {
2610 fob = PyFile_FromFile(fp, pathname, fdp->mode, fclose);
2611 if (fob == NULL) {
2612 fclose(fp);
2613 return NULL;
2614 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002615 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002616 else {
2617 fob = Py_None;
2618 Py_INCREF(fob);
Tim Peters50d8d372001-02-28 05:34:27 +00002619 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002620 ret = Py_BuildValue("Os(ssi)",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002621 fob, pathname, fdp->suffix, fdp->mode, fdp->type);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002622 Py_DECREF(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002623 return ret;
2624}
2625
Guido van Rossum79f25d91997-04-29 20:08:16 +00002626static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002627imp_find_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002628{
2629 char *name;
2630 PyObject *path = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002631 if (!PyArg_ParseTuple(args, "s|O:find_module", &name, &path))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002632 return NULL;
2633 return call_find_module(name, path);
2634}
2635
2636static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002637imp_init_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002638{
2639 char *name;
2640 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002641 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002642 if (!PyArg_ParseTuple(args, "s:init_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002643 return NULL;
2644 ret = init_builtin(name);
2645 if (ret < 0)
2646 return NULL;
2647 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002648 Py_INCREF(Py_None);
2649 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002650 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002651 m = PyImport_AddModule(name);
2652 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002653 return m;
2654}
2655
Guido van Rossum79f25d91997-04-29 20:08:16 +00002656static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002657imp_init_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002658{
2659 char *name;
2660 int ret;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002661 PyObject *m;
Guido van Rossum43713e52000-02-29 13:59:29 +00002662 if (!PyArg_ParseTuple(args, "s:init_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002663 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002664 ret = PyImport_ImportFrozenModule(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002665 if (ret < 0)
2666 return NULL;
2667 if (ret == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002668 Py_INCREF(Py_None);
2669 return Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002670 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002671 m = PyImport_AddModule(name);
2672 Py_XINCREF(m);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002673 return m;
2674}
2675
Guido van Rossum79f25d91997-04-29 20:08:16 +00002676static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002677imp_get_frozen_object(PyObject *self, PyObject *args)
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002678{
2679 char *name;
Jack Jansen95ffa231995-10-03 14:38:41 +00002680
Guido van Rossum43713e52000-02-29 13:59:29 +00002681 if (!PyArg_ParseTuple(args, "s:get_frozen_object", &name))
Guido van Rossum6ec1efb1995-08-04 04:08:57 +00002682 return NULL;
2683 return get_frozen_object(name);
2684}
2685
Guido van Rossum79f25d91997-04-29 20:08:16 +00002686static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002687imp_is_builtin(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002688{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002689 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002690 if (!PyArg_ParseTuple(args, "s:is_builtin", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002691 return NULL;
Guido van Rossum50ee94f2002-04-09 18:00:58 +00002692 return PyInt_FromLong(is_builtin(name));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002693}
2694
Guido van Rossum79f25d91997-04-29 20:08:16 +00002695static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002696imp_is_frozen(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002697{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002698 char *name;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002699 struct _frozen *p;
Guido van Rossum43713e52000-02-29 13:59:29 +00002700 if (!PyArg_ParseTuple(args, "s:is_frozen", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002701 return NULL;
Guido van Rossum323bf5e1998-06-24 03:54:06 +00002702 p = find_frozen(name);
Guido van Rossumb8bff3f2002-04-07 06:34:38 +00002703 return PyBool_FromLong((long) (p == NULL ? 0 : p->size));
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002704}
2705
2706static FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002707get_file(char *pathname, PyObject *fob, char *mode)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002708{
2709 FILE *fp;
2710 if (fob == NULL) {
Tim Peters86c7d2f2004-08-01 23:24:21 +00002711 if (mode[0] == 'U')
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002712 mode = "r" PY_STDIOTEXTMODE;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002713 fp = fopen(pathname, mode);
2714 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002715 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002716 }
2717 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002718 fp = PyFile_AsFile(fob);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002719 if (fp == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002720 PyErr_SetString(PyExc_ValueError,
2721 "bad/closed file object");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002722 }
2723 return fp;
2724}
2725
Guido van Rossum79f25d91997-04-29 20:08:16 +00002726static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002727imp_load_compiled(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002728{
2729 char *name;
2730 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002731 PyObject *fob = NULL;
2732 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002733 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002734 if (!PyArg_ParseTuple(args, "ss|O!:load_compiled", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002735 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002736 return NULL;
2737 fp = get_file(pathname, fob, "rb");
2738 if (fp == NULL)
2739 return NULL;
2740 m = load_compiled_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002741 if (fob == NULL)
2742 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002743 return m;
2744}
2745
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002746#ifdef HAVE_DYNAMIC_LOADING
2747
Guido van Rossum79f25d91997-04-29 20:08:16 +00002748static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002749imp_load_dynamic(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002750{
2751 char *name;
2752 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002753 PyObject *fob = NULL;
2754 PyObject *m;
Guido van Rossum7faeab31995-07-07 22:50:36 +00002755 FILE *fp = NULL;
Guido van Rossum43713e52000-02-29 13:59:29 +00002756 if (!PyArg_ParseTuple(args, "ss|O!:load_dynamic", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002757 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002758 return NULL;
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002759 if (fob) {
Guido van Rossum7faeab31995-07-07 22:50:36 +00002760 fp = get_file(pathname, fob, "r");
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002761 if (fp == NULL)
2762 return NULL;
2763 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002764 m = _PyImport_LoadDynamicModule(name, pathname, fp);
Guido van Rossum7faeab31995-07-07 22:50:36 +00002765 return m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002766}
2767
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002768#endif /* HAVE_DYNAMIC_LOADING */
2769
Guido van Rossum79f25d91997-04-29 20:08:16 +00002770static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002771imp_load_source(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002772{
2773 char *name;
2774 char *pathname;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002775 PyObject *fob = NULL;
2776 PyObject *m;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002777 FILE *fp;
Guido van Rossum43713e52000-02-29 13:59:29 +00002778 if (!PyArg_ParseTuple(args, "ss|O!:load_source", &name, &pathname,
Guido van Rossum79f25d91997-04-29 20:08:16 +00002779 &PyFile_Type, &fob))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002780 return NULL;
2781 fp = get_file(pathname, fob, "r");
2782 if (fp == NULL)
2783 return NULL;
2784 m = load_source_module(name, pathname, fp);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002785 if (fob == NULL)
2786 fclose(fp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002787 return m;
2788}
2789
Guido van Rossum79f25d91997-04-29 20:08:16 +00002790static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002791imp_load_module(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002792{
2793 char *name;
2794 PyObject *fob;
2795 char *pathname;
2796 char *suffix; /* Unused */
2797 char *mode;
2798 int type;
2799 FILE *fp;
2800
Guido van Rossum43713e52000-02-29 13:59:29 +00002801 if (!PyArg_ParseTuple(args, "sOs(ssi):load_module",
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002802 &name, &fob, &pathname,
2803 &suffix, &mode, &type))
2804 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002805 if (*mode) {
2806 /* Mode must start with 'r' or 'U' and must not contain '+'.
2807 Implicit in this test is the assumption that the mode
2808 may contain other modifiers like 'b' or 't'. */
2809
2810 if (!(*mode == 'r' || *mode == 'U') || strchr(mode, '+')) {
Jeremy Hylton4ae6fae2002-05-30 17:15:25 +00002811 PyErr_Format(PyExc_ValueError,
2812 "invalid file open mode %.200s", mode);
2813 return NULL;
Guido van Rossum5e2c5fa2002-05-30 17:33:07 +00002814 }
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002815 }
2816 if (fob == Py_None)
2817 fp = NULL;
2818 else {
2819 if (!PyFile_Check(fob)) {
2820 PyErr_SetString(PyExc_ValueError,
2821 "load_module arg#2 should be a file or None");
2822 return NULL;
2823 }
2824 fp = get_file(pathname, fob, mode);
2825 if (fp == NULL)
2826 return NULL;
2827 }
Just van Rossum52e14d62002-12-30 22:08:05 +00002828 return load_module(name, fp, pathname, type, NULL);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002829}
2830
2831static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002832imp_load_package(PyObject *self, PyObject *args)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002833{
2834 char *name;
2835 char *pathname;
Guido van Rossum43713e52000-02-29 13:59:29 +00002836 if (!PyArg_ParseTuple(args, "ss:load_package", &name, &pathname))
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002837 return NULL;
2838 return load_package(name, pathname);
2839}
2840
2841static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002842imp_new_module(PyObject *self, PyObject *args)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002843{
2844 char *name;
Guido van Rossum43713e52000-02-29 13:59:29 +00002845 if (!PyArg_ParseTuple(args, "s:new_module", &name))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002846 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002847 return PyModule_New(name);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002848}
2849
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002850/* Doc strings */
2851
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002852PyDoc_STRVAR(doc_imp,
2853"This module provides the components needed to build your own\n\
2854__import__ function. Undocumented functions are obsolete.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002855
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002856PyDoc_STRVAR(doc_find_module,
2857"find_module(name, [path]) -> (file, filename, (suffix, mode, type))\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002858Search for a module. If path is omitted or None, search for a\n\
2859built-in, frozen or special module and continue search in sys.path.\n\
2860The module name cannot contain '.'; to search for a submodule of a\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002861package, pass the submodule name and the package's __path__.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002862
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002863PyDoc_STRVAR(doc_load_module,
2864"load_module(name, file, filename, (suffix, mode, type)) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002865Load a module, given information returned by find_module().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002866The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002867
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002868PyDoc_STRVAR(doc_get_magic,
2869"get_magic() -> string\n\
2870Return the magic number for .pyc or .pyo files.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002871
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002872PyDoc_STRVAR(doc_get_suffixes,
2873"get_suffixes() -> [(suffix, mode, type), ...]\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002874Return a list of (suffix, mode, type) tuples describing the files\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002875that find_module() looks for.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002876
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002877PyDoc_STRVAR(doc_new_module,
2878"new_module(name) -> module\n\
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002879Create a new module. Do not enter it in sys.modules.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002880The module name must include the full package name, if any.");
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002881
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002882PyDoc_STRVAR(doc_lock_held,
Tim Petersa7c65092004-08-01 23:26:05 +00002883"lock_held() -> boolean\n\
2884Return True if the import lock is currently held, else False.\n\
2885On platforms without threads, return False.");
Tim Peters69232342001-08-30 05:16:13 +00002886
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002887PyDoc_STRVAR(doc_acquire_lock,
2888"acquire_lock() -> None\n\
Neal Norwitz2294c0d2003-02-12 23:02:21 +00002889Acquires the interpreter's import lock for the current thread.\n\
2890This lock should be used by import hooks to ensure thread-safety\n\
2891when importing modules.\n\
Guido van Rossumc4f4ca92003-02-12 21:46:11 +00002892On platforms without threads, this function does nothing.");
2893
2894PyDoc_STRVAR(doc_release_lock,
2895"release_lock() -> None\n\
2896Release the interpreter's import lock.\n\
2897On platforms without threads, this function does nothing.");
2898
Guido van Rossum79f25d91997-04-29 20:08:16 +00002899static PyMethodDef imp_methods[] = {
Neal Norwitz08ea61a2003-02-17 18:18:00 +00002900 {"find_module", imp_find_module, METH_VARARGS, doc_find_module},
2901 {"get_magic", imp_get_magic, METH_NOARGS, doc_get_magic},
2902 {"get_suffixes", imp_get_suffixes, METH_NOARGS, doc_get_suffixes},
2903 {"load_module", imp_load_module, METH_VARARGS, doc_load_module},
2904 {"new_module", imp_new_module, METH_VARARGS, doc_new_module},
2905 {"lock_held", imp_lock_held, METH_NOARGS, doc_lock_held},
2906 {"acquire_lock", imp_acquire_lock, METH_NOARGS, doc_acquire_lock},
2907 {"release_lock", imp_release_lock, METH_NOARGS, doc_release_lock},
Guido van Rossum0207e6d1997-09-09 22:04:42 +00002908 /* The rest are obsolete */
Neal Norwitz031829d2002-03-31 14:37:44 +00002909 {"get_frozen_object", imp_get_frozen_object, METH_VARARGS},
2910 {"init_builtin", imp_init_builtin, METH_VARARGS},
2911 {"init_frozen", imp_init_frozen, METH_VARARGS},
2912 {"is_builtin", imp_is_builtin, METH_VARARGS},
2913 {"is_frozen", imp_is_frozen, METH_VARARGS},
2914 {"load_compiled", imp_load_compiled, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002915#ifdef HAVE_DYNAMIC_LOADING
Neal Norwitz031829d2002-03-31 14:37:44 +00002916 {"load_dynamic", imp_load_dynamic, METH_VARARGS},
Guido van Rossum96a8fb71999-12-22 14:09:35 +00002917#endif
Neal Norwitz031829d2002-03-31 14:37:44 +00002918 {"load_package", imp_load_package, METH_VARARGS},
Neal Norwitz031829d2002-03-31 14:37:44 +00002919 {"load_source", imp_load_source, METH_VARARGS},
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002920 {NULL, NULL} /* sentinel */
2921};
2922
Guido van Rossum1a8791e1998-08-04 22:46:29 +00002923static int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002924setint(PyObject *d, char *name, int value)
Guido van Rossumaee0bad1997-09-05 07:33:22 +00002925{
2926 PyObject *v;
2927 int err;
2928
2929 v = PyInt_FromLong((long)value);
2930 err = PyDict_SetItemString(d, name, v);
2931 Py_XDECREF(v);
2932 return err;
2933}
2934
Thomas Wouters0e3f5912006-08-11 14:57:12 +00002935typedef struct {
2936 PyObject_HEAD
2937} NullImporter;
2938
2939static int
2940NullImporter_init(NullImporter *self, PyObject *args, PyObject *kwds)
2941{
2942 char *path;
2943
2944 if (!_PyArg_NoKeywords("NullImporter()", kwds))
2945 return -1;
2946
2947 if (!PyArg_ParseTuple(args, "s:NullImporter",
2948 &path))
2949 return -1;
2950
2951 if (strlen(path) == 0) {
2952 PyErr_SetString(PyExc_ImportError, "empty pathname");
2953 return -1;
2954 } else {
2955#ifndef RISCOS
2956 struct stat statbuf;
2957 int rv;
2958
2959 rv = stat(path, &statbuf);
2960 if (rv == 0) {
2961 /* it exists */
2962 if (S_ISDIR(statbuf.st_mode)) {
2963 /* it's a directory */
2964 PyErr_SetString(PyExc_ImportError,
2965 "existing directory");
2966 return -1;
2967 }
2968 }
2969#else
2970 if (object_exists(path)) {
2971 /* it exists */
2972 if (isdir(path)) {
2973 /* it's a directory */
2974 PyErr_SetString(PyExc_ImportError,
2975 "existing directory");
2976 return -1;
2977 }
2978 }
2979#endif
2980 }
2981 return 0;
2982}
2983
2984static PyObject *
2985NullImporter_find_module(NullImporter *self, PyObject *args)
2986{
2987 Py_RETURN_NONE;
2988}
2989
2990static PyMethodDef NullImporter_methods[] = {
2991 {"find_module", (PyCFunction)NullImporter_find_module, METH_VARARGS,
2992 "Always return None"
2993 },
2994 {NULL} /* Sentinel */
2995};
2996
2997
2998static PyTypeObject NullImporterType = {
2999 PyObject_HEAD_INIT(NULL)
3000 0, /*ob_size*/
3001 "imp.NullImporter", /*tp_name*/
3002 sizeof(NullImporter), /*tp_basicsize*/
3003 0, /*tp_itemsize*/
3004 0, /*tp_dealloc*/
3005 0, /*tp_print*/
3006 0, /*tp_getattr*/
3007 0, /*tp_setattr*/
3008 0, /*tp_compare*/
3009 0, /*tp_repr*/
3010 0, /*tp_as_number*/
3011 0, /*tp_as_sequence*/
3012 0, /*tp_as_mapping*/
3013 0, /*tp_hash */
3014 0, /*tp_call*/
3015 0, /*tp_str*/
3016 0, /*tp_getattro*/
3017 0, /*tp_setattro*/
3018 0, /*tp_as_buffer*/
3019 Py_TPFLAGS_DEFAULT, /*tp_flags*/
3020 "Null importer object", /* tp_doc */
3021 0, /* tp_traverse */
3022 0, /* tp_clear */
3023 0, /* tp_richcompare */
3024 0, /* tp_weaklistoffset */
3025 0, /* tp_iter */
3026 0, /* tp_iternext */
3027 NullImporter_methods, /* tp_methods */
3028 0, /* tp_members */
3029 0, /* tp_getset */
3030 0, /* tp_base */
3031 0, /* tp_dict */
3032 0, /* tp_descr_get */
3033 0, /* tp_descr_set */
3034 0, /* tp_dictoffset */
3035 (initproc)NullImporter_init, /* tp_init */
3036 0, /* tp_alloc */
3037 PyType_GenericNew /* tp_new */
3038};
3039
3040
Jason Tishler6bc06ec2003-09-04 11:59:50 +00003041PyMODINIT_FUNC
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003042initimp(void)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003043{
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003044 PyObject *m, *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003045
Thomas Wouters0e3f5912006-08-11 14:57:12 +00003046 if (PyType_Ready(&NullImporterType) < 0)
3047 goto failure;
3048
Guido van Rossum0207e6d1997-09-09 22:04:42 +00003049 m = Py_InitModule4("imp", imp_methods, doc_imp,
3050 NULL, PYTHON_API_VERSION);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00003051 if (m == NULL)
3052 goto failure;
Guido van Rossum79f25d91997-04-29 20:08:16 +00003053 d = PyModule_GetDict(m);
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00003054 if (d == NULL)
3055 goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003056
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003057 if (setint(d, "SEARCH_ERROR", SEARCH_ERROR) < 0) goto failure;
3058 if (setint(d, "PY_SOURCE", PY_SOURCE) < 0) goto failure;
3059 if (setint(d, "PY_COMPILED", PY_COMPILED) < 0) goto failure;
3060 if (setint(d, "C_EXTENSION", C_EXTENSION) < 0) goto failure;
3061 if (setint(d, "PY_RESOURCE", PY_RESOURCE) < 0) goto failure;
3062 if (setint(d, "PKG_DIRECTORY", PKG_DIRECTORY) < 0) goto failure;
3063 if (setint(d, "C_BUILTIN", C_BUILTIN) < 0) goto failure;
3064 if (setint(d, "PY_FROZEN", PY_FROZEN) < 0) goto failure;
Guido van Rossum0f84a341998-08-06 13:36:01 +00003065 if (setint(d, "PY_CODERESOURCE", PY_CODERESOURCE) < 0) goto failure;
Just van Rossum52e14d62002-12-30 22:08:05 +00003066 if (setint(d, "IMP_HOOK", IMP_HOOK) < 0) goto failure;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003067
Thomas Wouters0e3f5912006-08-11 14:57:12 +00003068 Py_INCREF(&NullImporterType);
3069 PyModule_AddObject(m, "NullImporter", (PyObject *)&NullImporterType);
Guido van Rossumaee0bad1997-09-05 07:33:22 +00003070 failure:
3071 ;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00003072}
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003073
3074
Guido van Rossumb18618d2000-05-03 23:44:39 +00003075/* API for embedding applications that want to add their own entries
3076 to the table of built-in modules. This should normally be called
3077 *before* Py_Initialize(). When the table resize fails, -1 is
3078 returned and the existing table is unchanged.
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003079
3080 After a similar function by Just van Rossum. */
3081
3082int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003083PyImport_ExtendInittab(struct _inittab *newtab)
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003084{
3085 static struct _inittab *our_copy = NULL;
3086 struct _inittab *p;
3087 int i, n;
3088
3089 /* Count the number of entries in both tables */
3090 for (n = 0; newtab[n].name != NULL; n++)
3091 ;
3092 if (n == 0)
3093 return 0; /* Nothing to do */
3094 for (i = 0; PyImport_Inittab[i].name != NULL; i++)
3095 ;
3096
3097 /* Allocate new memory for the combined table */
Guido van Rossumb18618d2000-05-03 23:44:39 +00003098 p = our_copy;
3099 PyMem_RESIZE(p, struct _inittab, i+n+1);
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003100 if (p == NULL)
3101 return -1;
3102
3103 /* Copy the tables into the new memory */
3104 if (our_copy != PyImport_Inittab)
3105 memcpy(p, PyImport_Inittab, (i+1) * sizeof(struct _inittab));
3106 PyImport_Inittab = our_copy = p;
3107 memcpy(p+i, newtab, (n+1) * sizeof(struct _inittab));
3108
3109 return 0;
3110}
3111
3112/* Shorthand to add a single entry given a name and a function */
3113
3114int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00003115PyImport_AppendInittab(char *name, void (*initfunc)(void))
Guido van Rossum09cae1f1998-05-14 02:32:54 +00003116{
3117 struct _inittab newtab[2];
3118
3119 memset(newtab, '\0', sizeof newtab);
3120
3121 newtab[0].name = name;
3122 newtab[0].initfunc = initfunc;
3123
3124 return PyImport_ExtendInittab(newtab);
3125}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00003126
3127#ifdef __cplusplus
3128}
3129#endif