blob: 8c82d45d379e7f2a75ce4bf28737acd657c6f625 [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"
Christian Heimesf31b69f2008-01-14 03:42:48 +000018#include "structseq.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +000019#include "code.h"
Barry Warsawb6a54d22000-12-06 21:47:46 +000020#include "frameobject.h"
Guido van Rossuma12fe4e2003-04-09 19:06:21 +000021#include "eval.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000022
Guido van Rossume2437a11992-03-23 18:20:18 +000023#include "osdefs.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +000024
Mark Hammond8696ebc2002-10-08 02:44:31 +000025#ifdef MS_WINDOWS
26#define WIN32_LEAN_AND_MEAN
27#include "windows.h"
28#endif /* MS_WINDOWS */
29
Guido van Rossum9b38a141996-09-11 23:12:24 +000030#ifdef MS_COREDLL
Guido van Rossumc606fe11996-04-09 02:37:57 +000031extern void *PyWin_DLLhModule;
Guido van Rossum6c1e5f21997-09-29 23:34:23 +000032/* A string loaded from the DLL at startup: */
33extern const char *PyWin_DLLVersionString;
Guido van Rossumc606fe11996-04-09 02:37:57 +000034#endif
35
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +000036#ifdef __VMS
37#include <unixlib.h>
38#endif
39
Martin v. Löwis5467d4c2003-05-10 07:10:12 +000040#ifdef MS_WINDOWS
41#include <windows.h>
42#endif
43
44#ifdef HAVE_LANGINFO_H
45#include <locale.h>
46#include <langinfo.h>
47#endif
48
Guido van Rossum65bf9f21997-04-29 18:33:38 +000049PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000050PySys_GetObject(char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000051{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000052 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000053 PyObject *sd = tstate->interp->sysdict;
Guido van Rossumbe203361999-10-05 22:17:41 +000054 if (sd == NULL)
55 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +000056 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000057}
58
59FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000060PySys_GetFile(char *name, FILE *def)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000061{
62 FILE *fp = NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +000063 PyObject *v = PySys_GetObject(name);
64 if (v != NULL && PyFile_Check(v))
65 fp = PyFile_AsFile(v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000066 if (fp == NULL)
67 fp = def;
68 return fp;
69}
70
71int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000072PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000073{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000074 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000075 PyObject *sd = tstate->interp->sysdict;
Guido van Rossum5ad58c61992-01-26 18:15:48 +000076 if (v == NULL) {
Guido van Rossum25ce5661997-08-02 03:10:38 +000077 if (PyDict_GetItemString(sd, name) == NULL)
Guido van Rossum5ad58c61992-01-26 18:15:48 +000078 return 0;
79 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000080 return PyDict_DelItemString(sd, name);
Guido van Rossum5ad58c61992-01-26 18:15:48 +000081 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000082 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000083 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000084}
85
Guido van Rossum65bf9f21997-04-29 18:33:38 +000086static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000087sys_displayhook(PyObject *self, PyObject *o)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000088{
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000089 PyObject *outf;
Nicholas Bastine5662ae2004-03-24 22:22:12 +000090 PyInterpreterState *interp = PyThreadState_GET()->interp;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000091 PyObject *modules = interp->modules;
92 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
93
Moshe Zadka03897ea2001-07-23 13:32:43 +000094 if (builtins == NULL) {
95 PyErr_SetString(PyExc_RuntimeError, "lost __builtin__");
96 return NULL;
97 }
98
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000099 /* Print value except if None */
100 /* After printing, also assign to '_' */
101 /* Before, set '_' to None to avoid recursion */
102 if (o == Py_None) {
103 Py_INCREF(Py_None);
104 return Py_None;
105 }
106 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
107 return NULL;
108 if (Py_FlushLine() != 0)
109 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000110 outf = PySys_GetObject("stdout");
111 if (outf == NULL) {
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000112 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
113 return NULL;
114 }
Greg Steinceb9b7c2001-01-11 09:27:34 +0000115 if (PyFile_WriteObject(o, outf, 0) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000116 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000117 PyFile_SoftSpace(outf, 1);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000118 if (Py_FlushLine() != 0)
119 return NULL;
120 if (PyObject_SetAttrString(builtins, "_", o) != 0)
121 return NULL;
122 Py_INCREF(Py_None);
123 return Py_None;
124}
125
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000126PyDoc_STRVAR(displayhook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000127"displayhook(object) -> None\n"
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000128"\n"
Brett Cannon51185172006-03-02 22:07:40 +0000129"Print an object to sys.stdout and also save it in __builtin__.\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000130);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000131
132static PyObject *
133sys_excepthook(PyObject* self, PyObject* args)
134{
135 PyObject *exc, *value, *tb;
Fred Drakea7688822001-10-24 20:47:48 +0000136 if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb))
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000137 return NULL;
138 PyErr_Display(exc, value, tb);
139 Py_INCREF(Py_None);
140 return Py_None;
141}
142
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000143PyDoc_STRVAR(excepthook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000144"excepthook(exctype, value, traceback) -> None\n"
145"\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000146"Handle an exception by displaying it with a traceback on sys.stderr.\n"
147);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000148
149static PyObject *
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000150sys_exc_info(PyObject *self, PyObject *noargs)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000151{
152 PyThreadState *tstate;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000153 tstate = PyThreadState_GET();
Guido van Rossuma027efa1997-05-05 20:56:21 +0000154 return Py_BuildValue(
155 "(OOO)",
156 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
157 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
158 tstate->exc_traceback != NULL ?
159 tstate->exc_traceback : Py_None);
160}
161
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000162PyDoc_STRVAR(exc_info_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000163"exc_info() -> (type, value, traceback)\n\
164\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000165Return information about the most recent exception caught by an except\n\
166clause in the current stack frame or in an older stack frame."
167);
168
169static PyObject *
170sys_exc_clear(PyObject *self, PyObject *noargs)
171{
Georg Brandl5a444242008-03-21 20:11:46 +0000172 PyThreadState *tstate;
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000173 PyObject *tmp_type, *tmp_value, *tmp_tb;
Georg Brandl5a444242008-03-21 20:11:46 +0000174
175 if (Py_Py3kWarningFlag &&
176 PyErr_Warn(PyExc_DeprecationWarning,
Georg Brandld5b635f2008-03-25 08:29:14 +0000177 "sys.exc_clear() not supported in 3.x; "
178 "use except clauses") < 0)
Georg Brandl5a444242008-03-21 20:11:46 +0000179 return NULL;
180
181 tstate = PyThreadState_GET();
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000182 tmp_type = tstate->exc_type;
183 tmp_value = tstate->exc_value;
184 tmp_tb = tstate->exc_traceback;
185 tstate->exc_type = NULL;
186 tstate->exc_value = NULL;
187 tstate->exc_traceback = NULL;
188 Py_XDECREF(tmp_type);
189 Py_XDECREF(tmp_value);
190 Py_XDECREF(tmp_tb);
191 /* For b/w compatibility */
192 PySys_SetObject("exc_type", Py_None);
193 PySys_SetObject("exc_value", Py_None);
194 PySys_SetObject("exc_traceback", Py_None);
195 Py_INCREF(Py_None);
196 return Py_None;
197}
198
199PyDoc_STRVAR(exc_clear_doc,
200"exc_clear() -> None\n\
201\n\
202Clear global information on the current exception. Subsequent calls to\n\
203exc_info() will return (None,None,None) until another exception is raised\n\
204in the current thread or the execution stack returns to a frame where\n\
205another exception is being handled."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000206);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000207
Guido van Rossuma027efa1997-05-05 20:56:21 +0000208static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000209sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000210{
Neal Norwitz0c766a02002-03-27 13:03:09 +0000211 PyObject *exit_code = 0;
Georg Brandl96a8c392006-05-29 21:04:52 +0000212 if (!PyArg_UnpackTuple(args, "exit", 0, 1, &exit_code))
Neal Norwitz0c766a02002-03-27 13:03:09 +0000213 return NULL;
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000214 /* Raise SystemExit so callers may catch it or clean up. */
Neal Norwitz0c766a02002-03-27 13:03:09 +0000215 PyErr_SetObject(PyExc_SystemExit, exit_code);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000216 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000217}
218
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000219PyDoc_STRVAR(exit_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000220"exit([status])\n\
221\n\
222Exit the interpreter by raising SystemExit(status).\n\
223If the status is omitted or None, it defaults to zero (i.e., success).\n\
Neil Schemenauer0f2103f2002-03-23 20:46:35 +0000224If the status is numeric, it will be used as the system exit status.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000225If it is another kind of object, it will be printed and the system\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000226exit status will be one (i.e., failure)."
227);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000228
Martin v. Löwis107b7da2001-11-09 20:59:39 +0000229#ifdef Py_USING_UNICODE
230
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000231static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000232sys_getdefaultencoding(PyObject *self)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000233{
Fred Drake8b4d01d2000-05-09 19:57:01 +0000234 return PyString_FromString(PyUnicode_GetDefaultEncoding());
235}
236
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000237PyDoc_STRVAR(getdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000238"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000239\n\
240Return the current default string encoding used by the Unicode \n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000241implementation."
242);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000243
244static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000245sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000246{
247 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000248 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000249 return NULL;
250 if (PyUnicode_SetDefaultEncoding(encoding))
251 return NULL;
252 Py_INCREF(Py_None);
253 return Py_None;
254}
255
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000256PyDoc_STRVAR(setdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000257"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000258\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000259Set the current default string encoding used by the Unicode implementation."
260);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000261
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000262static PyObject *
263sys_getfilesystemencoding(PyObject *self)
264{
265 if (Py_FileSystemDefaultEncoding)
266 return PyString_FromString(Py_FileSystemDefaultEncoding);
267 Py_INCREF(Py_None);
268 return Py_None;
269}
270
271PyDoc_STRVAR(getfilesystemencoding_doc,
272"getfilesystemencoding() -> string\n\
273\n\
274Return the encoding used to convert Unicode filenames in\n\
275operating system filenames."
276);
277
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000278#endif
279
Fred Drake5755ce62001-06-27 19:19:46 +0000280/*
281 * Cached interned string objects used for calling the profile and
282 * trace functions. Initialized by trace_init().
283 */
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000284static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL};
Fred Drake5755ce62001-06-27 19:19:46 +0000285
286static int
287trace_init(void)
288{
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000289 static char *whatnames[7] = {"call", "exception", "line", "return",
290 "c_call", "c_exception", "c_return"};
Fred Drake5755ce62001-06-27 19:19:46 +0000291 PyObject *name;
292 int i;
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000293 for (i = 0; i < 7; ++i) {
Fred Drake5755ce62001-06-27 19:19:46 +0000294 if (whatstrings[i] == NULL) {
295 name = PyString_InternFromString(whatnames[i]);
296 if (name == NULL)
297 return -1;
298 whatstrings[i] = name;
299 }
300 }
301 return 0;
302}
303
304
305static PyObject *
306call_trampoline(PyThreadState *tstate, PyObject* callback,
307 PyFrameObject *frame, int what, PyObject *arg)
308{
309 PyObject *args = PyTuple_New(3);
310 PyObject *whatstr;
311 PyObject *result;
312
313 if (args == NULL)
314 return NULL;
315 Py_INCREF(frame);
316 whatstr = whatstrings[what];
317 Py_INCREF(whatstr);
318 if (arg == NULL)
319 arg = Py_None;
320 Py_INCREF(arg);
321 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
322 PyTuple_SET_ITEM(args, 1, whatstr);
323 PyTuple_SET_ITEM(args, 2, arg);
324
325 /* call the Python-level function */
326 PyFrame_FastToLocals(frame);
327 result = PyEval_CallObject(callback, args);
328 PyFrame_LocalsToFast(frame, 1);
329 if (result == NULL)
330 PyTraceBack_Here(frame);
331
332 /* cleanup */
333 Py_DECREF(args);
334 return result;
335}
336
337static int
338profile_trampoline(PyObject *self, PyFrameObject *frame,
339 int what, PyObject *arg)
340{
341 PyThreadState *tstate = frame->f_tstate;
342 PyObject *result;
343
Fred Drake8f51f542001-10-04 14:48:42 +0000344 if (arg == NULL)
345 arg = Py_None;
Fred Drake5755ce62001-06-27 19:19:46 +0000346 result = call_trampoline(tstate, self, frame, what, arg);
347 if (result == NULL) {
348 PyEval_SetProfile(NULL, NULL);
349 return -1;
350 }
351 Py_DECREF(result);
352 return 0;
353}
354
355static int
356trace_trampoline(PyObject *self, PyFrameObject *frame,
357 int what, PyObject *arg)
358{
359 PyThreadState *tstate = frame->f_tstate;
360 PyObject *callback;
361 PyObject *result;
362
363 if (what == PyTrace_CALL)
364 callback = self;
365 else
366 callback = frame->f_trace;
367 if (callback == NULL)
368 return 0;
369 result = call_trampoline(tstate, callback, frame, what, arg);
370 if (result == NULL) {
371 PyEval_SetTrace(NULL, NULL);
372 Py_XDECREF(frame->f_trace);
373 frame->f_trace = NULL;
374 return -1;
375 }
376 if (result != Py_None) {
377 PyObject *temp = frame->f_trace;
378 frame->f_trace = NULL;
379 Py_XDECREF(temp);
380 frame->f_trace = result;
381 }
382 else {
383 Py_DECREF(result);
384 }
385 return 0;
386}
Fred Draked0838392001-06-16 21:02:31 +0000387
Fred Drake8b4d01d2000-05-09 19:57:01 +0000388static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000389sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000390{
Fred Drake5755ce62001-06-27 19:19:46 +0000391 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000392 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000393 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000394 PyEval_SetTrace(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000395 else
Fred Drake5755ce62001-06-27 19:19:46 +0000396 PyEval_SetTrace(trace_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000397 Py_INCREF(Py_None);
398 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000399}
400
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000401PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000402"settrace(function)\n\
403\n\
404Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000405function call. See the debugger chapter in the library manual."
406);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000407
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000408static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000409sys_gettrace(PyObject *self, PyObject *args)
410{
411 PyThreadState *tstate = PyThreadState_GET();
412 PyObject *temp = tstate->c_traceobj;
413
414 if (temp == NULL)
415 temp = Py_None;
416 Py_INCREF(temp);
417 return temp;
418}
419
420PyDoc_STRVAR(gettrace_doc,
421"gettrace()\n\
422\n\
423Return the global debug tracing function set with sys.settrace.\n\
424See the debugger chapter in the library manual."
425);
426
427static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000428sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000429{
Fred Drake5755ce62001-06-27 19:19:46 +0000430 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000431 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000432 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000433 PyEval_SetProfile(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000434 else
Fred Drake5755ce62001-06-27 19:19:46 +0000435 PyEval_SetProfile(profile_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000436 Py_INCREF(Py_None);
437 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000438}
439
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000440PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000441"setprofile(function)\n\
442\n\
443Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000444and return. See the profiler chapter in the library manual."
445);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000446
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000447static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000448sys_getprofile(PyObject *self, PyObject *args)
449{
450 PyThreadState *tstate = PyThreadState_GET();
451 PyObject *temp = tstate->c_profileobj;
452
453 if (temp == NULL)
454 temp = Py_None;
455 Py_INCREF(temp);
456 return temp;
457}
458
459PyDoc_STRVAR(getprofile_doc,
460"getprofile()\n\
461\n\
462Return the profiling function set with sys.setprofile.\n\
463See the profiler chapter in the library manual."
464);
465
466static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000467sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000468{
Skip Montanarod581d772002-09-03 20:10:45 +0000469 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000470 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000471 Py_INCREF(Py_None);
472 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000473}
474
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000475PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000476"setcheckinterval(n)\n\
477\n\
478Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000479n instructions. This also affects how often thread switches occur."
480);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000481
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000482static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000483sys_getcheckinterval(PyObject *self, PyObject *args)
484{
485 return PyInt_FromLong(_Py_CheckInterval);
486}
487
488PyDoc_STRVAR(getcheckinterval_doc,
489"getcheckinterval() -> current check interval; see setcheckinterval()."
490);
491
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000492#ifdef WITH_TSC
493static PyObject *
494sys_settscdump(PyObject *self, PyObject *args)
495{
496 int bool;
497 PyThreadState *tstate = PyThreadState_Get();
498
499 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
500 return NULL;
501 if (bool)
502 tstate->interp->tscdump = 1;
503 else
504 tstate->interp->tscdump = 0;
505 Py_INCREF(Py_None);
506 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000507
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000508}
509
Tim Peters216b78b2006-01-06 02:40:53 +0000510PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000511"settscdump(bool)\n\
512\n\
513If true, tell the Python interpreter to dump VM measurements to\n\
514stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000515processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000516);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000517#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000518
Tim Peterse5e065b2003-07-06 18:36:54 +0000519static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000520sys_setrecursionlimit(PyObject *self, PyObject *args)
521{
522 int new_limit;
523 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
524 return NULL;
525 if (new_limit <= 0) {
Tim Peters216b78b2006-01-06 02:40:53 +0000526 PyErr_SetString(PyExc_ValueError,
527 "recursion limit must be positive");
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000528 return NULL;
529 }
530 Py_SetRecursionLimit(new_limit);
531 Py_INCREF(Py_None);
532 return Py_None;
533}
534
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000535PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000536"setrecursionlimit(n)\n\
537\n\
538Set the maximum depth of the Python interpreter stack to n. This\n\
539limit prevents infinite recursion from causing an overflow of the C\n\
540stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000541dependent."
542);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000543
544static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000545sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000546{
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000547 return PyInt_FromLong(Py_GetRecursionLimit());
548}
549
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000550PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000551"getrecursionlimit()\n\
552\n\
553Return the current value of the recursion limit, the maximum depth\n\
554of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000555recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000556);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000557
Mark Hammond8696ebc2002-10-08 02:44:31 +0000558#ifdef MS_WINDOWS
559PyDoc_STRVAR(getwindowsversion_doc,
560"getwindowsversion()\n\
561\n\
562Return information about the running version of Windows.\n\
563The result is a tuple of (major, minor, build, platform, text)\n\
564All elements are numbers, except text which is a string.\n\
565Platform may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP\n\
566"
567);
568
569static PyObject *
570sys_getwindowsversion(PyObject *self)
571{
572 OSVERSIONINFO ver;
573 ver.dwOSVersionInfoSize = sizeof(ver);
574 if (!GetVersionEx(&ver))
575 return PyErr_SetFromWindowsErr(0);
576 return Py_BuildValue("HHHHs",
577 ver.dwMajorVersion,
578 ver.dwMinorVersion,
579 ver.dwBuildNumber,
580 ver.dwPlatformId,
581 ver.szCSDVersion);
582}
583
584#endif /* MS_WINDOWS */
585
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000586#ifdef HAVE_DLOPEN
587static PyObject *
588sys_setdlopenflags(PyObject *self, PyObject *args)
589{
590 int new_val;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000591 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000592 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
593 return NULL;
594 if (!tstate)
595 return NULL;
596 tstate->interp->dlopenflags = new_val;
597 Py_INCREF(Py_None);
598 return Py_None;
599}
600
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000601PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000602"setdlopenflags(n) -> None\n\
603\n\
604Set the flags that will be used for dlopen() calls. Among other\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000605things, this will enable a lazy resolving of symbols when importing\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000606a module, if called as sys.setdlopenflags(0)\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000607To share symbols across extension modules, call as\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000608sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)"
609);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000610
611static PyObject *
612sys_getdlopenflags(PyObject *self, PyObject *args)
613{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000614 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000615 if (!tstate)
616 return NULL;
617 return PyInt_FromLong(tstate->interp->dlopenflags);
618}
619
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000620PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000621"getdlopenflags() -> int\n\
622\n\
623Return the current value of the flags that are used for dlopen()\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000624calls. The flag constants are defined in the dl module."
625);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000626#endif
627
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000628#ifdef USE_MALLOPT
629/* Link with -lmalloc (or -lmpc) on an SGI */
630#include <malloc.h>
631
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000632static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000633sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000634{
635 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000636 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000637 return NULL;
638 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000639 Py_INCREF(Py_None);
640 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000641}
642#endif /* USE_MALLOPT */
643
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000644static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000645sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000646{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000647 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000648}
649
Tim Peters4be93d02002-07-07 19:59:50 +0000650#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000651static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000652sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000653{
Armin Rigoe1709372006-04-12 17:06:05 +0000654 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000655}
Armin Rigoe1709372006-04-12 17:06:05 +0000656#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000657
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000658PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000659"getrefcount(object) -> integer\n\
660\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000661Return the reference count of object. The count returned is generally\n\
662one higher than you might expect, because it includes the (temporary)\n\
663reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000664);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000665
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000666#ifdef COUNT_ALLOCS
667static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000668sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000669{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000670 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000671
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000672 return get_counts();
673}
674#endif
675
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000676PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000677"_getframe([depth]) -> frameobject\n\
678\n\
679Return a frame object from the call stack. If optional integer depth is\n\
680given, return the frame object that many calls below the top of the stack.\n\
681If that is deeper than the call stack, ValueError is raised. The default\n\
682for depth is zero, returning the frame at the top of the call stack.\n\
683\n\
684This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000685purposes only."
686);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000687
688static PyObject *
689sys_getframe(PyObject *self, PyObject *args)
690{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000691 PyFrameObject *f = PyThreadState_GET()->frame;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000692 int depth = -1;
693
694 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
695 return NULL;
696
697 while (depth > 0 && f != NULL) {
698 f = f->f_back;
699 --depth;
700 }
701 if (f == NULL) {
702 PyErr_SetString(PyExc_ValueError,
703 "call stack is not deep enough");
704 return NULL;
705 }
706 Py_INCREF(f);
707 return (PyObject*)f;
708}
709
Tim Peters32a83612006-07-10 21:08:24 +0000710PyDoc_STRVAR(current_frames_doc,
711"_current_frames() -> dictionary\n\
712\n\
713Return a dictionary mapping each current thread T's thread id to T's\n\
714current stack frame.\n\
715\n\
716This function should be used for specialized purposes only."
717);
718
719static PyObject *
720sys_current_frames(PyObject *self, PyObject *noargs)
721{
722 return _PyThread_CurrentFrames();
723}
724
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000725PyDoc_STRVAR(call_tracing_doc,
726"call_tracing(func, args) -> object\n\
727\n\
728Call func(*args), while tracing is enabled. The tracing state is\n\
729saved, and restored afterwards. This is intended to be called from\n\
730a debugger from a checkpoint, to recursively debug some other code."
731);
732
733static PyObject *
734sys_call_tracing(PyObject *self, PyObject *args)
735{
736 PyObject *func, *funcargs;
Georg Brandl96a8c392006-05-29 21:04:52 +0000737 if (!PyArg_UnpackTuple(args, "call_tracing", 2, 2, &func, &funcargs))
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000738 return NULL;
739 return _PyEval_CallTracing(func, funcargs);
740}
741
Jeremy Hylton985eba52003-02-05 23:13:00 +0000742PyDoc_STRVAR(callstats_doc,
743"callstats() -> tuple of integers\n\
744\n\
745Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
746when Python was built. Otherwise, return None.\n\
747\n\
748When enabled, this function returns detailed, implementation-specific\n\
749details about the number of function calls executed. The return value is\n\
750a 11-tuple where the entries in the tuple are counts of:\n\
7510. all function calls\n\
7521. calls to PyFunction_Type objects\n\
7532. PyFunction calls that do not create an argument tuple\n\
7543. PyFunction calls that do not create an argument tuple\n\
755 and bypass PyEval_EvalCodeEx()\n\
7564. PyMethod calls\n\
7575. PyMethod calls on bound methods\n\
7586. PyType calls\n\
7597. PyCFunction calls\n\
7608. generator calls\n\
7619. All other calls\n\
76210. Number of stack pops performed by call_function()"
763);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000764
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000765#ifdef __cplusplus
766extern "C" {
767#endif
768
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000769#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000770/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000771extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000772#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000773
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000774#ifdef DYNAMIC_EXECUTION_PROFILE
775/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000776extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000777#endif
778
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000779#ifdef __cplusplus
780}
781#endif
782
Christian Heimes422051a2008-02-04 18:00:12 +0000783static PyObject *
784sys_clear_type_cache(PyObject* self, PyObject* args)
785{
786 PyType_ClearCache();
787 Py_RETURN_NONE;
788}
789
790PyDoc_STRVAR(sys_clear_type_cache__doc__,
791"_clear_type_cache() -> None\n\
792Clear the internal type lookup cache.");
793
794
795static PyObject *
796sys_compact_freelists(PyObject* self, PyObject* args)
797{
798 size_t isum, ibc, ibf;
799 size_t fsum, fbc, fbf;
800
801 PyInt_CompactFreeList(&ibc, &ibf, &isum);
802 PyFloat_CompactFreeList(&fbc, &fbf, &fsum);
803
804 return Py_BuildValue("(kkk)(kkk)", isum, ibc, ibf,
805 fsum, fbc, fbf);
806
807}
808
809PyDoc_STRVAR(sys_compact_freelists__doc__,
810"_compact_freelists() -> ((remaing_objects, total_blocks, freed_blocks), ...)\n\
811Compact the free lists of ints and floats.");
812
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000813static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000814 /* Might as well keep this in alphabetic order */
Tim Peters216b78b2006-01-06 02:40:53 +0000815 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
Jeremy Hylton985eba52003-02-05 23:13:00 +0000816 callstats_doc},
Christian Heimes422051a2008-02-04 18:00:12 +0000817 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
818 sys_clear_type_cache__doc__},
819 {"_compact_freelists", sys_compact_freelists, METH_NOARGS,
820 sys_compact_freelists__doc__},
Tim Peters32a83612006-07-10 21:08:24 +0000821 {"_current_frames", sys_current_frames, METH_NOARGS,
822 current_frames_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000823 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000824 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
825 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000826 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
Neal Norwitz0c766a02002-03-27 13:03:09 +0000827 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000828#ifdef Py_USING_UNICODE
Tim Peters216b78b2006-01-06 02:40:53 +0000829 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
830 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000831#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000832#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000833 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000834 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000835#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000836#ifdef COUNT_ALLOCS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000837 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000838#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000839#ifdef DYNAMIC_EXECUTION_PROFILE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000840 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000841#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000842#ifdef Py_USING_UNICODE
843 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
Tim Peters216b78b2006-01-06 02:40:53 +0000844 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000845#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000846#ifdef Py_TRACE_REFS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000847 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000848#endif
849#ifdef Py_REF_DEBUG
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000850 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000851#endif
Fred Drakea7688822001-10-24 20:47:48 +0000852 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000853 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000854 getrecursionlimit_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000855 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000856#ifdef MS_WINDOWS
857 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
858 getwindowsversion_doc},
859#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000860#ifdef USE_MALLOPT
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000861 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000862#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000863#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000864 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000865 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000866#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000867 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000868 setcheckinterval_doc},
Tim Peterse5e065b2003-07-06 18:36:54 +0000869 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000870 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000871#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000872 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000873 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000874#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000875 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
Georg Brandl56112892008-01-20 13:59:46 +0000876 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000877 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000878 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000879#ifdef WITH_TSC
880 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
881#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000882 {"settrace", sys_settrace, METH_O, settrace_doc},
Georg Brandl56112892008-01-20 13:59:46 +0000883 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000884 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000885 {NULL, NULL} /* sentinel */
886};
887
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000888static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000889list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000890{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000891 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000892 int i;
893 if (list == NULL)
894 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000895 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Guido van Rossuma027efa1997-05-05 20:56:21 +0000896 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000897 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000898 if (name == NULL)
899 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000900 PyList_Append(list, name);
901 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000902 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000903 if (PyList_Sort(list) != 0) {
904 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000905 list = NULL;
906 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000907 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000908 PyObject *v = PyList_AsTuple(list);
909 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000910 list = v;
911 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000912 return list;
913}
914
Guido van Rossum23fff912000-12-15 22:02:05 +0000915static PyObject *warnoptions = NULL;
916
917void
918PySys_ResetWarnOptions(void)
919{
920 if (warnoptions == NULL || !PyList_Check(warnoptions))
921 return;
922 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
923}
924
925void
926PySys_AddWarnOption(char *s)
927{
928 PyObject *str;
929
930 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
931 Py_XDECREF(warnoptions);
932 warnoptions = PyList_New(0);
933 if (warnoptions == NULL)
934 return;
935 }
936 str = PyString_FromString(s);
937 if (str != NULL) {
938 PyList_Append(warnoptions, str);
939 Py_DECREF(str);
940 }
941}
942
Brett Cannone9746892008-04-12 23:44:07 +0000943int
944PySys_HasWarnOptions(void)
945{
Brett Cannon40f0a872008-04-13 00:18:44 +0000946 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
Brett Cannone9746892008-04-12 23:44:07 +0000947}
948
Guido van Rossum40552d01998-08-06 03:34:39 +0000949/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
950 Two literals concatenated works just fine. If you have a K&R compiler
951 or other abomination that however *does* understand longer strings,
952 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000953PyDoc_VAR(sys_doc) =
954PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000955"This module provides access to some objects used or maintained by the\n\
956interpreter and to functions that interact strongly with the interpreter.\n\
957\n\
958Dynamic objects:\n\
959\n\
960argv -- command line arguments; argv[0] is the script pathname if known\n\
961path -- module search path; path[0] is the script directory, else ''\n\
962modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000963\n\
964displayhook -- called to show results in an interactive session\n\
965excepthook -- called to handle any uncaught exception other than SystemExit\n\
966 To customize printing in an interactive session or to install a custom\n\
967 top-level exception handler, assign other functions to replace these.\n\
968\n\
969exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
970 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000971\n\
972stdin -- standard input file object; used by raw_input() and input()\n\
973stdout -- standard output file object; used by the print statement\n\
974stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000975 By assigning other file objects (or objects that behave like files)\n\
976 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000977\n\
978last_type -- type of last uncaught exception\n\
979last_value -- value of last uncaught exception\n\
980last_traceback -- traceback of last uncaught exception\n\
981 These three are only available in an interactive session after a\n\
982 traceback has been printed.\n\
983\n\
984exc_type -- type of exception currently being handled\n\
985exc_value -- value of exception currently being handled\n\
986exc_traceback -- traceback of exception currently being handled\n\
987 The function exc_info() should be used instead of these three,\n\
988 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000989"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000990)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000991/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000992PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000993"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000994Static objects:\n\
995\n\
996maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +0000997maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000998builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +0000999version -- the version of this interpreter as a string\n\
1000version_info -- version information as a tuple\n\
1001hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001002copyright -- copyright notice pertaining to this interpreter\n\
1003platform -- platform identifier\n\
1004executable -- pathname of this Python interpreter\n\
1005prefix -- prefix used to find the Python library\n\
1006exec_prefix -- prefix used to find the machine-specific Python library\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001007"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001008)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001009#ifdef MS_WINDOWS
1010/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001011PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001012"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001013winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001014"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001015)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001016#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001017PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001018"__stdin__ -- the original stdin; don't touch!\n\
1019__stdout__ -- the original stdout; don't touch!\n\
1020__stderr__ -- the original stderr; don't touch!\n\
1021__displayhook__ -- the original displayhook; don't touch!\n\
1022__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001023\n\
1024Functions:\n\
1025\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +00001026displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001027excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001028exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +00001029exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001030exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001031getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Georg Brandl56112892008-01-20 13:59:46 +00001032getprofile() -- get the global profiling function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001033getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001034getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Georg Brandl56112892008-01-20 13:59:46 +00001035gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001036setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001037setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001038setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001039setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001040settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001041"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001042)
Fred Drakeccede592000-08-14 20:59:57 +00001043/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001044
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001045static int
1046_check_and_flush (FILE *stream)
1047{
1048 int prev_fail = ferror (stream);
1049 return fflush (stream) || prev_fail ? EOF : 0;
1050}
1051
Martin v. Löwis43b57802006-01-05 23:38:54 +00001052/* Subversion branch and revision management */
1053static const char _patchlevel_revision[] = PY_PATCHLEVEL_REVISION;
1054static const char headurl[] = "$HeadURL$";
1055static int svn_initialized;
1056static char patchlevel_revision[50]; /* Just the number */
1057static char branch[50];
1058static char shortbranch[50];
1059static const char *svn_revision;
1060
Tim Peterse86e7a52006-01-06 02:42:46 +00001061static void
1062svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001063{
1064 const char *python, *br_start, *br_end, *br_end2, *svnversion;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001065 Py_ssize_t len;
1066 int istag;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001067
1068 if (svn_initialized)
1069 return;
1070
1071 python = strstr(headurl, "/python/");
Christian Heimes6a453c32008-03-24 19:57:42 +00001072 if (!python) {
1073 /* XXX quick hack to get bzr working */
1074 *patchlevel_revision = '\0';
1075 strcpy(branch, "");
1076 strcpy(shortbranch, "unknown");
1077 svn_revision = "";
Christian Heimesa113bd92008-03-24 19:58:17 +00001078 return;
1079 /* Py_FatalError("subversion keywords missing"); */
Christian Heimes6a453c32008-03-24 19:57:42 +00001080 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001081
1082 br_start = python + 8;
1083 br_end = strchr(br_start, '/');
Neal Norwitz837ce932006-10-28 21:15:30 +00001084 assert(br_end);
1085
Tim Peters216b78b2006-01-06 02:40:53 +00001086 /* Works even for trunk,
Martin v. Löwis43b57802006-01-05 23:38:54 +00001087 as we are in trunk/Python/sysmodule.c */
1088 br_end2 = strchr(br_end+1, '/');
1089
1090 istag = strncmp(br_start, "tags", 4) == 0;
1091 if (strncmp(br_start, "trunk", 5) == 0) {
1092 strcpy(branch, "trunk");
1093 strcpy(shortbranch, "trunk");
1094
Tim Peters216b78b2006-01-06 02:40:53 +00001095 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001096 else if (istag || strncmp(br_start, "branches", 8) == 0) {
1097 len = br_end2 - br_start;
1098 strncpy(branch, br_start, len);
1099 branch[len] = '\0';
1100
1101 len = br_end2 - (br_end + 1);
1102 strncpy(shortbranch, br_end + 1, len);
1103 shortbranch[len] = '\0';
Tim Peters216b78b2006-01-06 02:40:53 +00001104 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001105 else {
1106 Py_FatalError("bad HeadURL");
1107 return;
1108 }
1109
1110
1111 svnversion = _Py_svnversion();
1112 if (strcmp(svnversion, "exported") != 0)
1113 svn_revision = svnversion;
1114 else if (istag) {
1115 len = strlen(_patchlevel_revision);
Neal Norwitz68cdf8a2007-04-16 07:37:55 +00001116 assert(len >= 13);
1117 assert(len < (sizeof(patchlevel_revision) + 13));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001118 strncpy(patchlevel_revision, _patchlevel_revision + 11,
1119 len - 13);
1120 patchlevel_revision[len - 13] = '\0';
1121 svn_revision = patchlevel_revision;
1122 }
1123 else
1124 svn_revision = "";
Tim Peters216b78b2006-01-06 02:40:53 +00001125
Martin v. Löwis43b57802006-01-05 23:38:54 +00001126 svn_initialized = 1;
1127}
1128
1129/* Return svnversion output if available.
1130 Else return Revision of patchlevel.h if on branch.
1131 Else return empty string */
1132const char*
1133Py_SubversionRevision()
1134{
1135 svnversion_init();
1136 return svn_revision;
1137}
1138
1139const char*
1140Py_SubversionShortBranch()
1141{
1142 svnversion_init();
1143 return shortbranch;
1144}
1145
Christian Heimesf31b69f2008-01-14 03:42:48 +00001146
1147PyDoc_STRVAR(flags__doc__,
1148"sys.flags\n\
1149\n\
1150Flags provided through command line arguments or environment vars.");
1151
Christian Heimes796fc312008-01-30 18:58:29 +00001152static PyTypeObject FlagsType = {0, 0, 0, 0, 0, 0};
Christian Heimesf31b69f2008-01-14 03:42:48 +00001153
1154static PyStructSequence_Field flags_fields[] = {
1155 {"debug", "-d"},
1156 {"py3k_warning", "-3"},
1157 {"division_warning", "-Q"},
1158 {"division_new", "-Qnew"},
1159 {"inspect", "-i"},
1160 {"interactive", "-i"},
1161 {"optimize", "-O or -OO"},
1162 {"dont_write_bytecode", "-B"},
1163 /* {"no_user_site", "-s"}, */
1164 {"no_site", "-S"},
Andrew M. Kuchling7ce9b182008-01-15 01:29:16 +00001165 {"ignore_environment", "-E"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001166 {"tabcheck", "-t or -tt"},
1167 {"verbose", "-v"},
1168#ifdef RISCOS
Andrew M. Kuchling7ce9b182008-01-15 01:29:16 +00001169 {"riscos_wimp", "???"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001170#endif
1171 /* {"unbuffered", "-u"}, */
1172 {"unicode", "-U"},
1173 /* {"skip_first", "-x"}, */
Brett Cannone9746892008-04-12 23:44:07 +00001174 {"bytes_warning", "-b"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001175 {0}
1176};
1177
1178static PyStructSequence_Desc flags_desc = {
1179 "sys.flags", /* name */
1180 flags__doc__, /* doc */
1181 flags_fields, /* fields */
1182#ifdef RISCOS
1183 14
1184#else
1185 13
1186#endif
1187};
1188
1189static PyObject*
1190make_flags(void)
1191{
1192 int pos = 0;
1193 PyObject *seq;
1194
1195 seq = PyStructSequence_New(&FlagsType);
1196 if (seq == NULL)
1197 return NULL;
1198
1199#define SetFlag(flag) \
1200 PyStructSequence_SET_ITEM(seq, pos++, PyInt_FromLong(flag))
1201
1202 SetFlag(Py_DebugFlag);
1203 SetFlag(Py_Py3kWarningFlag);
1204 SetFlag(Py_DivisionWarningFlag);
1205 SetFlag(_Py_QnewFlag);
1206 SetFlag(Py_InspectFlag);
1207 SetFlag(Py_InteractiveFlag);
1208 SetFlag(Py_OptimizeFlag);
1209 SetFlag(Py_DontWriteBytecodeFlag);
1210 /* SetFlag(Py_NoUserSiteDirectory); */
1211 SetFlag(Py_NoSiteFlag);
1212 SetFlag(Py_IgnoreEnvironmentFlag);
1213 SetFlag(Py_TabcheckFlag);
1214 SetFlag(Py_VerboseFlag);
1215#ifdef RISCOS
1216 SetFlag(Py_RISCOSWimpFlag);
1217#endif
1218 /* SetFlag(saw_unbuffered_flag); */
1219 SetFlag(Py_UnicodeFlag);
1220 /* SetFlag(skipfirstline); */
Brett Cannone9746892008-04-12 23:44:07 +00001221 SetFlag(Py_BytesWarningFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001222#undef SetFlag
1223
1224 if (PyErr_Occurred()) {
1225 return NULL;
1226 }
Christian Heimesf31b69f2008-01-14 03:42:48 +00001227 return seq;
1228}
1229
Guido van Rossum25ce5661997-08-02 03:10:38 +00001230PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001231_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001232{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001233 PyObject *m, *v, *sysdict;
1234 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +00001235 char *s;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001236#ifdef MS_WINDOWS
Tim Peters02f1d0d2006-06-06 00:25:07 +00001237 char buf[128];
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001238#endif
Guido van Rossum25ce5661997-08-02 03:10:38 +00001239
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001240 m = Py_InitModule3("sys", sys_methods, sys_doc);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00001241 if (m == NULL)
1242 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001243 sysdict = PyModule_GetDict(m);
Christian Heimes0d924432008-01-30 17:21:22 +00001244#define SET_SYS_FROM_STRING(key, value) \
1245 v = value; \
1246 if (v != NULL) \
1247 PyDict_SetItemString(sysdict, key, v); \
1248 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001249
Neal Norwitz11bd1192005-10-03 00:54:56 +00001250 {
1251 /* XXX: does this work on Win/Win64? (see posix_fstat) */
1252 struct stat sb;
1253 if (fstat(fileno(stdin), &sb) == 0 &&
1254 S_ISDIR(sb.st_mode)) {
Neal Norwitz72c2c062006-03-09 05:58:11 +00001255 /* There's nothing more we can do. */
1256 /* Py_FatalError() will core dump, so just exit. */
1257 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1258 exit(EXIT_FAILURE);
Neal Norwitz11bd1192005-10-03 00:54:56 +00001259 }
1260 }
1261
Martin v. Löwis13a1fde2005-01-27 18:56:16 +00001262 /* Closing the standard FILE* if sys.std* goes aways causes problems
1263 * for embedded Python usages. Closing them when somebody explicitly
1264 * invokes .close() might be possible, but the FAQ promises they get
1265 * never closed. However, we still need to get write errors when
1266 * writing fails (e.g. because stdout is redirected), so we flush the
1267 * streams and check for errors before the file objects are deleted.
1268 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1269 * from that procedure.
1270 */
1271 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001272 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1273 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001274 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001275 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001276#ifdef MS_WINDOWS
Thomas Woutersafea5292007-01-23 13:42:00 +00001277 if(isatty(_fileno(stdin)) && PyFile_Check(sysin)) {
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001278 sprintf(buf, "cp%d", GetConsoleCP());
1279 if (!PyFile_SetEncoding(sysin, buf))
1280 return NULL;
1281 }
Thomas Woutersafea5292007-01-23 13:42:00 +00001282 if(isatty(_fileno(stdout)) && PyFile_Check(sysout)) {
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001283 sprintf(buf, "cp%d", GetConsoleOutputCP());
1284 if (!PyFile_SetEncoding(sysout, buf))
1285 return NULL;
1286 }
Thomas Woutersafea5292007-01-23 13:42:00 +00001287 if(isatty(_fileno(stderr)) && PyFile_Check(syserr)) {
Martin v. Löwisea62d252006-04-03 10:56:49 +00001288 sprintf(buf, "cp%d", GetConsoleOutputCP());
1289 if (!PyFile_SetEncoding(syserr, buf))
1290 return NULL;
1291 }
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001292#endif
1293
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001294 PyDict_SetItemString(sysdict, "stdin", sysin);
1295 PyDict_SetItemString(sysdict, "stdout", sysout);
1296 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +00001297 /* Make backup copies for cleanup */
1298 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1299 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1300 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001301 PyDict_SetItemString(sysdict, "__displayhook__",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001302 PyDict_GetItemString(sysdict, "displayhook"));
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001303 PyDict_SetItemString(sysdict, "__excepthook__",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001304 PyDict_GetItemString(sysdict, "excepthook"));
Guido van Rossum25ce5661997-08-02 03:10:38 +00001305 Py_XDECREF(sysin);
1306 Py_XDECREF(sysout);
1307 Py_XDECREF(syserr);
Christian Heimes0d924432008-01-30 17:21:22 +00001308
1309 SET_SYS_FROM_STRING("version",
1310 PyString_FromString(Py_GetVersion()));
1311 SET_SYS_FROM_STRING("hexversion",
1312 PyInt_FromLong(PY_VERSION_HEX));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001313 svnversion_init();
Christian Heimes0d924432008-01-30 17:21:22 +00001314 SET_SYS_FROM_STRING("subversion",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001315 Py_BuildValue("(ssz)", "CPython", branch,
Christian Heimes0d924432008-01-30 17:21:22 +00001316 svn_revision));
1317 SET_SYS_FROM_STRING("dont_write_bytecode",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001318 PyBool_FromLong(Py_DontWriteBytecodeFlag));
Fred Drake93a20bf2000-04-13 17:44:51 +00001319 /*
1320 * These release level checks are mutually exclusive and cover
1321 * the field, so don't get too fancy with the pre-processor!
1322 */
1323#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001324 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +00001325#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001326 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +00001327#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001328 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +00001329#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +00001330 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +00001331#endif
Neal Norwitze1fdb322006-07-21 05:32:28 +00001332
Neal Norwitze1fdb322006-07-21 05:32:28 +00001333 SET_SYS_FROM_STRING("version_info",
1334 Py_BuildValue("iiisi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +00001335 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +00001336 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +00001337 PY_RELEASE_SERIAL));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001338 SET_SYS_FROM_STRING("api_version",
1339 PyInt_FromLong(PYTHON_API_VERSION));
1340 SET_SYS_FROM_STRING("copyright",
1341 PyString_FromString(Py_GetCopyright()));
1342 SET_SYS_FROM_STRING("platform",
1343 PyString_FromString(Py_GetPlatform()));
1344 SET_SYS_FROM_STRING("executable",
1345 PyString_FromString(Py_GetProgramFullPath()));
1346 SET_SYS_FROM_STRING("prefix",
1347 PyString_FromString(Py_GetPrefix()));
1348 SET_SYS_FROM_STRING("exec_prefix",
1349 PyString_FromString(Py_GetExecPrefix()));
1350 SET_SYS_FROM_STRING("maxint",
1351 PyInt_FromLong(PyInt_GetMax()));
Christian Heimes28104c52007-11-27 23:16:44 +00001352 SET_SYS_FROM_STRING("py3kwarning",
1353 PyBool_FromLong(Py_Py3kWarningFlag));
Christian Heimesdfdfaab2007-12-01 11:20:10 +00001354 SET_SYS_FROM_STRING("float_info",
1355 PyFloat_GetInfo());
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001356#ifdef Py_USING_UNICODE
Neal Norwitze1fdb322006-07-21 05:32:28 +00001357 SET_SYS_FROM_STRING("maxunicode",
1358 PyInt_FromLong(PyUnicode_GetMax()));
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001359#endif
Neal Norwitze1fdb322006-07-21 05:32:28 +00001360 SET_SYS_FROM_STRING("builtin_module_names",
1361 list_builtin_module_names());
Fred Drake099325e2000-08-14 15:47:03 +00001362 {
1363 /* Assumes that longs are at least 2 bytes long.
1364 Should be safe! */
1365 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +00001366 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001367
1368 s = (char *) &number;
1369 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +00001370 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +00001371 else
Fred Drakea2b6ad62000-08-15 04:24:43 +00001372 value = "little";
Neal Norwitze1fdb322006-07-21 05:32:28 +00001373 SET_SYS_FROM_STRING("byteorder",
1374 PyString_FromString(value));
Fred Drake099325e2000-08-14 15:47:03 +00001375 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001376#ifdef MS_COREDLL
Neal Norwitze1fdb322006-07-21 05:32:28 +00001377 SET_SYS_FROM_STRING("dllhandle",
1378 PyLong_FromVoidPtr(PyWin_DLLhModule));
1379 SET_SYS_FROM_STRING("winver",
1380 PyString_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001381#endif
Guido van Rossum23fff912000-12-15 22:02:05 +00001382 if (warnoptions == NULL) {
1383 warnoptions = PyList_New(0);
1384 }
1385 else {
1386 Py_INCREF(warnoptions);
1387 }
1388 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +00001389 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +00001390 }
Tim Peters216b78b2006-01-06 02:40:53 +00001391
Christian Heimes796fc312008-01-30 18:58:29 +00001392 if (FlagsType.tp_name == 0)
1393 PyStructSequence_InitType(&FlagsType, &flags_desc);
Christian Heimes0d924432008-01-30 17:21:22 +00001394 SET_SYS_FROM_STRING("flags", make_flags());
Christian Heimesf31b69f2008-01-14 03:42:48 +00001395 /* prevent user from creating new instances */
1396 FlagsType.tp_init = NULL;
1397 FlagsType.tp_new = NULL;
1398
Christian Heimes0d924432008-01-30 17:21:22 +00001399#undef SET_SYS_FROM_STRING
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001400 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001401 return NULL;
1402 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001403}
1404
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001405static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001406makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001407{
Guido van Rossum3f5da241990-12-20 15:06:42 +00001408 int i, n;
1409 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001410 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001411
Guido van Rossum3f5da241990-12-20 15:06:42 +00001412 n = 1;
1413 p = path;
1414 while ((p = strchr(p, delim)) != NULL) {
1415 n++;
1416 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001417 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001418 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001419 if (v == NULL)
1420 return NULL;
1421 for (i = 0; ; i++) {
1422 p = strchr(path, delim);
1423 if (p == NULL)
1424 p = strchr(path, '\0'); /* End of string */
Armin Rigo7ccbca92006-10-04 12:17:45 +00001425 w = PyString_FromStringAndSize(path, (Py_ssize_t) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +00001426 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001427 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001428 return NULL;
1429 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001430 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001431 if (*p == '\0')
1432 break;
1433 path = p+1;
1434 }
1435 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001436}
1437
1438void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001439PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001440{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001441 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001442 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001443 Py_FatalError("can't create sys.path");
1444 if (PySys_SetObject("path", v) != 0)
1445 Py_FatalError("can't assign sys.path");
1446 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001447}
1448
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001449static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001450makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001451{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001452 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +00001453 if (argc <= 0 || argv == NULL) {
1454 /* Ensure at least one (empty) argument is seen */
1455 static char *empty_argv[1] = {""};
1456 argv = empty_argv;
1457 argc = 1;
1458 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001459 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001460 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001461 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001462 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001463#ifdef __VMS
1464 PyObject *v;
1465
1466 /* argv[0] is the script pathname if known */
1467 if (i == 0) {
1468 char* fn = decc$translate_vms(argv[0]);
1469 if ((fn == (char *)0) || fn == (char *)-1)
1470 v = PyString_FromString(argv[0]);
1471 else
1472 v = PyString_FromString(
1473 decc$translate_vms(argv[0]));
1474 } else
1475 v = PyString_FromString(argv[i]);
1476#else
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001477 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001478#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001479 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001480 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001481 av = NULL;
1482 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001483 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001484 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001485 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001486 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001487 return av;
1488}
1489
1490void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001491PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001492{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001493#if defined(HAVE_REALPATH)
1494 char fullpath[MAXPATHLEN];
1495#elif defined(MS_WINDOWS)
Thomas Heller27bb71e2003-01-08 14:33:48 +00001496 char fullpath[MAX_PATH];
1497#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001498 PyObject *av = makeargvobject(argc, argv);
1499 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001500 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001501 Py_FatalError("no mem for sys.argv");
1502 if (PySys_SetObject("argv", av) != 0)
1503 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +00001504 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001505 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +00001506 char *p = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001507 Py_ssize_t n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001508 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001509#ifdef HAVE_READLINK
1510 char link[MAXPATHLEN+1];
1511 char argv0copy[2*MAXPATHLEN+1];
1512 int nr = 0;
Georg Brandl69537722005-09-15 13:00:34 +00001513 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
Guido van Rossumc474dea1997-04-25 15:38:31 +00001514 nr = readlink(argv0, link, MAXPATHLEN);
1515 if (nr > 0) {
1516 /* It's a symlink */
1517 link[nr] = '\0';
1518 if (link[0] == SEP)
1519 argv0 = link; /* Link to absolute path */
1520 else if (strchr(link, SEP) == NULL)
1521 ; /* Link without path */
1522 else {
1523 /* Must join(dirname(argv0), link) */
1524 char *q = strrchr(argv0, SEP);
1525 if (q == NULL)
1526 argv0 = link; /* argv0 without path */
1527 else {
1528 /* Must make a copy */
1529 strcpy(argv0copy, argv0);
1530 q = strrchr(argv0copy, SEP);
1531 strcpy(q+1, link);
1532 argv0 = argv0copy;
1533 }
1534 }
1535 }
1536#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001537#if SEP == '\\' /* Special case for MS filename syntax */
Georg Brandl69537722005-09-15 13:00:34 +00001538 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossumcc883411996-09-10 14:44:21 +00001539 char *q;
Thomas Heller27bb71e2003-01-08 14:33:48 +00001540#ifdef MS_WINDOWS
1541 char *ptemp;
1542 if (GetFullPathName(argv0,
1543 sizeof(fullpath),
1544 fullpath,
1545 &ptemp)) {
1546 argv0 = fullpath;
1547 }
1548#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001549 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +00001550 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +00001551 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +00001552 if (q != NULL)
1553 p = q;
1554 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001555 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001556 if (n > 1 && p[-1] != ':')
1557 n--; /* Drop trailing separator */
1558 }
1559 }
1560#else /* All other filename syntaxes */
Georg Brandl69537722005-09-15 13:00:34 +00001561 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001562#if defined(HAVE_REALPATH)
1563 if (realpath(argv0, fullpath)) {
1564 argv0 = fullpath;
1565 }
1566#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001567 p = strrchr(argv0, SEP);
Guido van Rossum162e38c2003-02-19 15:25:10 +00001568 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001569 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001570#ifndef RISCOS
Guido van Rossumc474dea1997-04-25 15:38:31 +00001571 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001572#else /* don't include trailing separator */
1573 n = p - argv0;
1574#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001575#if SEP == '/' /* Special case for Unix filename syntax */
1576 if (n > 1)
1577 n--; /* Drop trailing separator */
1578#endif /* Unix */
1579 }
1580#endif /* All others */
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001581 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +00001582 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001583 Py_FatalError("no mem for sys.path insertion");
1584 if (PyList_Insert(path, 0, a) < 0)
1585 Py_FatalError("sys.path.insert(0) failed");
1586 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +00001587 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001588 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001589}
Guido van Rossuma890e681998-05-12 14:59:24 +00001590
1591
1592/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1593 Adapted from code submitted by Just van Rossum.
1594
1595 PySys_WriteStdout(format, ...)
1596 PySys_WriteStderr(format, ...)
1597
1598 The first function writes to sys.stdout; the second to sys.stderr. When
1599 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001600 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001601
1602 Both take a printf-style format string as their first argument followed
1603 by a variable length argument list determined by the format string.
1604
1605 *** WARNING ***
1606
1607 The format should limit the total size of the formatted output string to
1608 1000 bytes. In particular, this means that no unrestricted "%s" formats
1609 should occur; these should be limited using "%.<N>s where <N> is a
1610 decimal number calculated so that <N> plus the maximum size of other
1611 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1612 which can print hundreds of digits for very large numbers.
1613
1614 */
1615
1616static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001617mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001618{
1619 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001620 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001621
Guido van Rossum8442af31998-10-12 18:22:10 +00001622 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001623 file = PySys_GetObject(name);
1624 if (file == NULL || PyFile_AsFile(file) == fp)
1625 vfprintf(fp, format, va);
1626 else {
1627 char buffer[1001];
Tim Peters080d5b32001-12-02 08:29:16 +00001628 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1629 format, va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001630 if (PyFile_WriteString(buffer, file) != 0) {
1631 PyErr_Clear();
1632 fputs(buffer, fp);
1633 }
Skip Montanaro53a6d1d2006-04-18 00:55:46 +00001634 if (written < 0 || (size_t)written >= sizeof(buffer)) {
Jeremy Hylton5d3d1342001-11-28 21:44:53 +00001635 const char *truncated = "... truncated";
1636 if (PyFile_WriteString(truncated, file) != 0) {
1637 PyErr_Clear();
1638 fputs(truncated, fp);
1639 }
1640 }
Guido van Rossuma890e681998-05-12 14:59:24 +00001641 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001642 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001643}
1644
1645void
Guido van Rossuma890e681998-05-12 14:59:24 +00001646PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001647{
1648 va_list va;
1649
Guido van Rossuma890e681998-05-12 14:59:24 +00001650 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001651 mywrite("stdout", stdout, format, va);
1652 va_end(va);
1653}
1654
1655void
Guido van Rossuma890e681998-05-12 14:59:24 +00001656PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001657{
1658 va_list va;
1659
Guido van Rossuma890e681998-05-12 14:59:24 +00001660 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001661 mywrite("stderr", stderr, format, va);
1662 va_end(va);
1663}