blob: c6eb91fc6f563ee7626f2af4924bea5c5ac1faf2 [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"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +000018#include "code.h"
Barry Warsawb6a54d22000-12-06 21:47:46 +000019#include "frameobject.h"
Guido van Rossuma12fe4e2003-04-09 19:06:21 +000020#include "eval.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000021
Guido van Rossume2437a11992-03-23 18:20:18 +000022#include "osdefs.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +000023
Mark Hammond8696ebc2002-10-08 02:44:31 +000024#ifdef MS_WINDOWS
25#define WIN32_LEAN_AND_MEAN
26#include "windows.h"
27#endif /* MS_WINDOWS */
28
Guido van Rossum9b38a141996-09-11 23:12:24 +000029#ifdef MS_COREDLL
Guido van Rossumc606fe11996-04-09 02:37:57 +000030extern void *PyWin_DLLhModule;
Guido van Rossum6c1e5f21997-09-29 23:34:23 +000031/* A string loaded from the DLL at startup: */
32extern const char *PyWin_DLLVersionString;
Guido van Rossumc606fe11996-04-09 02:37:57 +000033#endif
34
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +000035#ifdef __VMS
36#include <unixlib.h>
37#endif
38
Martin v. Löwis5467d4c2003-05-10 07:10:12 +000039#ifdef MS_WINDOWS
40#include <windows.h>
41#endif
42
43#ifdef HAVE_LANGINFO_H
44#include <locale.h>
45#include <langinfo.h>
46#endif
47
Guido van Rossum65bf9f21997-04-29 18:33:38 +000048PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000049PySys_GetObject(char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000050{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000051 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000052 PyObject *sd = tstate->interp->sysdict;
Guido van Rossumbe203361999-10-05 22:17:41 +000053 if (sd == NULL)
54 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +000055 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000056}
57
58FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000059PySys_GetFile(char *name, FILE *def)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000060{
61 FILE *fp = NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +000062 PyObject *v = PySys_GetObject(name);
63 if (v != NULL && PyFile_Check(v))
64 fp = PyFile_AsFile(v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000065 if (fp == NULL)
66 fp = def;
67 return fp;
68}
69
70int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000071PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000072{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000073 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000074 PyObject *sd = tstate->interp->sysdict;
Guido van Rossum5ad58c61992-01-26 18:15:48 +000075 if (v == NULL) {
Guido van Rossum25ce5661997-08-02 03:10:38 +000076 if (PyDict_GetItemString(sd, name) == NULL)
Guido van Rossum5ad58c61992-01-26 18:15:48 +000077 return 0;
78 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000079 return PyDict_DelItemString(sd, name);
Guido van Rossum5ad58c61992-01-26 18:15:48 +000080 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000081 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000082 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000083}
84
Guido van Rossum65bf9f21997-04-29 18:33:38 +000085static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000086sys_displayhook(PyObject *self, PyObject *o)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000087{
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000088 PyObject *outf;
Nicholas Bastine5662ae2004-03-24 22:22:12 +000089 PyInterpreterState *interp = PyThreadState_GET()->interp;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000090 PyObject *modules = interp->modules;
91 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
92
Moshe Zadka03897ea2001-07-23 13:32:43 +000093 if (builtins == NULL) {
94 PyErr_SetString(PyExc_RuntimeError, "lost __builtin__");
95 return NULL;
96 }
97
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000098 /* Print value except if None */
99 /* After printing, also assign to '_' */
100 /* Before, set '_' to None to avoid recursion */
101 if (o == Py_None) {
102 Py_INCREF(Py_None);
103 return Py_None;
104 }
105 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
106 return NULL;
107 if (Py_FlushLine() != 0)
108 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000109 outf = PySys_GetObject("stdout");
110 if (outf == NULL) {
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000111 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
112 return NULL;
113 }
Greg Steinceb9b7c2001-01-11 09:27:34 +0000114 if (PyFile_WriteObject(o, outf, 0) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000115 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000116 PyFile_SoftSpace(outf, 1);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000117 if (Py_FlushLine() != 0)
118 return NULL;
119 if (PyObject_SetAttrString(builtins, "_", o) != 0)
120 return NULL;
121 Py_INCREF(Py_None);
122 return Py_None;
123}
124
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000125PyDoc_STRVAR(displayhook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000126"displayhook(object) -> None\n"
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000127"\n"
Brett Cannon51185172006-03-02 22:07:40 +0000128"Print an object to sys.stdout and also save it in __builtin__.\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000129);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000130
131static PyObject *
132sys_excepthook(PyObject* self, PyObject* args)
133{
134 PyObject *exc, *value, *tb;
Fred Drakea7688822001-10-24 20:47:48 +0000135 if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb))
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000136 return NULL;
137 PyErr_Display(exc, value, tb);
138 Py_INCREF(Py_None);
139 return Py_None;
140}
141
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000142PyDoc_STRVAR(excepthook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000143"excepthook(exctype, value, traceback) -> None\n"
144"\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000145"Handle an exception by displaying it with a traceback on sys.stderr.\n"
146);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000147
148static PyObject *
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000149sys_exc_info(PyObject *self, PyObject *noargs)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000150{
151 PyThreadState *tstate;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000152 tstate = PyThreadState_GET();
Guido van Rossuma027efa1997-05-05 20:56:21 +0000153 return Py_BuildValue(
154 "(OOO)",
155 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
156 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
157 tstate->exc_traceback != NULL ?
158 tstate->exc_traceback : Py_None);
159}
160
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000161PyDoc_STRVAR(exc_info_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000162"exc_info() -> (type, value, traceback)\n\
163\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000164Return information about the most recent exception caught by an except\n\
165clause in the current stack frame or in an older stack frame."
166);
167
168static PyObject *
169sys_exc_clear(PyObject *self, PyObject *noargs)
170{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000171 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000172 PyObject *tmp_type, *tmp_value, *tmp_tb;
173 tmp_type = tstate->exc_type;
174 tmp_value = tstate->exc_value;
175 tmp_tb = tstate->exc_traceback;
176 tstate->exc_type = NULL;
177 tstate->exc_value = NULL;
178 tstate->exc_traceback = NULL;
179 Py_XDECREF(tmp_type);
180 Py_XDECREF(tmp_value);
181 Py_XDECREF(tmp_tb);
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000182 Py_INCREF(Py_None);
183 return Py_None;
184}
185
186PyDoc_STRVAR(exc_clear_doc,
187"exc_clear() -> None\n\
188\n\
189Clear global information on the current exception. Subsequent calls to\n\
190exc_info() will return (None,None,None) until another exception is raised\n\
191in the current thread or the execution stack returns to a frame where\n\
192another exception is being handled."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000193);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000194
Guido van Rossuma027efa1997-05-05 20:56:21 +0000195static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000196sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000197{
Neal Norwitz0c766a02002-03-27 13:03:09 +0000198 PyObject *exit_code = 0;
199 if (!PyArg_ParseTuple(args, "|O:exit", &exit_code))
200 return NULL;
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000201 /* Raise SystemExit so callers may catch it or clean up. */
Neal Norwitz0c766a02002-03-27 13:03:09 +0000202 PyErr_SetObject(PyExc_SystemExit, exit_code);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000203 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000204}
205
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000206PyDoc_STRVAR(exit_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000207"exit([status])\n\
208\n\
209Exit the interpreter by raising SystemExit(status).\n\
210If the status is omitted or None, it defaults to zero (i.e., success).\n\
Neil Schemenauer0f2103f2002-03-23 20:46:35 +0000211If the status is numeric, it will be used as the system exit status.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000212If it is another kind of object, it will be printed and the system\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000213exit status will be one (i.e., failure)."
214);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000215
Martin v. Löwis107b7da2001-11-09 20:59:39 +0000216#ifdef Py_USING_UNICODE
217
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000218static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000219sys_getdefaultencoding(PyObject *self)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000220{
Fred Drake8b4d01d2000-05-09 19:57:01 +0000221 return PyString_FromString(PyUnicode_GetDefaultEncoding());
222}
223
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000224PyDoc_STRVAR(getdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000225"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000226\n\
227Return the current default string encoding used by the Unicode \n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000228implementation."
229);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000230
231static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000232sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000233{
234 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000235 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000236 return NULL;
237 if (PyUnicode_SetDefaultEncoding(encoding))
238 return NULL;
239 Py_INCREF(Py_None);
240 return Py_None;
241}
242
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000243PyDoc_STRVAR(setdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000244"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000245\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000246Set the current default string encoding used by the Unicode implementation."
247);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000248
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000249static PyObject *
250sys_getfilesystemencoding(PyObject *self)
251{
252 if (Py_FileSystemDefaultEncoding)
253 return PyString_FromString(Py_FileSystemDefaultEncoding);
254 Py_INCREF(Py_None);
255 return Py_None;
256}
257
258PyDoc_STRVAR(getfilesystemencoding_doc,
259"getfilesystemencoding() -> string\n\
260\n\
261Return the encoding used to convert Unicode filenames in\n\
262operating system filenames."
263);
264
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000265#endif
266
Fred Drake5755ce62001-06-27 19:19:46 +0000267/*
268 * Cached interned string objects used for calling the profile and
269 * trace functions. Initialized by trace_init().
270 */
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000271static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL};
Fred Drake5755ce62001-06-27 19:19:46 +0000272
273static int
274trace_init(void)
275{
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000276 static char *whatnames[7] = {"call", "exception", "line", "return",
277 "c_call", "c_exception", "c_return"};
Fred Drake5755ce62001-06-27 19:19:46 +0000278 PyObject *name;
279 int i;
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000280 for (i = 0; i < 7; ++i) {
Fred Drake5755ce62001-06-27 19:19:46 +0000281 if (whatstrings[i] == NULL) {
282 name = PyString_InternFromString(whatnames[i]);
283 if (name == NULL)
284 return -1;
285 whatstrings[i] = name;
286 }
287 }
288 return 0;
289}
290
291
292static PyObject *
293call_trampoline(PyThreadState *tstate, PyObject* callback,
294 PyFrameObject *frame, int what, PyObject *arg)
295{
296 PyObject *args = PyTuple_New(3);
297 PyObject *whatstr;
298 PyObject *result;
299
300 if (args == NULL)
301 return NULL;
302 Py_INCREF(frame);
303 whatstr = whatstrings[what];
304 Py_INCREF(whatstr);
305 if (arg == NULL)
306 arg = Py_None;
307 Py_INCREF(arg);
308 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
309 PyTuple_SET_ITEM(args, 1, whatstr);
310 PyTuple_SET_ITEM(args, 2, arg);
311
312 /* call the Python-level function */
313 PyFrame_FastToLocals(frame);
314 result = PyEval_CallObject(callback, args);
315 PyFrame_LocalsToFast(frame, 1);
316 if (result == NULL)
317 PyTraceBack_Here(frame);
318
319 /* cleanup */
320 Py_DECREF(args);
321 return result;
322}
323
324static int
325profile_trampoline(PyObject *self, PyFrameObject *frame,
326 int what, PyObject *arg)
327{
328 PyThreadState *tstate = frame->f_tstate;
329 PyObject *result;
330
Fred Drake8f51f542001-10-04 14:48:42 +0000331 if (arg == NULL)
332 arg = Py_None;
Fred Drake5755ce62001-06-27 19:19:46 +0000333 result = call_trampoline(tstate, self, frame, what, arg);
334 if (result == NULL) {
335 PyEval_SetProfile(NULL, NULL);
336 return -1;
337 }
338 Py_DECREF(result);
339 return 0;
340}
341
342static int
343trace_trampoline(PyObject *self, PyFrameObject *frame,
344 int what, PyObject *arg)
345{
346 PyThreadState *tstate = frame->f_tstate;
347 PyObject *callback;
348 PyObject *result;
349
350 if (what == PyTrace_CALL)
351 callback = self;
352 else
353 callback = frame->f_trace;
354 if (callback == NULL)
355 return 0;
356 result = call_trampoline(tstate, callback, frame, what, arg);
357 if (result == NULL) {
358 PyEval_SetTrace(NULL, NULL);
359 Py_XDECREF(frame->f_trace);
360 frame->f_trace = NULL;
361 return -1;
362 }
363 if (result != Py_None) {
364 PyObject *temp = frame->f_trace;
365 frame->f_trace = NULL;
366 Py_XDECREF(temp);
367 frame->f_trace = result;
368 }
369 else {
370 Py_DECREF(result);
371 }
372 return 0;
373}
Fred Draked0838392001-06-16 21:02:31 +0000374
Fred Drake8b4d01d2000-05-09 19:57:01 +0000375static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000376sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000377{
Fred Drake5755ce62001-06-27 19:19:46 +0000378 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000379 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000380 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000381 PyEval_SetTrace(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000382 else
Fred Drake5755ce62001-06-27 19:19:46 +0000383 PyEval_SetTrace(trace_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000384 Py_INCREF(Py_None);
385 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000386}
387
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000388PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000389"settrace(function)\n\
390\n\
391Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000392function call. See the debugger chapter in the library manual."
393);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000394
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000395static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000396sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000397{
Fred Drake5755ce62001-06-27 19:19:46 +0000398 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000399 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000400 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000401 PyEval_SetProfile(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000402 else
Fred Drake5755ce62001-06-27 19:19:46 +0000403 PyEval_SetProfile(profile_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000404 Py_INCREF(Py_None);
405 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000406}
407
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000408PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000409"setprofile(function)\n\
410\n\
411Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000412and return. See the profiler chapter in the library manual."
413);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000414
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000415static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000416sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000417{
Skip Montanarod581d772002-09-03 20:10:45 +0000418 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000419 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000420 Py_INCREF(Py_None);
421 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000422}
423
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000424PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000425"setcheckinterval(n)\n\
426\n\
427Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000428n instructions. This also affects how often thread switches occur."
429);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000430
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000431static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000432sys_getcheckinterval(PyObject *self, PyObject *args)
433{
434 return PyInt_FromLong(_Py_CheckInterval);
435}
436
437PyDoc_STRVAR(getcheckinterval_doc,
438"getcheckinterval() -> current check interval; see setcheckinterval()."
439);
440
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000441#ifdef WITH_TSC
442static PyObject *
443sys_settscdump(PyObject *self, PyObject *args)
444{
445 int bool;
446 PyThreadState *tstate = PyThreadState_Get();
447
448 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
449 return NULL;
450 if (bool)
451 tstate->interp->tscdump = 1;
452 else
453 tstate->interp->tscdump = 0;
454 Py_INCREF(Py_None);
455 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000456
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000457}
458
Tim Peters216b78b2006-01-06 02:40:53 +0000459PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000460"settscdump(bool)\n\
461\n\
462If true, tell the Python interpreter to dump VM measurements to\n\
463stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000464processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000465);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000466#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000467
Tim Peterse5e065b2003-07-06 18:36:54 +0000468static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000469sys_setrecursionlimit(PyObject *self, PyObject *args)
470{
471 int new_limit;
472 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
473 return NULL;
474 if (new_limit <= 0) {
Tim Peters216b78b2006-01-06 02:40:53 +0000475 PyErr_SetString(PyExc_ValueError,
476 "recursion limit must be positive");
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000477 return NULL;
478 }
479 Py_SetRecursionLimit(new_limit);
480 Py_INCREF(Py_None);
481 return Py_None;
482}
483
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000484PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000485"setrecursionlimit(n)\n\
486\n\
487Set the maximum depth of the Python interpreter stack to n. This\n\
488limit prevents infinite recursion from causing an overflow of the C\n\
489stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000490dependent."
491);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000492
493static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000494sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000495{
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000496 return PyInt_FromLong(Py_GetRecursionLimit());
497}
498
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000499PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000500"getrecursionlimit()\n\
501\n\
502Return the current value of the recursion limit, the maximum depth\n\
503of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000504recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000505);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000506
Mark Hammond8696ebc2002-10-08 02:44:31 +0000507#ifdef MS_WINDOWS
508PyDoc_STRVAR(getwindowsversion_doc,
509"getwindowsversion()\n\
510\n\
511Return information about the running version of Windows.\n\
512The result is a tuple of (major, minor, build, platform, text)\n\
513All elements are numbers, except text which is a string.\n\
514Platform may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP\n\
515"
516);
517
518static PyObject *
519sys_getwindowsversion(PyObject *self)
520{
521 OSVERSIONINFO ver;
522 ver.dwOSVersionInfoSize = sizeof(ver);
523 if (!GetVersionEx(&ver))
524 return PyErr_SetFromWindowsErr(0);
525 return Py_BuildValue("HHHHs",
526 ver.dwMajorVersion,
527 ver.dwMinorVersion,
528 ver.dwBuildNumber,
529 ver.dwPlatformId,
530 ver.szCSDVersion);
531}
532
533#endif /* MS_WINDOWS */
534
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000535#ifdef HAVE_DLOPEN
536static PyObject *
537sys_setdlopenflags(PyObject *self, PyObject *args)
538{
539 int new_val;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000540 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000541 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
542 return NULL;
543 if (!tstate)
544 return NULL;
545 tstate->interp->dlopenflags = new_val;
546 Py_INCREF(Py_None);
547 return Py_None;
548}
549
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000550PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000551"setdlopenflags(n) -> None\n\
552\n\
553Set the flags that will be used for dlopen() calls. Among other\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000554things, this will enable a lazy resolving of symbols when importing\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000555a module, if called as sys.setdlopenflags(0)\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000556To share symbols across extension modules, call as\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000557sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)"
558);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000559
560static PyObject *
561sys_getdlopenflags(PyObject *self, PyObject *args)
562{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000563 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000564 if (!tstate)
565 return NULL;
566 return PyInt_FromLong(tstate->interp->dlopenflags);
567}
568
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000569PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000570"getdlopenflags() -> int\n\
571\n\
572Return the current value of the flags that are used for dlopen()\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000573calls. The flag constants are defined in the dl module."
574);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000575#endif
576
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000577#ifdef USE_MALLOPT
578/* Link with -lmalloc (or -lmpc) on an SGI */
579#include <malloc.h>
580
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000581static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000582sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000583{
584 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000585 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000586 return NULL;
587 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000588 Py_INCREF(Py_None);
589 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000590}
591#endif /* USE_MALLOPT */
592
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000593static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000594sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000595{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000596 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000597}
598
Tim Peters4be93d02002-07-07 19:59:50 +0000599#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000600static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000601sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000602{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000603 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000604}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000605#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000606
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000607PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000608"getrefcount(object) -> integer\n\
609\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000610Return the reference count of object. The count returned is generally\n\
611one higher than you might expect, because it includes the (temporary)\n\
612reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000613);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000614
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000615#ifdef COUNT_ALLOCS
616static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000617sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000618{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000619 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000620
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000621 return get_counts();
622}
623#endif
624
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000625PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000626"_getframe([depth]) -> frameobject\n\
627\n\
628Return a frame object from the call stack. If optional integer depth is\n\
629given, return the frame object that many calls below the top of the stack.\n\
630If that is deeper than the call stack, ValueError is raised. The default\n\
631for depth is zero, returning the frame at the top of the call stack.\n\
632\n\
633This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000634purposes only."
635);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000636
637static PyObject *
638sys_getframe(PyObject *self, PyObject *args)
639{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000640 PyFrameObject *f = PyThreadState_GET()->frame;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000641 int depth = -1;
642
643 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
644 return NULL;
645
646 while (depth > 0 && f != NULL) {
647 f = f->f_back;
648 --depth;
649 }
650 if (f == NULL) {
651 PyErr_SetString(PyExc_ValueError,
652 "call stack is not deep enough");
653 return NULL;
654 }
655 Py_INCREF(f);
656 return (PyObject*)f;
657}
658
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000659PyDoc_STRVAR(call_tracing_doc,
660"call_tracing(func, args) -> object\n\
661\n\
662Call func(*args), while tracing is enabled. The tracing state is\n\
663saved, and restored afterwards. This is intended to be called from\n\
664a debugger from a checkpoint, to recursively debug some other code."
665);
666
667static PyObject *
668sys_call_tracing(PyObject *self, PyObject *args)
669{
670 PyObject *func, *funcargs;
671 if (!PyArg_ParseTuple(args, "OO:call_tracing", &func, &funcargs))
672 return NULL;
673 return _PyEval_CallTracing(func, funcargs);
674}
675
Jeremy Hylton985eba52003-02-05 23:13:00 +0000676PyDoc_STRVAR(callstats_doc,
677"callstats() -> tuple of integers\n\
678\n\
679Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
680when Python was built. Otherwise, return None.\n\
681\n\
682When enabled, this function returns detailed, implementation-specific\n\
683details about the number of function calls executed. The return value is\n\
684a 11-tuple where the entries in the tuple are counts of:\n\
6850. all function calls\n\
6861. calls to PyFunction_Type objects\n\
6872. PyFunction calls that do not create an argument tuple\n\
6883. PyFunction calls that do not create an argument tuple\n\
689 and bypass PyEval_EvalCodeEx()\n\
6904. PyMethod calls\n\
6915. PyMethod calls on bound methods\n\
6926. PyType calls\n\
6937. PyCFunction calls\n\
6948. generator calls\n\
6959. All other calls\n\
69610. Number of stack pops performed by call_function()"
697);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000698
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000699#ifdef __cplusplus
700extern "C" {
701#endif
702
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000703#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000704/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000705extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000706#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000707
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000708#ifdef DYNAMIC_EXECUTION_PROFILE
709/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000710extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000711#endif
712
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000713#ifdef __cplusplus
714}
715#endif
716
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000717static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000718 /* Might as well keep this in alphabetic order */
Tim Peters216b78b2006-01-06 02:40:53 +0000719 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
Jeremy Hylton985eba52003-02-05 23:13:00 +0000720 callstats_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000721 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000722 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
723 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000724 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
Neal Norwitz0c766a02002-03-27 13:03:09 +0000725 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000726#ifdef Py_USING_UNICODE
Tim Peters216b78b2006-01-06 02:40:53 +0000727 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
728 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000729#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000730#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000731 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000732 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000733#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000734#ifdef COUNT_ALLOCS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000735 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000736#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000737#ifdef DYNAMIC_EXECUTION_PROFILE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000738 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000739#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000740#ifdef Py_USING_UNICODE
741 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
Tim Peters216b78b2006-01-06 02:40:53 +0000742 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000743#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000744#ifdef Py_TRACE_REFS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000745 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000746#endif
747#ifdef Py_REF_DEBUG
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000748 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000749#endif
Fred Drakea7688822001-10-24 20:47:48 +0000750 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000751 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000752 getrecursionlimit_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000753 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000754#ifdef MS_WINDOWS
755 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
756 getwindowsversion_doc},
757#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000758#ifdef USE_MALLOPT
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000759 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000760#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000761#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000762 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000763 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000764#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000765 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000766 setcheckinterval_doc},
Tim Peterse5e065b2003-07-06 18:36:54 +0000767 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000768 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000769#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000770 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000771 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000772#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000773 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000774 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000775 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000776#ifdef WITH_TSC
777 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
778#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000779 {"settrace", sys_settrace, METH_O, settrace_doc},
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000780 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000781 {NULL, NULL} /* sentinel */
782};
783
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000784static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000785list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000786{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000787 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000788 int i;
789 if (list == NULL)
790 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000791 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Guido van Rossuma027efa1997-05-05 20:56:21 +0000792 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000793 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000794 if (name == NULL)
795 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000796 PyList_Append(list, name);
797 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000798 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000799 if (PyList_Sort(list) != 0) {
800 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000801 list = NULL;
802 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000803 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000804 PyObject *v = PyList_AsTuple(list);
805 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000806 list = v;
807 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000808 return list;
809}
810
Guido van Rossum23fff912000-12-15 22:02:05 +0000811static PyObject *warnoptions = NULL;
812
813void
814PySys_ResetWarnOptions(void)
815{
816 if (warnoptions == NULL || !PyList_Check(warnoptions))
817 return;
818 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
819}
820
821void
822PySys_AddWarnOption(char *s)
823{
824 PyObject *str;
825
826 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
827 Py_XDECREF(warnoptions);
828 warnoptions = PyList_New(0);
829 if (warnoptions == NULL)
830 return;
831 }
832 str = PyString_FromString(s);
833 if (str != NULL) {
834 PyList_Append(warnoptions, str);
835 Py_DECREF(str);
836 }
837}
838
Guido van Rossum40552d01998-08-06 03:34:39 +0000839/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
840 Two literals concatenated works just fine. If you have a K&R compiler
841 or other abomination that however *does* understand longer strings,
842 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000843PyDoc_VAR(sys_doc) =
844PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000845"This module provides access to some objects used or maintained by the\n\
846interpreter and to functions that interact strongly with the interpreter.\n\
847\n\
848Dynamic objects:\n\
849\n\
850argv -- command line arguments; argv[0] is the script pathname if known\n\
851path -- module search path; path[0] is the script directory, else ''\n\
852modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000853\n\
854displayhook -- called to show results in an interactive session\n\
855excepthook -- called to handle any uncaught exception other than SystemExit\n\
856 To customize printing in an interactive session or to install a custom\n\
857 top-level exception handler, assign other functions to replace these.\n\
858\n\
859exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
860 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000861\n\
862stdin -- standard input file object; used by raw_input() and input()\n\
863stdout -- standard output file object; used by the print statement\n\
864stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000865 By assigning other file objects (or objects that behave like files)\n\
866 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000867\n\
868last_type -- type of last uncaught exception\n\
869last_value -- value of last uncaught exception\n\
870last_traceback -- traceback of last uncaught exception\n\
871 These three are only available in an interactive session after a\n\
872 traceback has been printed.\n\
873\n\
874exc_type -- type of exception currently being handled\n\
875exc_value -- value of exception currently being handled\n\
876exc_traceback -- traceback of exception currently being handled\n\
877 The function exc_info() should be used instead of these three,\n\
878 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000879"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000880)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000881/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000882PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000883"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000884Static objects:\n\
885\n\
886maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +0000887maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000888builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +0000889version -- the version of this interpreter as a string\n\
890version_info -- version information as a tuple\n\
891hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000892copyright -- copyright notice pertaining to this interpreter\n\
893platform -- platform identifier\n\
894executable -- pathname of this Python interpreter\n\
895prefix -- prefix used to find the Python library\n\
896exec_prefix -- prefix used to find the machine-specific Python library\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000897"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000898)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000899#ifdef MS_WINDOWS
900/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000901PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000902"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000903winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000904"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000905)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000906#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000907PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000908"__stdin__ -- the original stdin; don't touch!\n\
909__stdout__ -- the original stdout; don't touch!\n\
910__stderr__ -- the original stderr; don't touch!\n\
911__displayhook__ -- the original displayhook; don't touch!\n\
912__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000913\n\
914Functions:\n\
915\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000916displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000917excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000918exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000919exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000920exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000921getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000922getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000923getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000924setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000925setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000926setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000927setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000928settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +0000929"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000930)
Fred Drakeccede592000-08-14 20:59:57 +0000931/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000932
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +0000933static int
934_check_and_flush (FILE *stream)
935{
936 int prev_fail = ferror (stream);
937 return fflush (stream) || prev_fail ? EOF : 0;
938}
939
Martin v. Löwis43b57802006-01-05 23:38:54 +0000940/* Subversion branch and revision management */
941static const char _patchlevel_revision[] = PY_PATCHLEVEL_REVISION;
942static const char headurl[] = "$HeadURL$";
943static int svn_initialized;
944static char patchlevel_revision[50]; /* Just the number */
945static char branch[50];
946static char shortbranch[50];
947static const char *svn_revision;
948
Tim Peterse86e7a52006-01-06 02:42:46 +0000949static void
950svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +0000951{
952 const char *python, *br_start, *br_end, *br_end2, *svnversion;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000953 Py_ssize_t len;
954 int istag;
Martin v. Löwis43b57802006-01-05 23:38:54 +0000955
956 if (svn_initialized)
957 return;
958
959 python = strstr(headurl, "/python/");
960 if (!python)
961 Py_FatalError("subversion keywords missing");
962
963 br_start = python + 8;
964 br_end = strchr(br_start, '/');
Tim Peters216b78b2006-01-06 02:40:53 +0000965 /* Works even for trunk,
Martin v. Löwis43b57802006-01-05 23:38:54 +0000966 as we are in trunk/Python/sysmodule.c */
967 br_end2 = strchr(br_end+1, '/');
968
969 istag = strncmp(br_start, "tags", 4) == 0;
970 if (strncmp(br_start, "trunk", 5) == 0) {
971 strcpy(branch, "trunk");
972 strcpy(shortbranch, "trunk");
973
Tim Peters216b78b2006-01-06 02:40:53 +0000974 }
Martin v. Löwis43b57802006-01-05 23:38:54 +0000975 else if (istag || strncmp(br_start, "branches", 8) == 0) {
976 len = br_end2 - br_start;
977 strncpy(branch, br_start, len);
978 branch[len] = '\0';
979
980 len = br_end2 - (br_end + 1);
981 strncpy(shortbranch, br_end + 1, len);
982 shortbranch[len] = '\0';
Tim Peters216b78b2006-01-06 02:40:53 +0000983 }
Martin v. Löwis43b57802006-01-05 23:38:54 +0000984 else {
985 Py_FatalError("bad HeadURL");
986 return;
987 }
988
989
990 svnversion = _Py_svnversion();
991 if (strcmp(svnversion, "exported") != 0)
992 svn_revision = svnversion;
993 else if (istag) {
994 len = strlen(_patchlevel_revision);
995 strncpy(patchlevel_revision, _patchlevel_revision + 11,
996 len - 13);
997 patchlevel_revision[len - 13] = '\0';
998 svn_revision = patchlevel_revision;
999 }
1000 else
1001 svn_revision = "";
Tim Peters216b78b2006-01-06 02:40:53 +00001002
Martin v. Löwis43b57802006-01-05 23:38:54 +00001003 svn_initialized = 1;
1004}
1005
1006/* Return svnversion output if available.
1007 Else return Revision of patchlevel.h if on branch.
1008 Else return empty string */
1009const char*
1010Py_SubversionRevision()
1011{
1012 svnversion_init();
1013 return svn_revision;
1014}
1015
1016const char*
1017Py_SubversionShortBranch()
1018{
1019 svnversion_init();
1020 return shortbranch;
1021}
1022
Guido van Rossum25ce5661997-08-02 03:10:38 +00001023PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001024_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001025{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001026 PyObject *m, *v, *sysdict;
1027 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +00001028 char *s;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001029#ifdef MS_WINDOWS
1030 char buf[10];
1031#endif
Guido van Rossum25ce5661997-08-02 03:10:38 +00001032
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001033 m = Py_InitModule3("sys", sys_methods, sys_doc);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00001034 if (m == NULL)
1035 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001036 sysdict = PyModule_GetDict(m);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001037
Neal Norwitz11bd1192005-10-03 00:54:56 +00001038 {
1039 /* XXX: does this work on Win/Win64? (see posix_fstat) */
1040 struct stat sb;
1041 if (fstat(fileno(stdin), &sb) == 0 &&
1042 S_ISDIR(sb.st_mode)) {
Neal Norwitz72c2c062006-03-09 05:58:11 +00001043 /* There's nothing more we can do. */
1044 /* Py_FatalError() will core dump, so just exit. */
1045 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1046 exit(EXIT_FAILURE);
Neal Norwitz11bd1192005-10-03 00:54:56 +00001047 }
1048 }
1049
Martin v. Löwis13a1fde2005-01-27 18:56:16 +00001050 /* Closing the standard FILE* if sys.std* goes aways causes problems
1051 * for embedded Python usages. Closing them when somebody explicitly
1052 * invokes .close() might be possible, but the FAQ promises they get
1053 * never closed. However, we still need to get write errors when
1054 * writing fails (e.g. because stdout is redirected), so we flush the
1055 * streams and check for errors before the file objects are deleted.
1056 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1057 * from that procedure.
1058 */
1059 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001060 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1061 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001062 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001063 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001064#ifdef MS_WINDOWS
1065 if(isatty(_fileno(stdin))){
1066 sprintf(buf, "cp%d", GetConsoleCP());
1067 if (!PyFile_SetEncoding(sysin, buf))
1068 return NULL;
1069 }
1070 if(isatty(_fileno(stdout))) {
1071 sprintf(buf, "cp%d", GetConsoleOutputCP());
1072 if (!PyFile_SetEncoding(sysout, buf))
1073 return NULL;
1074 }
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001075 if(isatty(_fileno(stderr))) {
1076 sprintf(buf, "cp%d", GetConsoleOutputCP());
1077 if (!PyFile_SetEncoding(syserr, buf))
1078 return NULL;
1079 }
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001080#endif
1081
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001082 PyDict_SetItemString(sysdict, "stdin", sysin);
1083 PyDict_SetItemString(sysdict, "stdout", sysout);
1084 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +00001085 /* Make backup copies for cleanup */
1086 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1087 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1088 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001089 PyDict_SetItemString(sysdict, "__displayhook__",
1090 PyDict_GetItemString(sysdict, "displayhook"));
1091 PyDict_SetItemString(sysdict, "__excepthook__",
1092 PyDict_GetItemString(sysdict, "excepthook"));
Guido van Rossum25ce5661997-08-02 03:10:38 +00001093 Py_XDECREF(sysin);
1094 Py_XDECREF(sysout);
1095 Py_XDECREF(syserr);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001096 PyDict_SetItemString(sysdict, "version",
1097 v = PyString_FromString(Py_GetVersion()));
Barry Warsaw54892c41999-01-27 16:33:19 +00001098 Py_XDECREF(v);
Guido van Rossume0d7dae1999-01-03 12:55:39 +00001099 PyDict_SetItemString(sysdict, "hexversion",
1100 v = PyInt_FromLong(PY_VERSION_HEX));
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001101 Py_XDECREF(v);
Martin v. Löwis43b57802006-01-05 23:38:54 +00001102 svnversion_init();
1103 v = Py_BuildValue("(ssz)", "CPython", branch, svn_revision);
1104 PyDict_SetItemString(sysdict, "subversion", v);
Barry Warsaw2a38a862005-12-18 01:27:35 +00001105 Py_XDECREF(v);
Fred Drake93a20bf2000-04-13 17:44:51 +00001106 /*
1107 * These release level checks are mutually exclusive and cover
1108 * the field, so don't get too fancy with the pre-processor!
1109 */
1110#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001111 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +00001112#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001113 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +00001114#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001115 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +00001116#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +00001117 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +00001118#endif
Fred Drake801c08d2000-04-13 15:29:10 +00001119 PyDict_SetItemString(sysdict, "version_info",
Fred Drake6d27c1e2000-04-13 20:03:20 +00001120 v = Py_BuildValue("iiisi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +00001121 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +00001122 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +00001123 PY_RELEASE_SERIAL));
Fred Drake801c08d2000-04-13 15:29:10 +00001124 Py_XDECREF(v);
Skip Montanaro8e790e72002-09-03 13:25:17 +00001125 PyDict_SetItemString(sysdict, "api_version",
1126 v = PyInt_FromLong(PYTHON_API_VERSION));
1127 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001128 PyDict_SetItemString(sysdict, "copyright",
1129 v = PyString_FromString(Py_GetCopyright()));
1130 Py_XDECREF(v);
1131 PyDict_SetItemString(sysdict, "platform",
1132 v = PyString_FromString(Py_GetPlatform()));
1133 Py_XDECREF(v);
Guido van Rossumb2c8ec41997-05-22 20:41:20 +00001134 PyDict_SetItemString(sysdict, "executable",
1135 v = PyString_FromString(Py_GetProgramFullPath()));
1136 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001137 PyDict_SetItemString(sysdict, "prefix",
1138 v = PyString_FromString(Py_GetPrefix()));
1139 Py_XDECREF(v);
1140 PyDict_SetItemString(sysdict, "exec_prefix",
1141 v = PyString_FromString(Py_GetExecPrefix()));
1142 Py_XDECREF(v);
1143 PyDict_SetItemString(sysdict, "maxint",
1144 v = PyInt_FromLong(PyInt_GetMax()));
1145 Py_XDECREF(v);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001146#ifdef Py_USING_UNICODE
Martin v. Löwisce9b5a52001-06-27 06:28:56 +00001147 PyDict_SetItemString(sysdict, "maxunicode",
1148 v = PyInt_FromLong(PyUnicode_GetMax()));
1149 Py_XDECREF(v);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001150#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001151 PyDict_SetItemString(sysdict, "builtin_module_names",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001152 v = list_builtin_module_names());
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001153 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +00001154 {
1155 /* Assumes that longs are at least 2 bytes long.
1156 Should be safe! */
1157 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +00001158 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001159
1160 s = (char *) &number;
1161 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +00001162 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +00001163 else
Fred Drakea2b6ad62000-08-15 04:24:43 +00001164 value = "little";
1165 PyDict_SetItemString(sysdict, "byteorder",
Barry Warsawf2581c92000-08-16 23:03:57 +00001166 v = PyString_FromString(value));
1167 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +00001168 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001169#ifdef MS_COREDLL
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001170 PyDict_SetItemString(sysdict, "dllhandle",
Guido van Rossum582acec2000-06-28 22:07:35 +00001171 v = PyLong_FromVoidPtr(PyWin_DLLhModule));
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001172 Py_XDECREF(v);
1173 PyDict_SetItemString(sysdict, "winver",
Guido van Rossum6c1e5f21997-09-29 23:34:23 +00001174 v = PyString_FromString(PyWin_DLLVersionString));
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001175 Py_XDECREF(v);
Guido van Rossumc606fe11996-04-09 02:37:57 +00001176#endif
Guido van Rossum23fff912000-12-15 22:02:05 +00001177 if (warnoptions == NULL) {
1178 warnoptions = PyList_New(0);
1179 }
1180 else {
1181 Py_INCREF(warnoptions);
1182 }
1183 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +00001184 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +00001185 }
Tim Peters216b78b2006-01-06 02:40:53 +00001186
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001187 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001188 return NULL;
1189 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001190}
1191
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001192static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001193makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001194{
Guido van Rossum3f5da241990-12-20 15:06:42 +00001195 int i, n;
1196 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001197 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001198
Guido van Rossum3f5da241990-12-20 15:06:42 +00001199 n = 1;
1200 p = path;
1201 while ((p = strchr(p, delim)) != NULL) {
1202 n++;
1203 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001204 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001205 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001206 if (v == NULL)
1207 return NULL;
1208 for (i = 0; ; i++) {
1209 p = strchr(path, delim);
1210 if (p == NULL)
1211 p = strchr(path, '\0'); /* End of string */
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001212 w = PyString_FromStringAndSize(path, (int) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +00001213 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001214 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001215 return NULL;
1216 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001217 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001218 if (*p == '\0')
1219 break;
1220 path = p+1;
1221 }
1222 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001223}
1224
1225void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001226PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001227{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001228 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001229 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001230 Py_FatalError("can't create sys.path");
1231 if (PySys_SetObject("path", v) != 0)
1232 Py_FatalError("can't assign sys.path");
1233 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001234}
1235
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001236static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001237makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001238{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001239 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +00001240 if (argc <= 0 || argv == NULL) {
1241 /* Ensure at least one (empty) argument is seen */
1242 static char *empty_argv[1] = {""};
1243 argv = empty_argv;
1244 argc = 1;
1245 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001246 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001247 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001248 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001249 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001250#ifdef __VMS
1251 PyObject *v;
1252
1253 /* argv[0] is the script pathname if known */
1254 if (i == 0) {
1255 char* fn = decc$translate_vms(argv[0]);
1256 if ((fn == (char *)0) || fn == (char *)-1)
1257 v = PyString_FromString(argv[0]);
1258 else
1259 v = PyString_FromString(
1260 decc$translate_vms(argv[0]));
1261 } else
1262 v = PyString_FromString(argv[i]);
1263#else
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001264 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001265#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001266 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001267 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001268 av = NULL;
1269 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001270 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001271 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001272 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001273 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001274 return av;
1275}
1276
1277void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001278PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001279{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001280#if defined(HAVE_REALPATH)
1281 char fullpath[MAXPATHLEN];
1282#elif defined(MS_WINDOWS)
Thomas Heller27bb71e2003-01-08 14:33:48 +00001283 char fullpath[MAX_PATH];
1284#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001285 PyObject *av = makeargvobject(argc, argv);
1286 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001287 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001288 Py_FatalError("no mem for sys.argv");
1289 if (PySys_SetObject("argv", av) != 0)
1290 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +00001291 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001292 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +00001293 char *p = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001294 Py_ssize_t n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001295 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001296#ifdef HAVE_READLINK
1297 char link[MAXPATHLEN+1];
1298 char argv0copy[2*MAXPATHLEN+1];
1299 int nr = 0;
Georg Brandl69537722005-09-15 13:00:34 +00001300 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
Guido van Rossumc474dea1997-04-25 15:38:31 +00001301 nr = readlink(argv0, link, MAXPATHLEN);
1302 if (nr > 0) {
1303 /* It's a symlink */
1304 link[nr] = '\0';
1305 if (link[0] == SEP)
1306 argv0 = link; /* Link to absolute path */
1307 else if (strchr(link, SEP) == NULL)
1308 ; /* Link without path */
1309 else {
1310 /* Must join(dirname(argv0), link) */
1311 char *q = strrchr(argv0, SEP);
1312 if (q == NULL)
1313 argv0 = link; /* argv0 without path */
1314 else {
1315 /* Must make a copy */
1316 strcpy(argv0copy, argv0);
1317 q = strrchr(argv0copy, SEP);
1318 strcpy(q+1, link);
1319 argv0 = argv0copy;
1320 }
1321 }
1322 }
1323#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001324#if SEP == '\\' /* Special case for MS filename syntax */
Georg Brandl69537722005-09-15 13:00:34 +00001325 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossumcc883411996-09-10 14:44:21 +00001326 char *q;
Thomas Heller27bb71e2003-01-08 14:33:48 +00001327#ifdef MS_WINDOWS
1328 char *ptemp;
1329 if (GetFullPathName(argv0,
1330 sizeof(fullpath),
1331 fullpath,
1332 &ptemp)) {
1333 argv0 = fullpath;
1334 }
1335#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001336 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +00001337 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +00001338 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +00001339 if (q != NULL)
1340 p = q;
1341 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001342 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001343 if (n > 1 && p[-1] != ':')
1344 n--; /* Drop trailing separator */
1345 }
1346 }
1347#else /* All other filename syntaxes */
Georg Brandl69537722005-09-15 13:00:34 +00001348 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001349#if defined(HAVE_REALPATH)
1350 if (realpath(argv0, fullpath)) {
1351 argv0 = fullpath;
1352 }
1353#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001354 p = strrchr(argv0, SEP);
Guido van Rossum162e38c2003-02-19 15:25:10 +00001355 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001356 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001357#ifndef RISCOS
Guido van Rossumc474dea1997-04-25 15:38:31 +00001358 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001359#else /* don't include trailing separator */
1360 n = p - argv0;
1361#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001362#if SEP == '/' /* Special case for Unix filename syntax */
1363 if (n > 1)
1364 n--; /* Drop trailing separator */
1365#endif /* Unix */
1366 }
1367#endif /* All others */
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001368 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +00001369 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001370 Py_FatalError("no mem for sys.path insertion");
1371 if (PyList_Insert(path, 0, a) < 0)
1372 Py_FatalError("sys.path.insert(0) failed");
1373 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +00001374 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001375 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001376}
Guido van Rossuma890e681998-05-12 14:59:24 +00001377
1378
1379/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1380 Adapted from code submitted by Just van Rossum.
1381
1382 PySys_WriteStdout(format, ...)
1383 PySys_WriteStderr(format, ...)
1384
1385 The first function writes to sys.stdout; the second to sys.stderr. When
1386 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001387 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001388
1389 Both take a printf-style format string as their first argument followed
1390 by a variable length argument list determined by the format string.
1391
1392 *** WARNING ***
1393
1394 The format should limit the total size of the formatted output string to
1395 1000 bytes. In particular, this means that no unrestricted "%s" formats
1396 should occur; these should be limited using "%.<N>s where <N> is a
1397 decimal number calculated so that <N> plus the maximum size of other
1398 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1399 which can print hundreds of digits for very large numbers.
1400
1401 */
1402
1403static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001404mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001405{
1406 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001407 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001408
Guido van Rossum8442af31998-10-12 18:22:10 +00001409 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001410 file = PySys_GetObject(name);
1411 if (file == NULL || PyFile_AsFile(file) == fp)
1412 vfprintf(fp, format, va);
1413 else {
1414 char buffer[1001];
Tim Peters080d5b32001-12-02 08:29:16 +00001415 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1416 format, va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001417 if (PyFile_WriteString(buffer, file) != 0) {
1418 PyErr_Clear();
1419 fputs(buffer, fp);
1420 }
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001421 if (written < 0 || (size_t)written >= sizeof(buffer)) {
Jeremy Hylton5d3d1342001-11-28 21:44:53 +00001422 const char *truncated = "... truncated";
1423 if (PyFile_WriteString(truncated, file) != 0) {
1424 PyErr_Clear();
1425 fputs(truncated, fp);
1426 }
1427 }
Guido van Rossuma890e681998-05-12 14:59:24 +00001428 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001429 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001430}
1431
1432void
Guido van Rossuma890e681998-05-12 14:59:24 +00001433PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001434{
1435 va_list va;
1436
Guido van Rossuma890e681998-05-12 14:59:24 +00001437 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001438 mywrite("stdout", stdout, format, va);
1439 va_end(va);
1440}
1441
1442void
Guido van Rossuma890e681998-05-12 14:59:24 +00001443PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001444{
1445 va_list va;
1446
Guido van Rossuma890e681998-05-12 14:59:24 +00001447 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001448 mywrite("stderr", stderr, format, va);
1449 va_end(va);
1450}