blob: a9ab6a7c99746bf81da7e014c20ca552b543cd64 [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
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000175 if (PyErr_WarnPy3k("sys.exc_clear() not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000176 "use except clauses", 1) < 0)
Georg Brandl5a444242008-03-21 20:11:46 +0000177 return NULL;
178
179 tstate = PyThreadState_GET();
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000180 tmp_type = tstate->exc_type;
181 tmp_value = tstate->exc_value;
182 tmp_tb = tstate->exc_traceback;
183 tstate->exc_type = NULL;
184 tstate->exc_value = NULL;
185 tstate->exc_traceback = NULL;
186 Py_XDECREF(tmp_type);
187 Py_XDECREF(tmp_value);
188 Py_XDECREF(tmp_tb);
189 /* For b/w compatibility */
190 PySys_SetObject("exc_type", Py_None);
191 PySys_SetObject("exc_value", Py_None);
192 PySys_SetObject("exc_traceback", Py_None);
193 Py_INCREF(Py_None);
194 return Py_None;
195}
196
197PyDoc_STRVAR(exc_clear_doc,
198"exc_clear() -> None\n\
199\n\
200Clear global information on the current exception. Subsequent calls to\n\
201exc_info() will return (None,None,None) until another exception is raised\n\
202in the current thread or the execution stack returns to a frame where\n\
203another exception is being handled."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000204);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000205
Guido van Rossuma027efa1997-05-05 20:56:21 +0000206static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000207sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000208{
Neal Norwitz0c766a02002-03-27 13:03:09 +0000209 PyObject *exit_code = 0;
Georg Brandl96a8c392006-05-29 21:04:52 +0000210 if (!PyArg_UnpackTuple(args, "exit", 0, 1, &exit_code))
Neal Norwitz0c766a02002-03-27 13:03:09 +0000211 return NULL;
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000212 /* Raise SystemExit so callers may catch it or clean up. */
Neal Norwitz0c766a02002-03-27 13:03:09 +0000213 PyErr_SetObject(PyExc_SystemExit, exit_code);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000214 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000215}
216
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000217PyDoc_STRVAR(exit_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000218"exit([status])\n\
219\n\
220Exit the interpreter by raising SystemExit(status).\n\
221If the status is omitted or None, it defaults to zero (i.e., success).\n\
Neil Schemenauer0f2103f2002-03-23 20:46:35 +0000222If the status is numeric, it will be used as the system exit status.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000223If it is another kind of object, it will be printed and the system\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000224exit status will be one (i.e., failure)."
225);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000226
Martin v. Löwis107b7da2001-11-09 20:59:39 +0000227#ifdef Py_USING_UNICODE
228
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000229static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000230sys_getdefaultencoding(PyObject *self)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000231{
Fred Drake8b4d01d2000-05-09 19:57:01 +0000232 return PyString_FromString(PyUnicode_GetDefaultEncoding());
233}
234
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000235PyDoc_STRVAR(getdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000236"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000237\n\
238Return the current default string encoding used by the Unicode \n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000239implementation."
240);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000241
242static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000243sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000244{
245 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000246 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000247 return NULL;
248 if (PyUnicode_SetDefaultEncoding(encoding))
249 return NULL;
250 Py_INCREF(Py_None);
251 return Py_None;
252}
253
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000254PyDoc_STRVAR(setdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000255"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000256\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000257Set the current default string encoding used by the Unicode implementation."
258);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000259
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000260static PyObject *
261sys_getfilesystemencoding(PyObject *self)
262{
263 if (Py_FileSystemDefaultEncoding)
264 return PyString_FromString(Py_FileSystemDefaultEncoding);
265 Py_INCREF(Py_None);
266 return Py_None;
267}
268
269PyDoc_STRVAR(getfilesystemencoding_doc,
270"getfilesystemencoding() -> string\n\
271\n\
272Return the encoding used to convert Unicode filenames in\n\
273operating system filenames."
274);
275
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000276#endif
277
Fred Drake5755ce62001-06-27 19:19:46 +0000278/*
279 * Cached interned string objects used for calling the profile and
280 * trace functions. Initialized by trace_init().
281 */
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000282static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL};
Fred Drake5755ce62001-06-27 19:19:46 +0000283
284static int
285trace_init(void)
286{
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000287 static char *whatnames[7] = {"call", "exception", "line", "return",
288 "c_call", "c_exception", "c_return"};
Fred Drake5755ce62001-06-27 19:19:46 +0000289 PyObject *name;
290 int i;
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000291 for (i = 0; i < 7; ++i) {
Fred Drake5755ce62001-06-27 19:19:46 +0000292 if (whatstrings[i] == NULL) {
293 name = PyString_InternFromString(whatnames[i]);
294 if (name == NULL)
295 return -1;
296 whatstrings[i] = name;
297 }
298 }
299 return 0;
300}
301
302
303static PyObject *
304call_trampoline(PyThreadState *tstate, PyObject* callback,
305 PyFrameObject *frame, int what, PyObject *arg)
306{
307 PyObject *args = PyTuple_New(3);
308 PyObject *whatstr;
309 PyObject *result;
310
311 if (args == NULL)
312 return NULL;
313 Py_INCREF(frame);
314 whatstr = whatstrings[what];
315 Py_INCREF(whatstr);
316 if (arg == NULL)
317 arg = Py_None;
318 Py_INCREF(arg);
319 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
320 PyTuple_SET_ITEM(args, 1, whatstr);
321 PyTuple_SET_ITEM(args, 2, arg);
322
323 /* call the Python-level function */
324 PyFrame_FastToLocals(frame);
325 result = PyEval_CallObject(callback, args);
326 PyFrame_LocalsToFast(frame, 1);
327 if (result == NULL)
328 PyTraceBack_Here(frame);
329
330 /* cleanup */
331 Py_DECREF(args);
332 return result;
333}
334
335static int
336profile_trampoline(PyObject *self, PyFrameObject *frame,
337 int what, PyObject *arg)
338{
339 PyThreadState *tstate = frame->f_tstate;
340 PyObject *result;
341
Fred Drake8f51f542001-10-04 14:48:42 +0000342 if (arg == NULL)
343 arg = Py_None;
Fred Drake5755ce62001-06-27 19:19:46 +0000344 result = call_trampoline(tstate, self, frame, what, arg);
345 if (result == NULL) {
346 PyEval_SetProfile(NULL, NULL);
347 return -1;
348 }
349 Py_DECREF(result);
350 return 0;
351}
352
353static int
354trace_trampoline(PyObject *self, PyFrameObject *frame,
355 int what, PyObject *arg)
356{
357 PyThreadState *tstate = frame->f_tstate;
358 PyObject *callback;
359 PyObject *result;
360
361 if (what == PyTrace_CALL)
362 callback = self;
363 else
364 callback = frame->f_trace;
365 if (callback == NULL)
366 return 0;
367 result = call_trampoline(tstate, callback, frame, what, arg);
368 if (result == NULL) {
369 PyEval_SetTrace(NULL, NULL);
370 Py_XDECREF(frame->f_trace);
371 frame->f_trace = NULL;
372 return -1;
373 }
374 if (result != Py_None) {
375 PyObject *temp = frame->f_trace;
376 frame->f_trace = NULL;
377 Py_XDECREF(temp);
378 frame->f_trace = result;
379 }
380 else {
381 Py_DECREF(result);
382 }
383 return 0;
384}
Fred Draked0838392001-06-16 21:02:31 +0000385
Fred Drake8b4d01d2000-05-09 19:57:01 +0000386static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000387sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000388{
Fred Drake5755ce62001-06-27 19:19:46 +0000389 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000390 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000391 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000392 PyEval_SetTrace(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000393 else
Fred Drake5755ce62001-06-27 19:19:46 +0000394 PyEval_SetTrace(trace_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000395 Py_INCREF(Py_None);
396 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000397}
398
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000399PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000400"settrace(function)\n\
401\n\
402Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000403function call. See the debugger chapter in the library manual."
404);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000405
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000406static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000407sys_gettrace(PyObject *self, PyObject *args)
408{
409 PyThreadState *tstate = PyThreadState_GET();
410 PyObject *temp = tstate->c_traceobj;
411
412 if (temp == NULL)
413 temp = Py_None;
414 Py_INCREF(temp);
415 return temp;
416}
417
418PyDoc_STRVAR(gettrace_doc,
419"gettrace()\n\
420\n\
421Return the global debug tracing function set with sys.settrace.\n\
422See the debugger chapter in the library manual."
423);
424
425static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000426sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000427{
Fred Drake5755ce62001-06-27 19:19:46 +0000428 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000429 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000430 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000431 PyEval_SetProfile(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000432 else
Fred Drake5755ce62001-06-27 19:19:46 +0000433 PyEval_SetProfile(profile_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000434 Py_INCREF(Py_None);
435 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000436}
437
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000438PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000439"setprofile(function)\n\
440\n\
441Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000442and return. See the profiler chapter in the library manual."
443);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000444
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000445static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000446sys_getprofile(PyObject *self, PyObject *args)
447{
448 PyThreadState *tstate = PyThreadState_GET();
449 PyObject *temp = tstate->c_profileobj;
450
451 if (temp == NULL)
452 temp = Py_None;
453 Py_INCREF(temp);
454 return temp;
455}
456
457PyDoc_STRVAR(getprofile_doc,
458"getprofile()\n\
459\n\
460Return the profiling function set with sys.setprofile.\n\
461See the profiler chapter in the library manual."
462);
463
464static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000465sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000466{
Skip Montanarod581d772002-09-03 20:10:45 +0000467 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000468 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000469 Py_INCREF(Py_None);
470 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000471}
472
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000473PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000474"setcheckinterval(n)\n\
475\n\
476Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000477n instructions. This also affects how often thread switches occur."
478);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000479
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000480static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000481sys_getcheckinterval(PyObject *self, PyObject *args)
482{
483 return PyInt_FromLong(_Py_CheckInterval);
484}
485
486PyDoc_STRVAR(getcheckinterval_doc,
487"getcheckinterval() -> current check interval; see setcheckinterval()."
488);
489
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000490#ifdef WITH_TSC
491static PyObject *
492sys_settscdump(PyObject *self, PyObject *args)
493{
494 int bool;
495 PyThreadState *tstate = PyThreadState_Get();
496
497 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
498 return NULL;
499 if (bool)
500 tstate->interp->tscdump = 1;
501 else
502 tstate->interp->tscdump = 0;
503 Py_INCREF(Py_None);
504 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000505
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000506}
507
Tim Peters216b78b2006-01-06 02:40:53 +0000508PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000509"settscdump(bool)\n\
510\n\
511If true, tell the Python interpreter to dump VM measurements to\n\
512stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000513processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000514);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000515#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000516
Tim Peterse5e065b2003-07-06 18:36:54 +0000517static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000518sys_setrecursionlimit(PyObject *self, PyObject *args)
519{
520 int new_limit;
521 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
522 return NULL;
523 if (new_limit <= 0) {
Tim Peters216b78b2006-01-06 02:40:53 +0000524 PyErr_SetString(PyExc_ValueError,
525 "recursion limit must be positive");
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000526 return NULL;
527 }
528 Py_SetRecursionLimit(new_limit);
529 Py_INCREF(Py_None);
530 return Py_None;
531}
532
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000533PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000534"setrecursionlimit(n)\n\
535\n\
536Set the maximum depth of the Python interpreter stack to n. This\n\
537limit prevents infinite recursion from causing an overflow of the C\n\
538stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000539dependent."
540);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000541
542static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000543sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000544{
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000545 return PyInt_FromLong(Py_GetRecursionLimit());
546}
547
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000548PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000549"getrecursionlimit()\n\
550\n\
551Return the current value of the recursion limit, the maximum depth\n\
552of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000553recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000554);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000555
Mark Hammond8696ebc2002-10-08 02:44:31 +0000556#ifdef MS_WINDOWS
557PyDoc_STRVAR(getwindowsversion_doc,
558"getwindowsversion()\n\
559\n\
560Return information about the running version of Windows.\n\
561The result is a tuple of (major, minor, build, platform, text)\n\
562All elements are numbers, except text which is a string.\n\
563Platform may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP\n\
564"
565);
566
567static PyObject *
568sys_getwindowsversion(PyObject *self)
569{
570 OSVERSIONINFO ver;
571 ver.dwOSVersionInfoSize = sizeof(ver);
572 if (!GetVersionEx(&ver))
573 return PyErr_SetFromWindowsErr(0);
574 return Py_BuildValue("HHHHs",
575 ver.dwMajorVersion,
576 ver.dwMinorVersion,
577 ver.dwBuildNumber,
578 ver.dwPlatformId,
579 ver.szCSDVersion);
580}
581
582#endif /* MS_WINDOWS */
583
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000584#ifdef HAVE_DLOPEN
585static PyObject *
586sys_setdlopenflags(PyObject *self, PyObject *args)
587{
588 int new_val;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000589 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000590 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
591 return NULL;
592 if (!tstate)
593 return NULL;
594 tstate->interp->dlopenflags = new_val;
595 Py_INCREF(Py_None);
596 return Py_None;
597}
598
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000599PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000600"setdlopenflags(n) -> None\n\
601\n\
602Set the flags that will be used for dlopen() calls. Among other\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000603things, this will enable a lazy resolving of symbols when importing\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000604a module, if called as sys.setdlopenflags(0)\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000605To share symbols across extension modules, call as\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000606sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)"
607);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000608
609static PyObject *
610sys_getdlopenflags(PyObject *self, PyObject *args)
611{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000612 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000613 if (!tstate)
614 return NULL;
615 return PyInt_FromLong(tstate->interp->dlopenflags);
616}
617
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000618PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000619"getdlopenflags() -> int\n\
620\n\
621Return the current value of the flags that are used for dlopen()\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000622calls. The flag constants are defined in the dl module."
623);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000624#endif
625
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000626#ifdef USE_MALLOPT
627/* Link with -lmalloc (or -lmpc) on an SGI */
628#include <malloc.h>
629
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000630static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000631sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000632{
633 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000634 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000635 return NULL;
636 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000637 Py_INCREF(Py_None);
638 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000639}
640#endif /* USE_MALLOPT */
641
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000642static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000643sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000644{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000645 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000646}
647
Tim Peters4be93d02002-07-07 19:59:50 +0000648#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000649static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000650sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000651{
Armin Rigoe1709372006-04-12 17:06:05 +0000652 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000653}
Armin Rigoe1709372006-04-12 17:06:05 +0000654#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000655
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000656PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000657"getrefcount(object) -> integer\n\
658\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000659Return the reference count of object. The count returned is generally\n\
660one higher than you might expect, because it includes the (temporary)\n\
661reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000662);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000663
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000664#ifdef COUNT_ALLOCS
665static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000666sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000667{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000668 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000669
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000670 return get_counts();
671}
672#endif
673
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000674PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000675"_getframe([depth]) -> frameobject\n\
676\n\
677Return a frame object from the call stack. If optional integer depth is\n\
678given, return the frame object that many calls below the top of the stack.\n\
679If that is deeper than the call stack, ValueError is raised. The default\n\
680for depth is zero, returning the frame at the top of the call stack.\n\
681\n\
682This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000683purposes only."
684);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000685
686static PyObject *
687sys_getframe(PyObject *self, PyObject *args)
688{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000689 PyFrameObject *f = PyThreadState_GET()->frame;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000690 int depth = -1;
691
692 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
693 return NULL;
694
695 while (depth > 0 && f != NULL) {
696 f = f->f_back;
697 --depth;
698 }
699 if (f == NULL) {
700 PyErr_SetString(PyExc_ValueError,
701 "call stack is not deep enough");
702 return NULL;
703 }
704 Py_INCREF(f);
705 return (PyObject*)f;
706}
707
Tim Peters32a83612006-07-10 21:08:24 +0000708PyDoc_STRVAR(current_frames_doc,
709"_current_frames() -> dictionary\n\
710\n\
711Return a dictionary mapping each current thread T's thread id to T's\n\
712current stack frame.\n\
713\n\
714This function should be used for specialized purposes only."
715);
716
717static PyObject *
718sys_current_frames(PyObject *self, PyObject *noargs)
719{
720 return _PyThread_CurrentFrames();
721}
722
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000723PyDoc_STRVAR(call_tracing_doc,
724"call_tracing(func, args) -> object\n\
725\n\
726Call func(*args), while tracing is enabled. The tracing state is\n\
727saved, and restored afterwards. This is intended to be called from\n\
728a debugger from a checkpoint, to recursively debug some other code."
729);
730
731static PyObject *
732sys_call_tracing(PyObject *self, PyObject *args)
733{
734 PyObject *func, *funcargs;
Georg Brandl96a8c392006-05-29 21:04:52 +0000735 if (!PyArg_UnpackTuple(args, "call_tracing", 2, 2, &func, &funcargs))
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000736 return NULL;
737 return _PyEval_CallTracing(func, funcargs);
738}
739
Jeremy Hylton985eba52003-02-05 23:13:00 +0000740PyDoc_STRVAR(callstats_doc,
741"callstats() -> tuple of integers\n\
742\n\
743Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
744when Python was built. Otherwise, return None.\n\
745\n\
746When enabled, this function returns detailed, implementation-specific\n\
747details about the number of function calls executed. The return value is\n\
748a 11-tuple where the entries in the tuple are counts of:\n\
7490. all function calls\n\
7501. calls to PyFunction_Type objects\n\
7512. PyFunction calls that do not create an argument tuple\n\
7523. PyFunction calls that do not create an argument tuple\n\
753 and bypass PyEval_EvalCodeEx()\n\
7544. PyMethod calls\n\
7555. PyMethod calls on bound methods\n\
7566. PyType calls\n\
7577. PyCFunction calls\n\
7588. generator calls\n\
7599. All other calls\n\
76010. Number of stack pops performed by call_function()"
761);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000762
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000763#ifdef __cplusplus
764extern "C" {
765#endif
766
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000767#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000768/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000769extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000770#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000771
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000772#ifdef DYNAMIC_EXECUTION_PROFILE
773/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000774extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000775#endif
776
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000777#ifdef __cplusplus
778}
779#endif
780
Christian Heimes422051a2008-02-04 18:00:12 +0000781static PyObject *
782sys_clear_type_cache(PyObject* self, PyObject* args)
783{
784 PyType_ClearCache();
785 Py_RETURN_NONE;
786}
787
788PyDoc_STRVAR(sys_clear_type_cache__doc__,
789"_clear_type_cache() -> None\n\
790Clear the internal type lookup cache.");
791
792
793static PyObject *
794sys_compact_freelists(PyObject* self, PyObject* args)
795{
796 size_t isum, ibc, ibf;
797 size_t fsum, fbc, fbf;
798
799 PyInt_CompactFreeList(&ibc, &ibf, &isum);
800 PyFloat_CompactFreeList(&fbc, &fbf, &fsum);
801
802 return Py_BuildValue("(kkk)(kkk)", isum, ibc, ibf,
803 fsum, fbc, fbf);
804
805}
806
807PyDoc_STRVAR(sys_compact_freelists__doc__,
808"_compact_freelists() -> ((remaing_objects, total_blocks, freed_blocks), ...)\n\
809Compact the free lists of ints and floats.");
810
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000811static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000812 /* Might as well keep this in alphabetic order */
Tim Peters216b78b2006-01-06 02:40:53 +0000813 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
Jeremy Hylton985eba52003-02-05 23:13:00 +0000814 callstats_doc},
Christian Heimes422051a2008-02-04 18:00:12 +0000815 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
816 sys_clear_type_cache__doc__},
817 {"_compact_freelists", sys_compact_freelists, METH_NOARGS,
818 sys_compact_freelists__doc__},
Tim Peters32a83612006-07-10 21:08:24 +0000819 {"_current_frames", sys_current_frames, METH_NOARGS,
820 current_frames_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000821 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000822 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
823 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000824 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
Neal Norwitz0c766a02002-03-27 13:03:09 +0000825 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000826#ifdef Py_USING_UNICODE
Tim Peters216b78b2006-01-06 02:40:53 +0000827 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
828 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000829#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000830#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000831 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000832 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000833#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000834#ifdef COUNT_ALLOCS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000835 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000836#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000837#ifdef DYNAMIC_EXECUTION_PROFILE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000838 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000839#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000840#ifdef Py_USING_UNICODE
841 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
Tim Peters216b78b2006-01-06 02:40:53 +0000842 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000843#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000844#ifdef Py_TRACE_REFS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000845 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000846#endif
847#ifdef Py_REF_DEBUG
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000848 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000849#endif
Fred Drakea7688822001-10-24 20:47:48 +0000850 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000851 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000852 getrecursionlimit_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000853 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000854#ifdef MS_WINDOWS
855 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
856 getwindowsversion_doc},
857#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000858#ifdef USE_MALLOPT
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000859 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000860#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000861#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000862 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000863 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000864#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000865 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000866 setcheckinterval_doc},
Tim Peterse5e065b2003-07-06 18:36:54 +0000867 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000868 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000869#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000870 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000871 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000872#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000873 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
Georg Brandl56112892008-01-20 13:59:46 +0000874 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000875 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000876 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000877#ifdef WITH_TSC
878 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
879#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000880 {"settrace", sys_settrace, METH_O, settrace_doc},
Georg Brandl56112892008-01-20 13:59:46 +0000881 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000882 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000883 {NULL, NULL} /* sentinel */
884};
885
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000886static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000887list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000888{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000889 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000890 int i;
891 if (list == NULL)
892 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000893 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Guido van Rossuma027efa1997-05-05 20:56:21 +0000894 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000895 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000896 if (name == NULL)
897 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000898 PyList_Append(list, name);
899 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000900 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000901 if (PyList_Sort(list) != 0) {
902 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000903 list = NULL;
904 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000905 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000906 PyObject *v = PyList_AsTuple(list);
907 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000908 list = v;
909 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000910 return list;
911}
912
Guido van Rossum23fff912000-12-15 22:02:05 +0000913static PyObject *warnoptions = NULL;
914
915void
916PySys_ResetWarnOptions(void)
917{
918 if (warnoptions == NULL || !PyList_Check(warnoptions))
919 return;
920 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
921}
922
923void
924PySys_AddWarnOption(char *s)
925{
926 PyObject *str;
927
928 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
929 Py_XDECREF(warnoptions);
930 warnoptions = PyList_New(0);
931 if (warnoptions == NULL)
932 return;
933 }
934 str = PyString_FromString(s);
935 if (str != NULL) {
936 PyList_Append(warnoptions, str);
937 Py_DECREF(str);
938 }
939}
940
Brett Cannone9746892008-04-12 23:44:07 +0000941int
942PySys_HasWarnOptions(void)
943{
Brett Cannon40f0a872008-04-13 00:18:44 +0000944 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
Brett Cannone9746892008-04-12 23:44:07 +0000945}
946
Guido van Rossum40552d01998-08-06 03:34:39 +0000947/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
948 Two literals concatenated works just fine. If you have a K&R compiler
949 or other abomination that however *does* understand longer strings,
950 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000951PyDoc_VAR(sys_doc) =
952PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000953"This module provides access to some objects used or maintained by the\n\
954interpreter and to functions that interact strongly with the interpreter.\n\
955\n\
956Dynamic objects:\n\
957\n\
958argv -- command line arguments; argv[0] is the script pathname if known\n\
959path -- module search path; path[0] is the script directory, else ''\n\
960modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000961\n\
962displayhook -- called to show results in an interactive session\n\
963excepthook -- called to handle any uncaught exception other than SystemExit\n\
964 To customize printing in an interactive session or to install a custom\n\
965 top-level exception handler, assign other functions to replace these.\n\
966\n\
967exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
968 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000969\n\
970stdin -- standard input file object; used by raw_input() and input()\n\
971stdout -- standard output file object; used by the print statement\n\
972stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000973 By assigning other file objects (or objects that behave like files)\n\
974 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000975\n\
976last_type -- type of last uncaught exception\n\
977last_value -- value of last uncaught exception\n\
978last_traceback -- traceback of last uncaught exception\n\
979 These three are only available in an interactive session after a\n\
980 traceback has been printed.\n\
981\n\
982exc_type -- type of exception currently being handled\n\
983exc_value -- value of exception currently being handled\n\
984exc_traceback -- traceback of exception currently being handled\n\
985 The function exc_info() should be used instead of these three,\n\
986 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000987"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000988)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000989/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000990PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000991"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000992Static objects:\n\
993\n\
994maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +0000995maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000996builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +0000997version -- the version of this interpreter as a string\n\
998version_info -- version information as a tuple\n\
999hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001000copyright -- copyright notice pertaining to this interpreter\n\
1001platform -- platform identifier\n\
1002executable -- pathname of this Python interpreter\n\
1003prefix -- prefix used to find the Python library\n\
1004exec_prefix -- prefix used to find the machine-specific Python library\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001005"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001006)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001007#ifdef MS_WINDOWS
1008/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001009PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001010"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001011winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001012"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001013)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001014#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001015PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001016"__stdin__ -- the original stdin; don't touch!\n\
1017__stdout__ -- the original stdout; don't touch!\n\
1018__stderr__ -- the original stderr; don't touch!\n\
1019__displayhook__ -- the original displayhook; don't touch!\n\
1020__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001021\n\
1022Functions:\n\
1023\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +00001024displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001025excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001026exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +00001027exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001028exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001029getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Georg Brandl56112892008-01-20 13:59:46 +00001030getprofile() -- get the global profiling function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001031getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001032getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Georg Brandl56112892008-01-20 13:59:46 +00001033gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001034setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001035setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001036setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001037setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001038settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001039"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001040)
Fred Drakeccede592000-08-14 20:59:57 +00001041/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001042
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001043static int
1044_check_and_flush (FILE *stream)
1045{
1046 int prev_fail = ferror (stream);
1047 return fflush (stream) || prev_fail ? EOF : 0;
1048}
1049
Martin v. Löwis43b57802006-01-05 23:38:54 +00001050/* Subversion branch and revision management */
1051static const char _patchlevel_revision[] = PY_PATCHLEVEL_REVISION;
1052static const char headurl[] = "$HeadURL$";
1053static int svn_initialized;
1054static char patchlevel_revision[50]; /* Just the number */
1055static char branch[50];
1056static char shortbranch[50];
1057static const char *svn_revision;
1058
Tim Peterse86e7a52006-01-06 02:42:46 +00001059static void
1060svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001061{
1062 const char *python, *br_start, *br_end, *br_end2, *svnversion;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001063 Py_ssize_t len;
1064 int istag;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001065
1066 if (svn_initialized)
1067 return;
1068
1069 python = strstr(headurl, "/python/");
Christian Heimes6a453c32008-03-24 19:57:42 +00001070 if (!python) {
1071 /* XXX quick hack to get bzr working */
1072 *patchlevel_revision = '\0';
1073 strcpy(branch, "");
1074 strcpy(shortbranch, "unknown");
1075 svn_revision = "";
Christian Heimesa113bd92008-03-24 19:58:17 +00001076 return;
1077 /* Py_FatalError("subversion keywords missing"); */
Christian Heimes6a453c32008-03-24 19:57:42 +00001078 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001079
1080 br_start = python + 8;
1081 br_end = strchr(br_start, '/');
Neal Norwitz837ce932006-10-28 21:15:30 +00001082 assert(br_end);
1083
Tim Peters216b78b2006-01-06 02:40:53 +00001084 /* Works even for trunk,
Martin v. Löwis43b57802006-01-05 23:38:54 +00001085 as we are in trunk/Python/sysmodule.c */
1086 br_end2 = strchr(br_end+1, '/');
1087
1088 istag = strncmp(br_start, "tags", 4) == 0;
1089 if (strncmp(br_start, "trunk", 5) == 0) {
1090 strcpy(branch, "trunk");
1091 strcpy(shortbranch, "trunk");
1092
Tim Peters216b78b2006-01-06 02:40:53 +00001093 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001094 else if (istag || strncmp(br_start, "branches", 8) == 0) {
1095 len = br_end2 - br_start;
1096 strncpy(branch, br_start, len);
1097 branch[len] = '\0';
1098
1099 len = br_end2 - (br_end + 1);
1100 strncpy(shortbranch, br_end + 1, len);
1101 shortbranch[len] = '\0';
Tim Peters216b78b2006-01-06 02:40:53 +00001102 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001103 else {
1104 Py_FatalError("bad HeadURL");
1105 return;
1106 }
1107
1108
1109 svnversion = _Py_svnversion();
1110 if (strcmp(svnversion, "exported") != 0)
1111 svn_revision = svnversion;
1112 else if (istag) {
1113 len = strlen(_patchlevel_revision);
Neal Norwitz68cdf8a2007-04-16 07:37:55 +00001114 assert(len >= 13);
1115 assert(len < (sizeof(patchlevel_revision) + 13));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001116 strncpy(patchlevel_revision, _patchlevel_revision + 11,
1117 len - 13);
1118 patchlevel_revision[len - 13] = '\0';
1119 svn_revision = patchlevel_revision;
1120 }
1121 else
1122 svn_revision = "";
Tim Peters216b78b2006-01-06 02:40:53 +00001123
Martin v. Löwis43b57802006-01-05 23:38:54 +00001124 svn_initialized = 1;
1125}
1126
1127/* Return svnversion output if available.
1128 Else return Revision of patchlevel.h if on branch.
1129 Else return empty string */
1130const char*
1131Py_SubversionRevision()
1132{
1133 svnversion_init();
1134 return svn_revision;
1135}
1136
1137const char*
1138Py_SubversionShortBranch()
1139{
1140 svnversion_init();
1141 return shortbranch;
1142}
1143
Christian Heimesf31b69f2008-01-14 03:42:48 +00001144
1145PyDoc_STRVAR(flags__doc__,
1146"sys.flags\n\
1147\n\
1148Flags provided through command line arguments or environment vars.");
1149
Christian Heimes796fc312008-01-30 18:58:29 +00001150static PyTypeObject FlagsType = {0, 0, 0, 0, 0, 0};
Christian Heimesf31b69f2008-01-14 03:42:48 +00001151
1152static PyStructSequence_Field flags_fields[] = {
1153 {"debug", "-d"},
1154 {"py3k_warning", "-3"},
1155 {"division_warning", "-Q"},
1156 {"division_new", "-Qnew"},
1157 {"inspect", "-i"},
1158 {"interactive", "-i"},
1159 {"optimize", "-O or -OO"},
1160 {"dont_write_bytecode", "-B"},
1161 /* {"no_user_site", "-s"}, */
1162 {"no_site", "-S"},
Andrew M. Kuchling7ce9b182008-01-15 01:29:16 +00001163 {"ignore_environment", "-E"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001164 {"tabcheck", "-t or -tt"},
1165 {"verbose", "-v"},
1166#ifdef RISCOS
Andrew M. Kuchling7ce9b182008-01-15 01:29:16 +00001167 {"riscos_wimp", "???"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001168#endif
1169 /* {"unbuffered", "-u"}, */
1170 {"unicode", "-U"},
1171 /* {"skip_first", "-x"}, */
Brett Cannone9746892008-04-12 23:44:07 +00001172 {"bytes_warning", "-b"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001173 {0}
1174};
1175
1176static PyStructSequence_Desc flags_desc = {
1177 "sys.flags", /* name */
1178 flags__doc__, /* doc */
1179 flags_fields, /* fields */
1180#ifdef RISCOS
1181 14
1182#else
1183 13
1184#endif
1185};
1186
1187static PyObject*
1188make_flags(void)
1189{
1190 int pos = 0;
1191 PyObject *seq;
1192
1193 seq = PyStructSequence_New(&FlagsType);
1194 if (seq == NULL)
1195 return NULL;
1196
1197#define SetFlag(flag) \
1198 PyStructSequence_SET_ITEM(seq, pos++, PyInt_FromLong(flag))
1199
1200 SetFlag(Py_DebugFlag);
1201 SetFlag(Py_Py3kWarningFlag);
1202 SetFlag(Py_DivisionWarningFlag);
1203 SetFlag(_Py_QnewFlag);
1204 SetFlag(Py_InspectFlag);
1205 SetFlag(Py_InteractiveFlag);
1206 SetFlag(Py_OptimizeFlag);
1207 SetFlag(Py_DontWriteBytecodeFlag);
1208 /* SetFlag(Py_NoUserSiteDirectory); */
1209 SetFlag(Py_NoSiteFlag);
1210 SetFlag(Py_IgnoreEnvironmentFlag);
1211 SetFlag(Py_TabcheckFlag);
1212 SetFlag(Py_VerboseFlag);
1213#ifdef RISCOS
1214 SetFlag(Py_RISCOSWimpFlag);
1215#endif
1216 /* SetFlag(saw_unbuffered_flag); */
1217 SetFlag(Py_UnicodeFlag);
1218 /* SetFlag(skipfirstline); */
Brett Cannone9746892008-04-12 23:44:07 +00001219 SetFlag(Py_BytesWarningFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001220#undef SetFlag
1221
1222 if (PyErr_Occurred()) {
1223 return NULL;
1224 }
Christian Heimesf31b69f2008-01-14 03:42:48 +00001225 return seq;
1226}
1227
Guido van Rossum25ce5661997-08-02 03:10:38 +00001228PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001229_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001230{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001231 PyObject *m, *v, *sysdict;
1232 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +00001233 char *s;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001234#ifdef MS_WINDOWS
Tim Peters02f1d0d2006-06-06 00:25:07 +00001235 char buf[128];
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001236#endif
Guido van Rossum25ce5661997-08-02 03:10:38 +00001237
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001238 m = Py_InitModule3("sys", sys_methods, sys_doc);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00001239 if (m == NULL)
1240 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001241 sysdict = PyModule_GetDict(m);
Christian Heimes0d924432008-01-30 17:21:22 +00001242#define SET_SYS_FROM_STRING(key, value) \
1243 v = value; \
1244 if (v != NULL) \
1245 PyDict_SetItemString(sysdict, key, v); \
1246 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001247
Neal Norwitz11bd1192005-10-03 00:54:56 +00001248 {
1249 /* XXX: does this work on Win/Win64? (see posix_fstat) */
1250 struct stat sb;
1251 if (fstat(fileno(stdin), &sb) == 0 &&
1252 S_ISDIR(sb.st_mode)) {
Neal Norwitz72c2c062006-03-09 05:58:11 +00001253 /* There's nothing more we can do. */
1254 /* Py_FatalError() will core dump, so just exit. */
1255 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1256 exit(EXIT_FAILURE);
Neal Norwitz11bd1192005-10-03 00:54:56 +00001257 }
1258 }
1259
Martin v. Löwis13a1fde2005-01-27 18:56:16 +00001260 /* Closing the standard FILE* if sys.std* goes aways causes problems
1261 * for embedded Python usages. Closing them when somebody explicitly
1262 * invokes .close() might be possible, but the FAQ promises they get
1263 * never closed. However, we still need to get write errors when
1264 * writing fails (e.g. because stdout is redirected), so we flush the
1265 * streams and check for errors before the file objects are deleted.
1266 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1267 * from that procedure.
1268 */
1269 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001270 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1271 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001272 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001273 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001274#ifdef MS_WINDOWS
Thomas Woutersafea5292007-01-23 13:42:00 +00001275 if(isatty(_fileno(stdin)) && PyFile_Check(sysin)) {
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001276 sprintf(buf, "cp%d", GetConsoleCP());
1277 if (!PyFile_SetEncoding(sysin, buf))
1278 return NULL;
1279 }
Thomas Woutersafea5292007-01-23 13:42:00 +00001280 if(isatty(_fileno(stdout)) && PyFile_Check(sysout)) {
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001281 sprintf(buf, "cp%d", GetConsoleOutputCP());
1282 if (!PyFile_SetEncoding(sysout, buf))
1283 return NULL;
1284 }
Thomas Woutersafea5292007-01-23 13:42:00 +00001285 if(isatty(_fileno(stderr)) && PyFile_Check(syserr)) {
Martin v. Löwisea62d252006-04-03 10:56:49 +00001286 sprintf(buf, "cp%d", GetConsoleOutputCP());
1287 if (!PyFile_SetEncoding(syserr, buf))
1288 return NULL;
1289 }
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001290#endif
1291
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001292 PyDict_SetItemString(sysdict, "stdin", sysin);
1293 PyDict_SetItemString(sysdict, "stdout", sysout);
1294 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +00001295 /* Make backup copies for cleanup */
1296 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1297 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1298 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001299 PyDict_SetItemString(sysdict, "__displayhook__",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001300 PyDict_GetItemString(sysdict, "displayhook"));
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001301 PyDict_SetItemString(sysdict, "__excepthook__",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001302 PyDict_GetItemString(sysdict, "excepthook"));
Guido van Rossum25ce5661997-08-02 03:10:38 +00001303 Py_XDECREF(sysin);
1304 Py_XDECREF(sysout);
1305 Py_XDECREF(syserr);
Christian Heimes0d924432008-01-30 17:21:22 +00001306
1307 SET_SYS_FROM_STRING("version",
1308 PyString_FromString(Py_GetVersion()));
1309 SET_SYS_FROM_STRING("hexversion",
1310 PyInt_FromLong(PY_VERSION_HEX));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001311 svnversion_init();
Christian Heimes0d924432008-01-30 17:21:22 +00001312 SET_SYS_FROM_STRING("subversion",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001313 Py_BuildValue("(ssz)", "CPython", branch,
Christian Heimes0d924432008-01-30 17:21:22 +00001314 svn_revision));
1315 SET_SYS_FROM_STRING("dont_write_bytecode",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001316 PyBool_FromLong(Py_DontWriteBytecodeFlag));
Fred Drake93a20bf2000-04-13 17:44:51 +00001317 /*
1318 * These release level checks are mutually exclusive and cover
1319 * the field, so don't get too fancy with the pre-processor!
1320 */
1321#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001322 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +00001323#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001324 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +00001325#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001326 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +00001327#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +00001328 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +00001329#endif
Neal Norwitze1fdb322006-07-21 05:32:28 +00001330
Neal Norwitze1fdb322006-07-21 05:32:28 +00001331 SET_SYS_FROM_STRING("version_info",
1332 Py_BuildValue("iiisi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +00001333 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +00001334 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +00001335 PY_RELEASE_SERIAL));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001336 SET_SYS_FROM_STRING("api_version",
1337 PyInt_FromLong(PYTHON_API_VERSION));
1338 SET_SYS_FROM_STRING("copyright",
1339 PyString_FromString(Py_GetCopyright()));
1340 SET_SYS_FROM_STRING("platform",
1341 PyString_FromString(Py_GetPlatform()));
1342 SET_SYS_FROM_STRING("executable",
1343 PyString_FromString(Py_GetProgramFullPath()));
1344 SET_SYS_FROM_STRING("prefix",
1345 PyString_FromString(Py_GetPrefix()));
1346 SET_SYS_FROM_STRING("exec_prefix",
1347 PyString_FromString(Py_GetExecPrefix()));
1348 SET_SYS_FROM_STRING("maxint",
1349 PyInt_FromLong(PyInt_GetMax()));
Christian Heimes28104c52007-11-27 23:16:44 +00001350 SET_SYS_FROM_STRING("py3kwarning",
1351 PyBool_FromLong(Py_Py3kWarningFlag));
Christian Heimesdfdfaab2007-12-01 11:20:10 +00001352 SET_SYS_FROM_STRING("float_info",
1353 PyFloat_GetInfo());
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001354#ifdef Py_USING_UNICODE
Neal Norwitze1fdb322006-07-21 05:32:28 +00001355 SET_SYS_FROM_STRING("maxunicode",
1356 PyInt_FromLong(PyUnicode_GetMax()));
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001357#endif
Neal Norwitze1fdb322006-07-21 05:32:28 +00001358 SET_SYS_FROM_STRING("builtin_module_names",
1359 list_builtin_module_names());
Fred Drake099325e2000-08-14 15:47:03 +00001360 {
1361 /* Assumes that longs are at least 2 bytes long.
1362 Should be safe! */
1363 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +00001364 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001365
1366 s = (char *) &number;
1367 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +00001368 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +00001369 else
Fred Drakea2b6ad62000-08-15 04:24:43 +00001370 value = "little";
Neal Norwitze1fdb322006-07-21 05:32:28 +00001371 SET_SYS_FROM_STRING("byteorder",
1372 PyString_FromString(value));
Fred Drake099325e2000-08-14 15:47:03 +00001373 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001374#ifdef MS_COREDLL
Neal Norwitze1fdb322006-07-21 05:32:28 +00001375 SET_SYS_FROM_STRING("dllhandle",
1376 PyLong_FromVoidPtr(PyWin_DLLhModule));
1377 SET_SYS_FROM_STRING("winver",
1378 PyString_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001379#endif
Guido van Rossum23fff912000-12-15 22:02:05 +00001380 if (warnoptions == NULL) {
1381 warnoptions = PyList_New(0);
1382 }
1383 else {
1384 Py_INCREF(warnoptions);
1385 }
1386 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +00001387 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +00001388 }
Tim Peters216b78b2006-01-06 02:40:53 +00001389
Christian Heimes796fc312008-01-30 18:58:29 +00001390 if (FlagsType.tp_name == 0)
1391 PyStructSequence_InitType(&FlagsType, &flags_desc);
Christian Heimes0d924432008-01-30 17:21:22 +00001392 SET_SYS_FROM_STRING("flags", make_flags());
Christian Heimesf31b69f2008-01-14 03:42:48 +00001393 /* prevent user from creating new instances */
1394 FlagsType.tp_init = NULL;
1395 FlagsType.tp_new = NULL;
1396
Christian Heimes0d924432008-01-30 17:21:22 +00001397#undef SET_SYS_FROM_STRING
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001398 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001399 return NULL;
1400 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001401}
1402
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001403static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001404makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001405{
Guido van Rossum3f5da241990-12-20 15:06:42 +00001406 int i, n;
1407 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001408 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001409
Guido van Rossum3f5da241990-12-20 15:06:42 +00001410 n = 1;
1411 p = path;
1412 while ((p = strchr(p, delim)) != NULL) {
1413 n++;
1414 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001415 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001416 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001417 if (v == NULL)
1418 return NULL;
1419 for (i = 0; ; i++) {
1420 p = strchr(path, delim);
1421 if (p == NULL)
1422 p = strchr(path, '\0'); /* End of string */
Armin Rigo7ccbca92006-10-04 12:17:45 +00001423 w = PyString_FromStringAndSize(path, (Py_ssize_t) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +00001424 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001425 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001426 return NULL;
1427 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001428 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001429 if (*p == '\0')
1430 break;
1431 path = p+1;
1432 }
1433 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001434}
1435
1436void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001437PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001438{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001439 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001440 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001441 Py_FatalError("can't create sys.path");
1442 if (PySys_SetObject("path", v) != 0)
1443 Py_FatalError("can't assign sys.path");
1444 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001445}
1446
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001447static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001448makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001449{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001450 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +00001451 if (argc <= 0 || argv == NULL) {
1452 /* Ensure at least one (empty) argument is seen */
1453 static char *empty_argv[1] = {""};
1454 argv = empty_argv;
1455 argc = 1;
1456 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001457 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001458 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001459 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001460 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001461#ifdef __VMS
1462 PyObject *v;
1463
1464 /* argv[0] is the script pathname if known */
1465 if (i == 0) {
1466 char* fn = decc$translate_vms(argv[0]);
1467 if ((fn == (char *)0) || fn == (char *)-1)
1468 v = PyString_FromString(argv[0]);
1469 else
1470 v = PyString_FromString(
1471 decc$translate_vms(argv[0]));
1472 } else
1473 v = PyString_FromString(argv[i]);
1474#else
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001475 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001476#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001477 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001478 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001479 av = NULL;
1480 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001481 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001482 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001483 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001484 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001485 return av;
1486}
1487
1488void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001489PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001490{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001491#if defined(HAVE_REALPATH)
1492 char fullpath[MAXPATHLEN];
1493#elif defined(MS_WINDOWS)
Thomas Heller27bb71e2003-01-08 14:33:48 +00001494 char fullpath[MAX_PATH];
1495#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001496 PyObject *av = makeargvobject(argc, argv);
1497 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001498 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001499 Py_FatalError("no mem for sys.argv");
1500 if (PySys_SetObject("argv", av) != 0)
1501 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +00001502 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001503 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +00001504 char *p = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001505 Py_ssize_t n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001506 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001507#ifdef HAVE_READLINK
1508 char link[MAXPATHLEN+1];
1509 char argv0copy[2*MAXPATHLEN+1];
1510 int nr = 0;
Georg Brandl69537722005-09-15 13:00:34 +00001511 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
Guido van Rossumc474dea1997-04-25 15:38:31 +00001512 nr = readlink(argv0, link, MAXPATHLEN);
1513 if (nr > 0) {
1514 /* It's a symlink */
1515 link[nr] = '\0';
1516 if (link[0] == SEP)
1517 argv0 = link; /* Link to absolute path */
1518 else if (strchr(link, SEP) == NULL)
1519 ; /* Link without path */
1520 else {
1521 /* Must join(dirname(argv0), link) */
1522 char *q = strrchr(argv0, SEP);
1523 if (q == NULL)
1524 argv0 = link; /* argv0 without path */
1525 else {
1526 /* Must make a copy */
1527 strcpy(argv0copy, argv0);
1528 q = strrchr(argv0copy, SEP);
1529 strcpy(q+1, link);
1530 argv0 = argv0copy;
1531 }
1532 }
1533 }
1534#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001535#if SEP == '\\' /* Special case for MS filename syntax */
Georg Brandl69537722005-09-15 13:00:34 +00001536 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossumcc883411996-09-10 14:44:21 +00001537 char *q;
Thomas Heller27bb71e2003-01-08 14:33:48 +00001538#ifdef MS_WINDOWS
1539 char *ptemp;
1540 if (GetFullPathName(argv0,
1541 sizeof(fullpath),
1542 fullpath,
1543 &ptemp)) {
1544 argv0 = fullpath;
1545 }
1546#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001547 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +00001548 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +00001549 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +00001550 if (q != NULL)
1551 p = q;
1552 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001553 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001554 if (n > 1 && p[-1] != ':')
1555 n--; /* Drop trailing separator */
1556 }
1557 }
1558#else /* All other filename syntaxes */
Georg Brandl69537722005-09-15 13:00:34 +00001559 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001560#if defined(HAVE_REALPATH)
1561 if (realpath(argv0, fullpath)) {
1562 argv0 = fullpath;
1563 }
1564#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001565 p = strrchr(argv0, SEP);
Guido van Rossum162e38c2003-02-19 15:25:10 +00001566 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001567 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001568#ifndef RISCOS
Guido van Rossumc474dea1997-04-25 15:38:31 +00001569 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001570#else /* don't include trailing separator */
1571 n = p - argv0;
1572#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001573#if SEP == '/' /* Special case for Unix filename syntax */
1574 if (n > 1)
1575 n--; /* Drop trailing separator */
1576#endif /* Unix */
1577 }
1578#endif /* All others */
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001579 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +00001580 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001581 Py_FatalError("no mem for sys.path insertion");
1582 if (PyList_Insert(path, 0, a) < 0)
1583 Py_FatalError("sys.path.insert(0) failed");
1584 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +00001585 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001586 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001587}
Guido van Rossuma890e681998-05-12 14:59:24 +00001588
1589
1590/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1591 Adapted from code submitted by Just van Rossum.
1592
1593 PySys_WriteStdout(format, ...)
1594 PySys_WriteStderr(format, ...)
1595
1596 The first function writes to sys.stdout; the second to sys.stderr. When
1597 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001598 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001599
1600 Both take a printf-style format string as their first argument followed
1601 by a variable length argument list determined by the format string.
1602
1603 *** WARNING ***
1604
1605 The format should limit the total size of the formatted output string to
1606 1000 bytes. In particular, this means that no unrestricted "%s" formats
1607 should occur; these should be limited using "%.<N>s where <N> is a
1608 decimal number calculated so that <N> plus the maximum size of other
1609 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1610 which can print hundreds of digits for very large numbers.
1611
1612 */
1613
1614static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001615mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001616{
1617 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001618 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001619
Guido van Rossum8442af31998-10-12 18:22:10 +00001620 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001621 file = PySys_GetObject(name);
1622 if (file == NULL || PyFile_AsFile(file) == fp)
1623 vfprintf(fp, format, va);
1624 else {
1625 char buffer[1001];
Tim Peters080d5b32001-12-02 08:29:16 +00001626 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1627 format, va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001628 if (PyFile_WriteString(buffer, file) != 0) {
1629 PyErr_Clear();
1630 fputs(buffer, fp);
1631 }
Skip Montanaro53a6d1d2006-04-18 00:55:46 +00001632 if (written < 0 || (size_t)written >= sizeof(buffer)) {
Jeremy Hylton5d3d1342001-11-28 21:44:53 +00001633 const char *truncated = "... truncated";
1634 if (PyFile_WriteString(truncated, file) != 0) {
1635 PyErr_Clear();
1636 fputs(truncated, fp);
1637 }
1638 }
Guido van Rossuma890e681998-05-12 14:59:24 +00001639 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001640 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001641}
1642
1643void
Guido van Rossuma890e681998-05-12 14:59:24 +00001644PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001645{
1646 va_list va;
1647
Guido van Rossuma890e681998-05-12 14:59:24 +00001648 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001649 mywrite("stdout", stdout, format, va);
1650 va_end(va);
1651}
1652
1653void
Guido van Rossuma890e681998-05-12 14:59:24 +00001654PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001655{
1656 va_list va;
1657
Guido van Rossuma890e681998-05-12 14:59:24 +00001658 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001659 mywrite("stderr", stderr, format, va);
1660 va_end(va);
1661}