blob: 27eaad10a013cb74253229b4b199c65b4c3b1e9d [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"
Florent Xicluna8af970a2010-03-03 11:49:53 +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{
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000232 return PyString_FromString(PyUnicode_GetDefaultEncoding());
Fred Drake8b4d01d2000-05-09 19:57:01 +0000233}
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)
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000264 return PyString_FromString(Py_FileSystemDefaultEncoding);
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000265 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) {
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000293 name = PyString_InternFromString(whatnames[i]);
Fred Drake5755ce62001-06-27 19:19:46 +0000294 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\
Eric Smithee931b72010-01-27 00:28:29 +0000560Return information about the running version of Windows as a named tuple.\n\
561The members are named: major, minor, build, platform, service_pack,\n\
562service_pack_major, service_pack_minor, suite_mask, and product_type. For\n\
563backward compatibiliy, only the first 5 items are available by indexing.\n\
564All elements are numbers, except service_pack which is a string. Platform\n\
565may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP/Vista/7,\n\
5663 for Windows CE. Product_type may be 1 for a workstation, 2 for a domain\n\
567controller, 3 for a server."
Mark Hammond8696ebc2002-10-08 02:44:31 +0000568);
569
Eric Smithee931b72010-01-27 00:28:29 +0000570static PyTypeObject WindowsVersionType = {0, 0, 0, 0, 0, 0};
571
572static PyStructSequence_Field windows_version_fields[] = {
573 {"major", "Major version number"},
574 {"minor", "Minor version number"},
575 {"build", "Build number"},
576 {"platform", "Operating system platform"},
577 {"service_pack", "Latest Service Pack installed on the system"},
578 {"service_pack_major", "Service Pack major version number"},
579 {"service_pack_minor", "Service Pack minor version number"},
580 {"suite_mask", "Bit mask identifying available product suites"},
581 {"product_type", "System product type"},
582 {0}
583};
584
585static PyStructSequence_Desc windows_version_desc = {
586 "sys.getwindowsversion", /* name */
587 getwindowsversion_doc, /* doc */
588 windows_version_fields, /* fields */
589 5 /* For backward compatibility,
590 only the first 5 items are accessible
591 via indexing, the rest are name only */
592};
593
Mark Hammond8696ebc2002-10-08 02:44:31 +0000594static PyObject *
595sys_getwindowsversion(PyObject *self)
596{
Eric Smithee931b72010-01-27 00:28:29 +0000597 PyObject *version;
598 int pos = 0;
599 OSVERSIONINFOEX ver;
Mark Hammond8696ebc2002-10-08 02:44:31 +0000600 ver.dwOSVersionInfoSize = sizeof(ver);
Eric Smithee931b72010-01-27 00:28:29 +0000601 if (!GetVersionEx((OSVERSIONINFO*) &ver))
Mark Hammond8696ebc2002-10-08 02:44:31 +0000602 return PyErr_SetFromWindowsErr(0);
Eric Smithee931b72010-01-27 00:28:29 +0000603
604 version = PyStructSequence_New(&WindowsVersionType);
605 if (version == NULL)
606 return NULL;
607
608 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwMajorVersion));
609 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwMinorVersion));
610 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwBuildNumber));
611 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.dwPlatformId));
612 PyStructSequence_SET_ITEM(version, pos++, PyString_FromString(ver.szCSDVersion));
613 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wServicePackMajor));
614 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wServicePackMinor));
615 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wSuiteMask));
616 PyStructSequence_SET_ITEM(version, pos++, PyInt_FromLong(ver.wProductType));
617
618 return version;
Mark Hammond8696ebc2002-10-08 02:44:31 +0000619}
620
621#endif /* MS_WINDOWS */
622
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000623#ifdef HAVE_DLOPEN
624static PyObject *
625sys_setdlopenflags(PyObject *self, PyObject *args)
626{
627 int new_val;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000628 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000629 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
630 return NULL;
631 if (!tstate)
632 return NULL;
633 tstate->interp->dlopenflags = new_val;
634 Py_INCREF(Py_None);
635 return Py_None;
636}
637
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000638PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000639"setdlopenflags(n) -> None\n\
640\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000641Set the flags used by the interpreter for dlopen calls, such as when the\n\
642interpreter loads extension modules. Among other things, this will enable\n\
643a lazy resolving of symbols when importing a module, if called as\n\
644sys.setdlopenflags(0). To share symbols across extension modules, call as\n\
645sys.setdlopenflags(ctypes.RTLD_GLOBAL). Symbolic names for the flag modules\n\
646can be either found in the ctypes module, or in the DLFCN module. If DLFCN\n\
647is not available, it can be generated from /usr/include/dlfcn.h using the\n\
648h2py script.");
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000649
650static PyObject *
651sys_getdlopenflags(PyObject *self, PyObject *args)
652{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000653 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000654 if (!tstate)
655 return NULL;
656 return PyInt_FromLong(tstate->interp->dlopenflags);
657}
658
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000659PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000660"getdlopenflags() -> int\n\
661\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000662Return the current value of the flags that are used for dlopen calls.\n\
663The flag constants are defined in the ctypes and DLFCN modules.");
664
665#endif /* HAVE_DLOPEN */
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000666
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000667#ifdef USE_MALLOPT
668/* Link with -lmalloc (or -lmpc) on an SGI */
669#include <malloc.h>
670
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000671static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000672sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000673{
674 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000675 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000676 return NULL;
677 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000678 Py_INCREF(Py_None);
679 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000680}
681#endif /* USE_MALLOPT */
682
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000683static PyObject *
Robert Schuppenies47629022008-07-10 17:13:55 +0000684sys_getsizeof(PyObject *self, PyObject *args, PyObject *kwds)
Robert Schuppenies51df0642008-06-01 16:16:17 +0000685{
Robert Schuppenies47629022008-07-10 17:13:55 +0000686 PyObject *res = NULL;
Benjamin Petersonaf1692a2009-05-09 16:36:39 +0000687 static PyObject *str__sizeof__ = NULL, *gc_head_size = NULL;
Robert Schuppenies47629022008-07-10 17:13:55 +0000688 static char *kwlist[] = {"object", "default", 0};
689 PyObject *o, *dflt = NULL;
690
691 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:getsizeof",
692 kwlist, &o, &dflt))
693 return NULL;
Robert Schuppenies51df0642008-06-01 16:16:17 +0000694
Robert Schuppenies47629022008-07-10 17:13:55 +0000695 /* Initialize static variable for GC head size */
696 if (gc_head_size == NULL) {
697 gc_head_size = PyInt_FromSsize_t(sizeof(PyGC_Head));
698 if (gc_head_size == NULL)
699 return NULL;
700 }
701
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000702 /* Make sure the type is initialized. float gets initialized late */
Robert Schuppenies47629022008-07-10 17:13:55 +0000703 if (PyType_Ready(Py_TYPE(o)) < 0)
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000704 return NULL;
705
706 /* Instance of old-style class */
Robert Schuppenies47629022008-07-10 17:13:55 +0000707 if (PyInstance_Check(o))
708 res = PyInt_FromSsize_t(PyInstance_Type.tp_basicsize);
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000709 /* all other objects */
710 else {
Benjamin Petersonaf1692a2009-05-09 16:36:39 +0000711 PyObject *method = _PyObject_LookupSpecial(o, "__sizeof__",
712 &str__sizeof__);
Benjamin Peterson87e50062009-05-25 02:40:21 +0000713 if (method == NULL) {
714 if (!PyErr_Occurred())
715 PyErr_Format(PyExc_TypeError,
716 "Type %.100s doesn't define __sizeof__",
717 Py_TYPE(o)->tp_name);
718 }
Benjamin Petersonaf1692a2009-05-09 16:36:39 +0000719 else {
720 res = PyObject_CallFunctionObjArgs(method, NULL);
721 Py_DECREF(method);
722 }
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000723 }
Robert Schuppenies47629022008-07-10 17:13:55 +0000724
725 /* Has a default value been given? */
726 if ((res == NULL) && (dflt != NULL) &&
727 PyErr_ExceptionMatches(PyExc_TypeError))
728 {
729 PyErr_Clear();
730 Py_INCREF(dflt);
731 return dflt;
732 }
733 else if (res == NULL)
734 return res;
735
736 /* add gc_head size */
737 if (PyObject_IS_GC(o)) {
738 PyObject *tmp = res;
739 res = PyNumber_Add(tmp, gc_head_size);
740 Py_DECREF(tmp);
741 }
742 return res;
Robert Schuppenies51df0642008-06-01 16:16:17 +0000743}
744
745PyDoc_STRVAR(getsizeof_doc,
Robert Schuppenies47629022008-07-10 17:13:55 +0000746"getsizeof(object, default) -> int\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +0000747\n\
748Return the size of object in bytes.");
749
750static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000751sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000752{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000753 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000754}
755
Tim Peters4be93d02002-07-07 19:59:50 +0000756#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000757static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000758sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000759{
Armin Rigoe1709372006-04-12 17:06:05 +0000760 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000761}
Armin Rigoe1709372006-04-12 17:06:05 +0000762#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000763
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000764PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000765"getrefcount(object) -> integer\n\
766\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000767Return the reference count of object. The count returned is generally\n\
768one higher than you might expect, because it includes the (temporary)\n\
769reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000770);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000771
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000772#ifdef COUNT_ALLOCS
773static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000774sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000775{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000776 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000777
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000778 return get_counts();
779}
780#endif
781
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000782PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000783"_getframe([depth]) -> frameobject\n\
784\n\
785Return a frame object from the call stack. If optional integer depth is\n\
786given, return the frame object that many calls below the top of the stack.\n\
787If that is deeper than the call stack, ValueError is raised. The default\n\
788for depth is zero, returning the frame at the top of the call stack.\n\
789\n\
790This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000791purposes only."
792);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000793
794static PyObject *
795sys_getframe(PyObject *self, PyObject *args)
796{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000797 PyFrameObject *f = PyThreadState_GET()->frame;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000798 int depth = -1;
799
800 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
801 return NULL;
802
803 while (depth > 0 && f != NULL) {
804 f = f->f_back;
805 --depth;
806 }
807 if (f == NULL) {
808 PyErr_SetString(PyExc_ValueError,
809 "call stack is not deep enough");
810 return NULL;
811 }
812 Py_INCREF(f);
813 return (PyObject*)f;
814}
815
Tim Peters32a83612006-07-10 21:08:24 +0000816PyDoc_STRVAR(current_frames_doc,
817"_current_frames() -> dictionary\n\
818\n\
819Return a dictionary mapping each current thread T's thread id to T's\n\
820current stack frame.\n\
821\n\
822This function should be used for specialized purposes only."
823);
824
825static PyObject *
826sys_current_frames(PyObject *self, PyObject *noargs)
827{
828 return _PyThread_CurrentFrames();
829}
830
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000831PyDoc_STRVAR(call_tracing_doc,
832"call_tracing(func, args) -> object\n\
833\n\
834Call func(*args), while tracing is enabled. The tracing state is\n\
835saved, and restored afterwards. This is intended to be called from\n\
836a debugger from a checkpoint, to recursively debug some other code."
837);
838
839static PyObject *
840sys_call_tracing(PyObject *self, PyObject *args)
841{
842 PyObject *func, *funcargs;
Victor Stinnerb4b0a292010-01-31 22:32:15 +0000843 if (!PyArg_ParseTuple(args, "OO!:call_tracing", &func, &PyTuple_Type, &funcargs))
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000844 return NULL;
845 return _PyEval_CallTracing(func, funcargs);
846}
847
Jeremy Hylton985eba52003-02-05 23:13:00 +0000848PyDoc_STRVAR(callstats_doc,
849"callstats() -> tuple of integers\n\
850\n\
851Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
852when Python was built. Otherwise, return None.\n\
853\n\
854When enabled, this function returns detailed, implementation-specific\n\
855details about the number of function calls executed. The return value is\n\
856a 11-tuple where the entries in the tuple are counts of:\n\
8570. all function calls\n\
8581. calls to PyFunction_Type objects\n\
8592. PyFunction calls that do not create an argument tuple\n\
8603. PyFunction calls that do not create an argument tuple\n\
861 and bypass PyEval_EvalCodeEx()\n\
8624. PyMethod calls\n\
8635. PyMethod calls on bound methods\n\
8646. PyType calls\n\
8657. PyCFunction calls\n\
8668. generator calls\n\
8679. All other calls\n\
86810. Number of stack pops performed by call_function()"
869);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000870
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000871#ifdef __cplusplus
872extern "C" {
873#endif
874
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000875#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000876/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000877extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000878#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000879
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000880#ifdef DYNAMIC_EXECUTION_PROFILE
881/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000882extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000883#endif
884
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000885#ifdef __cplusplus
886}
887#endif
888
Christian Heimes422051a2008-02-04 18:00:12 +0000889static PyObject *
890sys_clear_type_cache(PyObject* self, PyObject* args)
891{
892 PyType_ClearCache();
893 Py_RETURN_NONE;
894}
895
896PyDoc_STRVAR(sys_clear_type_cache__doc__,
897"_clear_type_cache() -> None\n\
898Clear the internal type lookup cache.");
899
900
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000901static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000902 /* Might as well keep this in alphabetic order */
Tim Peters216b78b2006-01-06 02:40:53 +0000903 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
Jeremy Hylton985eba52003-02-05 23:13:00 +0000904 callstats_doc},
Christian Heimes422051a2008-02-04 18:00:12 +0000905 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
906 sys_clear_type_cache__doc__},
Tim Peters32a83612006-07-10 21:08:24 +0000907 {"_current_frames", sys_current_frames, METH_NOARGS,
908 current_frames_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000909 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000910 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
911 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000912 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
Neal Norwitz0c766a02002-03-27 13:03:09 +0000913 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000914#ifdef Py_USING_UNICODE
Tim Peters216b78b2006-01-06 02:40:53 +0000915 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
916 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000917#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000918#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000919 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000920 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000921#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000922#ifdef COUNT_ALLOCS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000923 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000924#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000925#ifdef DYNAMIC_EXECUTION_PROFILE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000926 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000927#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000928#ifdef Py_USING_UNICODE
929 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
Tim Peters216b78b2006-01-06 02:40:53 +0000930 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000931#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000932#ifdef Py_TRACE_REFS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000933 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000934#endif
935#ifdef Py_REF_DEBUG
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000936 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000937#endif
Fred Drakea7688822001-10-24 20:47:48 +0000938 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000939 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000940 getrecursionlimit_doc},
Robert Schuppenies47629022008-07-10 17:13:55 +0000941 {"getsizeof", (PyCFunction)sys_getsizeof,
942 METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000943 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000944#ifdef MS_WINDOWS
945 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
946 getwindowsversion_doc},
947#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000948#ifdef USE_MALLOPT
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000949 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000950#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000951#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000952 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000953 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000954#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000955 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000956 setcheckinterval_doc},
Tim Peterse5e065b2003-07-06 18:36:54 +0000957 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000958 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000959#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000960 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000961 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000962#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000963 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
Georg Brandl56112892008-01-20 13:59:46 +0000964 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000965 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000966 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000967#ifdef WITH_TSC
968 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
969#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000970 {"settrace", sys_settrace, METH_O, settrace_doc},
Georg Brandl56112892008-01-20 13:59:46 +0000971 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000972 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000973 {NULL, NULL} /* sentinel */
974};
975
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000976static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000977list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000978{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000979 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000980 int i;
981 if (list == NULL)
982 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000983 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000984 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000985 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000986 if (name == NULL)
987 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000988 PyList_Append(list, name);
989 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000990 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000991 if (PyList_Sort(list) != 0) {
992 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000993 list = NULL;
994 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000995 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000996 PyObject *v = PyList_AsTuple(list);
997 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000998 list = v;
999 }
Guido van Rossum34679b71993-01-26 13:33:44 +00001000 return list;
1001}
1002
Guido van Rossum23fff912000-12-15 22:02:05 +00001003static PyObject *warnoptions = NULL;
1004
1005void
1006PySys_ResetWarnOptions(void)
1007{
1008 if (warnoptions == NULL || !PyList_Check(warnoptions))
1009 return;
1010 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
1011}
1012
1013void
1014PySys_AddWarnOption(char *s)
1015{
1016 PyObject *str;
1017
1018 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
1019 Py_XDECREF(warnoptions);
1020 warnoptions = PyList_New(0);
1021 if (warnoptions == NULL)
1022 return;
1023 }
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001024 str = PyString_FromString(s);
Guido van Rossum23fff912000-12-15 22:02:05 +00001025 if (str != NULL) {
1026 PyList_Append(warnoptions, str);
1027 Py_DECREF(str);
1028 }
1029}
1030
Brett Cannone9746892008-04-12 23:44:07 +00001031int
1032PySys_HasWarnOptions(void)
1033{
Brett Cannon40f0a872008-04-13 00:18:44 +00001034 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
Brett Cannone9746892008-04-12 23:44:07 +00001035}
1036
Guido van Rossum40552d01998-08-06 03:34:39 +00001037/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
1038 Two literals concatenated works just fine. If you have a K&R compiler
1039 or other abomination that however *does* understand longer strings,
1040 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001041PyDoc_VAR(sys_doc) =
1042PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001043"This module provides access to some objects used or maintained by the\n\
1044interpreter and to functions that interact strongly with the interpreter.\n\
1045\n\
1046Dynamic objects:\n\
1047\n\
1048argv -- command line arguments; argv[0] is the script pathname if known\n\
1049path -- module search path; path[0] is the script directory, else ''\n\
1050modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001051\n\
1052displayhook -- called to show results in an interactive session\n\
1053excepthook -- called to handle any uncaught exception other than SystemExit\n\
1054 To customize printing in an interactive session or to install a custom\n\
1055 top-level exception handler, assign other functions to replace these.\n\
1056\n\
1057exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
1058 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001059\n\
1060stdin -- standard input file object; used by raw_input() and input()\n\
1061stdout -- standard output file object; used by the print statement\n\
1062stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001063 By assigning other file objects (or objects that behave like files)\n\
1064 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001065\n\
1066last_type -- type of last uncaught exception\n\
1067last_value -- value of last uncaught exception\n\
1068last_traceback -- traceback of last uncaught exception\n\
1069 These three are only available in an interactive session after a\n\
1070 traceback has been printed.\n\
1071\n\
1072exc_type -- type of exception currently being handled\n\
1073exc_value -- value of exception currently being handled\n\
1074exc_traceback -- traceback of exception currently being handled\n\
1075 The function exc_info() should be used instead of these three,\n\
1076 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001077"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001078)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001079/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001080PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001081"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001082Static objects:\n\
1083\n\
Mark Dickinsonefc82f72009-03-20 15:51:55 +00001084float_info -- a dict with information about the float inplementation.\n\
1085long_info -- a struct sequence with information about the long implementation.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001086maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwis4dd019f2008-05-20 08:11:19 +00001087maxsize -- the largest supported length of containers.\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +00001088maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +00001089builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001090version -- the version of this interpreter as a string\n\
Eric Smith81fe0932009-02-06 00:48:26 +00001091version_info -- version information as a named tuple\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001092hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001093copyright -- copyright notice pertaining to this interpreter\n\
1094platform -- platform identifier\n\
1095executable -- pathname of this Python interpreter\n\
1096prefix -- prefix used to find the Python library\n\
1097exec_prefix -- prefix used to find the machine-specific Python library\n\
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001098float_repr_style -- string indicating the style of repr() output for floats\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001099"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001100)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001101#ifdef MS_WINDOWS
1102/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001103PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001104"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001105winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001106"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001107)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001108#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001109PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001110"__stdin__ -- the original stdin; don't touch!\n\
1111__stdout__ -- the original stdout; don't touch!\n\
1112__stderr__ -- the original stderr; don't touch!\n\
1113__displayhook__ -- the original displayhook; don't touch!\n\
1114__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001115\n\
1116Functions:\n\
1117\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +00001118displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001119excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001120exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +00001121exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001122exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001123getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Georg Brandl56112892008-01-20 13:59:46 +00001124getprofile() -- get the global profiling function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001125getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001126getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +00001127getsizeof() -- return the size of an object in bytes\n\
Georg Brandl56112892008-01-20 13:59:46 +00001128gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001129setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001130setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001131setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001132setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001133settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001134"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001135)
Fred Drakeccede592000-08-14 20:59:57 +00001136/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001137
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001138static int
1139_check_and_flush (FILE *stream)
1140{
1141 int prev_fail = ferror (stream);
1142 return fflush (stream) || prev_fail ? EOF : 0;
1143}
1144
Martin v. Löwis43b57802006-01-05 23:38:54 +00001145/* Subversion branch and revision management */
1146static const char _patchlevel_revision[] = PY_PATCHLEVEL_REVISION;
1147static const char headurl[] = "$HeadURL$";
1148static int svn_initialized;
1149static char patchlevel_revision[50]; /* Just the number */
1150static char branch[50];
1151static char shortbranch[50];
1152static const char *svn_revision;
1153
Tim Peterse86e7a52006-01-06 02:42:46 +00001154static void
1155svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001156{
1157 const char *python, *br_start, *br_end, *br_end2, *svnversion;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001158 Py_ssize_t len;
1159 int istag;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001160
1161 if (svn_initialized)
1162 return;
1163
1164 python = strstr(headurl, "/python/");
Christian Heimes6a453c32008-03-24 19:57:42 +00001165 if (!python) {
1166 /* XXX quick hack to get bzr working */
1167 *patchlevel_revision = '\0';
1168 strcpy(branch, "");
1169 strcpy(shortbranch, "unknown");
1170 svn_revision = "";
Christian Heimesa113bd92008-03-24 19:58:17 +00001171 return;
1172 /* Py_FatalError("subversion keywords missing"); */
Christian Heimes6a453c32008-03-24 19:57:42 +00001173 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001174
1175 br_start = python + 8;
1176 br_end = strchr(br_start, '/');
Neal Norwitz837ce932006-10-28 21:15:30 +00001177 assert(br_end);
1178
Tim Peters216b78b2006-01-06 02:40:53 +00001179 /* Works even for trunk,
Martin v. Löwis43b57802006-01-05 23:38:54 +00001180 as we are in trunk/Python/sysmodule.c */
1181 br_end2 = strchr(br_end+1, '/');
1182
1183 istag = strncmp(br_start, "tags", 4) == 0;
1184 if (strncmp(br_start, "trunk", 5) == 0) {
1185 strcpy(branch, "trunk");
1186 strcpy(shortbranch, "trunk");
1187
Tim Peters216b78b2006-01-06 02:40:53 +00001188 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001189 else if (istag || strncmp(br_start, "branches", 8) == 0) {
1190 len = br_end2 - br_start;
1191 strncpy(branch, br_start, len);
1192 branch[len] = '\0';
1193
1194 len = br_end2 - (br_end + 1);
1195 strncpy(shortbranch, br_end + 1, len);
1196 shortbranch[len] = '\0';
Tim Peters216b78b2006-01-06 02:40:53 +00001197 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001198 else {
Christian Heimesaf748c32008-05-06 22:41:46 +00001199 Py_FatalError("bad HeadURL");
Martin v. Löwis43b57802006-01-05 23:38:54 +00001200 return;
1201 }
1202
1203
1204 svnversion = _Py_svnversion();
Benjamin Petersone5afa3b2009-05-23 19:24:37 +00001205 if (strcmp(svnversion, "Unversioned directory") != 0 && strcmp(svnversion, "exported") != 0)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001206 svn_revision = svnversion;
1207 else if (istag) {
1208 len = strlen(_patchlevel_revision);
Neal Norwitz68cdf8a2007-04-16 07:37:55 +00001209 assert(len >= 13);
1210 assert(len < (sizeof(patchlevel_revision) + 13));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001211 strncpy(patchlevel_revision, _patchlevel_revision + 11,
1212 len - 13);
1213 patchlevel_revision[len - 13] = '\0';
1214 svn_revision = patchlevel_revision;
1215 }
1216 else
1217 svn_revision = "";
Tim Peters216b78b2006-01-06 02:40:53 +00001218
Martin v. Löwis43b57802006-01-05 23:38:54 +00001219 svn_initialized = 1;
1220}
1221
1222/* Return svnversion output if available.
1223 Else return Revision of patchlevel.h if on branch.
1224 Else return empty string */
1225const char*
1226Py_SubversionRevision()
1227{
1228 svnversion_init();
1229 return svn_revision;
1230}
1231
1232const char*
1233Py_SubversionShortBranch()
1234{
1235 svnversion_init();
1236 return shortbranch;
1237}
1238
Christian Heimesf31b69f2008-01-14 03:42:48 +00001239
1240PyDoc_STRVAR(flags__doc__,
1241"sys.flags\n\
1242\n\
1243Flags provided through command line arguments or environment vars.");
1244
Christian Heimes796fc312008-01-30 18:58:29 +00001245static PyTypeObject FlagsType = {0, 0, 0, 0, 0, 0};
Christian Heimesf31b69f2008-01-14 03:42:48 +00001246
1247static PyStructSequence_Field flags_fields[] = {
1248 {"debug", "-d"},
1249 {"py3k_warning", "-3"},
1250 {"division_warning", "-Q"},
1251 {"division_new", "-Qnew"},
1252 {"inspect", "-i"},
1253 {"interactive", "-i"},
1254 {"optimize", "-O or -OO"},
1255 {"dont_write_bytecode", "-B"},
Christian Heimesaf748c32008-05-06 22:41:46 +00001256 {"no_user_site", "-s"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001257 {"no_site", "-S"},
Andrew M. Kuchling7ce9b182008-01-15 01:29:16 +00001258 {"ignore_environment", "-E"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001259 {"tabcheck", "-t or -tt"},
1260 {"verbose", "-v"},
1261#ifdef RISCOS
Andrew M. Kuchling7ce9b182008-01-15 01:29:16 +00001262 {"riscos_wimp", "???"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001263#endif
1264 /* {"unbuffered", "-u"}, */
1265 {"unicode", "-U"},
1266 /* {"skip_first", "-x"}, */
Brett Cannone9746892008-04-12 23:44:07 +00001267 {"bytes_warning", "-b"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001268 {0}
1269};
1270
1271static PyStructSequence_Desc flags_desc = {
1272 "sys.flags", /* name */
1273 flags__doc__, /* doc */
1274 flags_fields, /* fields */
1275#ifdef RISCOS
Brett Cannonbe1501b2008-05-08 20:23:06 +00001276 16
Christian Heimesf31b69f2008-01-14 03:42:48 +00001277#else
Brett Cannonbe1501b2008-05-08 20:23:06 +00001278 15
Christian Heimesf31b69f2008-01-14 03:42:48 +00001279#endif
1280};
1281
1282static PyObject*
1283make_flags(void)
1284{
1285 int pos = 0;
1286 PyObject *seq;
1287
1288 seq = PyStructSequence_New(&FlagsType);
1289 if (seq == NULL)
1290 return NULL;
1291
1292#define SetFlag(flag) \
1293 PyStructSequence_SET_ITEM(seq, pos++, PyInt_FromLong(flag))
1294
1295 SetFlag(Py_DebugFlag);
1296 SetFlag(Py_Py3kWarningFlag);
1297 SetFlag(Py_DivisionWarningFlag);
1298 SetFlag(_Py_QnewFlag);
1299 SetFlag(Py_InspectFlag);
1300 SetFlag(Py_InteractiveFlag);
1301 SetFlag(Py_OptimizeFlag);
1302 SetFlag(Py_DontWriteBytecodeFlag);
Christian Heimesaf748c32008-05-06 22:41:46 +00001303 SetFlag(Py_NoUserSiteDirectory);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001304 SetFlag(Py_NoSiteFlag);
1305 SetFlag(Py_IgnoreEnvironmentFlag);
1306 SetFlag(Py_TabcheckFlag);
1307 SetFlag(Py_VerboseFlag);
1308#ifdef RISCOS
1309 SetFlag(Py_RISCOSWimpFlag);
1310#endif
1311 /* SetFlag(saw_unbuffered_flag); */
1312 SetFlag(Py_UnicodeFlag);
1313 /* SetFlag(skipfirstline); */
Brett Cannone9746892008-04-12 23:44:07 +00001314 SetFlag(Py_BytesWarningFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001315#undef SetFlag
1316
1317 if (PyErr_Occurred()) {
1318 return NULL;
1319 }
Christian Heimesf31b69f2008-01-14 03:42:48 +00001320 return seq;
1321}
1322
Eric Smith81fe0932009-02-06 00:48:26 +00001323PyDoc_STRVAR(version_info__doc__,
1324"sys.version_info\n\
1325\n\
1326Version information as a named tuple.");
1327
1328static PyTypeObject VersionInfoType = {0, 0, 0, 0, 0, 0};
1329
1330static PyStructSequence_Field version_info_fields[] = {
1331 {"major", "Major release number"},
1332 {"minor", "Minor release number"},
1333 {"micro", "Patch release number"},
1334 {"releaselevel", "'alpha', 'beta', 'candidate', or 'release'"},
1335 {"serial", "Serial release number"},
1336 {0}
1337};
1338
1339static PyStructSequence_Desc version_info_desc = {
1340 "sys.version_info", /* name */
1341 version_info__doc__, /* doc */
1342 version_info_fields, /* fields */
1343 5
1344};
1345
1346static PyObject *
1347make_version_info(void)
1348{
1349 PyObject *version_info;
1350 char *s;
1351 int pos = 0;
1352
1353 version_info = PyStructSequence_New(&VersionInfoType);
1354 if (version_info == NULL) {
1355 return NULL;
1356 }
1357
1358 /*
1359 * These release level checks are mutually exclusive and cover
1360 * the field, so don't get too fancy with the pre-processor!
1361 */
1362#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
1363 s = "alpha";
1364#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
1365 s = "beta";
1366#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
1367 s = "candidate";
1368#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
1369 s = "final";
1370#endif
1371
1372#define SetIntItem(flag) \
1373 PyStructSequence_SET_ITEM(version_info, pos++, PyInt_FromLong(flag))
1374#define SetStrItem(flag) \
1375 PyStructSequence_SET_ITEM(version_info, pos++, PyString_FromString(flag))
1376
1377 SetIntItem(PY_MAJOR_VERSION);
1378 SetIntItem(PY_MINOR_VERSION);
1379 SetIntItem(PY_MICRO_VERSION);
1380 SetStrItem(s);
1381 SetIntItem(PY_RELEASE_SERIAL);
1382#undef SetIntItem
1383#undef SetStrItem
1384
1385 if (PyErr_Occurred()) {
1386 Py_CLEAR(version_info);
1387 return NULL;
1388 }
1389 return version_info;
1390}
1391
Guido van Rossum25ce5661997-08-02 03:10:38 +00001392PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001393_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001394{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001395 PyObject *m, *v, *sysdict;
1396 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +00001397 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001398
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001399 m = Py_InitModule3("sys", sys_methods, sys_doc);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00001400 if (m == NULL)
1401 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001402 sysdict = PyModule_GetDict(m);
Christian Heimes0d924432008-01-30 17:21:22 +00001403#define SET_SYS_FROM_STRING(key, value) \
1404 v = value; \
1405 if (v != NULL) \
1406 PyDict_SetItemString(sysdict, key, v); \
1407 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001408
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001409 /* Check that stdin is not a directory
1410 Using shell redirection, you can redirect stdin to a directory,
1411 crashing the Python interpreter. Catch this common mistake here
1412 and output a useful error message. Note that under MS Windows,
1413 the shell already prevents that. */
1414#if !defined(MS_WINDOWS)
Neal Norwitz11bd1192005-10-03 00:54:56 +00001415 {
Neal Norwitz11bd1192005-10-03 00:54:56 +00001416 struct stat sb;
1417 if (fstat(fileno(stdin), &sb) == 0 &&
1418 S_ISDIR(sb.st_mode)) {
Neal Norwitz72c2c062006-03-09 05:58:11 +00001419 /* There's nothing more we can do. */
1420 /* Py_FatalError() will core dump, so just exit. */
1421 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1422 exit(EXIT_FAILURE);
Neal Norwitz11bd1192005-10-03 00:54:56 +00001423 }
1424 }
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001425#endif
Neal Norwitz11bd1192005-10-03 00:54:56 +00001426
Martin v. Löwis13a1fde2005-01-27 18:56:16 +00001427 /* Closing the standard FILE* if sys.std* goes aways causes problems
1428 * for embedded Python usages. Closing them when somebody explicitly
1429 * invokes .close() might be possible, but the FAQ promises they get
1430 * never closed. However, we still need to get write errors when
1431 * writing fails (e.g. because stdout is redirected), so we flush the
1432 * streams and check for errors before the file objects are deleted.
1433 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1434 * from that procedure.
1435 */
1436 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001437 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1438 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001439 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001440 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001441
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001442 PyDict_SetItemString(sysdict, "stdin", sysin);
1443 PyDict_SetItemString(sysdict, "stdout", sysout);
1444 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +00001445 /* Make backup copies for cleanup */
1446 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1447 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1448 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001449 PyDict_SetItemString(sysdict, "__displayhook__",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001450 PyDict_GetItemString(sysdict, "displayhook"));
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001451 PyDict_SetItemString(sysdict, "__excepthook__",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001452 PyDict_GetItemString(sysdict, "excepthook"));
Guido van Rossum25ce5661997-08-02 03:10:38 +00001453 Py_XDECREF(sysin);
1454 Py_XDECREF(sysout);
1455 Py_XDECREF(syserr);
Christian Heimes0d924432008-01-30 17:21:22 +00001456
1457 SET_SYS_FROM_STRING("version",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001458 PyString_FromString(Py_GetVersion()));
Christian Heimes0d924432008-01-30 17:21:22 +00001459 SET_SYS_FROM_STRING("hexversion",
1460 PyInt_FromLong(PY_VERSION_HEX));
Martin v. Löwis43b57802006-01-05 23:38:54 +00001461 svnversion_init();
Christian Heimes0d924432008-01-30 17:21:22 +00001462 SET_SYS_FROM_STRING("subversion",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001463 Py_BuildValue("(ssz)", "CPython", branch,
Christian Heimes0d924432008-01-30 17:21:22 +00001464 svn_revision));
1465 SET_SYS_FROM_STRING("dont_write_bytecode",
Benjamin Peterson858a7702008-04-18 20:45:33 +00001466 PyBool_FromLong(Py_DontWriteBytecodeFlag));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001467 SET_SYS_FROM_STRING("api_version",
1468 PyInt_FromLong(PYTHON_API_VERSION));
1469 SET_SYS_FROM_STRING("copyright",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001470 PyString_FromString(Py_GetCopyright()));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001471 SET_SYS_FROM_STRING("platform",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001472 PyString_FromString(Py_GetPlatform()));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001473 SET_SYS_FROM_STRING("executable",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001474 PyString_FromString(Py_GetProgramFullPath()));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001475 SET_SYS_FROM_STRING("prefix",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001476 PyString_FromString(Py_GetPrefix()));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001477 SET_SYS_FROM_STRING("exec_prefix",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001478 PyString_FromString(Py_GetExecPrefix()));
Martin v. Löwis4dd019f2008-05-20 08:11:19 +00001479 SET_SYS_FROM_STRING("maxsize",
1480 PyInt_FromSsize_t(PY_SSIZE_T_MAX));
Neal Norwitze1fdb322006-07-21 05:32:28 +00001481 SET_SYS_FROM_STRING("maxint",
1482 PyInt_FromLong(PyInt_GetMax()));
Christian Heimes28104c52007-11-27 23:16:44 +00001483 SET_SYS_FROM_STRING("py3kwarning",
1484 PyBool_FromLong(Py_Py3kWarningFlag));
Christian Heimesdfdfaab2007-12-01 11:20:10 +00001485 SET_SYS_FROM_STRING("float_info",
1486 PyFloat_GetInfo());
Mark Dickinsonefc82f72009-03-20 15:51:55 +00001487 SET_SYS_FROM_STRING("long_info",
1488 PyLong_GetInfo());
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001489#ifdef Py_USING_UNICODE
Neal Norwitze1fdb322006-07-21 05:32:28 +00001490 SET_SYS_FROM_STRING("maxunicode",
1491 PyInt_FromLong(PyUnicode_GetMax()));
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001492#endif
Neal Norwitze1fdb322006-07-21 05:32:28 +00001493 SET_SYS_FROM_STRING("builtin_module_names",
1494 list_builtin_module_names());
Fred Drake099325e2000-08-14 15:47:03 +00001495 {
1496 /* Assumes that longs are at least 2 bytes long.
1497 Should be safe! */
1498 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +00001499 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001500
1501 s = (char *) &number;
1502 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +00001503 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +00001504 else
Fred Drakea2b6ad62000-08-15 04:24:43 +00001505 value = "little";
Neal Norwitze1fdb322006-07-21 05:32:28 +00001506 SET_SYS_FROM_STRING("byteorder",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001507 PyString_FromString(value));
Fred Drake099325e2000-08-14 15:47:03 +00001508 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001509#ifdef MS_COREDLL
Neal Norwitze1fdb322006-07-21 05:32:28 +00001510 SET_SYS_FROM_STRING("dllhandle",
1511 PyLong_FromVoidPtr(PyWin_DLLhModule));
1512 SET_SYS_FROM_STRING("winver",
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001513 PyString_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001514#endif
Guido van Rossum23fff912000-12-15 22:02:05 +00001515 if (warnoptions == NULL) {
1516 warnoptions = PyList_New(0);
1517 }
1518 else {
1519 Py_INCREF(warnoptions);
1520 }
1521 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +00001522 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +00001523 }
Tim Peters216b78b2006-01-06 02:40:53 +00001524
Eric Smith81fe0932009-02-06 00:48:26 +00001525 /* version_info */
1526 if (VersionInfoType.tp_name == 0)
1527 PyStructSequence_InitType(&VersionInfoType, &version_info_desc);
1528 SET_SYS_FROM_STRING("version_info", make_version_info());
1529 /* prevent user from creating new instances */
1530 VersionInfoType.tp_init = NULL;
1531 VersionInfoType.tp_new = NULL;
1532
1533 /* flags */
Christian Heimes796fc312008-01-30 18:58:29 +00001534 if (FlagsType.tp_name == 0)
1535 PyStructSequence_InitType(&FlagsType, &flags_desc);
Christian Heimes0d924432008-01-30 17:21:22 +00001536 SET_SYS_FROM_STRING("flags", make_flags());
Christian Heimesf31b69f2008-01-14 03:42:48 +00001537 /* prevent user from creating new instances */
1538 FlagsType.tp_init = NULL;
1539 FlagsType.tp_new = NULL;
1540
Eric Smithee931b72010-01-27 00:28:29 +00001541
1542#if defined(MS_WINDOWS)
1543 /* getwindowsversion */
1544 if (WindowsVersionType.tp_name == 0)
1545 PyStructSequence_InitType(&WindowsVersionType, &windows_version_desc);
1546 /* prevent user from creating new instances */
1547 WindowsVersionType.tp_init = NULL;
1548 WindowsVersionType.tp_new = NULL;
1549#endif
1550
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001551 /* float repr style: 0.03 (short) vs 0.029999999999999999 (legacy) */
1552#ifndef PY_NO_SHORT_FLOAT_REPR
1553 SET_SYS_FROM_STRING("float_repr_style",
1554 PyString_FromString("short"));
1555#else
1556 SET_SYS_FROM_STRING("float_repr_style",
1557 PyString_FromString("legacy"));
1558#endif
1559
Christian Heimes0d924432008-01-30 17:21:22 +00001560#undef SET_SYS_FROM_STRING
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001561 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001562 return NULL;
1563 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001564}
1565
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001566static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001567makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001568{
Guido van Rossum3f5da241990-12-20 15:06:42 +00001569 int i, n;
1570 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001571 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001572
Guido van Rossum3f5da241990-12-20 15:06:42 +00001573 n = 1;
1574 p = path;
1575 while ((p = strchr(p, delim)) != NULL) {
1576 n++;
1577 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001578 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001579 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001580 if (v == NULL)
1581 return NULL;
1582 for (i = 0; ; i++) {
1583 p = strchr(path, delim);
1584 if (p == NULL)
1585 p = strchr(path, '\0'); /* End of string */
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001586 w = PyString_FromStringAndSize(path, (Py_ssize_t) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +00001587 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001588 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001589 return NULL;
1590 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001591 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001592 if (*p == '\0')
1593 break;
1594 path = p+1;
1595 }
1596 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001597}
1598
1599void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001600PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001601{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001602 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001603 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001604 Py_FatalError("can't create sys.path");
1605 if (PySys_SetObject("path", v) != 0)
1606 Py_FatalError("can't assign sys.path");
1607 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001608}
1609
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001610static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001611makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001612{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001613 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +00001614 if (argc <= 0 || argv == NULL) {
1615 /* Ensure at least one (empty) argument is seen */
1616 static char *empty_argv[1] = {""};
1617 argv = empty_argv;
1618 argc = 1;
1619 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001620 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001621 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001622 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001623 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001624#ifdef __VMS
1625 PyObject *v;
1626
1627 /* argv[0] is the script pathname if known */
1628 if (i == 0) {
1629 char* fn = decc$translate_vms(argv[0]);
1630 if ((fn == (char *)0) || fn == (char *)-1)
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001631 v = PyString_FromString(argv[0]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001632 else
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001633 v = PyString_FromString(
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001634 decc$translate_vms(argv[0]));
1635 } else
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001636 v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001637#else
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001638 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001639#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001640 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001641 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001642 av = NULL;
1643 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001644 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001645 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001646 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001647 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001648 return av;
1649}
1650
1651void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001652PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001653{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001654#if defined(HAVE_REALPATH)
1655 char fullpath[MAXPATHLEN];
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001656#elif defined(MS_WINDOWS) && !defined(MS_WINCE)
Thomas Heller27bb71e2003-01-08 14:33:48 +00001657 char fullpath[MAX_PATH];
1658#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001659 PyObject *av = makeargvobject(argc, argv);
1660 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001661 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001662 Py_FatalError("no mem for sys.argv");
1663 if (PySys_SetObject("argv", av) != 0)
1664 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +00001665 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001666 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +00001667 char *p = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001668 Py_ssize_t n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001669 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001670#ifdef HAVE_READLINK
1671 char link[MAXPATHLEN+1];
1672 char argv0copy[2*MAXPATHLEN+1];
1673 int nr = 0;
Georg Brandl69537722005-09-15 13:00:34 +00001674 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
Guido van Rossumc474dea1997-04-25 15:38:31 +00001675 nr = readlink(argv0, link, MAXPATHLEN);
1676 if (nr > 0) {
1677 /* It's a symlink */
1678 link[nr] = '\0';
1679 if (link[0] == SEP)
1680 argv0 = link; /* Link to absolute path */
1681 else if (strchr(link, SEP) == NULL)
1682 ; /* Link without path */
1683 else {
1684 /* Must join(dirname(argv0), link) */
1685 char *q = strrchr(argv0, SEP);
1686 if (q == NULL)
1687 argv0 = link; /* argv0 without path */
1688 else {
1689 /* Must make a copy */
1690 strcpy(argv0copy, argv0);
1691 q = strrchr(argv0copy, SEP);
1692 strcpy(q+1, link);
1693 argv0 = argv0copy;
1694 }
1695 }
1696 }
1697#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001698#if SEP == '\\' /* Special case for MS filename syntax */
Georg Brandl69537722005-09-15 13:00:34 +00001699 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossumcc883411996-09-10 14:44:21 +00001700 char *q;
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001701#if defined(MS_WINDOWS) && !defined(MS_WINCE)
1702 /* This code here replaces the first element in argv with the full
1703 path that it represents. Under CE, there are no relative paths so
1704 the argument must be the full path anyway. */
Thomas Heller27bb71e2003-01-08 14:33:48 +00001705 char *ptemp;
1706 if (GetFullPathName(argv0,
1707 sizeof(fullpath),
1708 fullpath,
1709 &ptemp)) {
1710 argv0 = fullpath;
1711 }
1712#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001713 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +00001714 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +00001715 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +00001716 if (q != NULL)
1717 p = q;
1718 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001719 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001720 if (n > 1 && p[-1] != ':')
1721 n--; /* Drop trailing separator */
1722 }
1723 }
1724#else /* All other filename syntaxes */
Georg Brandl69537722005-09-15 13:00:34 +00001725 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001726#if defined(HAVE_REALPATH)
1727 if (realpath(argv0, fullpath)) {
1728 argv0 = fullpath;
1729 }
1730#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001731 p = strrchr(argv0, SEP);
Guido van Rossum162e38c2003-02-19 15:25:10 +00001732 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001733 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001734#ifndef RISCOS
Guido van Rossumc474dea1997-04-25 15:38:31 +00001735 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001736#else /* don't include trailing separator */
1737 n = p - argv0;
1738#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001739#if SEP == '/' /* Special case for Unix filename syntax */
1740 if (n > 1)
1741 n--; /* Drop trailing separator */
1742#endif /* Unix */
1743 }
1744#endif /* All others */
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001745 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +00001746 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001747 Py_FatalError("no mem for sys.path insertion");
1748 if (PyList_Insert(path, 0, a) < 0)
1749 Py_FatalError("sys.path.insert(0) failed");
1750 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +00001751 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001752 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001753}
Guido van Rossuma890e681998-05-12 14:59:24 +00001754
1755
1756/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1757 Adapted from code submitted by Just van Rossum.
1758
1759 PySys_WriteStdout(format, ...)
1760 PySys_WriteStderr(format, ...)
1761
1762 The first function writes to sys.stdout; the second to sys.stderr. When
1763 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001764 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001765
1766 Both take a printf-style format string as their first argument followed
1767 by a variable length argument list determined by the format string.
1768
1769 *** WARNING ***
1770
1771 The format should limit the total size of the formatted output string to
1772 1000 bytes. In particular, this means that no unrestricted "%s" formats
1773 should occur; these should be limited using "%.<N>s where <N> is a
1774 decimal number calculated so that <N> plus the maximum size of other
1775 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1776 which can print hundreds of digits for very large numbers.
1777
1778 */
1779
1780static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001781mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001782{
1783 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001784 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001785
Guido van Rossum8442af31998-10-12 18:22:10 +00001786 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001787 file = PySys_GetObject(name);
1788 if (file == NULL || PyFile_AsFile(file) == fp)
1789 vfprintf(fp, format, va);
1790 else {
1791 char buffer[1001];
Tim Peters080d5b32001-12-02 08:29:16 +00001792 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1793 format, va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001794 if (PyFile_WriteString(buffer, file) != 0) {
1795 PyErr_Clear();
1796 fputs(buffer, fp);
1797 }
Skip Montanaro53a6d1d2006-04-18 00:55:46 +00001798 if (written < 0 || (size_t)written >= sizeof(buffer)) {
Jeremy Hylton5d3d1342001-11-28 21:44:53 +00001799 const char *truncated = "... truncated";
1800 if (PyFile_WriteString(truncated, file) != 0) {
1801 PyErr_Clear();
1802 fputs(truncated, fp);
1803 }
1804 }
Guido van Rossuma890e681998-05-12 14:59:24 +00001805 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001806 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001807}
1808
1809void
Guido van Rossuma890e681998-05-12 14:59:24 +00001810PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001811{
1812 va_list va;
1813
Guido van Rossuma890e681998-05-12 14:59:24 +00001814 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001815 mywrite("stdout", stdout, format, va);
1816 va_end(va);
1817}
1818
1819void
Guido van Rossuma890e681998-05-12 14:59:24 +00001820PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001821{
1822 va_list va;
1823
Guido van Rossuma890e681998-05-12 14:59:24 +00001824 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001825 mywrite("stderr", stderr, format, va);
1826 va_end(va);
1827}