blob: f4118d6899ed98751720e95a76bcde1947e5656d [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 Heimesd32ed6f2008-01-14 18:49:24 +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
Amaury Forgeot d'Arc06cfe952007-11-10 13:55:44 +000027#include <windows.h>
Mark Hammond8696ebc2002-10-08 02:44:31 +000028#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 HAVE_LANGINFO_H
41#include <locale.h>
42#include <langinfo.h>
43#endif
44
Guido van Rossum65bf9f21997-04-29 18:33:38 +000045PyObject *
Neal Norwitzf3081322007-08-25 00:32:45 +000046PySys_GetObject(const char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000047{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000048 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000049 PyObject *sd = tstate->interp->sysdict;
Guido van Rossumbe203361999-10-05 22:17:41 +000050 if (sd == NULL)
51 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +000052 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000053}
54
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000055int
Neal Norwitzf3081322007-08-25 00:32:45 +000056PySys_SetObject(const char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000057{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000058 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000059 PyObject *sd = tstate->interp->sysdict;
Guido van Rossum5ad58c61992-01-26 18:15:48 +000060 if (v == NULL) {
Guido van Rossum25ce5661997-08-02 03:10:38 +000061 if (PyDict_GetItemString(sd, name) == NULL)
Guido van Rossum5ad58c61992-01-26 18:15:48 +000062 return 0;
63 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000064 return PyDict_DelItemString(sd, name);
Guido van Rossum5ad58c61992-01-26 18:15:48 +000065 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000066 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000067 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000068}
69
Guido van Rossum65bf9f21997-04-29 18:33:38 +000070static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000071sys_displayhook(PyObject *self, PyObject *o)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000072{
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000073 PyObject *outf;
Nicholas Bastine5662ae2004-03-24 22:22:12 +000074 PyInterpreterState *interp = PyThreadState_GET()->interp;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000075 PyObject *modules = interp->modules;
Georg Brandl1a3284e2007-12-02 09:40:06 +000076 PyObject *builtins = PyDict_GetItemString(modules, "builtins");
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000077
Moshe Zadka03897ea2001-07-23 13:32:43 +000078 if (builtins == NULL) {
Georg Brandl1a3284e2007-12-02 09:40:06 +000079 PyErr_SetString(PyExc_RuntimeError, "lost builtins module");
Moshe Zadka03897ea2001-07-23 13:32:43 +000080 return NULL;
81 }
82
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000083 /* Print value except if None */
84 /* After printing, also assign to '_' */
85 /* Before, set '_' to None to avoid recursion */
86 if (o == Py_None) {
87 Py_INCREF(Py_None);
88 return Py_None;
89 }
90 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
91 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +000092 outf = PySys_GetObject("stdout");
Christian Heimes2be03732007-11-15 02:26:46 +000093 if (outf == NULL || outf == Py_None) {
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000094 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
95 return NULL;
96 }
Greg Steinceb9b7c2001-01-11 09:27:34 +000097 if (PyFile_WriteObject(o, outf, 0) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000098 return NULL;
Guido van Rossum79139b22007-02-09 23:20:19 +000099 if (PyFile_WriteString("\n", outf) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000100 return NULL;
101 if (PyObject_SetAttrString(builtins, "_", o) != 0)
102 return NULL;
103 Py_INCREF(Py_None);
104 return Py_None;
105}
106
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000107PyDoc_STRVAR(displayhook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000108"displayhook(object) -> None\n"
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000109"\n"
Georg Brandl1a3284e2007-12-02 09:40:06 +0000110"Print an object to sys.stdout and also save it in builtins.\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000111);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000112
113static PyObject *
114sys_excepthook(PyObject* self, PyObject* args)
115{
116 PyObject *exc, *value, *tb;
Fred Drakea7688822001-10-24 20:47:48 +0000117 if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb))
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000118 return NULL;
119 PyErr_Display(exc, value, tb);
120 Py_INCREF(Py_None);
121 return Py_None;
122}
123
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000124PyDoc_STRVAR(excepthook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000125"excepthook(exctype, value, traceback) -> None\n"
126"\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000127"Handle an exception by displaying it with a traceback on sys.stderr.\n"
128);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000129
130static PyObject *
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000131sys_exc_info(PyObject *self, PyObject *noargs)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000132{
133 PyThreadState *tstate;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000134 tstate = PyThreadState_GET();
Guido van Rossuma027efa1997-05-05 20:56:21 +0000135 return Py_BuildValue(
136 "(OOO)",
137 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
138 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
139 tstate->exc_traceback != NULL ?
140 tstate->exc_traceback : Py_None);
141}
142
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000143PyDoc_STRVAR(exc_info_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000144"exc_info() -> (type, value, traceback)\n\
145\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000146Return information about the most recent exception caught by an except\n\
147clause in the current stack frame or in an older stack frame."
148);
149
150static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000151sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000152{
Neal Norwitz0c766a02002-03-27 13:03:09 +0000153 PyObject *exit_code = 0;
Thomas Wouters4d70c3d2006-06-08 14:42:34 +0000154 if (!PyArg_UnpackTuple(args, "exit", 0, 1, &exit_code))
Neal Norwitz0c766a02002-03-27 13:03:09 +0000155 return NULL;
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000156 /* Raise SystemExit so callers may catch it or clean up. */
Neal Norwitz0c766a02002-03-27 13:03:09 +0000157 PyErr_SetObject(PyExc_SystemExit, exit_code);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000158 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000159}
160
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000161PyDoc_STRVAR(exit_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000162"exit([status])\n\
163\n\
164Exit the interpreter by raising SystemExit(status).\n\
165If the status is omitted or None, it defaults to zero (i.e., success).\n\
Neil Schemenauer0f2103f2002-03-23 20:46:35 +0000166If the status is numeric, it will be used as the system exit status.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000167If it is another kind of object, it will be printed and the system\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000168exit status will be one (i.e., failure)."
169);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000170
Martin v. Löwis107b7da2001-11-09 20:59:39 +0000171
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000172static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000173sys_getdefaultencoding(PyObject *self)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000174{
Walter Dörwald360b01a2007-06-05 20:15:52 +0000175 return PyUnicode_FromString(PyUnicode_GetDefaultEncoding());
Fred Drake8b4d01d2000-05-09 19:57:01 +0000176}
177
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000178PyDoc_STRVAR(getdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000179"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000180\n\
181Return the current default string encoding used by the Unicode \n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000182implementation."
183);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000184
185static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000186sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000187{
188 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000189 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000190 return NULL;
191 if (PyUnicode_SetDefaultEncoding(encoding))
192 return NULL;
193 Py_INCREF(Py_None);
194 return Py_None;
195}
196
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000197PyDoc_STRVAR(setdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000198"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000199\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000200Set the current default string encoding used by the Unicode implementation."
201);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000202
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000203static PyObject *
204sys_getfilesystemencoding(PyObject *self)
205{
206 if (Py_FileSystemDefaultEncoding)
Walter Dörwald360b01a2007-06-05 20:15:52 +0000207 return PyUnicode_FromString(Py_FileSystemDefaultEncoding);
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000208 Py_INCREF(Py_None);
209 return Py_None;
210}
211
212PyDoc_STRVAR(getfilesystemencoding_doc,
213"getfilesystemencoding() -> string\n\
214\n\
215Return the encoding used to convert Unicode filenames in\n\
216operating system filenames."
217);
218
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000219
Georg Brandl66a796e2006-12-19 20:50:34 +0000220
221static PyObject *
222sys_intern(PyObject *self, PyObject *args)
223{
224 PyObject *s;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000225 if (!PyArg_ParseTuple(args, "U:intern", &s))
Georg Brandl66a796e2006-12-19 20:50:34 +0000226 return NULL;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000227 if (PyUnicode_CheckExact(s)) {
Walter Dörwald2a0c0812007-06-05 20:22:04 +0000228 Py_INCREF(s);
229 PyUnicode_InternInPlace(&s);
230 return s;
231 }
232 else {
233 PyErr_Format(PyExc_TypeError,
234 "can't intern %.400s", s->ob_type->tp_name);
Georg Brandl66a796e2006-12-19 20:50:34 +0000235 return NULL;
236 }
Georg Brandl66a796e2006-12-19 20:50:34 +0000237}
238
239PyDoc_STRVAR(intern_doc,
240"intern(string) -> string\n\
241\n\
242``Intern'' the given string. This enters the string in the (global)\n\
243table of interned strings whose purpose is to speed up dictionary lookups.\n\
244Return the string itself or the previously interned string object with the\n\
245same value.");
246
247
Fred Drake5755ce62001-06-27 19:19:46 +0000248/*
249 * Cached interned string objects used for calling the profile and
250 * trace functions. Initialized by trace_init().
251 */
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000252static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL};
Fred Drake5755ce62001-06-27 19:19:46 +0000253
254static int
255trace_init(void)
256{
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000257 static char *whatnames[7] = {"call", "exception", "line", "return",
258 "c_call", "c_exception", "c_return"};
Fred Drake5755ce62001-06-27 19:19:46 +0000259 PyObject *name;
260 int i;
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000261 for (i = 0; i < 7; ++i) {
Fred Drake5755ce62001-06-27 19:19:46 +0000262 if (whatstrings[i] == NULL) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000263 name = PyUnicode_InternFromString(whatnames[i]);
Fred Drake5755ce62001-06-27 19:19:46 +0000264 if (name == NULL)
265 return -1;
266 whatstrings[i] = name;
267 }
268 }
269 return 0;
270}
271
272
273static PyObject *
274call_trampoline(PyThreadState *tstate, PyObject* callback,
275 PyFrameObject *frame, int what, PyObject *arg)
276{
277 PyObject *args = PyTuple_New(3);
278 PyObject *whatstr;
279 PyObject *result;
280
281 if (args == NULL)
282 return NULL;
283 Py_INCREF(frame);
284 whatstr = whatstrings[what];
285 Py_INCREF(whatstr);
286 if (arg == NULL)
287 arg = Py_None;
288 Py_INCREF(arg);
289 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
290 PyTuple_SET_ITEM(args, 1, whatstr);
291 PyTuple_SET_ITEM(args, 2, arg);
292
293 /* call the Python-level function */
294 PyFrame_FastToLocals(frame);
295 result = PyEval_CallObject(callback, args);
296 PyFrame_LocalsToFast(frame, 1);
297 if (result == NULL)
298 PyTraceBack_Here(frame);
299
300 /* cleanup */
301 Py_DECREF(args);
302 return result;
303}
304
305static int
306profile_trampoline(PyObject *self, PyFrameObject *frame,
307 int what, PyObject *arg)
308{
309 PyThreadState *tstate = frame->f_tstate;
310 PyObject *result;
311
Fred Drake8f51f542001-10-04 14:48:42 +0000312 if (arg == NULL)
313 arg = Py_None;
Fred Drake5755ce62001-06-27 19:19:46 +0000314 result = call_trampoline(tstate, self, frame, what, arg);
315 if (result == NULL) {
316 PyEval_SetProfile(NULL, NULL);
317 return -1;
318 }
319 Py_DECREF(result);
320 return 0;
321}
322
323static int
324trace_trampoline(PyObject *self, PyFrameObject *frame,
325 int what, PyObject *arg)
326{
327 PyThreadState *tstate = frame->f_tstate;
328 PyObject *callback;
329 PyObject *result;
330
331 if (what == PyTrace_CALL)
332 callback = self;
333 else
334 callback = frame->f_trace;
335 if (callback == NULL)
336 return 0;
337 result = call_trampoline(tstate, callback, frame, what, arg);
338 if (result == NULL) {
339 PyEval_SetTrace(NULL, NULL);
340 Py_XDECREF(frame->f_trace);
341 frame->f_trace = NULL;
342 return -1;
343 }
344 if (result != Py_None) {
345 PyObject *temp = frame->f_trace;
346 frame->f_trace = NULL;
347 Py_XDECREF(temp);
348 frame->f_trace = result;
349 }
350 else {
351 Py_DECREF(result);
352 }
353 return 0;
354}
Fred Draked0838392001-06-16 21:02:31 +0000355
Fred Drake8b4d01d2000-05-09 19:57:01 +0000356static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000357sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000358{
Fred Drake5755ce62001-06-27 19:19:46 +0000359 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000360 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000361 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000362 PyEval_SetTrace(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000363 else
Fred Drake5755ce62001-06-27 19:19:46 +0000364 PyEval_SetTrace(trace_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000365 Py_INCREF(Py_None);
366 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000367}
368
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000369PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000370"settrace(function)\n\
371\n\
372Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000373function call. See the debugger chapter in the library manual."
374);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000375
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000376static PyObject *
Christian Heimes9bd667a2008-01-20 15:14:11 +0000377sys_gettrace(PyObject *self, PyObject *args)
378{
379 PyThreadState *tstate = PyThreadState_GET();
380 PyObject *temp = tstate->c_traceobj;
381
382 if (temp == NULL)
383 temp = Py_None;
384 Py_INCREF(temp);
385 return temp;
386}
387
388PyDoc_STRVAR(gettrace_doc,
389"gettrace()\n\
390\n\
391Return the global debug tracing function set with sys.settrace.\n\
392See the debugger chapter in the library manual."
393);
394
395static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000396sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000397{
Fred Drake5755ce62001-06-27 19:19:46 +0000398 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000399 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000400 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000401 PyEval_SetProfile(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000402 else
Fred Drake5755ce62001-06-27 19:19:46 +0000403 PyEval_SetProfile(profile_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000404 Py_INCREF(Py_None);
405 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000406}
407
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000408PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000409"setprofile(function)\n\
410\n\
411Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000412and return. See the profiler chapter in the library manual."
413);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000414
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000415static PyObject *
Christian Heimes9bd667a2008-01-20 15:14:11 +0000416sys_getprofile(PyObject *self, PyObject *args)
417{
418 PyThreadState *tstate = PyThreadState_GET();
419 PyObject *temp = tstate->c_profileobj;
420
421 if (temp == NULL)
422 temp = Py_None;
423 Py_INCREF(temp);
424 return temp;
425}
426
427PyDoc_STRVAR(getprofile_doc,
428"getprofile()\n\
429\n\
430Return the profiling function set with sys.setprofile.\n\
431See the profiler chapter in the library manual."
432);
433
434static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000435sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000436{
Skip Montanarod581d772002-09-03 20:10:45 +0000437 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000438 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000439 Py_INCREF(Py_None);
440 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000441}
442
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000443PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000444"setcheckinterval(n)\n\
445\n\
446Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000447n instructions. This also affects how often thread switches occur."
448);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000449
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000450static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000451sys_getcheckinterval(PyObject *self, PyObject *args)
452{
Christian Heimes217cfd12007-12-02 14:31:20 +0000453 return PyLong_FromLong(_Py_CheckInterval);
Tim Peterse5e065b2003-07-06 18:36:54 +0000454}
455
456PyDoc_STRVAR(getcheckinterval_doc,
457"getcheckinterval() -> current check interval; see setcheckinterval()."
458);
459
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000460#ifdef WITH_TSC
461static PyObject *
462sys_settscdump(PyObject *self, PyObject *args)
463{
464 int bool;
465 PyThreadState *tstate = PyThreadState_Get();
466
467 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
468 return NULL;
469 if (bool)
470 tstate->interp->tscdump = 1;
471 else
472 tstate->interp->tscdump = 0;
473 Py_INCREF(Py_None);
474 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000475
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000476}
477
Tim Peters216b78b2006-01-06 02:40:53 +0000478PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000479"settscdump(bool)\n\
480\n\
481If true, tell the Python interpreter to dump VM measurements to\n\
482stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000483processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000484);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000485#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000486
Tim Peterse5e065b2003-07-06 18:36:54 +0000487static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000488sys_setrecursionlimit(PyObject *self, PyObject *args)
489{
490 int new_limit;
491 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
492 return NULL;
493 if (new_limit <= 0) {
Tim Peters216b78b2006-01-06 02:40:53 +0000494 PyErr_SetString(PyExc_ValueError,
495 "recursion limit must be positive");
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000496 return NULL;
497 }
498 Py_SetRecursionLimit(new_limit);
499 Py_INCREF(Py_None);
500 return Py_None;
501}
502
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000503PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000504"setrecursionlimit(n)\n\
505\n\
506Set the maximum depth of the Python interpreter stack to n. This\n\
507limit prevents infinite recursion from causing an overflow of the C\n\
508stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000509dependent."
510);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000511
512static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000513sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000514{
Christian Heimes217cfd12007-12-02 14:31:20 +0000515 return PyLong_FromLong(Py_GetRecursionLimit());
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000516}
517
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000518PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000519"getrecursionlimit()\n\
520\n\
521Return the current value of the recursion limit, the maximum depth\n\
522of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000523recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000524);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000525
Mark Hammond8696ebc2002-10-08 02:44:31 +0000526#ifdef MS_WINDOWS
527PyDoc_STRVAR(getwindowsversion_doc,
528"getwindowsversion()\n\
529\n\
530Return information about the running version of Windows.\n\
531The result is a tuple of (major, minor, build, platform, text)\n\
532All elements are numbers, except text which is a string.\n\
533Platform may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP\n\
534"
535);
536
537static PyObject *
538sys_getwindowsversion(PyObject *self)
539{
540 OSVERSIONINFO ver;
541 ver.dwOSVersionInfoSize = sizeof(ver);
542 if (!GetVersionEx(&ver))
543 return PyErr_SetFromWindowsErr(0);
544 return Py_BuildValue("HHHHs",
545 ver.dwMajorVersion,
546 ver.dwMinorVersion,
547 ver.dwBuildNumber,
548 ver.dwPlatformId,
549 ver.szCSDVersion);
550}
551
552#endif /* MS_WINDOWS */
553
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000554#ifdef HAVE_DLOPEN
555static PyObject *
556sys_setdlopenflags(PyObject *self, PyObject *args)
557{
558 int new_val;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000559 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000560 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
561 return NULL;
562 if (!tstate)
563 return NULL;
564 tstate->interp->dlopenflags = new_val;
565 Py_INCREF(Py_None);
566 return Py_None;
567}
568
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000569PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000570"setdlopenflags(n) -> None\n\
571\n\
572Set the flags that will be used for dlopen() calls. Among other\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000573things, this will enable a lazy resolving of symbols when importing\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000574a module, if called as sys.setdlopenflags(0)\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000575To share symbols across extension modules, call as\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000576sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)"
577);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000578
579static PyObject *
580sys_getdlopenflags(PyObject *self, PyObject *args)
581{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000582 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000583 if (!tstate)
584 return NULL;
Christian Heimes217cfd12007-12-02 14:31:20 +0000585 return PyLong_FromLong(tstate->interp->dlopenflags);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000586}
587
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000588PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000589"getdlopenflags() -> int\n\
590\n\
591Return the current value of the flags that are used for dlopen()\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000592calls. The flag constants are defined in the dl module."
593);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000594#endif
595
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000596#ifdef USE_MALLOPT
597/* Link with -lmalloc (or -lmpc) on an SGI */
598#include <malloc.h>
599
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000600static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000601sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000602{
603 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000604 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000605 return NULL;
606 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000607 Py_INCREF(Py_None);
608 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000609}
610#endif /* USE_MALLOPT */
611
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000612static PyObject *
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000613sys_getsizeof(PyObject *self, PyObject *args, PyObject *kwds)
Martin v. Löwis00709aa2008-06-04 14:18:43 +0000614{
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000615 PyObject *res = NULL;
616 static PyObject *str__sizeof__, *gc_head_size = NULL;
617 static char *kwlist[] = {"object", "default", 0};
618 PyObject *o, *dflt = NULL;
Thomas Hellerd88ddfa2008-07-15 17:14:51 +0000619 PyObject *method;
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000620
621 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:getsizeof",
622 kwlist, &o, &dflt))
623 return NULL;
Martin v. Löwis00709aa2008-06-04 14:18:43 +0000624
625 /* Initialize static variable needed by _PyType_Lookup */
626 if (str__sizeof__ == NULL) {
627 str__sizeof__ = PyUnicode_InternFromString("__sizeof__");
628 if (str__sizeof__ == NULL)
629 return NULL;
630 }
631
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000632 /* Initialize static variable for GC head size */
633 if (gc_head_size == NULL) {
634 gc_head_size = PyLong_FromSsize_t(sizeof(PyGC_Head));
635 if (gc_head_size == NULL)
Martin v. Löwis00709aa2008-06-04 14:18:43 +0000636 return NULL;
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000637 }
638
639 /* Make sure the type is initialized. float gets initialized late */
640 if (PyType_Ready(Py_TYPE(o)) < 0)
641 return NULL;
642
Thomas Hellerd88ddfa2008-07-15 17:14:51 +0000643 method = _PyType_Lookup(Py_TYPE(o), str__sizeof__);
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000644 if (method == NULL)
645 PyErr_Format(PyExc_TypeError,
646 "Type %.100s doesn't define __sizeof__",
647 Py_TYPE(o)->tp_name);
Martin v. Löwis00709aa2008-06-04 14:18:43 +0000648 else
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000649 res = PyObject_CallFunctionObjArgs(method, o, NULL);
650
651 /* Has a default value been given */
652 if ((res == NULL) && (dflt != NULL) &&
653 PyErr_ExceptionMatches(PyExc_TypeError))
654 {
655 PyErr_Clear();
656 Py_INCREF(dflt);
657 return dflt;
658 }
659 else if (res == NULL)
660 return res;
661
662 /* add gc_head size */
663 if (PyObject_IS_GC(o)) {
664 PyObject *tmp = res;
665 res = PyNumber_Add(tmp, gc_head_size);
666 Py_DECREF(tmp);
667 }
668 return res;
Martin v. Löwis00709aa2008-06-04 14:18:43 +0000669}
670
671PyDoc_STRVAR(getsizeof_doc,
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000672"getsizeof(object, default) -> int\n\
Martin v. Löwis00709aa2008-06-04 14:18:43 +0000673\n\
674Return the size of object in bytes.");
675
676static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000677sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000678{
Christian Heimes217cfd12007-12-02 14:31:20 +0000679 return PyLong_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000680}
681
Tim Peters4be93d02002-07-07 19:59:50 +0000682#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000683static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000684sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000685{
Christian Heimes217cfd12007-12-02 14:31:20 +0000686 return PyLong_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000687}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000688#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000689
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000690PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000691"getrefcount(object) -> integer\n\
692\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000693Return the reference count of object. The count returned is generally\n\
694one higher than you might expect, because it includes the (temporary)\n\
695reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000696);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000697
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000698#ifdef COUNT_ALLOCS
699static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000700sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000701{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000702 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000703
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000704 return get_counts();
705}
706#endif
707
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000708PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000709"_getframe([depth]) -> frameobject\n\
710\n\
711Return a frame object from the call stack. If optional integer depth is\n\
712given, return the frame object that many calls below the top of the stack.\n\
713If that is deeper than the call stack, ValueError is raised. The default\n\
714for depth is zero, returning the frame at the top of the call stack.\n\
715\n\
716This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000717purposes only."
718);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000719
720static PyObject *
721sys_getframe(PyObject *self, PyObject *args)
722{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000723 PyFrameObject *f = PyThreadState_GET()->frame;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000724 int depth = -1;
725
726 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
727 return NULL;
728
729 while (depth > 0 && f != NULL) {
730 f = f->f_back;
731 --depth;
732 }
733 if (f == NULL) {
734 PyErr_SetString(PyExc_ValueError,
735 "call stack is not deep enough");
736 return NULL;
737 }
738 Py_INCREF(f);
739 return (PyObject*)f;
740}
741
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000742PyDoc_STRVAR(current_frames_doc,
743"_current_frames() -> dictionary\n\
744\n\
745Return a dictionary mapping each current thread T's thread id to T's\n\
746current stack frame.\n\
747\n\
748This function should be used for specialized purposes only."
749);
750
751static PyObject *
752sys_current_frames(PyObject *self, PyObject *noargs)
753{
754 return _PyThread_CurrentFrames();
755}
756
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000757PyDoc_STRVAR(call_tracing_doc,
758"call_tracing(func, args) -> object\n\
759\n\
760Call func(*args), while tracing is enabled. The tracing state is\n\
761saved, and restored afterwards. This is intended to be called from\n\
762a debugger from a checkpoint, to recursively debug some other code."
763);
764
765static PyObject *
766sys_call_tracing(PyObject *self, PyObject *args)
767{
768 PyObject *func, *funcargs;
Thomas Wouters4d70c3d2006-06-08 14:42:34 +0000769 if (!PyArg_UnpackTuple(args, "call_tracing", 2, 2, &func, &funcargs))
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000770 return NULL;
771 return _PyEval_CallTracing(func, funcargs);
772}
773
Jeremy Hylton985eba52003-02-05 23:13:00 +0000774PyDoc_STRVAR(callstats_doc,
775"callstats() -> tuple of integers\n\
776\n\
777Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
778when Python was built. Otherwise, return None.\n\
779\n\
780When enabled, this function returns detailed, implementation-specific\n\
781details about the number of function calls executed. The return value is\n\
782a 11-tuple where the entries in the tuple are counts of:\n\
7830. all function calls\n\
7841. calls to PyFunction_Type objects\n\
7852. PyFunction calls that do not create an argument tuple\n\
7863. PyFunction calls that do not create an argument tuple\n\
787 and bypass PyEval_EvalCodeEx()\n\
7884. PyMethod calls\n\
7895. PyMethod calls on bound methods\n\
7906. PyType calls\n\
7917. PyCFunction calls\n\
7928. generator calls\n\
7939. All other calls\n\
79410. Number of stack pops performed by call_function()"
795);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000796
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000797#ifdef __cplusplus
798extern "C" {
799#endif
800
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000801#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000802/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000803extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000804#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000805
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000806#ifdef DYNAMIC_EXECUTION_PROFILE
807/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000808extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000809#endif
810
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000811#ifdef __cplusplus
812}
813#endif
814
Christian Heimes15ebc882008-02-04 18:48:49 +0000815static PyObject *
816sys_clear_type_cache(PyObject* self, PyObject* args)
817{
818 PyType_ClearCache();
819 Py_RETURN_NONE;
820}
821
822PyDoc_STRVAR(sys_clear_type_cache__doc__,
823"_clear_type_cache() -> None\n\
824Clear the internal type lookup cache.");
825
826
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000827static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000828 /* Might as well keep this in alphabetic order */
Tim Peters216b78b2006-01-06 02:40:53 +0000829 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
Jeremy Hylton985eba52003-02-05 23:13:00 +0000830 callstats_doc},
Christian Heimes15ebc882008-02-04 18:48:49 +0000831 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
832 sys_clear_type_cache__doc__},
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000833 {"_current_frames", sys_current_frames, METH_NOARGS,
834 current_frames_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000835 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000836 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000837 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
Neal Norwitz0c766a02002-03-27 13:03:09 +0000838 {"exit", sys_exit, METH_VARARGS, exit_doc},
Tim Peters216b78b2006-01-06 02:40:53 +0000839 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
840 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000841#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000842 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000843 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000844#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000845#ifdef COUNT_ALLOCS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000846 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000847#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000848#ifdef DYNAMIC_EXECUTION_PROFILE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000849 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000850#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000851 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
Tim Peters216b78b2006-01-06 02:40:53 +0000852 METH_NOARGS, getfilesystemencoding_doc},
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000853#ifdef Py_TRACE_REFS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000854 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000855#endif
856#ifdef Py_REF_DEBUG
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000857 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000858#endif
Fred Drakea7688822001-10-24 20:47:48 +0000859 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000860 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000861 getrecursionlimit_doc},
Robert Schuppeniesfbe94c52008-07-14 10:13:31 +0000862 {"getsizeof", (PyCFunction)sys_getsizeof,
863 METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000864 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000865#ifdef MS_WINDOWS
866 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
867 getwindowsversion_doc},
868#endif /* MS_WINDOWS */
Georg Brandl66a796e2006-12-19 20:50:34 +0000869 {"intern", sys_intern, METH_VARARGS, intern_doc},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000870#ifdef USE_MALLOPT
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000871 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000872#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000873 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000874 setdefaultencoding_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000875 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000876 setcheckinterval_doc},
Tim Peterse5e065b2003-07-06 18:36:54 +0000877 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000878 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000879#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000880 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000881 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000882#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000883 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
Christian Heimes9bd667a2008-01-20 15:14:11 +0000884 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000885 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000886 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000887#ifdef WITH_TSC
888 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
889#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000890 {"settrace", sys_settrace, METH_O, settrace_doc},
Christian Heimes9bd667a2008-01-20 15:14:11 +0000891 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000892 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000893 {NULL, NULL} /* sentinel */
894};
895
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000896static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000897list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000898{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000899 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000900 int i;
901 if (list == NULL)
902 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000903 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000904 PyObject *name = PyUnicode_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000905 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000906 if (name == NULL)
907 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000908 PyList_Append(list, name);
909 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000910 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000911 if (PyList_Sort(list) != 0) {
912 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000913 list = NULL;
914 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000915 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000916 PyObject *v = PyList_AsTuple(list);
917 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000918 list = v;
919 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000920 return list;
921}
922
Guido van Rossum23fff912000-12-15 22:02:05 +0000923static PyObject *warnoptions = NULL;
924
925void
926PySys_ResetWarnOptions(void)
927{
928 if (warnoptions == NULL || !PyList_Check(warnoptions))
929 return;
930 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
931}
932
933void
Martin v. Löwis790465f2008-04-05 20:41:37 +0000934PySys_AddWarnOption(const wchar_t *s)
Guido van Rossum23fff912000-12-15 22:02:05 +0000935{
936 PyObject *str;
937
938 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
939 Py_XDECREF(warnoptions);
940 warnoptions = PyList_New(0);
941 if (warnoptions == NULL)
942 return;
943 }
Martin v. Löwis790465f2008-04-05 20:41:37 +0000944 str = PyUnicode_FromWideChar(s, -1);
Guido van Rossum23fff912000-12-15 22:02:05 +0000945 if (str != NULL) {
946 PyList_Append(warnoptions, str);
947 Py_DECREF(str);
948 }
949}
950
Christian Heimes33fe8092008-04-13 13:53:33 +0000951int
952PySys_HasWarnOptions(void)
953{
954 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
955}
956
Guido van Rossum40552d01998-08-06 03:34:39 +0000957/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
958 Two literals concatenated works just fine. If you have a K&R compiler
959 or other abomination that however *does* understand longer strings,
960 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000961PyDoc_VAR(sys_doc) =
962PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000963"This module provides access to some objects used or maintained by the\n\
964interpreter and to functions that interact strongly with the interpreter.\n\
965\n\
966Dynamic objects:\n\
967\n\
968argv -- command line arguments; argv[0] is the script pathname if known\n\
969path -- module search path; path[0] is the script directory, else ''\n\
970modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000971\n\
972displayhook -- called to show results in an interactive session\n\
973excepthook -- called to handle any uncaught exception other than SystemExit\n\
974 To customize printing in an interactive session or to install a custom\n\
975 top-level exception handler, assign other functions to replace these.\n\
976\n\
Benjamin Peterson06157a42008-07-15 00:28:36 +0000977stdin -- standard input file object; used by input()\n\
Georg Brandl88fc6642007-02-09 21:28:07 +0000978stdout -- standard output file object; used by print()\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000979stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000980 By assigning other file objects (or objects that behave like files)\n\
981 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000982\n\
983last_type -- type of last uncaught exception\n\
984last_value -- value of last uncaught exception\n\
985last_traceback -- traceback of last uncaught exception\n\
986 These three are only available in an interactive session after a\n\
987 traceback has been printed.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000988"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000989)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000990/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000991PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000992"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000993Static objects:\n\
994\n\
Christian Heimes2d378ab2007-12-15 01:28:04 +0000995float_info -- a dict with information about the float implementation.\n\
Thomas Woutersd2cf20e2007-08-30 22:57:53 +0000996maxsize -- the largest supported length of containers.\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\
Christian Heimes2d378ab2007-12-15 01:28:04 +0000999subversion -- subversion information of the build as tuple\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001000version -- the version of this interpreter as a string\n\
1001version_info -- version information as a tuple\n\
1002hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001003copyright -- copyright notice pertaining to this interpreter\n\
1004platform -- platform identifier\n\
1005executable -- pathname of this Python interpreter\n\
1006prefix -- prefix used to find the Python library\n\
1007exec_prefix -- prefix used to find the machine-specific Python library\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001008"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001009)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001010#ifdef MS_WINDOWS
1011/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001012PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001013"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001014winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001015"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001016)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001017#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001018PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001019"__stdin__ -- the original stdin; don't touch!\n\
1020__stdout__ -- the original stdout; don't touch!\n\
1021__stderr__ -- the original stderr; don't touch!\n\
1022__displayhook__ -- the original displayhook; don't touch!\n\
1023__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001024\n\
1025Functions:\n\
1026\n\
Georg Brandl1a3284e2007-12-02 09:40:06 +00001027displayhook() -- print an object to the screen, and save it in builtins._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001028excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001029exc_info() -- return thread-safe information about the current exception\n\
1030exit() -- 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\
Christian Heimes9bd667a2008-01-20 15:14:11 +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\
Martin v. Löwis00709aa2008-06-04 14:18:43 +00001035getsizeof() -- return the size of an object in bytes\n\
Christian Heimes9bd667a2008-01-20 15:14:11 +00001036gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001037setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001038setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001039setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001040setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001041settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001042"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001043)
Fred Drakeccede592000-08-14 20:59:57 +00001044/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001045
Martin v. Löwis43b57802006-01-05 23:38:54 +00001046/* Subversion branch and revision management */
1047static const char _patchlevel_revision[] = PY_PATCHLEVEL_REVISION;
1048static const char headurl[] = "$HeadURL$";
1049static int svn_initialized;
1050static char patchlevel_revision[50]; /* Just the number */
1051static char branch[50];
1052static char shortbranch[50];
1053static const char *svn_revision;
1054
Tim Peterse86e7a52006-01-06 02:42:46 +00001055static void
1056svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001057{
1058 const char *python, *br_start, *br_end, *br_end2, *svnversion;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001059 Py_ssize_t len;
Collin Winterd5a5f5d2007-08-22 19:45:07 +00001060 int istag = 0;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001061
1062 if (svn_initialized)
1063 return;
1064
1065 python = strstr(headurl, "/python/");
Collin Winterd5a5f5d2007-08-22 19:45:07 +00001066 if (!python) {
1067 strcpy(branch, "unknown branch");
1068 strcpy(shortbranch, "unknown");
Tim Peters216b78b2006-01-06 02:40:53 +00001069 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001070 else {
Collin Winterd5a5f5d2007-08-22 19:45:07 +00001071 br_start = python + 8;
1072 br_end = strchr(br_start, '/');
1073 assert(br_end);
1074
1075 /* Works even for trunk,
1076 as we are in trunk/Python/sysmodule.c */
1077 br_end2 = strchr(br_end+1, '/');
1078
1079 istag = strncmp(br_start, "tags", 4) == 0;
1080 if (strncmp(br_start, "trunk", 5) == 0) {
1081 strcpy(branch, "trunk");
1082 strcpy(shortbranch, "trunk");
1083 }
1084 else if (istag || strncmp(br_start, "branches", 8) == 0) {
1085 len = br_end2 - br_start;
1086 strncpy(branch, br_start, len);
1087 branch[len] = '\0';
1088
1089 len = br_end2 - (br_end + 1);
1090 strncpy(shortbranch, br_end + 1, len);
1091 shortbranch[len] = '\0';
1092 }
1093 else {
1094 Py_FatalError("bad HeadURL");
1095 return;
1096 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001097 }
1098
1099
1100 svnversion = _Py_svnversion();
1101 if (strcmp(svnversion, "exported") != 0)
1102 svn_revision = svnversion;
1103 else if (istag) {
1104 len = strlen(_patchlevel_revision);
Guido van Rossumd8faa362007-04-27 19:54:29 +00001105 assert(len >= 13);
1106 assert(len < (sizeof(patchlevel_revision) + 13));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001107 strncpy(patchlevel_revision, _patchlevel_revision + 11,
1108 len - 13);
1109 patchlevel_revision[len - 13] = '\0';
1110 svn_revision = patchlevel_revision;
1111 }
1112 else
1113 svn_revision = "";
Tim Peters216b78b2006-01-06 02:40:53 +00001114
Martin v. Löwis43b57802006-01-05 23:38:54 +00001115 svn_initialized = 1;
1116}
1117
1118/* Return svnversion output if available.
1119 Else return Revision of patchlevel.h if on branch.
1120 Else return empty string */
1121const char*
1122Py_SubversionRevision()
1123{
1124 svnversion_init();
1125 return svn_revision;
1126}
1127
1128const char*
1129Py_SubversionShortBranch()
1130{
1131 svnversion_init();
1132 return shortbranch;
1133}
1134
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001135
1136PyDoc_STRVAR(flags__doc__,
1137"sys.flags\n\
1138\n\
1139Flags provided through command line arguments or environment vars.");
1140
1141static PyTypeObject FlagsType;
1142
1143static PyStructSequence_Field flags_fields[] = {
1144 {"debug", "-d"},
1145 {"division_warning", "-Q"},
1146 {"inspect", "-i"},
1147 {"interactive", "-i"},
1148 {"optimize", "-O or -OO"},
1149 {"dont_write_bytecode", "-B"},
Christian Heimes8dc226f2008-05-06 23:45:46 +00001150 {"no_user_site", "-s"},
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001151 {"no_site", "-S"},
Guido van Rossum7736b5b2008-01-15 21:44:53 +00001152 {"ignore_environment", "-E"},
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001153 {"verbose", "-v"},
1154#ifdef RISCOS
Guido van Rossum7736b5b2008-01-15 21:44:53 +00001155 {"riscos_wimp", "???"},
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001156#endif
1157 /* {"unbuffered", "-u"}, */
1158 /* {"skip_first", "-x"}, */
Christian Heimes33fe8092008-04-13 13:53:33 +00001159 {"bytes_warning", "-b"},
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001160 {0}
1161};
1162
1163static PyStructSequence_Desc flags_desc = {
1164 "sys.flags", /* name */
1165 flags__doc__, /* doc */
1166 flags_fields, /* fields */
1167#ifdef RISCOS
Georg Brandlc5e88d52008-06-06 09:02:07 +00001168 12
Georg Brandle1b5ac62008-06-04 13:06:58 +00001169#else
Georg Brandlc5e88d52008-06-06 09:02:07 +00001170 11
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001171#endif
1172};
1173
1174static PyObject*
1175make_flags(void)
1176{
1177 int pos = 0;
1178 PyObject *seq;
1179
1180 seq = PyStructSequence_New(&FlagsType);
1181 if (seq == NULL)
1182 return NULL;
1183
1184#define SetFlag(flag) \
1185 PyStructSequence_SET_ITEM(seq, pos++, PyLong_FromLong(flag))
1186
1187 SetFlag(Py_DebugFlag);
1188 SetFlag(Py_DivisionWarningFlag);
1189 SetFlag(Py_InspectFlag);
1190 SetFlag(Py_InteractiveFlag);
1191 SetFlag(Py_OptimizeFlag);
1192 SetFlag(Py_DontWriteBytecodeFlag);
Christian Heimes8dc226f2008-05-06 23:45:46 +00001193 SetFlag(Py_NoUserSiteDirectory);
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001194 SetFlag(Py_NoSiteFlag);
1195 SetFlag(Py_IgnoreEnvironmentFlag);
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001196 SetFlag(Py_VerboseFlag);
1197#ifdef RISCOS
1198 SetFlag(Py_RISCOSWimpFlag);
1199#endif
1200 /* SetFlag(saw_unbuffered_flag); */
1201 /* SetFlag(skipfirstline); */
Christian Heimes33fe8092008-04-13 13:53:33 +00001202 SetFlag(Py_BytesWarningFlag);
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001203#undef SetFlag
1204
1205 if (PyErr_Occurred()) {
1206 return NULL;
1207 }
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001208 return seq;
1209}
1210
Martin v. Löwis1a214512008-06-11 05:26:20 +00001211static struct PyModuleDef sysmodule = {
1212 PyModuleDef_HEAD_INIT,
1213 "sys",
1214 sys_doc,
1215 0,
1216 sys_methods,
1217 NULL,
1218 NULL,
1219 NULL,
1220 NULL
1221};
1222
1223
1224
Guido van Rossum25ce5661997-08-02 03:10:38 +00001225PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001226_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001227{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001228 PyObject *m, *v, *sysdict;
Fred Drake6d27c1e2000-04-13 20:03:20 +00001229 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001230
Martin v. Löwis1a214512008-06-11 05:26:20 +00001231 m = PyModule_Create(&sysmodule);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00001232 if (m == NULL)
1233 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001234 sysdict = PyModule_GetDict(m);
Christian Heimes7b3ce6a2008-01-31 14:31:45 +00001235#define SET_SYS_FROM_STRING(key, value) \
1236 v = value; \
1237 if (v != NULL) \
1238 PyDict_SetItemString(sysdict, key, v); \
1239 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001240
Neal Norwitz11bd1192005-10-03 00:54:56 +00001241 {
1242 /* XXX: does this work on Win/Win64? (see posix_fstat) */
1243 struct stat sb;
1244 if (fstat(fileno(stdin), &sb) == 0 &&
1245 S_ISDIR(sb.st_mode)) {
Neal Norwitz72c2c062006-03-09 05:58:11 +00001246 /* There's nothing more we can do. */
1247 /* Py_FatalError() will core dump, so just exit. */
1248 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1249 exit(EXIT_FAILURE);
Neal Norwitz11bd1192005-10-03 00:54:56 +00001250 }
1251 }
1252
Nick Coghlane7837002007-12-21 07:31:17 +00001253 /* stdin/stdout/stderr are now set by pythonrun.c */
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001254
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001255 PyDict_SetItemString(sysdict, "__displayhook__",
Christian Heimesdae2a892008-04-19 00:55:37 +00001256 PyDict_GetItemString(sysdict, "displayhook"));
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001257 PyDict_SetItemString(sysdict, "__excepthook__",
Christian Heimesdae2a892008-04-19 00:55:37 +00001258 PyDict_GetItemString(sysdict, "excepthook"));
Christian Heimes7b3ce6a2008-01-31 14:31:45 +00001259 SET_SYS_FROM_STRING("version",
1260 PyUnicode_FromString(Py_GetVersion()));
1261 SET_SYS_FROM_STRING("hexversion",
1262 PyLong_FromLong(PY_VERSION_HEX));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001263 svnversion_init();
Christian Heimes7b3ce6a2008-01-31 14:31:45 +00001264 SET_SYS_FROM_STRING("subversion",
1265 Py_BuildValue("(UUU)", "CPython", branch,
1266 svn_revision));
1267 SET_SYS_FROM_STRING("dont_write_bytecode",
Christian Heimesdae2a892008-04-19 00:55:37 +00001268 PyBool_FromLong(Py_DontWriteBytecodeFlag));
Fred Drake93a20bf2000-04-13 17:44:51 +00001269 /*
1270 * These release level checks are mutually exclusive and cover
1271 * the field, so don't get too fancy with the pre-processor!
1272 */
1273#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001274 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +00001275#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001276 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +00001277#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001278 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +00001279#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +00001280 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +00001281#endif
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001282
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001283 SET_SYS_FROM_STRING("version_info",
Walter Dörwald94093ff2007-06-07 18:41:59 +00001284 Py_BuildValue("iiiUi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +00001285 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +00001286 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +00001287 PY_RELEASE_SERIAL));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001288 SET_SYS_FROM_STRING("api_version",
Christian Heimes217cfd12007-12-02 14:31:20 +00001289 PyLong_FromLong(PYTHON_API_VERSION));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001290 SET_SYS_FROM_STRING("copyright",
Walter Dörwald94093ff2007-06-07 18:41:59 +00001291 PyUnicode_FromString(Py_GetCopyright()));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001292 SET_SYS_FROM_STRING("platform",
Walter Dörwald94093ff2007-06-07 18:41:59 +00001293 PyUnicode_FromString(Py_GetPlatform()));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001294 SET_SYS_FROM_STRING("executable",
Martin v. Löwis790465f2008-04-05 20:41:37 +00001295 PyUnicode_FromWideChar(
1296 Py_GetProgramFullPath(), -1));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001297 SET_SYS_FROM_STRING("prefix",
Martin v. Löwis790465f2008-04-05 20:41:37 +00001298 PyUnicode_FromWideChar(Py_GetPrefix(), -1));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001299 SET_SYS_FROM_STRING("exec_prefix",
Martin v. Löwis790465f2008-04-05 20:41:37 +00001300 PyUnicode_FromWideChar(Py_GetExecPrefix(), -1));
Thomas Woutersd2cf20e2007-08-30 22:57:53 +00001301 SET_SYS_FROM_STRING("maxsize",
Christian Heimes217cfd12007-12-02 14:31:20 +00001302 PyLong_FromSsize_t(PY_SSIZE_T_MAX));
Christian Heimes93852662007-12-01 12:22:32 +00001303 SET_SYS_FROM_STRING("float_info",
1304 PyFloat_GetInfo());
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001305 SET_SYS_FROM_STRING("maxunicode",
Christian Heimes217cfd12007-12-02 14:31:20 +00001306 PyLong_FromLong(PyUnicode_GetMax()));
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001307 SET_SYS_FROM_STRING("builtin_module_names",
1308 list_builtin_module_names());
Fred Drake099325e2000-08-14 15:47:03 +00001309 {
1310 /* Assumes that longs are at least 2 bytes long.
1311 Should be safe! */
1312 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +00001313 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001314
1315 s = (char *) &number;
1316 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +00001317 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +00001318 else
Fred Drakea2b6ad62000-08-15 04:24:43 +00001319 value = "little";
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001320 SET_SYS_FROM_STRING("byteorder",
Walter Dörwald94093ff2007-06-07 18:41:59 +00001321 PyUnicode_FromString(value));
Fred Drake099325e2000-08-14 15:47:03 +00001322 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001323#ifdef MS_COREDLL
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001324 SET_SYS_FROM_STRING("dllhandle",
1325 PyLong_FromVoidPtr(PyWin_DLLhModule));
1326 SET_SYS_FROM_STRING("winver",
Walter Dörwald94093ff2007-06-07 18:41:59 +00001327 PyUnicode_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001328#endif
Guido van Rossum23fff912000-12-15 22:02:05 +00001329 if (warnoptions == NULL) {
1330 warnoptions = PyList_New(0);
1331 }
1332 else {
1333 Py_INCREF(warnoptions);
1334 }
1335 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +00001336 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +00001337 }
Tim Peters216b78b2006-01-06 02:40:53 +00001338
Christian Heimes7b3ce6a2008-01-31 14:31:45 +00001339 if (FlagsType.tp_name == 0)
1340 PyStructSequence_InitType(&FlagsType, &flags_desc);
1341 SET_SYS_FROM_STRING("flags", make_flags());
Christian Heimesd32ed6f2008-01-14 18:49:24 +00001342 /* prevent user from creating new instances */
1343 FlagsType.tp_init = NULL;
1344 FlagsType.tp_new = NULL;
1345
Christian Heimes7b3ce6a2008-01-31 14:31:45 +00001346#undef SET_SYS_FROM_STRING
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001347 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001348 return NULL;
1349 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001350}
1351
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001352static PyObject *
Martin v. Löwis790465f2008-04-05 20:41:37 +00001353makepathobject(const wchar_t *path, wchar_t delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001354{
Guido van Rossum3f5da241990-12-20 15:06:42 +00001355 int i, n;
Martin v. Löwis790465f2008-04-05 20:41:37 +00001356 const wchar_t *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001357 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001358
Guido van Rossum3f5da241990-12-20 15:06:42 +00001359 n = 1;
1360 p = path;
Martin v. Löwis790465f2008-04-05 20:41:37 +00001361 while ((p = wcschr(p, delim)) != NULL) {
Guido van Rossum3f5da241990-12-20 15:06:42 +00001362 n++;
1363 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001364 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001365 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001366 if (v == NULL)
1367 return NULL;
1368 for (i = 0; ; i++) {
Martin v. Löwis790465f2008-04-05 20:41:37 +00001369 p = wcschr(path, delim);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001370 if (p == NULL)
Martin v. Löwis790465f2008-04-05 20:41:37 +00001371 p = wcschr(path, L'\0'); /* End of string */
1372 w = PyUnicode_FromWideChar(path, (Py_ssize_t)(p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +00001373 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001374 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001375 return NULL;
1376 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001377 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001378 if (*p == '\0')
1379 break;
1380 path = p+1;
1381 }
1382 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001383}
1384
1385void
Martin v. Löwis790465f2008-04-05 20:41:37 +00001386PySys_SetPath(const wchar_t *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001387{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001388 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001389 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001390 Py_FatalError("can't create sys.path");
1391 if (PySys_SetObject("path", v) != 0)
1392 Py_FatalError("can't assign sys.path");
1393 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001394}
1395
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001396static PyObject *
Martin v. Löwis790465f2008-04-05 20:41:37 +00001397makeargvobject(int argc, wchar_t **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001398{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001399 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +00001400 if (argc <= 0 || argv == NULL) {
1401 /* Ensure at least one (empty) argument is seen */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001402 static wchar_t *empty_argv[1] = {L""};
Guido van Rossumee3a2991992-01-14 18:42:53 +00001403 argv = empty_argv;
1404 argc = 1;
1405 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001406 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001407 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001408 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001409 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001410#ifdef __VMS
1411 PyObject *v;
1412
1413 /* argv[0] is the script pathname if known */
1414 if (i == 0) {
1415 char* fn = decc$translate_vms(argv[0]);
1416 if ((fn == (char *)0) || fn == (char *)-1)
Guido van Rossum96ca6912007-06-15 03:49:03 +00001417 v = PyUnicode_FromString(argv[0]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001418 else
Guido van Rossum96ca6912007-06-15 03:49:03 +00001419 v = PyUnicode_FromString(
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001420 decc$translate_vms(argv[0]));
1421 } else
Guido van Rossum96ca6912007-06-15 03:49:03 +00001422 v = PyUnicode_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001423#else
Martin v. Löwis790465f2008-04-05 20:41:37 +00001424 PyObject *v = PyUnicode_FromWideChar(argv[i], -1);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001425#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001426 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001427 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001428 av = NULL;
1429 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001430 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001431 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001432 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001433 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001434 return av;
1435}
1436
Martin v. Löwis790465f2008-04-05 20:41:37 +00001437#ifdef HAVE_REALPATH
1438static wchar_t*
1439_wrealpath(const wchar_t *path, wchar_t *resolved_path)
1440{
1441 char cpath[PATH_MAX];
1442 char cresolved_path[PATH_MAX];
1443 char *res;
1444 size_t r;
1445 r = wcstombs(cpath, path, PATH_MAX);
1446 if (r == (size_t)-1 || r >= PATH_MAX) {
1447 errno = EINVAL;
1448 return NULL;
1449 }
1450 res = realpath(cpath, cresolved_path);
1451 if (res == NULL)
1452 return NULL;
1453 r = mbstowcs(resolved_path, cresolved_path, PATH_MAX);
1454 if (r == (size_t)-1 || r >= PATH_MAX) {
1455 errno = EINVAL;
1456 return NULL;
1457 }
1458 return resolved_path;
1459}
1460#endif
1461
Guido van Rossum3f5da241990-12-20 15:06:42 +00001462void
Martin v. Löwis790465f2008-04-05 20:41:37 +00001463PySys_SetArgv(int argc, wchar_t **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001464{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001465#if defined(HAVE_REALPATH)
Martin v. Löwis790465f2008-04-05 20:41:37 +00001466 wchar_t fullpath[MAXPATHLEN];
Guido van Rossum162e38c2003-02-19 15:25:10 +00001467#elif defined(MS_WINDOWS)
Martin v. Löwis790465f2008-04-05 20:41:37 +00001468 wchar_t fullpath[MAX_PATH];
Thomas Heller27bb71e2003-01-08 14:33:48 +00001469#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001470 PyObject *av = makeargvobject(argc, argv);
1471 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001472 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001473 Py_FatalError("no mem for sys.argv");
1474 if (PySys_SetObject("argv", av) != 0)
1475 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +00001476 if (path != NULL) {
Martin v. Löwis790465f2008-04-05 20:41:37 +00001477 wchar_t *argv0 = argv[0];
1478 wchar_t *p = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001479 Py_ssize_t n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001480 PyObject *a;
Martin v. Löwis790465f2008-04-05 20:41:37 +00001481 extern int _Py_wreadlink(const wchar_t *, wchar_t *, size_t);
Guido van Rossumc474dea1997-04-25 15:38:31 +00001482#ifdef HAVE_READLINK
Martin v. Löwis790465f2008-04-05 20:41:37 +00001483 wchar_t link[MAXPATHLEN+1];
1484 wchar_t argv0copy[2*MAXPATHLEN+1];
Guido van Rossumc474dea1997-04-25 15:38:31 +00001485 int nr = 0;
Martin v. Löwis790465f2008-04-05 20:41:37 +00001486 if (argc > 0 && argv0 != NULL && wcscmp(argv0, L"-c") != 0)
1487 nr = _Py_wreadlink(argv0, link, MAXPATHLEN);
Guido van Rossumc474dea1997-04-25 15:38:31 +00001488 if (nr > 0) {
1489 /* It's a symlink */
1490 link[nr] = '\0';
1491 if (link[0] == SEP)
1492 argv0 = link; /* Link to absolute path */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001493 else if (wcschr(link, SEP) == NULL)
Guido van Rossumc474dea1997-04-25 15:38:31 +00001494 ; /* Link without path */
1495 else {
1496 /* Must join(dirname(argv0), link) */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001497 wchar_t *q = wcsrchr(argv0, SEP);
Guido van Rossumc474dea1997-04-25 15:38:31 +00001498 if (q == NULL)
1499 argv0 = link; /* argv0 without path */
1500 else {
1501 /* Must make a copy */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001502 wcscpy(argv0copy, argv0);
1503 q = wcsrchr(argv0copy, SEP);
1504 wcscpy(q+1, link);
Guido van Rossumc474dea1997-04-25 15:38:31 +00001505 argv0 = argv0copy;
1506 }
1507 }
1508 }
1509#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001510#if SEP == '\\' /* Special case for MS filename syntax */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001511 if (argc > 0 && argv0 != NULL && wcscmp(argv0, L"-c") != 0) {
1512 wchar_t *q;
Thomas Heller27bb71e2003-01-08 14:33:48 +00001513#ifdef MS_WINDOWS
Martin v. Löwis790465f2008-04-05 20:41:37 +00001514 wchar_t *ptemp;
1515 if (GetFullPathNameW(argv0,
1516 sizeof(fullpath)/sizeof(fullpath[0]),
Thomas Heller27bb71e2003-01-08 14:33:48 +00001517 fullpath,
1518 &ptemp)) {
1519 argv0 = fullpath;
1520 }
1521#endif
Martin v. Löwis790465f2008-04-05 20:41:37 +00001522 p = wcsrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +00001523 /* Test for alternate separator */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001524 q = wcsrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +00001525 if (q != NULL)
1526 p = q;
1527 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001528 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001529 if (n > 1 && p[-1] != ':')
1530 n--; /* Drop trailing separator */
1531 }
1532 }
1533#else /* All other filename syntaxes */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001534 if (argc > 0 && argv0 != NULL && wcscmp(argv0, L"-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001535#if defined(HAVE_REALPATH)
Martin v. Löwis790465f2008-04-05 20:41:37 +00001536 if (_wrealpath(argv0, fullpath)) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001537 argv0 = fullpath;
1538 }
1539#endif
Martin v. Löwis790465f2008-04-05 20:41:37 +00001540 p = wcsrchr(argv0, SEP);
Guido van Rossum162e38c2003-02-19 15:25:10 +00001541 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001542 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001543 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001544#if SEP == '/' /* Special case for Unix filename syntax */
1545 if (n > 1)
1546 n--; /* Drop trailing separator */
1547#endif /* Unix */
1548 }
1549#endif /* All others */
Martin v. Löwis790465f2008-04-05 20:41:37 +00001550 a = PyUnicode_FromWideChar(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +00001551 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001552 Py_FatalError("no mem for sys.path insertion");
1553 if (PyList_Insert(path, 0, a) < 0)
1554 Py_FatalError("sys.path.insert(0) failed");
1555 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +00001556 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001557 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001558}
Guido van Rossuma890e681998-05-12 14:59:24 +00001559
1560
1561/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1562 Adapted from code submitted by Just van Rossum.
1563
1564 PySys_WriteStdout(format, ...)
1565 PySys_WriteStderr(format, ...)
1566
1567 The first function writes to sys.stdout; the second to sys.stderr. When
1568 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001569 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001570
1571 Both take a printf-style format string as their first argument followed
1572 by a variable length argument list determined by the format string.
1573
1574 *** WARNING ***
1575
1576 The format should limit the total size of the formatted output string to
1577 1000 bytes. In particular, this means that no unrestricted "%s" formats
1578 should occur; these should be limited using "%.<N>s where <N> is a
1579 decimal number calculated so that <N> plus the maximum size of other
1580 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1581 which can print hundreds of digits for very large numbers.
1582
1583 */
1584
1585static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001586mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001587{
1588 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001589 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossumda5b8f22007-06-12 23:30:11 +00001590 char buffer[1001];
1591 int written;
Guido van Rossuma890e681998-05-12 14:59:24 +00001592
Guido van Rossum8442af31998-10-12 18:22:10 +00001593 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001594 file = PySys_GetObject(name);
Guido van Rossumda5b8f22007-06-12 23:30:11 +00001595 written = PyOS_vsnprintf(buffer, sizeof(buffer), format, va);
1596 if (PyFile_WriteString(buffer, file) != 0) {
1597 PyErr_Clear();
1598 fputs(buffer, fp);
1599 }
1600 if (written < 0 || (size_t)written >= sizeof(buffer)) {
1601 const char *truncated = "... truncated";
1602 if (PyFile_WriteString(truncated, file) != 0) {
Guido van Rossuma890e681998-05-12 14:59:24 +00001603 PyErr_Clear();
Guido van Rossumda5b8f22007-06-12 23:30:11 +00001604 fputs(truncated, fp);
Jeremy Hylton5d3d1342001-11-28 21:44:53 +00001605 }
Guido van Rossuma890e681998-05-12 14:59:24 +00001606 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001607 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001608}
1609
1610void
Guido van Rossuma890e681998-05-12 14:59:24 +00001611PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001612{
1613 va_list va;
1614
Guido van Rossuma890e681998-05-12 14:59:24 +00001615 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001616 mywrite("stdout", stdout, format, va);
1617 va_end(va);
1618}
1619
1620void
Guido van Rossuma890e681998-05-12 14:59:24 +00001621PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001622{
1623 va_list va;
1624
Guido van Rossuma890e681998-05-12 14:59:24 +00001625 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001626 mywrite("stderr", stderr, format, va);
1627 va_end(va);
1628}