blob: 4ae207b3c0c3e4ec37bff1cb108f1b11e3abdbe5 [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002/* System module */
3
4/*
5Various bits of information used by the interpreter are collected in
6module 'sys'.
Guido van Rossum3f5da241990-12-20 15:06:42 +00007Function member:
Guido van Rossumcc8914f1995-03-20 15:09:40 +00008- exit(sts): raise SystemExit
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00009Data members:
10- stdin, stdout, stderr: standard file objects
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000011- modules: the table of modules (dictionary)
Guido van Rossum3f5da241990-12-20 15:06:42 +000012- path: module search path (list of strings)
13- argv: script arguments (list of strings)
14- ps1, ps2: optional primary and secondary prompts (strings)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000015*/
16
Guido van Rossum65bf9f21997-04-29 18:33:38 +000017#include "Python.h"
Barry Warsawb6a54d22000-12-06 21:47:46 +000018#include "compile.h"
19#include "frameobject.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000020
Guido van Rossume2437a11992-03-23 18:20:18 +000021#include "osdefs.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +000022
Guido van Rossum1254d791997-05-20 15:57:25 +000023#ifdef HAVE_UNISTD_H
Guido van Rossumc474dea1997-04-25 15:38:31 +000024#include <unistd.h>
25#endif
26
Guido van Rossum9b38a141996-09-11 23:12:24 +000027#ifdef MS_COREDLL
Guido van Rossumc606fe11996-04-09 02:37:57 +000028extern void *PyWin_DLLhModule;
Guido van Rossum6c1e5f21997-09-29 23:34:23 +000029/* A string loaded from the DLL at startup: */
30extern const char *PyWin_DLLVersionString;
Guido van Rossumc606fe11996-04-09 02:37:57 +000031#endif
32
Guido van Rossum65bf9f21997-04-29 18:33:38 +000033PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000034PySys_GetObject(char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000035{
Guido van Rossum25ce5661997-08-02 03:10:38 +000036 PyThreadState *tstate = PyThreadState_Get();
37 PyObject *sd = tstate->interp->sysdict;
Guido van Rossumbe203361999-10-05 22:17:41 +000038 if (sd == NULL)
39 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +000040 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000041}
42
43FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000044PySys_GetFile(char *name, FILE *def)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000045{
46 FILE *fp = NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +000047 PyObject *v = PySys_GetObject(name);
48 if (v != NULL && PyFile_Check(v))
49 fp = PyFile_AsFile(v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000050 if (fp == NULL)
51 fp = def;
52 return fp;
53}
54
55int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000056PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000057{
Guido van Rossum25ce5661997-08-02 03:10:38 +000058 PyThreadState *tstate = PyThreadState_Get();
59 PyObject *sd = tstate->interp->sysdict;
Guido van Rossum5ad58c61992-01-26 18:15:48 +000060 if (v == NULL) {
Guido van Rossum25ce5661997-08-02 03:10:38 +000061 if (PyDict_GetItemString(sd, name) == NULL)
Guido van Rossum5ad58c61992-01-26 18:15:48 +000062 return 0;
63 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000064 return PyDict_DelItemString(sd, name);
Guido van Rossum5ad58c61992-01-26 18:15:48 +000065 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000066 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000067 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000068}
69
Guido van Rossum65bf9f21997-04-29 18:33:38 +000070static PyObject *
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000071sys_displayhook(PyObject *self, PyObject *args)
72{
Greg Steinceb9b7c2001-01-11 09:27:34 +000073 PyObject *o, *outf;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000074 PyInterpreterState *interp = PyThreadState_Get()->interp;
75 PyObject *modules = interp->modules;
76 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
77
Moshe Zadka03897ea2001-07-23 13:32:43 +000078 if (builtins == NULL) {
79 PyErr_SetString(PyExc_RuntimeError, "lost __builtin__");
80 return NULL;
81 }
82
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000083 /* parse arguments */
84 if (!PyArg_ParseTuple(args, "O:displayhook", &o))
85 return NULL;
86
87 /* Print value except if None */
88 /* After printing, also assign to '_' */
89 /* Before, set '_' to None to avoid recursion */
90 if (o == Py_None) {
91 Py_INCREF(Py_None);
92 return Py_None;
93 }
94 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
95 return NULL;
96 if (Py_FlushLine() != 0)
97 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +000098 outf = PySys_GetObject("stdout");
99 if (outf == NULL) {
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000100 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
101 return NULL;
102 }
Greg Steinceb9b7c2001-01-11 09:27:34 +0000103 if (PyFile_WriteObject(o, outf, 0) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000104 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000105 PyFile_SoftSpace(outf, 1);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000106 if (Py_FlushLine() != 0)
107 return NULL;
108 if (PyObject_SetAttrString(builtins, "_", o) != 0)
109 return NULL;
110 Py_INCREF(Py_None);
111 return Py_None;
112}
113
114static char displayhook_doc[] =
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000115"displayhook(object) -> None\n"
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000116"\n"
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000117"Print an object to sys.stdout and also save it in __builtin__._\n";
118
119static PyObject *
120sys_excepthook(PyObject* self, PyObject* args)
121{
122 PyObject *exc, *value, *tb;
123 if (!PyArg_ParseTuple(args, "OOO:excepthook", &exc, &value, &tb))
124 return NULL;
125 PyErr_Display(exc, value, tb);
126 Py_INCREF(Py_None);
127 return Py_None;
128}
129
130static char excepthook_doc[] =
131"excepthook(exctype, value, traceback) -> None\n"
132"\n"
133"Handle an exception by displaying it with a traceback on sys.stderr.\n";
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000134
135static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000136sys_exc_info(PyObject *self, PyObject *args)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000137{
138 PyThreadState *tstate;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000139 if (!PyArg_ParseTuple(args, ":exc_info"))
Guido van Rossuma027efa1997-05-05 20:56:21 +0000140 return NULL;
141 tstate = PyThreadState_Get();
Guido van Rossuma027efa1997-05-05 20:56:21 +0000142 return Py_BuildValue(
143 "(OOO)",
144 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
145 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
146 tstate->exc_traceback != NULL ?
147 tstate->exc_traceback : Py_None);
148}
149
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000150static char exc_info_doc[] =
151"exc_info() -> (type, value, traceback)\n\
152\n\
153Return information about the exception that is currently being handled.\n\
154This should be called from inside an except clause only.";
155
Guido van Rossuma027efa1997-05-05 20:56:21 +0000156static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000157sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000158{
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000159 /* Raise SystemExit so callers may catch it or clean up. */
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000160 PyErr_SetObject(PyExc_SystemExit, args);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000161 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000162}
163
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000164static char exit_doc[] =
165"exit([status])\n\
166\n\
167Exit the interpreter by raising SystemExit(status).\n\
168If the status is omitted or None, it defaults to zero (i.e., success).\n\
169If the status numeric, it will be used as the system exit status.\n\
170If it is another kind of object, it will be printed and the system\n\
171exit status will be one (i.e., failure).";
172
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000173static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000174sys_getdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000175{
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000176 if (!PyArg_ParseTuple(args, ":getdefaultencoding"))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000177 return NULL;
178 return PyString_FromString(PyUnicode_GetDefaultEncoding());
179}
180
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000181static char getdefaultencoding_doc[] =
182"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000183\n\
184Return the current default string encoding used by the Unicode \n\
185implementation.";
186
187static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000188sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000189{
190 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000191 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000192 return NULL;
193 if (PyUnicode_SetDefaultEncoding(encoding))
194 return NULL;
195 Py_INCREF(Py_None);
196 return Py_None;
197}
198
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000199static char setdefaultencoding_doc[] =
200"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000201\n\
202Set the current default string encoding used by the Unicode implementation.";
203
Fred Drake5755ce62001-06-27 19:19:46 +0000204/*
205 * Cached interned string objects used for calling the profile and
206 * trace functions. Initialized by trace_init().
207 */
208static PyObject *whatstrings[4] = {NULL, NULL, NULL, NULL};
209
210static int
211trace_init(void)
212{
213 static char *whatnames[4] = {"call", "exception", "line", "return"};
214 PyObject *name;
215 int i;
216 for (i = 0; i < 4; ++i) {
217 if (whatstrings[i] == NULL) {
218 name = PyString_InternFromString(whatnames[i]);
219 if (name == NULL)
220 return -1;
221 whatstrings[i] = name;
222 }
223 }
224 return 0;
225}
226
227
228static PyObject *
229call_trampoline(PyThreadState *tstate, PyObject* callback,
230 PyFrameObject *frame, int what, PyObject *arg)
231{
232 PyObject *args = PyTuple_New(3);
233 PyObject *whatstr;
234 PyObject *result;
235
236 if (args == NULL)
237 return NULL;
238 Py_INCREF(frame);
239 whatstr = whatstrings[what];
240 Py_INCREF(whatstr);
241 if (arg == NULL)
242 arg = Py_None;
243 Py_INCREF(arg);
244 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
245 PyTuple_SET_ITEM(args, 1, whatstr);
246 PyTuple_SET_ITEM(args, 2, arg);
247
248 /* call the Python-level function */
249 PyFrame_FastToLocals(frame);
250 result = PyEval_CallObject(callback, args);
251 PyFrame_LocalsToFast(frame, 1);
252 if (result == NULL)
253 PyTraceBack_Here(frame);
254
255 /* cleanup */
256 Py_DECREF(args);
257 return result;
258}
259
260static int
261profile_trampoline(PyObject *self, PyFrameObject *frame,
262 int what, PyObject *arg)
263{
264 PyThreadState *tstate = frame->f_tstate;
265 PyObject *result;
266
267 result = call_trampoline(tstate, self, frame, what, arg);
268 if (result == NULL) {
269 PyEval_SetProfile(NULL, NULL);
270 return -1;
271 }
272 Py_DECREF(result);
273 return 0;
274}
275
276static int
277trace_trampoline(PyObject *self, PyFrameObject *frame,
278 int what, PyObject *arg)
279{
280 PyThreadState *tstate = frame->f_tstate;
281 PyObject *callback;
282 PyObject *result;
283
284 if (what == PyTrace_CALL)
285 callback = self;
286 else
287 callback = frame->f_trace;
288 if (callback == NULL)
289 return 0;
290 result = call_trampoline(tstate, callback, frame, what, arg);
291 if (result == NULL) {
292 PyEval_SetTrace(NULL, NULL);
293 Py_XDECREF(frame->f_trace);
294 frame->f_trace = NULL;
295 return -1;
296 }
297 if (result != Py_None) {
298 PyObject *temp = frame->f_trace;
299 frame->f_trace = NULL;
300 Py_XDECREF(temp);
301 frame->f_trace = result;
302 }
303 else {
304 Py_DECREF(result);
305 }
306 return 0;
307}
Fred Draked0838392001-06-16 21:02:31 +0000308
Fred Drake8b4d01d2000-05-09 19:57:01 +0000309static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000310sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000311{
Fred Drake5755ce62001-06-27 19:19:46 +0000312 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000313 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000314 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000315 PyEval_SetTrace(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000316 else
Fred Drake5755ce62001-06-27 19:19:46 +0000317 PyEval_SetTrace(trace_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000318 Py_INCREF(Py_None);
319 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000320}
321
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000322static char settrace_doc[] =
323"settrace(function)\n\
324\n\
325Set the global debug tracing function. It will be called on each\n\
326function call. See the debugger chapter in the library manual.";
327
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000328static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000329sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000330{
Fred Drake5755ce62001-06-27 19:19:46 +0000331 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000332 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000333 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000334 PyEval_SetProfile(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000335 else
Fred Drake5755ce62001-06-27 19:19:46 +0000336 PyEval_SetProfile(profile_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000337 Py_INCREF(Py_None);
338 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000339}
340
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000341static char setprofile_doc[] =
342"setprofile(function)\n\
343\n\
344Set the profiling function. It will be called on each function call\n\
345and return. See the profiler chapter in the library manual.";
346
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000347static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000348sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000349{
Guido van Rossuma027efa1997-05-05 20:56:21 +0000350 PyThreadState *tstate = PyThreadState_Get();
Guido van Rossum43713e52000-02-29 13:59:29 +0000351 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &tstate->interp->checkinterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000352 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000353 Py_INCREF(Py_None);
354 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000355}
356
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000357static char setcheckinterval_doc[] =
358"setcheckinterval(n)\n\
359\n\
360Tell the Python interpreter to check for asynchronous events every\n\
361n instructions. This also affects how often thread switches occur.";
362
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000363static PyObject *
364sys_setrecursionlimit(PyObject *self, PyObject *args)
365{
366 int new_limit;
367 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
368 return NULL;
369 if (new_limit <= 0) {
370 PyErr_SetString(PyExc_ValueError,
371 "recursion limit must be positive");
372 return NULL;
373 }
374 Py_SetRecursionLimit(new_limit);
375 Py_INCREF(Py_None);
376 return Py_None;
377}
378
379static char setrecursionlimit_doc[] =
380"setrecursionlimit(n)\n\
381\n\
382Set the maximum depth of the Python interpreter stack to n. This\n\
383limit prevents infinite recursion from causing an overflow of the C\n\
384stack and crashing Python. The highest possible limit is platform-\n\
385dependent.";
386
387static PyObject *
388sys_getrecursionlimit(PyObject *self, PyObject *args)
389{
390 if (!PyArg_ParseTuple(args, ":getrecursionlimit"))
391 return NULL;
392 return PyInt_FromLong(Py_GetRecursionLimit());
393}
394
395static char getrecursionlimit_doc[] =
396"getrecursionlimit()\n\
397\n\
398Return the current value of the recursion limit, the maximum depth\n\
399of the Python interpreter stack. This limit prevents infinite\n\
400recursion from causing an overflow of the C stack and crashing Python.";
401
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000402#ifdef HAVE_DLOPEN
403static PyObject *
404sys_setdlopenflags(PyObject *self, PyObject *args)
405{
406 int new_val;
407 PyThreadState *tstate = PyThreadState_Get();
408 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
409 return NULL;
410 if (!tstate)
411 return NULL;
412 tstate->interp->dlopenflags = new_val;
413 Py_INCREF(Py_None);
414 return Py_None;
415}
416
417static char setdlopenflags_doc[] =
418"setdlopenflags(n) -> None\n\
419\n\
420Set the flags that will be used for dlopen() calls. Among other\n\
421things, this will enable a lazy resolving of symbols when imporing\n\
422a module, if called as sys.setdlopenflags(0)\n\
423To share symols across extension modules, call as\n\
424sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)";
425
426static PyObject *
427sys_getdlopenflags(PyObject *self, PyObject *args)
428{
429 PyThreadState *tstate = PyThreadState_Get();
430 if (!PyArg_ParseTuple(args, ":getdlopenflags"))
431 return NULL;
432 if (!tstate)
433 return NULL;
434 return PyInt_FromLong(tstate->interp->dlopenflags);
435}
436
437static char getdlopenflags_doc[] =
438"getdlopenflags() -> int\n\
439\n\
440Return the current value of the flags that are used for dlopen()\n\
441calls. The flag constants are defined in the dl module.";
442#endif
443
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000444#ifdef USE_MALLOPT
445/* Link with -lmalloc (or -lmpc) on an SGI */
446#include <malloc.h>
447
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000448static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000449sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000450{
451 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000452 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000453 return NULL;
454 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000455 Py_INCREF(Py_None);
456 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000457}
458#endif /* USE_MALLOPT */
459
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000460static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000461sys_getrefcount(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000462{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000463 PyObject *arg;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000464 if (!PyArg_ParseTuple(args, "O:getrefcount", &arg))
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000465 return NULL;
Mark Hammond440d8982000-06-20 08:12:48 +0000466 return PyInt_FromLong(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000467}
468
Mark Hammond440d8982000-06-20 08:12:48 +0000469#ifdef Py_TRACE_REFS
470static PyObject *
471sys_gettotalrefcount(PyObject *self, PyObject *args)
472{
473 extern long _Py_RefTotal;
474 if (!PyArg_ParseTuple(args, ":gettotalrefcount"))
475 return NULL;
476 return PyInt_FromLong(_Py_RefTotal);
477}
478
479#endif /* Py_TRACE_REFS */
480
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000481static char getrefcount_doc[] =
482"getrefcount(object) -> integer\n\
483\n\
484Return the current reference count for the object. This includes the\n\
485temporary reference in the argument list, so it is at least 2.";
486
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000487#ifdef COUNT_ALLOCS
488static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000489sys_getcounts(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000490{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000491 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000492
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000493 if (!PyArg_ParseTuple(args, ":getcounts"))
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000494 return NULL;
495 return get_counts();
496}
497#endif
498
Barry Warsawb6a54d22000-12-06 21:47:46 +0000499static char getframe_doc[] =
500"_getframe([depth]) -> frameobject\n\
501\n\
502Return a frame object from the call stack. If optional integer depth is\n\
503given, return the frame object that many calls below the top of the stack.\n\
504If that is deeper than the call stack, ValueError is raised. The default\n\
505for depth is zero, returning the frame at the top of the call stack.\n\
506\n\
507This function should be used for internal and specialized\n\
508purposes only.";
509
510static PyObject *
511sys_getframe(PyObject *self, PyObject *args)
512{
513 PyFrameObject *f = PyThreadState_Get()->frame;
514 int depth = -1;
515
516 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
517 return NULL;
518
519 while (depth > 0 && f != NULL) {
520 f = f->f_back;
521 --depth;
522 }
523 if (f == NULL) {
524 PyErr_SetString(PyExc_ValueError,
525 "call stack is not deep enough");
526 return NULL;
527 }
528 Py_INCREF(f);
529 return (PyObject*)f;
530}
531
532
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000533#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000534/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000535extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000536#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000537
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000538#ifdef DYNAMIC_EXECUTION_PROFILE
539/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000540extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000541#endif
542
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000543static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000544 /* Might as well keep this in alphabetic order */
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000545 {"displayhook", sys_displayhook, 1, displayhook_doc},
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000546 {"exc_info", sys_exc_info, 1, exc_info_doc},
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000547 {"excepthook", sys_excepthook, 1, excepthook_doc},
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000548 {"exit", sys_exit, 0, exit_doc},
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000549 {"getdefaultencoding", sys_getdefaultencoding, 1,
550 getdefaultencoding_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000551#ifdef HAVE_DLOPEN
552 {"getdlopenflags", sys_getdlopenflags, 1,
553 getdlopenflags_doc},
554#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000555#ifdef COUNT_ALLOCS
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000556 {"getcounts", sys_getcounts, 1},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000557#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000558#ifdef DYNAMIC_EXECUTION_PROFILE
559 {"getdxp", _Py_GetDXProfile, 1},
560#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000561#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000562 {"getobjects", _Py_GetObjects, 1},
Mark Hammond440d8982000-06-20 08:12:48 +0000563 {"gettotalrefcount", sys_gettotalrefcount, 1},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000564#endif
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000565 {"getrefcount", sys_getrefcount, 1, getrefcount_doc},
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000566 {"getrecursionlimit", sys_getrecursionlimit, 1,
567 getrecursionlimit_doc},
Barry Warsawb6a54d22000-12-06 21:47:46 +0000568 {"_getframe", sys_getframe, 1, getframe_doc},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000569#ifdef USE_MALLOPT
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000570 {"mdebug", sys_mdebug, 1},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000571#endif
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000572 {"setdefaultencoding", sys_setdefaultencoding, 1,
573 setdefaultencoding_doc},
574 {"setcheckinterval", sys_setcheckinterval, 1,
575 setcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000576#ifdef HAVE_DLOPEN
577 {"setdlopenflags", sys_setdlopenflags, 1,
578 setdlopenflags_doc},
579#endif
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000580 {"setprofile", sys_setprofile, 0, setprofile_doc},
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000581 {"setrecursionlimit", sys_setrecursionlimit, 1,
582 setrecursionlimit_doc},
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000583 {"settrace", sys_settrace, 0, settrace_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000584 {NULL, NULL} /* sentinel */
585};
586
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000587static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000588list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000589{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000590 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000591 int i;
592 if (list == NULL)
593 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000594 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Guido van Rossuma027efa1997-05-05 20:56:21 +0000595 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000596 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000597 if (name == NULL)
598 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000599 PyList_Append(list, name);
600 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000601 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000602 if (PyList_Sort(list) != 0) {
603 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000604 list = NULL;
605 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000606 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000607 PyObject *v = PyList_AsTuple(list);
608 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000609 list = v;
610 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000611 return list;
612}
613
Guido van Rossum23fff912000-12-15 22:02:05 +0000614static PyObject *warnoptions = NULL;
615
616void
617PySys_ResetWarnOptions(void)
618{
619 if (warnoptions == NULL || !PyList_Check(warnoptions))
620 return;
621 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
622}
623
624void
625PySys_AddWarnOption(char *s)
626{
627 PyObject *str;
628
629 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
630 Py_XDECREF(warnoptions);
631 warnoptions = PyList_New(0);
632 if (warnoptions == NULL)
633 return;
634 }
635 str = PyString_FromString(s);
636 if (str != NULL) {
637 PyList_Append(warnoptions, str);
638 Py_DECREF(str);
639 }
640}
641
Guido van Rossum40552d01998-08-06 03:34:39 +0000642/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
643 Two literals concatenated works just fine. If you have a K&R compiler
644 or other abomination that however *does* understand longer strings,
645 get rid of the !!! comment in the middle and the quotes that surround it. */
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000646static char sys_doc[] =
647"This module provides access to some objects used or maintained by the\n\
648interpreter and to functions that interact strongly with the interpreter.\n\
649\n\
650Dynamic objects:\n\
651\n\
652argv -- command line arguments; argv[0] is the script pathname if known\n\
653path -- module search path; path[0] is the script directory, else ''\n\
654modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000655\n\
656displayhook -- called to show results in an interactive session\n\
657excepthook -- called to handle any uncaught exception other than SystemExit\n\
658 To customize printing in an interactive session or to install a custom\n\
659 top-level exception handler, assign other functions to replace these.\n\
660\n\
661exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
662 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000663\n\
664stdin -- standard input file object; used by raw_input() and input()\n\
665stdout -- standard output file object; used by the print statement\n\
666stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000667 By assigning other file objects (or objects that behave like files)\n\
668 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000669\n\
670last_type -- type of last uncaught exception\n\
671last_value -- value of last uncaught exception\n\
672last_traceback -- traceback of last uncaught exception\n\
673 These three are only available in an interactive session after a\n\
674 traceback has been printed.\n\
675\n\
676exc_type -- type of exception currently being handled\n\
677exc_value -- value of exception currently being handled\n\
678exc_traceback -- traceback of exception currently being handled\n\
679 The function exc_info() should be used instead of these three,\n\
680 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000681"
682#ifndef MS_WIN16
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000683/* concatenating string here */
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000684"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000685Static objects:\n\
686\n\
687maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +0000688maxunicode -- the largest supported character\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000689builtin_module_names -- tuple of module names built into this intepreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +0000690version -- the version of this interpreter as a string\n\
691version_info -- version information as a tuple\n\
692hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000693copyright -- copyright notice pertaining to this interpreter\n\
694platform -- platform identifier\n\
695executable -- pathname of this Python interpreter\n\
696prefix -- prefix used to find the Python library\n\
697exec_prefix -- prefix used to find the machine-specific Python library\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000698"
699#ifdef MS_WINDOWS
700/* concatenating string here */
701"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000702winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000703"
704#endif /* MS_WINDOWS */
705"__stdin__ -- the original stdin; don't touch!\n\
706__stdout__ -- the original stdout; don't touch!\n\
707__stderr__ -- the original stderr; don't touch!\n\
708__displayhook__ -- the original displayhook; don't touch!\n\
709__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000710\n\
711Functions:\n\
712\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000713displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000714excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000715exc_info() -- return thread-safe information about the current exception\n\
716exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000717getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000718getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000719getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000720setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000721setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000722setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000723setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000724settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +0000725"
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000726#endif /* MS_WIN16 */
Fred Drakeccede592000-08-14 20:59:57 +0000727/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000728
Guido van Rossum25ce5661997-08-02 03:10:38 +0000729PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000730_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000731{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000732 PyObject *m, *v, *sysdict;
733 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +0000734 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000735
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000736 m = Py_InitModule3("sys", sys_methods, sys_doc);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000737 sysdict = PyModule_GetDict(m);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000738
739 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
740 sysout = PyFile_FromFile(stdout, "<stdout>", "w", NULL);
741 syserr = PyFile_FromFile(stderr, "<stderr>", "w", NULL);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000742 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +0000743 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000744 PyDict_SetItemString(sysdict, "stdin", sysin);
745 PyDict_SetItemString(sysdict, "stdout", sysout);
746 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +0000747 /* Make backup copies for cleanup */
748 PyDict_SetItemString(sysdict, "__stdin__", sysin);
749 PyDict_SetItemString(sysdict, "__stdout__", sysout);
750 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000751 PyDict_SetItemString(sysdict, "__displayhook__",
752 PyDict_GetItemString(sysdict, "displayhook"));
753 PyDict_SetItemString(sysdict, "__excepthook__",
754 PyDict_GetItemString(sysdict, "excepthook"));
Guido van Rossum25ce5661997-08-02 03:10:38 +0000755 Py_XDECREF(sysin);
756 Py_XDECREF(sysout);
757 Py_XDECREF(syserr);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000758 PyDict_SetItemString(sysdict, "version",
759 v = PyString_FromString(Py_GetVersion()));
Barry Warsaw54892c41999-01-27 16:33:19 +0000760 Py_XDECREF(v);
Guido van Rossume0d7dae1999-01-03 12:55:39 +0000761 PyDict_SetItemString(sysdict, "hexversion",
762 v = PyInt_FromLong(PY_VERSION_HEX));
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000763 Py_XDECREF(v);
Fred Drake93a20bf2000-04-13 17:44:51 +0000764 /*
765 * These release level checks are mutually exclusive and cover
766 * the field, so don't get too fancy with the pre-processor!
767 */
768#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +0000769 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +0000770#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +0000771 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +0000772#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +0000773 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +0000774#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +0000775 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +0000776#endif
Fred Drake801c08d2000-04-13 15:29:10 +0000777 PyDict_SetItemString(sysdict, "version_info",
Fred Drake6d27c1e2000-04-13 20:03:20 +0000778 v = Py_BuildValue("iiisi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +0000779 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +0000780 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +0000781 PY_RELEASE_SERIAL));
Fred Drake801c08d2000-04-13 15:29:10 +0000782 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000783 PyDict_SetItemString(sysdict, "copyright",
784 v = PyString_FromString(Py_GetCopyright()));
785 Py_XDECREF(v);
786 PyDict_SetItemString(sysdict, "platform",
787 v = PyString_FromString(Py_GetPlatform()));
788 Py_XDECREF(v);
Guido van Rossumb2c8ec41997-05-22 20:41:20 +0000789 PyDict_SetItemString(sysdict, "executable",
790 v = PyString_FromString(Py_GetProgramFullPath()));
791 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000792 PyDict_SetItemString(sysdict, "prefix",
793 v = PyString_FromString(Py_GetPrefix()));
794 Py_XDECREF(v);
795 PyDict_SetItemString(sysdict, "exec_prefix",
796 v = PyString_FromString(Py_GetExecPrefix()));
797 Py_XDECREF(v);
798 PyDict_SetItemString(sysdict, "maxint",
799 v = PyInt_FromLong(PyInt_GetMax()));
800 Py_XDECREF(v);
Martin v. Löwisce9b5a52001-06-27 06:28:56 +0000801 PyDict_SetItemString(sysdict, "maxunicode",
802 v = PyInt_FromLong(PyUnicode_GetMax()));
803 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000804 PyDict_SetItemString(sysdict, "builtin_module_names",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000805 v = list_builtin_module_names());
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000806 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +0000807 {
808 /* Assumes that longs are at least 2 bytes long.
809 Should be safe! */
810 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +0000811 char *value;
Fred Drake099325e2000-08-14 15:47:03 +0000812
813 s = (char *) &number;
814 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +0000815 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +0000816 else
Fred Drakea2b6ad62000-08-15 04:24:43 +0000817 value = "little";
818 PyDict_SetItemString(sysdict, "byteorder",
Barry Warsawf2581c92000-08-16 23:03:57 +0000819 v = PyString_FromString(value));
820 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +0000821 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +0000822#ifdef MS_COREDLL
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000823 PyDict_SetItemString(sysdict, "dllhandle",
Guido van Rossum582acec2000-06-28 22:07:35 +0000824 v = PyLong_FromVoidPtr(PyWin_DLLhModule));
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000825 Py_XDECREF(v);
826 PyDict_SetItemString(sysdict, "winver",
Guido van Rossum6c1e5f21997-09-29 23:34:23 +0000827 v = PyString_FromString(PyWin_DLLVersionString));
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000828 Py_XDECREF(v);
Guido van Rossumc606fe11996-04-09 02:37:57 +0000829#endif
Guido van Rossum23fff912000-12-15 22:02:05 +0000830 if (warnoptions == NULL) {
831 warnoptions = PyList_New(0);
832 }
833 else {
834 Py_INCREF(warnoptions);
835 }
836 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +0000837 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +0000838 }
839
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000840 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +0000841 return NULL;
842 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000843}
844
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000845static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000846makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000847{
Guido van Rossum3f5da241990-12-20 15:06:42 +0000848 int i, n;
849 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000850 PyObject *v, *w;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000851
852 n = 1;
853 p = path;
854 while ((p = strchr(p, delim)) != NULL) {
855 n++;
856 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000857 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000858 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000859 if (v == NULL)
860 return NULL;
861 for (i = 0; ; i++) {
862 p = strchr(path, delim);
863 if (p == NULL)
864 p = strchr(path, '\0'); /* End of string */
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000865 w = PyString_FromStringAndSize(path, (int) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +0000866 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000867 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000868 return NULL;
869 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000870 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000871 if (*p == '\0')
872 break;
873 path = p+1;
874 }
875 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000876}
877
878void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000879PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000880{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000881 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000882 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000883 Py_FatalError("can't create sys.path");
884 if (PySys_SetObject("path", v) != 0)
885 Py_FatalError("can't assign sys.path");
886 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000887}
888
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000889static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000890makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000891{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000892 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +0000893 if (argc <= 0 || argv == NULL) {
894 /* Ensure at least one (empty) argument is seen */
895 static char *empty_argv[1] = {""};
896 argv = empty_argv;
897 argc = 1;
898 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000899 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000900 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000901 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000902 for (i = 0; i < argc; i++) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000903 PyObject *v = PyString_FromString(argv[i]);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000904 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000905 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000906 av = NULL;
907 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000908 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000909 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000910 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000911 }
Guido van Rossum3f5da241990-12-20 15:06:42 +0000912 return av;
913}
914
915void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000916PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000917{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000918 PyObject *av = makeargvobject(argc, argv);
919 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000920 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000921 Py_FatalError("no mem for sys.argv");
922 if (PySys_SetObject("argv", av) != 0)
923 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +0000924 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +0000925 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +0000926 char *p = NULL;
Guido van Rossumcc883411996-09-10 14:44:21 +0000927 int n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000928 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +0000929#ifdef HAVE_READLINK
930 char link[MAXPATHLEN+1];
931 char argv0copy[2*MAXPATHLEN+1];
932 int nr = 0;
933 if (argc > 0 && argv0 != NULL)
934 nr = readlink(argv0, link, MAXPATHLEN);
935 if (nr > 0) {
936 /* It's a symlink */
937 link[nr] = '\0';
938 if (link[0] == SEP)
939 argv0 = link; /* Link to absolute path */
940 else if (strchr(link, SEP) == NULL)
941 ; /* Link without path */
942 else {
943 /* Must join(dirname(argv0), link) */
944 char *q = strrchr(argv0, SEP);
945 if (q == NULL)
946 argv0 = link; /* argv0 without path */
947 else {
948 /* Must make a copy */
949 strcpy(argv0copy, argv0);
950 q = strrchr(argv0copy, SEP);
951 strcpy(q+1, link);
952 argv0 = argv0copy;
953 }
954 }
955 }
956#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +0000957#if SEP == '\\' /* Special case for MS filename syntax */
Guido van Rossumc474dea1997-04-25 15:38:31 +0000958 if (argc > 0 && argv0 != NULL) {
Guido van Rossumcc883411996-09-10 14:44:21 +0000959 char *q;
Guido van Rossumc474dea1997-04-25 15:38:31 +0000960 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +0000961 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +0000962 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +0000963 if (q != NULL)
964 p = q;
965 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +0000966 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +0000967 if (n > 1 && p[-1] != ':')
968 n--; /* Drop trailing separator */
969 }
970 }
971#else /* All other filename syntaxes */
Guido van Rossumc474dea1997-04-25 15:38:31 +0000972 if (argc > 0 && argv0 != NULL)
973 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +0000974 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +0000975#ifndef RISCOS
Guido van Rossumc474dea1997-04-25 15:38:31 +0000976 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +0000977#else /* don't include trailing separator */
978 n = p - argv0;
979#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +0000980#if SEP == '/' /* Special case for Unix filename syntax */
981 if (n > 1)
982 n--; /* Drop trailing separator */
983#endif /* Unix */
984 }
985#endif /* All others */
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000986 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +0000987 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000988 Py_FatalError("no mem for sys.path insertion");
989 if (PyList_Insert(path, 0, a) < 0)
990 Py_FatalError("sys.path.insert(0) failed");
991 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +0000992 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000993 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000994}
Guido van Rossuma890e681998-05-12 14:59:24 +0000995
996
997/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
998 Adapted from code submitted by Just van Rossum.
999
1000 PySys_WriteStdout(format, ...)
1001 PySys_WriteStderr(format, ...)
1002
1003 The first function writes to sys.stdout; the second to sys.stderr. When
1004 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001005 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001006
1007 Both take a printf-style format string as their first argument followed
1008 by a variable length argument list determined by the format string.
1009
1010 *** WARNING ***
1011
1012 The format should limit the total size of the formatted output string to
1013 1000 bytes. In particular, this means that no unrestricted "%s" formats
1014 should occur; these should be limited using "%.<N>s where <N> is a
1015 decimal number calculated so that <N> plus the maximum size of other
1016 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1017 which can print hundreds of digits for very large numbers.
1018
1019 */
1020
1021static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001022mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001023{
1024 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001025 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001026
Guido van Rossum8442af31998-10-12 18:22:10 +00001027 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001028 file = PySys_GetObject(name);
1029 if (file == NULL || PyFile_AsFile(file) == fp)
1030 vfprintf(fp, format, va);
1031 else {
1032 char buffer[1001];
Guido van Rossum8442af31998-10-12 18:22:10 +00001033 if (vsprintf(buffer, format, va) >= sizeof(buffer))
1034 Py_FatalError("PySys_WriteStdout/err: buffer overrun");
Guido van Rossuma890e681998-05-12 14:59:24 +00001035 if (PyFile_WriteString(buffer, file) != 0) {
1036 PyErr_Clear();
1037 fputs(buffer, fp);
1038 }
1039 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001040 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001041}
1042
1043void
Guido van Rossuma890e681998-05-12 14:59:24 +00001044PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001045{
1046 va_list va;
1047
Guido van Rossuma890e681998-05-12 14:59:24 +00001048 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001049 mywrite("stdout", stdout, format, va);
1050 va_end(va);
1051}
1052
1053void
Guido van Rossuma890e681998-05-12 14:59:24 +00001054PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001055{
1056 va_list va;
1057
Guido van Rossuma890e681998-05-12 14:59:24 +00001058 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001059 mywrite("stderr", stderr, format, va);
1060 va_end(va);
1061}