blob: 5cab14923ab365f1388a445b3477a1ad50168eec [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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000052 PyThreadState *tstate = PyThreadState_GET();
53 PyObject *sd = tstate->interp->sysdict;
54 if (sd == NULL)
55 return NULL;
56 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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000062 FILE *fp = NULL;
63 PyObject *v = PySys_GetObject(name);
64 if (v != NULL && PyFile_Check(v))
65 fp = PyFile_AsFile(v);
66 if (fp == NULL)
67 fp = def;
68 return fp;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000069}
70
71int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000072PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000073{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000074 PyThreadState *tstate = PyThreadState_GET();
75 PyObject *sd = tstate->interp->sysdict;
76 if (v == NULL) {
77 if (PyDict_GetItemString(sd, name) == NULL)
78 return 0;
79 else
80 return PyDict_DelItemString(sd, name);
81 }
82 else
83 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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +000089 PyObject *outf;
90 PyInterpreterState *interp = PyThreadState_GET()->interp;
91 PyObject *modules = interp->modules;
92 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000093
Antoine Pitrouc83ea132010-05-09 14:46:46 +000094 if (builtins == NULL) {
95 PyErr_SetString(PyExc_RuntimeError, "lost __builtin__");
96 return NULL;
97 }
Moshe Zadka03897ea2001-07-23 13:32:43 +000098
Antoine Pitrouc83ea132010-05-09 14:46:46 +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;
110 outf = PySys_GetObject("stdout");
111 if (outf == NULL) {
112 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
113 return NULL;
114 }
115 if (PyFile_WriteObject(o, outf, 0) != 0)
116 return NULL;
117 PyFile_SoftSpace(outf, 1);
118 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;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000124}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000135 PyObject *exc, *value, *tb;
136 if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb))
137 return NULL;
138 PyErr_Display(exc, value, tb);
139 Py_INCREF(Py_None);
140 return Py_None;
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000141}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000152 PyThreadState *tstate;
153 tstate = PyThreadState_GET();
154 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);
Guido van Rossuma027efa1997-05-05 20:56:21 +0000160}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000172 PyThreadState *tstate;
173 PyObject *tmp_type, *tmp_value, *tmp_tb;
Georg Brandl5a444242008-03-21 20:11:46 +0000174
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000175 if (PyErr_WarnPy3k("sys.exc_clear() not supported in 3.x; "
176 "use except clauses", 1) < 0)
177 return NULL;
Georg Brandl5a444242008-03-21 20:11:46 +0000178
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000179 tstate = PyThreadState_GET();
180 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;
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000195}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000209 PyObject *exit_code = 0;
210 if (!PyArg_UnpackTuple(args, "exit", 0, 1, &exit_code))
211 return NULL;
212 /* Raise SystemExit so callers may catch it or clean up. */
213 PyErr_SetObject(PyExc_SystemExit, exit_code);
214 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\
Ezio Melotti08350fb2013-08-26 14:00:39 +0300222If the status is an integer, 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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000245 char *encoding;
246 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
247 return NULL;
248 if (PyUnicode_SetDefaultEncoding(encoding))
249 return NULL;
250 Py_INCREF(Py_None);
251 return Py_None;
Fred Drake8b4d01d2000-05-09 19:57:01 +0000252}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000263 if (Py_FileSystemDefaultEncoding)
264 return PyString_FromString(Py_FileSystemDefaultEncoding);
265 Py_INCREF(Py_None);
266 return Py_None;
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000267}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000287 static char *whatnames[7] = {"call", "exception", "line", "return",
288 "c_call", "c_exception", "c_return"};
289 PyObject *name;
290 int i;
291 for (i = 0; i < 7; ++i) {
292 if (whatstrings[i] == NULL) {
293 name = PyString_InternFromString(whatnames[i]);
294 if (name == NULL)
295 return -1;
296 whatstrings[i] = name;
297 }
298 }
299 return 0;
Fred Drake5755ce62001-06-27 19:19:46 +0000300}
301
302
303static PyObject *
304call_trampoline(PyThreadState *tstate, PyObject* callback,
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000305 PyFrameObject *frame, int what, PyObject *arg)
Fred Drake5755ce62001-06-27 19:19:46 +0000306{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000307 PyObject *args = PyTuple_New(3);
308 PyObject *whatstr;
309 PyObject *result;
Fred Drake5755ce62001-06-27 19:19:46 +0000310
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000311 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);
Fred Drake5755ce62001-06-27 19:19:46 +0000322
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000323 /* 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);
Fred Drake5755ce62001-06-27 19:19:46 +0000329
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000330 /* cleanup */
331 Py_DECREF(args);
332 return result;
Fred Drake5755ce62001-06-27 19:19:46 +0000333}
334
335static int
336profile_trampoline(PyObject *self, PyFrameObject *frame,
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000337 int what, PyObject *arg)
Fred Drake5755ce62001-06-27 19:19:46 +0000338{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000339 PyThreadState *tstate = frame->f_tstate;
340 PyObject *result;
Fred Drake5755ce62001-06-27 19:19:46 +0000341
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000342 if (arg == NULL)
343 arg = Py_None;
344 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;
Fred Drake5755ce62001-06-27 19:19:46 +0000351}
352
353static int
354trace_trampoline(PyObject *self, PyFrameObject *frame,
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000355 int what, PyObject *arg)
Fred Drake5755ce62001-06-27 19:19:46 +0000356{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000357 PyThreadState *tstate = frame->f_tstate;
358 PyObject *callback;
359 PyObject *result;
Fred Drake5755ce62001-06-27 19:19:46 +0000360
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000361 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);
Serhiy Storchaka98a97222014-02-09 13:14:04 +0200370 Py_CLEAR(frame->f_trace);
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000371 return -1;
372 }
373 if (result != Py_None) {
374 PyObject *temp = frame->f_trace;
375 frame->f_trace = NULL;
376 Py_XDECREF(temp);
377 frame->f_trace = result;
378 }
379 else {
380 Py_DECREF(result);
381 }
382 return 0;
Fred Drake5755ce62001-06-27 19:19:46 +0000383}
Fred Draked0838392001-06-16 21:02:31 +0000384
Fred Drake8b4d01d2000-05-09 19:57:01 +0000385static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000386sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000387{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000388 if (trace_init() == -1)
389 return NULL;
390 if (args == Py_None)
391 PyEval_SetTrace(NULL, NULL);
392 else
393 PyEval_SetTrace(trace_trampoline, args);
394 Py_INCREF(Py_None);
395 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000396}
397
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000398PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000399"settrace(function)\n\
400\n\
401Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000402function call. See the debugger chapter in the library manual."
403);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000404
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000405static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000406sys_gettrace(PyObject *self, PyObject *args)
407{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000408 PyThreadState *tstate = PyThreadState_GET();
409 PyObject *temp = tstate->c_traceobj;
Georg Brandl56112892008-01-20 13:59:46 +0000410
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000411 if (temp == NULL)
412 temp = Py_None;
413 Py_INCREF(temp);
414 return temp;
Georg Brandl56112892008-01-20 13:59:46 +0000415}
416
417PyDoc_STRVAR(gettrace_doc,
418"gettrace()\n\
419\n\
420Return the global debug tracing function set with sys.settrace.\n\
421See the debugger chapter in the library manual."
422);
423
424static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000425sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000426{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000427 if (trace_init() == -1)
428 return NULL;
429 if (args == Py_None)
430 PyEval_SetProfile(NULL, NULL);
431 else
432 PyEval_SetProfile(profile_trampoline, args);
433 Py_INCREF(Py_None);
434 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000435}
436
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000437PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000438"setprofile(function)\n\
439\n\
440Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000441and return. See the profiler chapter in the library manual."
442);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000443
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000444static PyObject *
Georg Brandl56112892008-01-20 13:59:46 +0000445sys_getprofile(PyObject *self, PyObject *args)
446{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000447 PyThreadState *tstate = PyThreadState_GET();
448 PyObject *temp = tstate->c_profileobj;
Georg Brandl56112892008-01-20 13:59:46 +0000449
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000450 if (temp == NULL)
451 temp = Py_None;
452 Py_INCREF(temp);
453 return temp;
Georg Brandl56112892008-01-20 13:59:46 +0000454}
455
456PyDoc_STRVAR(getprofile_doc,
457"getprofile()\n\
458\n\
459Return the profiling function set with sys.setprofile.\n\
460See the profiler chapter in the library manual."
461);
462
463static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000464sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000465{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000466 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
467 return NULL;
Raymond Hettinger19b851d2011-06-01 18:21:42 -0700468 _Py_Ticker = _Py_CheckInterval;
Antoine Pitrouc83ea132010-05-09 14:46:46 +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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000483 return PyInt_FromLong(_Py_CheckInterval);
Tim Peterse5e065b2003-07-06 18:36:54 +0000484}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000494 int bool;
495 PyThreadState *tstate = PyThreadState_Get();
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000496
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000497 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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000520 int new_limit;
521 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
522 return NULL;
523 if (new_limit <= 0) {
524 PyErr_SetString(PyExc_ValueError,
525 "recursion limit must be positive");
526 return NULL;
527 }
528 Py_SetRecursionLimit(new_limit);
529 Py_INCREF(Py_None);
530 return Py_None;
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000531}
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{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000545 return PyInt_FromLong(Py_GetRecursionLimit());
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000546}
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\
Ezio Melotti24b07bc2011-03-15 18:55:01 +0200563backward compatibility, only the first 5 items are available by indexing.\n\
Eric Smithee931b72010-01-27 00:28:29 +0000564All 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[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000573 {"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}
Eric Smithee931b72010-01-27 00:28:29 +0000583};
584
585static PyStructSequence_Desc windows_version_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000586 "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 */
Eric Smithee931b72010-01-27 00:28:29 +0000592};
593
Mark Hammond8696ebc2002-10-08 02:44:31 +0000594static PyObject *
595sys_getwindowsversion(PyObject *self)
596{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000597 PyObject *version;
598 int pos = 0;
599 OSVERSIONINFOEX ver;
600 ver.dwOSVersionInfoSize = sizeof(ver);
601 if (!GetVersionEx((OSVERSIONINFO*) &ver))
602 return PyErr_SetFromWindowsErr(0);
Eric Smithee931b72010-01-27 00:28:29 +0000603
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000604 version = PyStructSequence_New(&WindowsVersionType);
605 if (version == NULL)
606 return NULL;
Eric Smithee931b72010-01-27 00:28:29 +0000607
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000608 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));
Eric Smithee931b72010-01-27 00:28:29 +0000617
Serhiy Storchaka15df36b2013-12-17 15:09:45 +0200618 if (PyErr_Occurred()) {
619 Py_DECREF(version);
620 return NULL;
621 }
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000622 return version;
Mark Hammond8696ebc2002-10-08 02:44:31 +0000623}
624
625#endif /* MS_WINDOWS */
626
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000627#ifdef HAVE_DLOPEN
628static PyObject *
629sys_setdlopenflags(PyObject *self, PyObject *args)
630{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000631 int new_val;
632 PyThreadState *tstate = PyThreadState_GET();
633 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
634 return NULL;
635 if (!tstate)
636 return NULL;
637 tstate->interp->dlopenflags = new_val;
638 Py_INCREF(Py_None);
639 return Py_None;
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000640}
641
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000642PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000643"setdlopenflags(n) -> None\n\
644\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000645Set the flags used by the interpreter for dlopen calls, such as when the\n\
646interpreter loads extension modules. Among other things, this will enable\n\
647a lazy resolving of symbols when importing a module, if called as\n\
648sys.setdlopenflags(0). To share symbols across extension modules, call as\n\
649sys.setdlopenflags(ctypes.RTLD_GLOBAL). Symbolic names for the flag modules\n\
650can be either found in the ctypes module, or in the DLFCN module. If DLFCN\n\
651is not available, it can be generated from /usr/include/dlfcn.h using the\n\
652h2py script.");
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000653
654static PyObject *
655sys_getdlopenflags(PyObject *self, PyObject *args)
656{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000657 PyThreadState *tstate = PyThreadState_GET();
658 if (!tstate)
659 return NULL;
660 return PyInt_FromLong(tstate->interp->dlopenflags);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000661}
662
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000663PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000664"getdlopenflags() -> int\n\
665\n\
Alexandre Vassalotti7274cff2009-06-29 01:01:51 +0000666Return the current value of the flags that are used for dlopen calls.\n\
667The flag constants are defined in the ctypes and DLFCN modules.");
668
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000669#endif /* HAVE_DLOPEN */
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000670
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000671#ifdef USE_MALLOPT
672/* Link with -lmalloc (or -lmpc) on an SGI */
673#include <malloc.h>
674
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000675static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000676sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000677{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000678 int flag;
679 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
680 return NULL;
681 mallopt(M_DEBUG, flag);
682 Py_INCREF(Py_None);
683 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000684}
685#endif /* USE_MALLOPT */
686
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300687size_t
688_PySys_GetSizeOf(PyObject *o)
Robert Schuppenies51df0642008-06-01 16:16:17 +0000689{
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300690 static PyObject *str__sizeof__ = NULL;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000691 PyObject *res = NULL;
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300692 size_t size;
Robert Schuppenies47629022008-07-10 17:13:55 +0000693
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000694 /* Make sure the type is initialized. float gets initialized late */
695 if (PyType_Ready(Py_TYPE(o)) < 0)
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300696 return (size_t)-1;
Robert Schuppeniesd2cd86d2008-07-10 13:43:26 +0000697
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000698 /* Instance of old-style class */
699 if (PyInstance_Check(o))
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300700 size = PyInstance_Type.tp_basicsize;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000701 /* all other objects */
702 else {
703 PyObject *method = _PyObject_LookupSpecial(o, "__sizeof__",
704 &str__sizeof__);
705 if (method == NULL) {
706 if (!PyErr_Occurred())
707 PyErr_Format(PyExc_TypeError,
708 "Type %.100s doesn't define __sizeof__",
709 Py_TYPE(o)->tp_name);
710 }
711 else {
712 res = PyObject_CallFunctionObjArgs(method, NULL);
713 Py_DECREF(method);
714 }
Robert Schuppenies47629022008-07-10 17:13:55 +0000715
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300716 if (res == NULL)
717 return (size_t)-1;
718
719 size = (size_t)PyInt_AsSsize_t(res);
720 Py_DECREF(res);
721 if (size == (size_t)-1 && PyErr_Occurred())
722 return (size_t)-1;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000723 }
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000724
725 /* add gc_head size */
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300726 if (PyObject_IS_GC(o))
727 size += sizeof(PyGC_Head);
728 return size;
729}
730
731static PyObject *
732sys_getsizeof(PyObject *self, PyObject *args, PyObject *kwds)
733{
734 static char *kwlist[] = {"object", "default", 0};
735 size_t size;
736 PyObject *o, *dflt = NULL;
737
738 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:getsizeof",
739 kwlist, &o, &dflt))
740 return NULL;
741
742 size = _PySys_GetSizeOf(o);
743
744 if (size == (size_t)-1 && PyErr_Occurred()) {
745 /* Has a default value been given */
746 if (dflt != NULL && PyErr_ExceptionMatches(PyExc_TypeError)) {
747 PyErr_Clear();
748 Py_INCREF(dflt);
749 return dflt;
750 }
751 else
752 return NULL;
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000753 }
Serhiy Storchakac95f51a2014-08-14 22:20:23 +0300754
755 return PyInt_FromSize_t(size);
Robert Schuppenies51df0642008-06-01 16:16:17 +0000756}
757
758PyDoc_STRVAR(getsizeof_doc,
Robert Schuppenies47629022008-07-10 17:13:55 +0000759"getsizeof(object, default) -> int\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +0000760\n\
761Return the size of object in bytes.");
762
763static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000764sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000765{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000766 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000767}
768
Tim Peters4be93d02002-07-07 19:59:50 +0000769#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000770static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000771sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000772{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000773 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000774}
Armin Rigoe1709372006-04-12 17:06:05 +0000775#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000776
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000777PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000778"getrefcount(object) -> integer\n\
779\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000780Return the reference count of object. The count returned is generally\n\
781one higher than you might expect, because it includes the (temporary)\n\
782reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000783);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000784
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000785#ifdef COUNT_ALLOCS
786static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000787sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000788{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000789 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000790
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000791 return get_counts();
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000792}
793#endif
794
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000795PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000796"_getframe([depth]) -> frameobject\n\
797\n\
798Return a frame object from the call stack. If optional integer depth is\n\
799given, return the frame object that many calls below the top of the stack.\n\
800If that is deeper than the call stack, ValueError is raised. The default\n\
801for depth is zero, returning the frame at the top of the call stack.\n\
802\n\
803This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000804purposes only."
805);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000806
807static PyObject *
808sys_getframe(PyObject *self, PyObject *args)
809{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000810 PyFrameObject *f = PyThreadState_GET()->frame;
811 int depth = -1;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000812
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000813 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
814 return NULL;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000815
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000816 while (depth > 0 && f != NULL) {
817 f = f->f_back;
818 --depth;
819 }
820 if (f == NULL) {
821 PyErr_SetString(PyExc_ValueError,
822 "call stack is not deep enough");
823 return NULL;
824 }
825 Py_INCREF(f);
826 return (PyObject*)f;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000827}
828
Tim Peters32a83612006-07-10 21:08:24 +0000829PyDoc_STRVAR(current_frames_doc,
830"_current_frames() -> dictionary\n\
831\n\
832Return a dictionary mapping each current thread T's thread id to T's\n\
833current stack frame.\n\
834\n\
835This function should be used for specialized purposes only."
836);
837
838static PyObject *
839sys_current_frames(PyObject *self, PyObject *noargs)
840{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000841 return _PyThread_CurrentFrames();
Tim Peters32a83612006-07-10 21:08:24 +0000842}
843
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000844PyDoc_STRVAR(call_tracing_doc,
845"call_tracing(func, args) -> object\n\
846\n\
847Call func(*args), while tracing is enabled. The tracing state is\n\
848saved, and restored afterwards. This is intended to be called from\n\
849a debugger from a checkpoint, to recursively debug some other code."
850);
851
852static PyObject *
853sys_call_tracing(PyObject *self, PyObject *args)
854{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000855 PyObject *func, *funcargs;
856 if (!PyArg_ParseTuple(args, "OO!:call_tracing", &func, &PyTuple_Type, &funcargs))
857 return NULL;
858 return _PyEval_CallTracing(func, funcargs);
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000859}
860
Jeremy Hylton985eba52003-02-05 23:13:00 +0000861PyDoc_STRVAR(callstats_doc,
862"callstats() -> tuple of integers\n\
863\n\
864Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
865when Python was built. Otherwise, return None.\n\
866\n\
867When enabled, this function returns detailed, implementation-specific\n\
868details about the number of function calls executed. The return value is\n\
869a 11-tuple where the entries in the tuple are counts of:\n\
8700. all function calls\n\
8711. calls to PyFunction_Type objects\n\
8722. PyFunction calls that do not create an argument tuple\n\
8733. PyFunction calls that do not create an argument tuple\n\
874 and bypass PyEval_EvalCodeEx()\n\
8754. PyMethod calls\n\
8765. PyMethod calls on bound methods\n\
8776. PyType calls\n\
8787. PyCFunction calls\n\
8798. generator calls\n\
8809. All other calls\n\
88110. Number of stack pops performed by call_function()"
882);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000883
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000884#ifdef __cplusplus
885extern "C" {
886#endif
887
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000888#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000889/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000890extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000891#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000892
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000893#ifdef DYNAMIC_EXECUTION_PROFILE
894/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000895extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000896#endif
897
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000898#ifdef __cplusplus
899}
900#endif
901
Christian Heimes422051a2008-02-04 18:00:12 +0000902static PyObject *
903sys_clear_type_cache(PyObject* self, PyObject* args)
904{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000905 PyType_ClearCache();
906 Py_RETURN_NONE;
Christian Heimes422051a2008-02-04 18:00:12 +0000907}
908
909PyDoc_STRVAR(sys_clear_type_cache__doc__,
910"_clear_type_cache() -> None\n\
911Clear the internal type lookup cache.");
912
913
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000914static PyMethodDef sys_methods[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000915 /* Might as well keep this in alphabetic order */
916 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
917 callstats_doc},
918 {"_clear_type_cache", sys_clear_type_cache, METH_NOARGS,
919 sys_clear_type_cache__doc__},
920 {"_current_frames", sys_current_frames, METH_NOARGS,
921 current_frames_doc},
922 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
923 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
924 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
925 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
926 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000927#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000928 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
929 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000930#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000931#ifdef HAVE_DLOPEN
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000932 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
933 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000934#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000935#ifdef COUNT_ALLOCS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000936 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000937#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000938#ifdef DYNAMIC_EXECUTION_PROFILE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000939 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000940#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000941#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000942 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
943 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000944#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000945#ifdef Py_TRACE_REFS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000946 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000947#endif
948#ifdef Py_REF_DEBUG
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000949 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000950#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000951 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
952 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
953 getrecursionlimit_doc},
954 {"getsizeof", (PyCFunction)sys_getsizeof,
955 METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
956 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000957#ifdef MS_WINDOWS
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000958 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
959 getwindowsversion_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000960#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000961#ifdef USE_MALLOPT
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000962 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000963#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000964#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000965 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
966 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000967#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000968 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
969 setcheckinterval_doc},
970 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
971 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000972#ifdef HAVE_DLOPEN
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000973 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
974 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000975#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000976 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
977 {"getprofile", sys_getprofile, METH_NOARGS, getprofile_doc},
978 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
979 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000980#ifdef WITH_TSC
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000981 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000982#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000983 {"settrace", sys_settrace, METH_O, settrace_doc},
984 {"gettrace", sys_gettrace, METH_NOARGS, gettrace_doc},
985 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
986 {NULL, NULL} /* sentinel */
Guido van Rossum3f5da241990-12-20 15:06:42 +0000987};
988
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000989static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000990list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000991{
Antoine Pitrouc83ea132010-05-09 14:46:46 +0000992 PyObject *list = PyList_New(0);
993 int i;
994 if (list == NULL)
995 return NULL;
996 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
997 PyObject *name = PyString_FromString(
998 PyImport_Inittab[i].name);
999 if (name == NULL)
1000 break;
1001 PyList_Append(list, name);
1002 Py_DECREF(name);
1003 }
1004 if (PyList_Sort(list) != 0) {
1005 Py_DECREF(list);
1006 list = NULL;
1007 }
1008 if (list) {
1009 PyObject *v = PyList_AsTuple(list);
1010 Py_DECREF(list);
1011 list = v;
1012 }
1013 return list;
Guido van Rossum34679b71993-01-26 13:33:44 +00001014}
1015
Guido van Rossum23fff912000-12-15 22:02:05 +00001016static PyObject *warnoptions = NULL;
1017
1018void
1019PySys_ResetWarnOptions(void)
1020{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001021 if (warnoptions == NULL || !PyList_Check(warnoptions))
1022 return;
1023 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
Guido van Rossum23fff912000-12-15 22:02:05 +00001024}
1025
1026void
1027PySys_AddWarnOption(char *s)
1028{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001029 PyObject *str;
Guido van Rossum23fff912000-12-15 22:02:05 +00001030
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001031 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
1032 Py_XDECREF(warnoptions);
1033 warnoptions = PyList_New(0);
1034 if (warnoptions == NULL)
1035 return;
1036 }
1037 str = PyString_FromString(s);
1038 if (str != NULL) {
1039 PyList_Append(warnoptions, str);
1040 Py_DECREF(str);
1041 }
Guido van Rossum23fff912000-12-15 22:02:05 +00001042}
1043
Brett Cannone9746892008-04-12 23:44:07 +00001044int
1045PySys_HasWarnOptions(void)
1046{
Brett Cannon40f0a872008-04-13 00:18:44 +00001047 return (warnoptions != NULL && (PyList_Size(warnoptions) > 0)) ? 1 : 0;
Brett Cannone9746892008-04-12 23:44:07 +00001048}
1049
Guido van Rossum40552d01998-08-06 03:34:39 +00001050/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
1051 Two literals concatenated works just fine. If you have a K&R compiler
1052 or other abomination that however *does* understand longer strings,
1053 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001054PyDoc_VAR(sys_doc) =
1055PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001056"This module provides access to some objects used or maintained by the\n\
1057interpreter and to functions that interact strongly with the interpreter.\n\
1058\n\
1059Dynamic objects:\n\
1060\n\
1061argv -- command line arguments; argv[0] is the script pathname if known\n\
1062path -- module search path; path[0] is the script directory, else ''\n\
1063modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001064\n\
1065displayhook -- called to show results in an interactive session\n\
1066excepthook -- called to handle any uncaught exception other than SystemExit\n\
1067 To customize printing in an interactive session or to install a custom\n\
1068 top-level exception handler, assign other functions to replace these.\n\
1069\n\
1070exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
1071 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001072\n\
1073stdin -- standard input file object; used by raw_input() and input()\n\
1074stdout -- standard output file object; used by the print statement\n\
1075stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001076 By assigning other file objects (or objects that behave like files)\n\
1077 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001078\n\
1079last_type -- type of last uncaught exception\n\
1080last_value -- value of last uncaught exception\n\
1081last_traceback -- traceback of last uncaught exception\n\
1082 These three are only available in an interactive session after a\n\
1083 traceback has been printed.\n\
1084\n\
1085exc_type -- type of exception currently being handled\n\
1086exc_value -- value of exception currently being handled\n\
1087exc_traceback -- traceback of exception currently being handled\n\
1088 The function exc_info() should be used instead of these three,\n\
1089 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001090"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001091)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001092/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001093PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +00001094"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001095Static objects:\n\
1096\n\
Mark Dickinsonefc82f72009-03-20 15:51:55 +00001097float_info -- a dict with information about the float inplementation.\n\
1098long_info -- a struct sequence with information about the long implementation.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001099maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwis4dd019f2008-05-20 08:11:19 +00001100maxsize -- the largest supported length of containers.\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +00001101maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +00001102builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001103version -- the version of this interpreter as a string\n\
Eric Smith81fe0932009-02-06 00:48:26 +00001104version_info -- version information as a named tuple\n\
Fred Drake801c08d2000-04-13 15:29:10 +00001105hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001106copyright -- copyright notice pertaining to this interpreter\n\
1107platform -- platform identifier\n\
Petri Lehtinenfe6f9d02012-02-02 21:11:28 +02001108executable -- absolute path of the executable binary of the Python interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001109prefix -- prefix used to find the Python library\n\
1110exec_prefix -- prefix used to find the machine-specific Python library\n\
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001111float_repr_style -- string indicating the style of repr() output for floats\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001112"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001113)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001114#ifdef MS_WINDOWS
1115/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001116PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001117"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001118winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001119"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001120)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001121#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001122PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001123"__stdin__ -- the original stdin; don't touch!\n\
1124__stdout__ -- the original stdout; don't touch!\n\
1125__stderr__ -- the original stderr; don't touch!\n\
1126__displayhook__ -- the original displayhook; don't touch!\n\
1127__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001128\n\
1129Functions:\n\
1130\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +00001131displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001132excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001133exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +00001134exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001135exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001136getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Georg Brandl56112892008-01-20 13:59:46 +00001137getprofile() -- get the global profiling function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001138getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001139getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Robert Schuppenies51df0642008-06-01 16:16:17 +00001140getsizeof() -- return the size of an object in bytes\n\
Georg Brandl56112892008-01-20 13:59:46 +00001141gettrace() -- get the global debug tracing function\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001142setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +00001143setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001144setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +00001145setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001146settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +00001147"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +00001148)
Fred Drakeccede592000-08-14 20:59:57 +00001149/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001150
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001151static int
1152_check_and_flush (FILE *stream)
1153{
1154 int prev_fail = ferror (stream);
1155 return fflush (stream) || prev_fail ? EOF : 0;
1156}
1157
Martin v. Löwis43b57802006-01-05 23:38:54 +00001158/* Subversion branch and revision management */
Martin v. Löwis43b57802006-01-05 23:38:54 +00001159static int svn_initialized;
1160static char patchlevel_revision[50]; /* Just the number */
1161static char branch[50];
1162static char shortbranch[50];
1163static const char *svn_revision;
1164
Tim Peterse86e7a52006-01-06 02:42:46 +00001165static void
1166svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +00001167{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001168 if (svn_initialized)
1169 return;
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001170 svn_initialized = 1;
Benjamin Peterson7859d402011-03-25 16:57:30 -05001171 *patchlevel_revision = '\0';
1172 strcpy(branch, "");
1173 strcpy(shortbranch, "unknown");
1174 svn_revision = "";
1175 return;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001176}
1177
1178/* Return svnversion output if available.
1179 Else return Revision of patchlevel.h if on branch.
1180 Else return empty string */
1181const char*
1182Py_SubversionRevision()
1183{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001184 svnversion_init();
1185 return svn_revision;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001186}
1187
1188const char*
1189Py_SubversionShortBranch()
1190{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001191 svnversion_init();
1192 return shortbranch;
Martin v. Löwis43b57802006-01-05 23:38:54 +00001193}
1194
Christian Heimesf31b69f2008-01-14 03:42:48 +00001195
1196PyDoc_STRVAR(flags__doc__,
1197"sys.flags\n\
1198\n\
1199Flags provided through command line arguments or environment vars.");
1200
Christian Heimes796fc312008-01-30 18:58:29 +00001201static PyTypeObject FlagsType = {0, 0, 0, 0, 0, 0};
Christian Heimesf31b69f2008-01-14 03:42:48 +00001202
1203static PyStructSequence_Field flags_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001204 {"debug", "-d"},
1205 {"py3k_warning", "-3"},
1206 {"division_warning", "-Q"},
1207 {"division_new", "-Qnew"},
1208 {"inspect", "-i"},
1209 {"interactive", "-i"},
1210 {"optimize", "-O or -OO"},
1211 {"dont_write_bytecode", "-B"},
1212 {"no_user_site", "-s"},
1213 {"no_site", "-S"},
1214 {"ignore_environment", "-E"},
1215 {"tabcheck", "-t or -tt"},
1216 {"verbose", "-v"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001217#ifdef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001218 {"riscos_wimp", "???"},
Christian Heimesf31b69f2008-01-14 03:42:48 +00001219#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001220 /* {"unbuffered", "-u"}, */
1221 {"unicode", "-U"},
1222 /* {"skip_first", "-x"}, */
1223 {"bytes_warning", "-b"},
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001224 {"hash_randomization", "-R"},
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001225 {0}
Christian Heimesf31b69f2008-01-14 03:42:48 +00001226};
1227
1228static PyStructSequence_Desc flags_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001229 "sys.flags", /* name */
1230 flags__doc__, /* doc */
1231 flags_fields, /* fields */
Christian Heimesf31b69f2008-01-14 03:42:48 +00001232#ifdef RISCOS
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001233 17
Christian Heimesf31b69f2008-01-14 03:42:48 +00001234#else
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001235 16
Christian Heimesf31b69f2008-01-14 03:42:48 +00001236#endif
1237};
1238
1239static PyObject*
1240make_flags(void)
1241{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001242 int pos = 0;
1243 PyObject *seq;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001244
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001245 seq = PyStructSequence_New(&FlagsType);
1246 if (seq == NULL)
1247 return NULL;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001248
1249#define SetFlag(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001250 PyStructSequence_SET_ITEM(seq, pos++, PyInt_FromLong(flag))
Christian Heimesf31b69f2008-01-14 03:42:48 +00001251
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001252 SetFlag(Py_DebugFlag);
1253 SetFlag(Py_Py3kWarningFlag);
1254 SetFlag(Py_DivisionWarningFlag);
1255 SetFlag(_Py_QnewFlag);
1256 SetFlag(Py_InspectFlag);
1257 SetFlag(Py_InteractiveFlag);
1258 SetFlag(Py_OptimizeFlag);
1259 SetFlag(Py_DontWriteBytecodeFlag);
1260 SetFlag(Py_NoUserSiteDirectory);
1261 SetFlag(Py_NoSiteFlag);
1262 SetFlag(Py_IgnoreEnvironmentFlag);
1263 SetFlag(Py_TabcheckFlag);
1264 SetFlag(Py_VerboseFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001265#ifdef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001266 SetFlag(Py_RISCOSWimpFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001267#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001268 /* SetFlag(saw_unbuffered_flag); */
1269 SetFlag(Py_UnicodeFlag);
1270 /* SetFlag(skipfirstline); */
Brett Cannone9746892008-04-12 23:44:07 +00001271 SetFlag(Py_BytesWarningFlag);
Barry Warsaw1e13eb02012-02-20 20:42:21 -05001272 SetFlag(Py_HashRandomizationFlag);
Christian Heimesf31b69f2008-01-14 03:42:48 +00001273#undef SetFlag
1274
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001275 if (PyErr_Occurred()) {
Serhiy Storchaka05854182013-12-17 14:59:29 +02001276 Py_DECREF(seq);
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001277 return NULL;
1278 }
1279 return seq;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001280}
1281
Eric Smith81fe0932009-02-06 00:48:26 +00001282PyDoc_STRVAR(version_info__doc__,
1283"sys.version_info\n\
1284\n\
1285Version information as a named tuple.");
1286
1287static PyTypeObject VersionInfoType = {0, 0, 0, 0, 0, 0};
1288
1289static PyStructSequence_Field version_info_fields[] = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001290 {"major", "Major release number"},
1291 {"minor", "Minor release number"},
1292 {"micro", "Patch release number"},
1293 {"releaselevel", "'alpha', 'beta', 'candidate', or 'release'"},
1294 {"serial", "Serial release number"},
1295 {0}
Eric Smith81fe0932009-02-06 00:48:26 +00001296};
1297
1298static PyStructSequence_Desc version_info_desc = {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001299 "sys.version_info", /* name */
1300 version_info__doc__, /* doc */
1301 version_info_fields, /* fields */
1302 5
Eric Smith81fe0932009-02-06 00:48:26 +00001303};
1304
1305static PyObject *
1306make_version_info(void)
1307{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001308 PyObject *version_info;
1309 char *s;
1310 int pos = 0;
Eric Smith81fe0932009-02-06 00:48:26 +00001311
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001312 version_info = PyStructSequence_New(&VersionInfoType);
1313 if (version_info == NULL) {
1314 return NULL;
1315 }
Eric Smith81fe0932009-02-06 00:48:26 +00001316
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001317 /*
1318 * These release level checks are mutually exclusive and cover
1319 * the field, so don't get too fancy with the pre-processor!
1320 */
Eric Smith81fe0932009-02-06 00:48:26 +00001321#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001322 s = "alpha";
Eric Smith81fe0932009-02-06 00:48:26 +00001323#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001324 s = "beta";
Eric Smith81fe0932009-02-06 00:48:26 +00001325#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001326 s = "candidate";
Eric Smith81fe0932009-02-06 00:48:26 +00001327#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001328 s = "final";
Eric Smith81fe0932009-02-06 00:48:26 +00001329#endif
1330
1331#define SetIntItem(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001332 PyStructSequence_SET_ITEM(version_info, pos++, PyInt_FromLong(flag))
Eric Smith81fe0932009-02-06 00:48:26 +00001333#define SetStrItem(flag) \
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001334 PyStructSequence_SET_ITEM(version_info, pos++, PyString_FromString(flag))
Eric Smith81fe0932009-02-06 00:48:26 +00001335
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001336 SetIntItem(PY_MAJOR_VERSION);
1337 SetIntItem(PY_MINOR_VERSION);
1338 SetIntItem(PY_MICRO_VERSION);
1339 SetStrItem(s);
1340 SetIntItem(PY_RELEASE_SERIAL);
Eric Smith81fe0932009-02-06 00:48:26 +00001341#undef SetIntItem
1342#undef SetStrItem
1343
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001344 if (PyErr_Occurred()) {
1345 Py_CLEAR(version_info);
1346 return NULL;
1347 }
1348 return version_info;
Eric Smith81fe0932009-02-06 00:48:26 +00001349}
1350
Guido van Rossum25ce5661997-08-02 03:10:38 +00001351PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001352_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001353{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001354 PyObject *m, *v, *sysdict;
1355 PyObject *sysin, *sysout, *syserr;
1356 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +00001357
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001358 m = Py_InitModule3("sys", sys_methods, sys_doc);
1359 if (m == NULL)
1360 return NULL;
1361 sysdict = PyModule_GetDict(m);
1362#define SET_SYS_FROM_STRING(key, value) \
1363 v = value; \
1364 if (v != NULL) \
1365 PyDict_SetItemString(sysdict, key, v); \
1366 Py_XDECREF(v)
Guido van Rossum25ce5661997-08-02 03:10:38 +00001367
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001368 /* Check that stdin is not a directory
1369 Using shell redirection, you can redirect stdin to a directory,
1370 crashing the Python interpreter. Catch this common mistake here
1371 and output a useful error message. Note that under MS Windows,
1372 the shell already prevents that. */
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001373#if !defined(MS_WINDOWS)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001374 {
1375 struct stat sb;
1376 if (fstat(fileno(stdin), &sb) == 0 &&
1377 S_ISDIR(sb.st_mode)) {
1378 /* There's nothing more we can do. */
1379 /* Py_FatalError() will core dump, so just exit. */
1380 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1381 exit(EXIT_FAILURE);
1382 }
1383 }
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001384#endif
Neal Norwitz11bd1192005-10-03 00:54:56 +00001385
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001386 /* Closing the standard FILE* if sys.std* goes aways causes problems
1387 * for embedded Python usages. Closing them when somebody explicitly
1388 * invokes .close() might be possible, but the FAQ promises they get
1389 * never closed. However, we still need to get write errors when
1390 * writing fails (e.g. because stdout is redirected), so we flush the
1391 * streams and check for errors before the file objects are deleted.
1392 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1393 * from that procedure.
1394 */
1395 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
1396 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1397 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
1398 if (PyErr_Occurred())
1399 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001400
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001401 PyDict_SetItemString(sysdict, "stdin", sysin);
1402 PyDict_SetItemString(sysdict, "stdout", sysout);
1403 PyDict_SetItemString(sysdict, "stderr", syserr);
1404 /* Make backup copies for cleanup */
1405 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1406 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1407 PyDict_SetItemString(sysdict, "__stderr__", syserr);
1408 PyDict_SetItemString(sysdict, "__displayhook__",
1409 PyDict_GetItemString(sysdict, "displayhook"));
1410 PyDict_SetItemString(sysdict, "__excepthook__",
1411 PyDict_GetItemString(sysdict, "excepthook"));
1412 Py_XDECREF(sysin);
1413 Py_XDECREF(sysout);
1414 Py_XDECREF(syserr);
Christian Heimes0d924432008-01-30 17:21:22 +00001415
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001416 SET_SYS_FROM_STRING("version",
1417 PyString_FromString(Py_GetVersion()));
1418 SET_SYS_FROM_STRING("hexversion",
1419 PyInt_FromLong(PY_VERSION_HEX));
1420 svnversion_init();
1421 SET_SYS_FROM_STRING("subversion",
1422 Py_BuildValue("(ssz)", "CPython", branch,
1423 svn_revision));
Georg Brandl3a5508e2011-03-06 10:42:21 +01001424 SET_SYS_FROM_STRING("_mercurial",
1425 Py_BuildValue("(szz)", "CPython", _Py_hgidentifier(),
1426 _Py_hgversion()));
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001427 SET_SYS_FROM_STRING("dont_write_bytecode",
1428 PyBool_FromLong(Py_DontWriteBytecodeFlag));
1429 SET_SYS_FROM_STRING("api_version",
1430 PyInt_FromLong(PYTHON_API_VERSION));
1431 SET_SYS_FROM_STRING("copyright",
1432 PyString_FromString(Py_GetCopyright()));
1433 SET_SYS_FROM_STRING("platform",
1434 PyString_FromString(Py_GetPlatform()));
1435 SET_SYS_FROM_STRING("executable",
1436 PyString_FromString(Py_GetProgramFullPath()));
1437 SET_SYS_FROM_STRING("prefix",
1438 PyString_FromString(Py_GetPrefix()));
1439 SET_SYS_FROM_STRING("exec_prefix",
1440 PyString_FromString(Py_GetExecPrefix()));
1441 SET_SYS_FROM_STRING("maxsize",
1442 PyInt_FromSsize_t(PY_SSIZE_T_MAX));
1443 SET_SYS_FROM_STRING("maxint",
1444 PyInt_FromLong(PyInt_GetMax()));
1445 SET_SYS_FROM_STRING("py3kwarning",
1446 PyBool_FromLong(Py_Py3kWarningFlag));
1447 SET_SYS_FROM_STRING("float_info",
1448 PyFloat_GetInfo());
1449 SET_SYS_FROM_STRING("long_info",
1450 PyLong_GetInfo());
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001451#ifdef Py_USING_UNICODE
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001452 SET_SYS_FROM_STRING("maxunicode",
1453 PyInt_FromLong(PyUnicode_GetMax()));
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001454#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001455 SET_SYS_FROM_STRING("builtin_module_names",
1456 list_builtin_module_names());
1457 {
1458 /* Assumes that longs are at least 2 bytes long.
1459 Should be safe! */
1460 unsigned long number = 1;
1461 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001462
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001463 s = (char *) &number;
1464 if (s[0] == 0)
1465 value = "big";
1466 else
1467 value = "little";
1468 SET_SYS_FROM_STRING("byteorder",
1469 PyString_FromString(value));
1470 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001471#ifdef MS_COREDLL
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001472 SET_SYS_FROM_STRING("dllhandle",
1473 PyLong_FromVoidPtr(PyWin_DLLhModule));
1474 SET_SYS_FROM_STRING("winver",
1475 PyString_FromString(PyWin_DLLVersionString));
Guido van Rossumc606fe11996-04-09 02:37:57 +00001476#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001477 if (warnoptions == NULL) {
1478 warnoptions = PyList_New(0);
1479 }
1480 else {
1481 Py_INCREF(warnoptions);
1482 }
1483 if (warnoptions != NULL) {
1484 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
1485 }
Tim Peters216b78b2006-01-06 02:40:53 +00001486
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001487 /* version_info */
1488 if (VersionInfoType.tp_name == 0)
1489 PyStructSequence_InitType(&VersionInfoType, &version_info_desc);
1490 SET_SYS_FROM_STRING("version_info", make_version_info());
1491 /* prevent user from creating new instances */
1492 VersionInfoType.tp_init = NULL;
1493 VersionInfoType.tp_new = NULL;
Eric Smith81fe0932009-02-06 00:48:26 +00001494
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001495 /* flags */
1496 if (FlagsType.tp_name == 0)
1497 PyStructSequence_InitType(&FlagsType, &flags_desc);
1498 SET_SYS_FROM_STRING("flags", make_flags());
1499 /* prevent user from creating new instances */
1500 FlagsType.tp_init = NULL;
1501 FlagsType.tp_new = NULL;
Christian Heimesf31b69f2008-01-14 03:42:48 +00001502
Eric Smithee931b72010-01-27 00:28:29 +00001503
1504#if defined(MS_WINDOWS)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001505 /* getwindowsversion */
1506 if (WindowsVersionType.tp_name == 0)
1507 PyStructSequence_InitType(&WindowsVersionType, &windows_version_desc);
1508 /* prevent user from creating new instances */
1509 WindowsVersionType.tp_init = NULL;
1510 WindowsVersionType.tp_new = NULL;
Eric Smithee931b72010-01-27 00:28:29 +00001511#endif
1512
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001513 /* float repr style: 0.03 (short) vs 0.029999999999999999 (legacy) */
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001514#ifndef PY_NO_SHORT_FLOAT_REPR
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001515 SET_SYS_FROM_STRING("float_repr_style",
1516 PyString_FromString("short"));
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001517#else
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001518 SET_SYS_FROM_STRING("float_repr_style",
1519 PyString_FromString("legacy"));
Mark Dickinsonda8652d92009-10-24 14:01:08 +00001520#endif
1521
Christian Heimes0d924432008-01-30 17:21:22 +00001522#undef SET_SYS_FROM_STRING
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001523 if (PyErr_Occurred())
1524 return NULL;
1525 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001526}
1527
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001528static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001529makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001530{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001531 int i, n;
1532 char *p;
1533 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001534
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001535 n = 1;
1536 p = path;
1537 while ((p = strchr(p, delim)) != NULL) {
1538 n++;
1539 p++;
1540 }
1541 v = PyList_New(n);
1542 if (v == NULL)
1543 return NULL;
1544 for (i = 0; ; i++) {
1545 p = strchr(path, delim);
1546 if (p == NULL)
1547 p = strchr(path, '\0'); /* End of string */
1548 w = PyString_FromStringAndSize(path, (Py_ssize_t) (p - path));
1549 if (w == NULL) {
1550 Py_DECREF(v);
1551 return NULL;
1552 }
1553 PyList_SetItem(v, i, w);
1554 if (*p == '\0')
1555 break;
1556 path = p+1;
1557 }
1558 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001559}
1560
1561void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001562PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001563{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001564 PyObject *v;
1565 if ((v = makepathobject(path, DELIM)) == NULL)
1566 Py_FatalError("can't create sys.path");
1567 if (PySys_SetObject("path", v) != 0)
1568 Py_FatalError("can't assign sys.path");
1569 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001570}
1571
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001572static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001573makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001574{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001575 PyObject *av;
1576 if (argc <= 0 || argv == NULL) {
1577 /* Ensure at least one (empty) argument is seen */
1578 static char *empty_argv[1] = {""};
1579 argv = empty_argv;
1580 argc = 1;
1581 }
1582 av = PyList_New(argc);
1583 if (av != NULL) {
1584 int i;
1585 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001586#ifdef __VMS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001587 PyObject *v;
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001588
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001589 /* argv[0] is the script pathname if known */
1590 if (i == 0) {
1591 char* fn = decc$translate_vms(argv[0]);
1592 if ((fn == (char *)0) || fn == (char *)-1)
1593 v = PyString_FromString(argv[0]);
1594 else
1595 v = PyString_FromString(
1596 decc$translate_vms(argv[0]));
1597 } else
1598 v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001599#else
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001600 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001601#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001602 if (v == NULL) {
1603 Py_DECREF(av);
1604 av = NULL;
1605 break;
1606 }
1607 PyList_SetItem(av, i, v);
1608 }
1609 }
1610 return av;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001611}
1612
1613void
Antoine Pitrou6a265602010-05-21 17:12:38 +00001614PySys_SetArgvEx(int argc, char **argv, int updatepath)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001615{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001616#if defined(HAVE_REALPATH)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001617 char fullpath[MAXPATHLEN];
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001618#elif defined(MS_WINDOWS) && !defined(MS_WINCE)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001619 char fullpath[MAX_PATH];
Thomas Heller27bb71e2003-01-08 14:33:48 +00001620#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001621 PyObject *av = makeargvobject(argc, argv);
1622 PyObject *path = PySys_GetObject("path");
1623 if (av == NULL)
1624 Py_FatalError("no mem for sys.argv");
1625 if (PySys_SetObject("argv", av) != 0)
1626 Py_FatalError("can't assign sys.argv");
Antoine Pitrou6a265602010-05-21 17:12:38 +00001627 if (updatepath && path != NULL) {
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001628 char *argv0 = argv[0];
1629 char *p = NULL;
1630 Py_ssize_t n = 0;
1631 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001632#ifdef HAVE_READLINK
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001633 char link[MAXPATHLEN+1];
1634 char argv0copy[2*MAXPATHLEN+1];
1635 int nr = 0;
1636 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
1637 nr = readlink(argv0, link, MAXPATHLEN);
1638 if (nr > 0) {
1639 /* It's a symlink */
1640 link[nr] = '\0';
1641 if (link[0] == SEP)
1642 argv0 = link; /* Link to absolute path */
1643 else if (strchr(link, SEP) == NULL)
1644 ; /* Link without path */
1645 else {
1646 /* Must join(dirname(argv0), link) */
1647 char *q = strrchr(argv0, SEP);
1648 if (q == NULL)
1649 argv0 = link; /* argv0 without path */
1650 else {
1651 /* Must make a copy */
1652 strcpy(argv0copy, argv0);
1653 q = strrchr(argv0copy, SEP);
1654 strcpy(q+1, link);
1655 argv0 = argv0copy;
1656 }
1657 }
1658 }
Guido van Rossumc474dea1997-04-25 15:38:31 +00001659#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001660#if SEP == '\\' /* Special case for MS filename syntax */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001661 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
1662 char *q;
Martin v. Löwis1b3bef22009-01-12 07:57:11 +00001663#if defined(MS_WINDOWS) && !defined(MS_WINCE)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001664 /* This code here replaces the first element in argv with the full
1665 path that it represents. Under CE, there are no relative paths so
1666 the argument must be the full path anyway. */
1667 char *ptemp;
1668 if (GetFullPathName(argv0,
1669 sizeof(fullpath),
1670 fullpath,
1671 &ptemp)) {
1672 argv0 = fullpath;
1673 }
Thomas Heller27bb71e2003-01-08 14:33:48 +00001674#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001675 p = strrchr(argv0, SEP);
1676 /* Test for alternate separator */
1677 q = strrchr(p ? p : argv0, '/');
1678 if (q != NULL)
1679 p = q;
1680 if (p != NULL) {
1681 n = p + 1 - argv0;
1682 if (n > 1 && p[-1] != ':')
1683 n--; /* Drop trailing separator */
1684 }
1685 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001686#else /* All other filename syntaxes */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001687 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001688#if defined(HAVE_REALPATH)
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001689 if (realpath(argv0, fullpath)) {
1690 argv0 = fullpath;
1691 }
Guido van Rossum162e38c2003-02-19 15:25:10 +00001692#endif
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001693 p = strrchr(argv0, SEP);
1694 }
1695 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001696#ifndef RISCOS
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001697 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001698#else /* don't include trailing separator */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001699 n = p - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001700#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001701#if SEP == '/' /* Special case for Unix filename syntax */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001702 if (n > 1)
1703 n--; /* Drop trailing separator */
Guido van Rossumcc883411996-09-10 14:44:21 +00001704#endif /* Unix */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001705 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001706#endif /* All others */
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001707 a = PyString_FromStringAndSize(argv0, n);
1708 if (a == NULL)
1709 Py_FatalError("no mem for sys.path insertion");
1710 if (PyList_Insert(path, 0, a) < 0)
1711 Py_FatalError("sys.path.insert(0) failed");
1712 Py_DECREF(a);
1713 }
1714 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001715}
Guido van Rossuma890e681998-05-12 14:59:24 +00001716
Antoine Pitrou6a265602010-05-21 17:12:38 +00001717void
1718PySys_SetArgv(int argc, char **argv)
1719{
1720 PySys_SetArgvEx(argc, argv, 1);
1721}
1722
Guido van Rossuma890e681998-05-12 14:59:24 +00001723
1724/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1725 Adapted from code submitted by Just van Rossum.
1726
1727 PySys_WriteStdout(format, ...)
1728 PySys_WriteStderr(format, ...)
1729
1730 The first function writes to sys.stdout; the second to sys.stderr. When
1731 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001732 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001733
1734 Both take a printf-style format string as their first argument followed
1735 by a variable length argument list determined by the format string.
1736
1737 *** WARNING ***
1738
1739 The format should limit the total size of the formatted output string to
1740 1000 bytes. In particular, this means that no unrestricted "%s" formats
1741 should occur; these should be limited using "%.<N>s where <N> is a
1742 decimal number calculated so that <N> plus the maximum size of other
1743 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1744 which can print hundreds of digits for very large numbers.
1745
1746 */
1747
1748static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001749mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001750{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001751 PyObject *file;
1752 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001753
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001754 PyErr_Fetch(&error_type, &error_value, &error_traceback);
1755 file = PySys_GetObject(name);
1756 if (file == NULL || PyFile_AsFile(file) == fp)
1757 vfprintf(fp, format, va);
1758 else {
1759 char buffer[1001];
1760 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1761 format, va);
1762 if (PyFile_WriteString(buffer, file) != 0) {
1763 PyErr_Clear();
1764 fputs(buffer, fp);
1765 }
1766 if (written < 0 || (size_t)written >= sizeof(buffer)) {
1767 const char *truncated = "... truncated";
1768 if (PyFile_WriteString(truncated, file) != 0) {
1769 PyErr_Clear();
1770 fputs(truncated, fp);
1771 }
1772 }
1773 }
1774 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001775}
1776
1777void
Guido van Rossuma890e681998-05-12 14:59:24 +00001778PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001779{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001780 va_list va;
Guido van Rossuma890e681998-05-12 14:59:24 +00001781
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001782 va_start(va, format);
1783 mywrite("stdout", stdout, format, va);
1784 va_end(va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001785}
1786
1787void
Guido van Rossuma890e681998-05-12 14:59:24 +00001788PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001789{
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001790 va_list va;
Guido van Rossuma890e681998-05-12 14:59:24 +00001791
Antoine Pitrouc83ea132010-05-09 14:46:46 +00001792 va_start(va, format);
1793 mywrite("stderr", stderr, format, va);
1794 va_end(va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001795}