blob: ea1388b6412469ca0d1c33d57eacf9e609a2cebc [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"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +000018#include "code.h"
Barry Warsawb6a54d22000-12-06 21:47:46 +000019#include "frameobject.h"
Guido van Rossuma12fe4e2003-04-09 19:06:21 +000020#include "eval.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000021
Guido van Rossume2437a11992-03-23 18:20:18 +000022#include "osdefs.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +000023
Mark Hammond8696ebc2002-10-08 02:44:31 +000024#ifdef MS_WINDOWS
25#define WIN32_LEAN_AND_MEAN
26#include "windows.h"
27#endif /* MS_WINDOWS */
28
Guido van Rossum9b38a141996-09-11 23:12:24 +000029#ifdef MS_COREDLL
Guido van Rossumc606fe11996-04-09 02:37:57 +000030extern void *PyWin_DLLhModule;
Guido van Rossum6c1e5f21997-09-29 23:34:23 +000031/* A string loaded from the DLL at startup: */
32extern const char *PyWin_DLLVersionString;
Guido van Rossumc606fe11996-04-09 02:37:57 +000033#endif
34
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +000035#ifdef __VMS
36#include <unixlib.h>
37#endif
38
Martin v. Löwis5467d4c2003-05-10 07:10:12 +000039#ifdef MS_WINDOWS
40#include <windows.h>
41#endif
42
43#ifdef HAVE_LANGINFO_H
44#include <locale.h>
45#include <langinfo.h>
46#endif
47
Guido van Rossum65bf9f21997-04-29 18:33:38 +000048PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000049PySys_GetObject(char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000050{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000051 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000052 PyObject *sd = tstate->interp->sysdict;
Guido van Rossumbe203361999-10-05 22:17:41 +000053 if (sd == NULL)
54 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +000055 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000056}
57
58FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000059PySys_GetFile(char *name, FILE *def)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000060{
61 FILE *fp = NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +000062 PyObject *v = PySys_GetObject(name);
63 if (v != NULL && PyFile_Check(v))
64 fp = PyFile_AsFile(v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000065 if (fp == NULL)
66 fp = def;
67 return fp;
68}
69
70int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000071PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000072{
Nicholas Bastine5662ae2004-03-24 22:22:12 +000073 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum25ce5661997-08-02 03:10:38 +000074 PyObject *sd = tstate->interp->sysdict;
Guido van Rossum5ad58c61992-01-26 18:15:48 +000075 if (v == NULL) {
Guido van Rossum25ce5661997-08-02 03:10:38 +000076 if (PyDict_GetItemString(sd, name) == NULL)
Guido van Rossum5ad58c61992-01-26 18:15:48 +000077 return 0;
78 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000079 return PyDict_DelItemString(sd, name);
Guido van Rossum5ad58c61992-01-26 18:15:48 +000080 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000081 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000082 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000083}
84
Guido van Rossum65bf9f21997-04-29 18:33:38 +000085static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000086sys_displayhook(PyObject *self, PyObject *o)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000087{
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000088 PyObject *outf;
Nicholas Bastine5662ae2004-03-24 22:22:12 +000089 PyInterpreterState *interp = PyThreadState_GET()->interp;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000090 PyObject *modules = interp->modules;
91 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
92
Moshe Zadka03897ea2001-07-23 13:32:43 +000093 if (builtins == NULL) {
94 PyErr_SetString(PyExc_RuntimeError, "lost __builtin__");
95 return NULL;
96 }
97
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000098 /* Print value except if None */
99 /* After printing, also assign to '_' */
100 /* Before, set '_' to None to avoid recursion */
101 if (o == Py_None) {
102 Py_INCREF(Py_None);
103 return Py_None;
104 }
105 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
106 return NULL;
107 if (Py_FlushLine() != 0)
108 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000109 outf = PySys_GetObject("stdout");
110 if (outf == NULL) {
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000111 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
112 return NULL;
113 }
Greg Steinceb9b7c2001-01-11 09:27:34 +0000114 if (PyFile_WriteObject(o, outf, 0) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000115 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000116 PyFile_SoftSpace(outf, 1);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000117 if (Py_FlushLine() != 0)
118 return NULL;
119 if (PyObject_SetAttrString(builtins, "_", o) != 0)
120 return NULL;
121 Py_INCREF(Py_None);
122 return Py_None;
123}
124
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000125PyDoc_STRVAR(displayhook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000126"displayhook(object) -> None\n"
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000127"\n"
Brett Cannon51185172006-03-02 22:07:40 +0000128"Print an object to sys.stdout and also save it in __builtin__.\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000129);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000130
131static PyObject *
132sys_excepthook(PyObject* self, PyObject* args)
133{
134 PyObject *exc, *value, *tb;
Fred Drakea7688822001-10-24 20:47:48 +0000135 if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb))
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000136 return NULL;
137 PyErr_Display(exc, value, tb);
138 Py_INCREF(Py_None);
139 return Py_None;
140}
141
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000142PyDoc_STRVAR(excepthook_doc,
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000143"excepthook(exctype, value, traceback) -> None\n"
144"\n"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000145"Handle an exception by displaying it with a traceback on sys.stderr.\n"
146);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000147
148static PyObject *
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000149sys_exc_info(PyObject *self, PyObject *noargs)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000150{
151 PyThreadState *tstate;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000152 tstate = PyThreadState_GET();
Guido van Rossuma027efa1997-05-05 20:56:21 +0000153 return Py_BuildValue(
154 "(OOO)",
155 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
156 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
157 tstate->exc_traceback != NULL ?
158 tstate->exc_traceback : Py_None);
159}
160
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000161PyDoc_STRVAR(exc_info_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000162"exc_info() -> (type, value, traceback)\n\
163\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000164Return information about the most recent exception caught by an except\n\
165clause in the current stack frame or in an older stack frame."
166);
167
168static PyObject *
169sys_exc_clear(PyObject *self, PyObject *noargs)
170{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000171 PyThreadState *tstate = PyThreadState_GET();
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000172 PyObject *tmp_type, *tmp_value, *tmp_tb;
173 tmp_type = tstate->exc_type;
174 tmp_value = tstate->exc_value;
175 tmp_tb = tstate->exc_traceback;
176 tstate->exc_type = NULL;
177 tstate->exc_value = NULL;
178 tstate->exc_traceback = NULL;
179 Py_XDECREF(tmp_type);
180 Py_XDECREF(tmp_value);
181 Py_XDECREF(tmp_tb);
182 /* For b/w compatibility */
183 PySys_SetObject("exc_type", Py_None);
184 PySys_SetObject("exc_value", Py_None);
185 PySys_SetObject("exc_traceback", Py_None);
186 Py_INCREF(Py_None);
187 return Py_None;
188}
189
190PyDoc_STRVAR(exc_clear_doc,
191"exc_clear() -> None\n\
192\n\
193Clear global information on the current exception. Subsequent calls to\n\
194exc_info() will return (None,None,None) until another exception is raised\n\
195in the current thread or the execution stack returns to a frame where\n\
196another exception is being handled."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000197);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000198
Guido van Rossuma027efa1997-05-05 20:56:21 +0000199static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000200sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000201{
Neal Norwitz0c766a02002-03-27 13:03:09 +0000202 PyObject *exit_code = 0;
Georg Brandl96a8c392006-05-29 21:04:52 +0000203 if (!PyArg_UnpackTuple(args, "exit", 0, 1, &exit_code))
Neal Norwitz0c766a02002-03-27 13:03:09 +0000204 return NULL;
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000205 /* Raise SystemExit so callers may catch it or clean up. */
Neal Norwitz0c766a02002-03-27 13:03:09 +0000206 PyErr_SetObject(PyExc_SystemExit, exit_code);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000207 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000208}
209
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000210PyDoc_STRVAR(exit_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000211"exit([status])\n\
212\n\
213Exit the interpreter by raising SystemExit(status).\n\
214If the status is omitted or None, it defaults to zero (i.e., success).\n\
Neil Schemenauer0f2103f2002-03-23 20:46:35 +0000215If the status is numeric, it will be used as the system exit status.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000216If it is another kind of object, it will be printed and the system\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000217exit status will be one (i.e., failure)."
218);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000219
Martin v. Löwis107b7da2001-11-09 20:59:39 +0000220#ifdef Py_USING_UNICODE
221
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000222static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000223sys_getdefaultencoding(PyObject *self)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000224{
Fred Drake8b4d01d2000-05-09 19:57:01 +0000225 return PyString_FromString(PyUnicode_GetDefaultEncoding());
226}
227
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000228PyDoc_STRVAR(getdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000229"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000230\n\
231Return the current default string encoding used by the Unicode \n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000232implementation."
233);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000234
235static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000236sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000237{
238 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000239 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000240 return NULL;
241 if (PyUnicode_SetDefaultEncoding(encoding))
242 return NULL;
243 Py_INCREF(Py_None);
244 return Py_None;
245}
246
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000247PyDoc_STRVAR(setdefaultencoding_doc,
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000248"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000249\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000250Set the current default string encoding used by the Unicode implementation."
251);
Fred Drake8b4d01d2000-05-09 19:57:01 +0000252
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000253static PyObject *
254sys_getfilesystemencoding(PyObject *self)
255{
256 if (Py_FileSystemDefaultEncoding)
257 return PyString_FromString(Py_FileSystemDefaultEncoding);
258 Py_INCREF(Py_None);
259 return Py_None;
260}
261
262PyDoc_STRVAR(getfilesystemencoding_doc,
263"getfilesystemencoding() -> string\n\
264\n\
265Return the encoding used to convert Unicode filenames in\n\
266operating system filenames."
267);
268
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000269#endif
270
Fred Drake5755ce62001-06-27 19:19:46 +0000271/*
272 * Cached interned string objects used for calling the profile and
273 * trace functions. Initialized by trace_init().
274 */
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000275static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL};
Fred Drake5755ce62001-06-27 19:19:46 +0000276
277static int
278trace_init(void)
279{
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000280 static char *whatnames[7] = {"call", "exception", "line", "return",
281 "c_call", "c_exception", "c_return"};
Fred Drake5755ce62001-06-27 19:19:46 +0000282 PyObject *name;
283 int i;
Nicholas Bastinc69ebe82004-03-24 21:57:10 +0000284 for (i = 0; i < 7; ++i) {
Fred Drake5755ce62001-06-27 19:19:46 +0000285 if (whatstrings[i] == NULL) {
286 name = PyString_InternFromString(whatnames[i]);
287 if (name == NULL)
288 return -1;
289 whatstrings[i] = name;
290 }
291 }
292 return 0;
293}
294
295
296static PyObject *
297call_trampoline(PyThreadState *tstate, PyObject* callback,
298 PyFrameObject *frame, int what, PyObject *arg)
299{
300 PyObject *args = PyTuple_New(3);
301 PyObject *whatstr;
302 PyObject *result;
303
304 if (args == NULL)
305 return NULL;
306 Py_INCREF(frame);
307 whatstr = whatstrings[what];
308 Py_INCREF(whatstr);
309 if (arg == NULL)
310 arg = Py_None;
311 Py_INCREF(arg);
312 PyTuple_SET_ITEM(args, 0, (PyObject *)frame);
313 PyTuple_SET_ITEM(args, 1, whatstr);
314 PyTuple_SET_ITEM(args, 2, arg);
315
316 /* call the Python-level function */
317 PyFrame_FastToLocals(frame);
318 result = PyEval_CallObject(callback, args);
319 PyFrame_LocalsToFast(frame, 1);
320 if (result == NULL)
321 PyTraceBack_Here(frame);
322
323 /* cleanup */
324 Py_DECREF(args);
325 return result;
326}
327
328static int
329profile_trampoline(PyObject *self, PyFrameObject *frame,
330 int what, PyObject *arg)
331{
332 PyThreadState *tstate = frame->f_tstate;
333 PyObject *result;
334
Fred Drake8f51f542001-10-04 14:48:42 +0000335 if (arg == NULL)
336 arg = Py_None;
Fred Drake5755ce62001-06-27 19:19:46 +0000337 result = call_trampoline(tstate, self, frame, what, arg);
338 if (result == NULL) {
339 PyEval_SetProfile(NULL, NULL);
340 return -1;
341 }
342 Py_DECREF(result);
343 return 0;
344}
345
346static int
347trace_trampoline(PyObject *self, PyFrameObject *frame,
348 int what, PyObject *arg)
349{
350 PyThreadState *tstate = frame->f_tstate;
351 PyObject *callback;
352 PyObject *result;
353
354 if (what == PyTrace_CALL)
355 callback = self;
356 else
357 callback = frame->f_trace;
358 if (callback == NULL)
359 return 0;
360 result = call_trampoline(tstate, callback, frame, what, arg);
361 if (result == NULL) {
362 PyEval_SetTrace(NULL, NULL);
363 Py_XDECREF(frame->f_trace);
364 frame->f_trace = NULL;
365 return -1;
366 }
367 if (result != Py_None) {
368 PyObject *temp = frame->f_trace;
369 frame->f_trace = NULL;
370 Py_XDECREF(temp);
371 frame->f_trace = result;
372 }
373 else {
374 Py_DECREF(result);
375 }
376 return 0;
377}
Fred Draked0838392001-06-16 21:02:31 +0000378
Fred Drake8b4d01d2000-05-09 19:57:01 +0000379static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000380sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000381{
Fred Drake5755ce62001-06-27 19:19:46 +0000382 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000383 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000384 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000385 PyEval_SetTrace(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000386 else
Fred Drake5755ce62001-06-27 19:19:46 +0000387 PyEval_SetTrace(trace_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000388 Py_INCREF(Py_None);
389 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000390}
391
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000392PyDoc_STRVAR(settrace_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000393"settrace(function)\n\
394\n\
395Set the global debug tracing function. It will be called on each\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000396function call. See the debugger chapter in the library manual."
397);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000398
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000399static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000400sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000401{
Fred Drake5755ce62001-06-27 19:19:46 +0000402 if (trace_init() == -1)
Fred Draked0838392001-06-16 21:02:31 +0000403 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000404 if (args == Py_None)
Fred Drake5755ce62001-06-27 19:19:46 +0000405 PyEval_SetProfile(NULL, NULL);
Guido van Rossume765f7d1992-04-05 14:17:55 +0000406 else
Fred Drake5755ce62001-06-27 19:19:46 +0000407 PyEval_SetProfile(profile_trampoline, args);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000408 Py_INCREF(Py_None);
409 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000410}
411
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000412PyDoc_STRVAR(setprofile_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000413"setprofile(function)\n\
414\n\
415Set the profiling function. It will be called on each function call\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000416and return. See the profiler chapter in the library manual."
417);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000418
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000419static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000420sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000421{
Skip Montanarod581d772002-09-03 20:10:45 +0000422 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000423 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000424 Py_INCREF(Py_None);
425 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000426}
427
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000428PyDoc_STRVAR(setcheckinterval_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000429"setcheckinterval(n)\n\
430\n\
431Tell the Python interpreter to check for asynchronous events every\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000432n instructions. This also affects how often thread switches occur."
433);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000434
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000435static PyObject *
Tim Peterse5e065b2003-07-06 18:36:54 +0000436sys_getcheckinterval(PyObject *self, PyObject *args)
437{
438 return PyInt_FromLong(_Py_CheckInterval);
439}
440
441PyDoc_STRVAR(getcheckinterval_doc,
442"getcheckinterval() -> current check interval; see setcheckinterval()."
443);
444
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000445#ifdef WITH_TSC
446static PyObject *
447sys_settscdump(PyObject *self, PyObject *args)
448{
449 int bool;
450 PyThreadState *tstate = PyThreadState_Get();
451
452 if (!PyArg_ParseTuple(args, "i:settscdump", &bool))
453 return NULL;
454 if (bool)
455 tstate->interp->tscdump = 1;
456 else
457 tstate->interp->tscdump = 0;
458 Py_INCREF(Py_None);
459 return Py_None;
Tim Peters216b78b2006-01-06 02:40:53 +0000460
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000461}
462
Tim Peters216b78b2006-01-06 02:40:53 +0000463PyDoc_STRVAR(settscdump_doc,
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000464"settscdump(bool)\n\
465\n\
466If true, tell the Python interpreter to dump VM measurements to\n\
467stderr. If false, turn off dump. The measurements are based on the\n\
Michael W. Hudson800ba232004-08-12 18:19:17 +0000468processor's time-stamp counter."
Tim Peters216b78b2006-01-06 02:40:53 +0000469);
Neal Norwitz0f5aed42004-06-13 20:32:17 +0000470#endif /* TSC */
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000471
Tim Peterse5e065b2003-07-06 18:36:54 +0000472static PyObject *
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000473sys_setrecursionlimit(PyObject *self, PyObject *args)
474{
475 int new_limit;
476 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
477 return NULL;
478 if (new_limit <= 0) {
Tim Peters216b78b2006-01-06 02:40:53 +0000479 PyErr_SetString(PyExc_ValueError,
480 "recursion limit must be positive");
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000481 return NULL;
482 }
483 Py_SetRecursionLimit(new_limit);
484 Py_INCREF(Py_None);
485 return Py_None;
486}
487
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000488PyDoc_STRVAR(setrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000489"setrecursionlimit(n)\n\
490\n\
491Set the maximum depth of the Python interpreter stack to n. This\n\
492limit prevents infinite recursion from causing an overflow of the C\n\
493stack and crashing Python. The highest possible limit is platform-\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000494dependent."
495);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000496
497static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000498sys_getrecursionlimit(PyObject *self)
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000499{
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000500 return PyInt_FromLong(Py_GetRecursionLimit());
501}
502
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000503PyDoc_STRVAR(getrecursionlimit_doc,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000504"getrecursionlimit()\n\
505\n\
506Return the current value of the recursion limit, the maximum depth\n\
507of the Python interpreter stack. This limit prevents infinite\n\
Jack Jansene739a0d2002-06-26 20:39:20 +0000508recursion from causing an overflow of the C stack and crashing Python."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000509);
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000510
Mark Hammond8696ebc2002-10-08 02:44:31 +0000511#ifdef MS_WINDOWS
512PyDoc_STRVAR(getwindowsversion_doc,
513"getwindowsversion()\n\
514\n\
515Return information about the running version of Windows.\n\
516The result is a tuple of (major, minor, build, platform, text)\n\
517All elements are numbers, except text which is a string.\n\
518Platform may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP\n\
519"
520);
521
522static PyObject *
523sys_getwindowsversion(PyObject *self)
524{
525 OSVERSIONINFO ver;
526 ver.dwOSVersionInfoSize = sizeof(ver);
527 if (!GetVersionEx(&ver))
528 return PyErr_SetFromWindowsErr(0);
529 return Py_BuildValue("HHHHs",
530 ver.dwMajorVersion,
531 ver.dwMinorVersion,
532 ver.dwBuildNumber,
533 ver.dwPlatformId,
534 ver.szCSDVersion);
535}
536
537#endif /* MS_WINDOWS */
538
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000539#ifdef HAVE_DLOPEN
540static PyObject *
541sys_setdlopenflags(PyObject *self, PyObject *args)
542{
543 int new_val;
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000544 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000545 if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val))
546 return NULL;
547 if (!tstate)
548 return NULL;
549 tstate->interp->dlopenflags = new_val;
550 Py_INCREF(Py_None);
551 return Py_None;
552}
553
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000554PyDoc_STRVAR(setdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000555"setdlopenflags(n) -> None\n\
556\n\
557Set the flags that will be used for dlopen() calls. Among other\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000558things, this will enable a lazy resolving of symbols when importing\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000559a module, if called as sys.setdlopenflags(0)\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000560To share symbols across extension modules, call as\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000561sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)"
562);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000563
564static PyObject *
565sys_getdlopenflags(PyObject *self, PyObject *args)
566{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000567 PyThreadState *tstate = PyThreadState_GET();
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000568 if (!tstate)
569 return NULL;
570 return PyInt_FromLong(tstate->interp->dlopenflags);
571}
572
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000573PyDoc_STRVAR(getdlopenflags_doc,
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000574"getdlopenflags() -> int\n\
575\n\
576Return the current value of the flags that are used for dlopen()\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000577calls. The flag constants are defined in the dl module."
578);
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000579#endif
580
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000581#ifdef USE_MALLOPT
582/* Link with -lmalloc (or -lmpc) on an SGI */
583#include <malloc.h>
584
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000585static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000586sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000587{
588 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000589 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000590 return NULL;
591 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000592 Py_INCREF(Py_None);
593 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000594}
595#endif /* USE_MALLOPT */
596
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000597static PyObject *
Fred Drakea7688822001-10-24 20:47:48 +0000598sys_getrefcount(PyObject *self, PyObject *arg)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000599{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000600 return PyInt_FromSsize_t(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000601}
602
Tim Peters4be93d02002-07-07 19:59:50 +0000603#ifdef Py_REF_DEBUG
Mark Hammond440d8982000-06-20 08:12:48 +0000604static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000605sys_gettotalrefcount(PyObject *self)
Mark Hammond440d8982000-06-20 08:12:48 +0000606{
Armin Rigoe1709372006-04-12 17:06:05 +0000607 return PyInt_FromSsize_t(_Py_GetRefTotal());
Mark Hammond440d8982000-06-20 08:12:48 +0000608}
Armin Rigoe1709372006-04-12 17:06:05 +0000609#endif /* Py_REF_DEBUG */
Mark Hammond440d8982000-06-20 08:12:48 +0000610
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000611PyDoc_STRVAR(getrefcount_doc,
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000612"getrefcount(object) -> integer\n\
613\n\
Fred Drakeba3ff1b2002-06-20 21:36:19 +0000614Return the reference count of object. The count returned is generally\n\
615one higher than you might expect, because it includes the (temporary)\n\
616reference as an argument to getrefcount()."
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000617);
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000618
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000619#ifdef COUNT_ALLOCS
620static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000621sys_getcounts(PyObject *self)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000622{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000623 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000624
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000625 return get_counts();
626}
627#endif
628
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000629PyDoc_STRVAR(getframe_doc,
Barry Warsawb6a54d22000-12-06 21:47:46 +0000630"_getframe([depth]) -> frameobject\n\
631\n\
632Return a frame object from the call stack. If optional integer depth is\n\
633given, return the frame object that many calls below the top of the stack.\n\
634If that is deeper than the call stack, ValueError is raised. The default\n\
635for depth is zero, returning the frame at the top of the call stack.\n\
636\n\
637This function should be used for internal and specialized\n\
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000638purposes only."
639);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000640
641static PyObject *
642sys_getframe(PyObject *self, PyObject *args)
643{
Nicholas Bastine5662ae2004-03-24 22:22:12 +0000644 PyFrameObject *f = PyThreadState_GET()->frame;
Barry Warsawb6a54d22000-12-06 21:47:46 +0000645 int depth = -1;
646
647 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
648 return NULL;
649
650 while (depth > 0 && f != NULL) {
651 f = f->f_back;
652 --depth;
653 }
654 if (f == NULL) {
655 PyErr_SetString(PyExc_ValueError,
656 "call stack is not deep enough");
657 return NULL;
658 }
659 Py_INCREF(f);
660 return (PyObject*)f;
661}
662
Tim Peters32a83612006-07-10 21:08:24 +0000663PyDoc_STRVAR(current_frames_doc,
664"_current_frames() -> dictionary\n\
665\n\
666Return a dictionary mapping each current thread T's thread id to T's\n\
667current stack frame.\n\
668\n\
669This function should be used for specialized purposes only."
670);
671
672static PyObject *
673sys_current_frames(PyObject *self, PyObject *noargs)
674{
675 return _PyThread_CurrentFrames();
676}
677
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000678PyDoc_STRVAR(call_tracing_doc,
679"call_tracing(func, args) -> object\n\
680\n\
681Call func(*args), while tracing is enabled. The tracing state is\n\
682saved, and restored afterwards. This is intended to be called from\n\
683a debugger from a checkpoint, to recursively debug some other code."
684);
685
686static PyObject *
687sys_call_tracing(PyObject *self, PyObject *args)
688{
689 PyObject *func, *funcargs;
Georg Brandl96a8c392006-05-29 21:04:52 +0000690 if (!PyArg_UnpackTuple(args, "call_tracing", 2, 2, &func, &funcargs))
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000691 return NULL;
692 return _PyEval_CallTracing(func, funcargs);
693}
694
Jeremy Hylton985eba52003-02-05 23:13:00 +0000695PyDoc_STRVAR(callstats_doc,
696"callstats() -> tuple of integers\n\
697\n\
698Return a tuple of function call statistics, if CALL_PROFILE was defined\n\
699when Python was built. Otherwise, return None.\n\
700\n\
701When enabled, this function returns detailed, implementation-specific\n\
702details about the number of function calls executed. The return value is\n\
703a 11-tuple where the entries in the tuple are counts of:\n\
7040. all function calls\n\
7051. calls to PyFunction_Type objects\n\
7062. PyFunction calls that do not create an argument tuple\n\
7073. PyFunction calls that do not create an argument tuple\n\
708 and bypass PyEval_EvalCodeEx()\n\
7094. PyMethod calls\n\
7105. PyMethod calls on bound methods\n\
7116. PyType calls\n\
7127. PyCFunction calls\n\
7138. generator calls\n\
7149. All other calls\n\
71510. Number of stack pops performed by call_function()"
716);
Barry Warsawb6a54d22000-12-06 21:47:46 +0000717
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000718#ifdef __cplusplus
719extern "C" {
720#endif
721
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000722#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000723/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000724extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000725#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000726
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000727#ifdef DYNAMIC_EXECUTION_PROFILE
728/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000729extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000730#endif
731
Skip Montanaro53a6d1d2006-04-18 00:55:46 +0000732#ifdef __cplusplus
733}
734#endif
735
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000736static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000737 /* Might as well keep this in alphabetic order */
Tim Peters216b78b2006-01-06 02:40:53 +0000738 {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS,
Jeremy Hylton985eba52003-02-05 23:13:00 +0000739 callstats_doc},
Tim Peters32a83612006-07-10 21:08:24 +0000740 {"_current_frames", sys_current_frames, METH_NOARGS,
741 current_frames_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000742 {"displayhook", sys_displayhook, METH_O, displayhook_doc},
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000743 {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc},
744 {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000745 {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc},
Neal Norwitz0c766a02002-03-27 13:03:09 +0000746 {"exit", sys_exit, METH_VARARGS, exit_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000747#ifdef Py_USING_UNICODE
Tim Peters216b78b2006-01-06 02:40:53 +0000748 {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding,
749 METH_NOARGS, getdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000750#endif
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000751#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000752 {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000753 getdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000754#endif
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000755#ifdef COUNT_ALLOCS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000756 {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000757#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000758#ifdef DYNAMIC_EXECUTION_PROFILE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000759 {"getdxp", _Py_GetDXProfile, METH_VARARGS},
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000760#endif
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000761#ifdef Py_USING_UNICODE
762 {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding,
Tim Peters216b78b2006-01-06 02:40:53 +0000763 METH_NOARGS, getfilesystemencoding_doc},
Martin v. Löwis73d538b2003-03-05 15:13:47 +0000764#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000765#ifdef Py_TRACE_REFS
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000766 {"getobjects", _Py_GetObjects, METH_VARARGS},
Tim Peters4be93d02002-07-07 19:59:50 +0000767#endif
768#ifdef Py_REF_DEBUG
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000769 {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000770#endif
Fred Drakea7688822001-10-24 20:47:48 +0000771 {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000772 {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000773 getrecursionlimit_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000774 {"_getframe", sys_getframe, METH_VARARGS, getframe_doc},
Mark Hammond8696ebc2002-10-08 02:44:31 +0000775#ifdef MS_WINDOWS
776 {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS,
777 getwindowsversion_doc},
778#endif /* MS_WINDOWS */
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000779#ifdef USE_MALLOPT
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000780 {"mdebug", sys_mdebug, METH_VARARGS},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000781#endif
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000782#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000783 {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000784 setdefaultencoding_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000785#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000786 {"setcheckinterval", sys_setcheckinterval, METH_VARARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000787 setcheckinterval_doc},
Tim Peterse5e065b2003-07-06 18:36:54 +0000788 {"getcheckinterval", sys_getcheckinterval, METH_NOARGS,
Tim Peters216b78b2006-01-06 02:40:53 +0000789 getcheckinterval_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000790#ifdef HAVE_DLOPEN
Tim Peters216b78b2006-01-06 02:40:53 +0000791 {"setdlopenflags", sys_setdlopenflags, METH_VARARGS,
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000792 setdlopenflags_doc},
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000793#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000794 {"setprofile", sys_setprofile, METH_O, setprofile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000795 {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS,
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000796 setrecursionlimit_doc},
Martin v. Löwisf30d60e2004-06-08 08:17:44 +0000797#ifdef WITH_TSC
798 {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc},
799#endif
Neal Norwitz290d31e2002-03-03 15:12:58 +0000800 {"settrace", sys_settrace, METH_O, settrace_doc},
Guido van Rossuma12fe4e2003-04-09 19:06:21 +0000801 {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000802 {NULL, NULL} /* sentinel */
803};
804
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000805static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000806list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000807{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000808 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000809 int i;
810 if (list == NULL)
811 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000812 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Guido van Rossuma027efa1997-05-05 20:56:21 +0000813 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000814 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000815 if (name == NULL)
816 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000817 PyList_Append(list, name);
818 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000819 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000820 if (PyList_Sort(list) != 0) {
821 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000822 list = NULL;
823 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000824 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000825 PyObject *v = PyList_AsTuple(list);
826 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000827 list = v;
828 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000829 return list;
830}
831
Guido van Rossum23fff912000-12-15 22:02:05 +0000832static PyObject *warnoptions = NULL;
833
834void
835PySys_ResetWarnOptions(void)
836{
837 if (warnoptions == NULL || !PyList_Check(warnoptions))
838 return;
839 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
840}
841
842void
843PySys_AddWarnOption(char *s)
844{
845 PyObject *str;
846
847 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
848 Py_XDECREF(warnoptions);
849 warnoptions = PyList_New(0);
850 if (warnoptions == NULL)
851 return;
852 }
853 str = PyString_FromString(s);
854 if (str != NULL) {
855 PyList_Append(warnoptions, str);
856 Py_DECREF(str);
857 }
858}
859
Guido van Rossum40552d01998-08-06 03:34:39 +0000860/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
861 Two literals concatenated works just fine. If you have a K&R compiler
862 or other abomination that however *does* understand longer strings,
863 get rid of the !!! comment in the middle and the quotes that surround it. */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000864PyDoc_VAR(sys_doc) =
865PyDoc_STR(
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000866"This module provides access to some objects used or maintained by the\n\
867interpreter and to functions that interact strongly with the interpreter.\n\
868\n\
869Dynamic objects:\n\
870\n\
871argv -- command line arguments; argv[0] is the script pathname if known\n\
872path -- module search path; path[0] is the script directory, else ''\n\
873modules -- dictionary of loaded modules\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000874\n\
875displayhook -- called to show results in an interactive session\n\
876excepthook -- called to handle any uncaught exception other than SystemExit\n\
877 To customize printing in an interactive session or to install a custom\n\
878 top-level exception handler, assign other functions to replace these.\n\
879\n\
880exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\
881 Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000882\n\
883stdin -- standard input file object; used by raw_input() and input()\n\
884stdout -- standard output file object; used by the print statement\n\
885stderr -- standard error object; used for error messages\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000886 By assigning other file objects (or objects that behave like files)\n\
887 to these, it is possible to redirect all of the interpreter's I/O.\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000888\n\
889last_type -- type of last uncaught exception\n\
890last_value -- value of last uncaught exception\n\
891last_traceback -- traceback of last uncaught exception\n\
892 These three are only available in an interactive session after a\n\
893 traceback has been printed.\n\
894\n\
895exc_type -- type of exception currently being handled\n\
896exc_value -- value of exception currently being handled\n\
897exc_traceback -- traceback of exception currently being handled\n\
898 The function exc_info() should be used instead of these three,\n\
899 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000900"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000901)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000902/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000903PyDoc_STR(
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000904"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000905Static objects:\n\
906\n\
907maxint -- the largest supported integer (the smallest is -maxint-1)\n\
Martin v. Löwisce9b5a52001-06-27 06:28:56 +0000908maxunicode -- the largest supported character\n\
Neal Norwitz2a47c0f2002-01-29 00:53:41 +0000909builtin_module_names -- tuple of module names built into this interpreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +0000910version -- the version of this interpreter as a string\n\
911version_info -- version information as a tuple\n\
912hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000913copyright -- copyright notice pertaining to this interpreter\n\
914platform -- platform identifier\n\
915executable -- pathname of this Python interpreter\n\
916prefix -- prefix used to find the Python library\n\
917exec_prefix -- prefix used to find the machine-specific Python library\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000918"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000919)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000920#ifdef MS_WINDOWS
921/* concatenating string here */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000922PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000923"dllhandle -- [Windows only] integer handle of the Python DLL\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000924winver -- [Windows only] version number of the Python DLL\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000925"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000926)
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000927#endif /* MS_WINDOWS */
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000928PyDoc_STR(
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000929"__stdin__ -- the original stdin; don't touch!\n\
930__stdout__ -- the original stdout; don't touch!\n\
931__stderr__ -- the original stderr; don't touch!\n\
932__displayhook__ -- the original displayhook; don't touch!\n\
933__excepthook__ -- the original excepthook; don't touch!\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000934\n\
935Functions:\n\
936\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000937displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +0000938excepthook() -- print an exception and its traceback to sys.stderr\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000939exc_info() -- return thread-safe information about the current exception\n\
Guido van Rossum46d3dc32003-03-01 03:20:41 +0000940exc_clear() -- clear the exception state for the current thread\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000941exit() -- exit the interpreter by raising SystemExit\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000942getdlopenflags() -- returns flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000943getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000944getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000945setcheckinterval() -- control how often the interpreter checks for events\n\
Martin v. Löwisf0473d52001-07-18 16:17:16 +0000946setdlopenflags() -- set the flags to be used for dlopen() calls\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000947setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000948setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000949settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +0000950"
Martin v. Löwisa3fb4f72002-06-09 13:33:54 +0000951)
Fred Drakeccede592000-08-14 20:59:57 +0000952/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000953
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +0000954static int
955_check_and_flush (FILE *stream)
956{
957 int prev_fail = ferror (stream);
958 return fflush (stream) || prev_fail ? EOF : 0;
959}
960
Martin v. Löwis43b57802006-01-05 23:38:54 +0000961/* Subversion branch and revision management */
962static const char _patchlevel_revision[] = PY_PATCHLEVEL_REVISION;
963static const char headurl[] = "$HeadURL$";
964static int svn_initialized;
965static char patchlevel_revision[50]; /* Just the number */
966static char branch[50];
967static char shortbranch[50];
968static const char *svn_revision;
969
Tim Peterse86e7a52006-01-06 02:42:46 +0000970static void
971svnversion_init(void)
Martin v. Löwis43b57802006-01-05 23:38:54 +0000972{
973 const char *python, *br_start, *br_end, *br_end2, *svnversion;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000974 Py_ssize_t len;
975 int istag;
Martin v. Löwis43b57802006-01-05 23:38:54 +0000976
977 if (svn_initialized)
978 return;
979
980 python = strstr(headurl, "/python/");
981 if (!python)
982 Py_FatalError("subversion keywords missing");
983
984 br_start = python + 8;
985 br_end = strchr(br_start, '/');
Tim Peters216b78b2006-01-06 02:40:53 +0000986 /* Works even for trunk,
Martin v. Löwis43b57802006-01-05 23:38:54 +0000987 as we are in trunk/Python/sysmodule.c */
988 br_end2 = strchr(br_end+1, '/');
989
990 istag = strncmp(br_start, "tags", 4) == 0;
991 if (strncmp(br_start, "trunk", 5) == 0) {
992 strcpy(branch, "trunk");
993 strcpy(shortbranch, "trunk");
994
Tim Peters216b78b2006-01-06 02:40:53 +0000995 }
Martin v. Löwis43b57802006-01-05 23:38:54 +0000996 else if (istag || strncmp(br_start, "branches", 8) == 0) {
997 len = br_end2 - br_start;
998 strncpy(branch, br_start, len);
999 branch[len] = '\0';
1000
1001 len = br_end2 - (br_end + 1);
1002 strncpy(shortbranch, br_end + 1, len);
1003 shortbranch[len] = '\0';
Tim Peters216b78b2006-01-06 02:40:53 +00001004 }
Martin v. Löwis43b57802006-01-05 23:38:54 +00001005 else {
1006 Py_FatalError("bad HeadURL");
1007 return;
1008 }
1009
1010
1011 svnversion = _Py_svnversion();
1012 if (strcmp(svnversion, "exported") != 0)
1013 svn_revision = svnversion;
1014 else if (istag) {
1015 len = strlen(_patchlevel_revision);
1016 strncpy(patchlevel_revision, _patchlevel_revision + 11,
1017 len - 13);
1018 patchlevel_revision[len - 13] = '\0';
1019 svn_revision = patchlevel_revision;
1020 }
1021 else
1022 svn_revision = "";
Tim Peters216b78b2006-01-06 02:40:53 +00001023
Martin v. Löwis43b57802006-01-05 23:38:54 +00001024 svn_initialized = 1;
1025}
1026
1027/* Return svnversion output if available.
1028 Else return Revision of patchlevel.h if on branch.
1029 Else return empty string */
1030const char*
1031Py_SubversionRevision()
1032{
1033 svnversion_init();
1034 return svn_revision;
1035}
1036
1037const char*
1038Py_SubversionShortBranch()
1039{
1040 svnversion_init();
1041 return shortbranch;
1042}
1043
Guido van Rossum25ce5661997-08-02 03:10:38 +00001044PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001045_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001046{
Guido van Rossum25ce5661997-08-02 03:10:38 +00001047 PyObject *m, *v, *sysdict;
1048 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +00001049 char *s;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001050#ifdef MS_WINDOWS
Tim Peters02f1d0d2006-06-06 00:25:07 +00001051 char buf[128];
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001052#endif
Guido van Rossum25ce5661997-08-02 03:10:38 +00001053
Guido van Rossumc3bc31e1998-06-27 19:43:25 +00001054 m = Py_InitModule3("sys", sys_methods, sys_doc);
Neal Norwitz1ac754f2006-01-19 06:09:39 +00001055 if (m == NULL)
1056 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001057 sysdict = PyModule_GetDict(m);
Guido van Rossum25ce5661997-08-02 03:10:38 +00001058
Neal Norwitz11bd1192005-10-03 00:54:56 +00001059 {
1060 /* XXX: does this work on Win/Win64? (see posix_fstat) */
1061 struct stat sb;
1062 if (fstat(fileno(stdin), &sb) == 0 &&
1063 S_ISDIR(sb.st_mode)) {
Neal Norwitz72c2c062006-03-09 05:58:11 +00001064 /* There's nothing more we can do. */
1065 /* Py_FatalError() will core dump, so just exit. */
1066 PySys_WriteStderr("Python error: <stdin> is a directory, cannot continue\n");
1067 exit(EXIT_FAILURE);
Neal Norwitz11bd1192005-10-03 00:54:56 +00001068 }
1069 }
1070
Martin v. Löwis13a1fde2005-01-27 18:56:16 +00001071 /* Closing the standard FILE* if sys.std* goes aways causes problems
1072 * for embedded Python usages. Closing them when somebody explicitly
1073 * invokes .close() might be possible, but the FAQ promises they get
1074 * never closed. However, we still need to get write errors when
1075 * writing fails (e.g. because stdout is redirected), so we flush the
1076 * streams and check for errors before the file objects are deleted.
1077 * On OS X, fflush()ing stdin causes an error, so we exempt stdin
1078 * from that procedure.
1079 */
1080 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
Martin v. Löwis8e3ca8a2005-01-23 09:41:49 +00001081 sysout = PyFile_FromFile(stdout, "<stdout>", "w", _check_and_flush);
1082 syserr = PyFile_FromFile(stderr, "<stderr>", "w", _check_and_flush);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001083 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001084 return NULL;
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001085#ifdef MS_WINDOWS
1086 if(isatty(_fileno(stdin))){
1087 sprintf(buf, "cp%d", GetConsoleCP());
1088 if (!PyFile_SetEncoding(sysin, buf))
1089 return NULL;
1090 }
1091 if(isatty(_fileno(stdout))) {
1092 sprintf(buf, "cp%d", GetConsoleOutputCP());
1093 if (!PyFile_SetEncoding(sysout, buf))
1094 return NULL;
1095 }
Martin v. Löwisea62d252006-04-03 10:56:49 +00001096 if(isatty(_fileno(stderr))) {
1097 sprintf(buf, "cp%d", GetConsoleOutputCP());
1098 if (!PyFile_SetEncoding(syserr, buf))
1099 return NULL;
1100 }
Martin v. Löwis5467d4c2003-05-10 07:10:12 +00001101#endif
1102
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001103 PyDict_SetItemString(sysdict, "stdin", sysin);
1104 PyDict_SetItemString(sysdict, "stdout", sysout);
1105 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +00001106 /* Make backup copies for cleanup */
1107 PyDict_SetItemString(sysdict, "__stdin__", sysin);
1108 PyDict_SetItemString(sysdict, "__stdout__", sysout);
1109 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Ka-Ping Yeeb5c51322001-03-23 02:46:52 +00001110 PyDict_SetItemString(sysdict, "__displayhook__",
1111 PyDict_GetItemString(sysdict, "displayhook"));
1112 PyDict_SetItemString(sysdict, "__excepthook__",
1113 PyDict_GetItemString(sysdict, "excepthook"));
Guido van Rossum25ce5661997-08-02 03:10:38 +00001114 Py_XDECREF(sysin);
1115 Py_XDECREF(sysout);
1116 Py_XDECREF(syserr);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001117 PyDict_SetItemString(sysdict, "version",
1118 v = PyString_FromString(Py_GetVersion()));
Barry Warsaw54892c41999-01-27 16:33:19 +00001119 Py_XDECREF(v);
Guido van Rossume0d7dae1999-01-03 12:55:39 +00001120 PyDict_SetItemString(sysdict, "hexversion",
1121 v = PyInt_FromLong(PY_VERSION_HEX));
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001122 Py_XDECREF(v);
Martin v. Löwis43b57802006-01-05 23:38:54 +00001123 svnversion_init();
1124 v = Py_BuildValue("(ssz)", "CPython", branch, svn_revision);
1125 PyDict_SetItemString(sysdict, "subversion", v);
Barry Warsaw2a38a862005-12-18 01:27:35 +00001126 Py_XDECREF(v);
Fred Drake93a20bf2000-04-13 17:44:51 +00001127 /*
1128 * These release level checks are mutually exclusive and cover
1129 * the field, so don't get too fancy with the pre-processor!
1130 */
1131#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001132 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +00001133#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001134 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +00001135#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +00001136 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +00001137#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +00001138 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +00001139#endif
Fred Drake801c08d2000-04-13 15:29:10 +00001140 PyDict_SetItemString(sysdict, "version_info",
Fred Drake6d27c1e2000-04-13 20:03:20 +00001141 v = Py_BuildValue("iiisi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +00001142 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +00001143 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +00001144 PY_RELEASE_SERIAL));
Fred Drake801c08d2000-04-13 15:29:10 +00001145 Py_XDECREF(v);
Skip Montanaro8e790e72002-09-03 13:25:17 +00001146 PyDict_SetItemString(sysdict, "api_version",
1147 v = PyInt_FromLong(PYTHON_API_VERSION));
1148 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001149 PyDict_SetItemString(sysdict, "copyright",
1150 v = PyString_FromString(Py_GetCopyright()));
1151 Py_XDECREF(v);
1152 PyDict_SetItemString(sysdict, "platform",
1153 v = PyString_FromString(Py_GetPlatform()));
1154 Py_XDECREF(v);
Guido van Rossumb2c8ec41997-05-22 20:41:20 +00001155 PyDict_SetItemString(sysdict, "executable",
1156 v = PyString_FromString(Py_GetProgramFullPath()));
1157 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001158 PyDict_SetItemString(sysdict, "prefix",
1159 v = PyString_FromString(Py_GetPrefix()));
1160 Py_XDECREF(v);
1161 PyDict_SetItemString(sysdict, "exec_prefix",
1162 v = PyString_FromString(Py_GetExecPrefix()));
1163 Py_XDECREF(v);
1164 PyDict_SetItemString(sysdict, "maxint",
1165 v = PyInt_FromLong(PyInt_GetMax()));
1166 Py_XDECREF(v);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001167#ifdef Py_USING_UNICODE
Martin v. Löwisce9b5a52001-06-27 06:28:56 +00001168 PyDict_SetItemString(sysdict, "maxunicode",
1169 v = PyInt_FromLong(PyUnicode_GetMax()));
1170 Py_XDECREF(v);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001171#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001172 PyDict_SetItemString(sysdict, "builtin_module_names",
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001173 v = list_builtin_module_names());
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001174 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +00001175 {
1176 /* Assumes that longs are at least 2 bytes long.
1177 Should be safe! */
1178 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +00001179 char *value;
Fred Drake099325e2000-08-14 15:47:03 +00001180
1181 s = (char *) &number;
1182 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +00001183 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +00001184 else
Fred Drakea2b6ad62000-08-15 04:24:43 +00001185 value = "little";
1186 PyDict_SetItemString(sysdict, "byteorder",
Barry Warsawf2581c92000-08-16 23:03:57 +00001187 v = PyString_FromString(value));
1188 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +00001189 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +00001190#ifdef MS_COREDLL
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001191 PyDict_SetItemString(sysdict, "dllhandle",
Guido van Rossum582acec2000-06-28 22:07:35 +00001192 v = PyLong_FromVoidPtr(PyWin_DLLhModule));
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001193 Py_XDECREF(v);
1194 PyDict_SetItemString(sysdict, "winver",
Guido van Rossum6c1e5f21997-09-29 23:34:23 +00001195 v = PyString_FromString(PyWin_DLLVersionString));
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001196 Py_XDECREF(v);
Guido van Rossumc606fe11996-04-09 02:37:57 +00001197#endif
Guido van Rossum23fff912000-12-15 22:02:05 +00001198 if (warnoptions == NULL) {
1199 warnoptions = PyList_New(0);
1200 }
1201 else {
1202 Py_INCREF(warnoptions);
1203 }
1204 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +00001205 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +00001206 }
Tim Peters216b78b2006-01-06 02:40:53 +00001207
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001208 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +00001209 return NULL;
1210 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001211}
1212
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001213static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001214makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001215{
Guido van Rossum3f5da241990-12-20 15:06:42 +00001216 int i, n;
1217 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001218 PyObject *v, *w;
Tim Peters216b78b2006-01-06 02:40:53 +00001219
Guido van Rossum3f5da241990-12-20 15:06:42 +00001220 n = 1;
1221 p = path;
1222 while ((p = strchr(p, delim)) != NULL) {
1223 n++;
1224 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001225 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001226 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001227 if (v == NULL)
1228 return NULL;
1229 for (i = 0; ; i++) {
1230 p = strchr(path, delim);
1231 if (p == NULL)
1232 p = strchr(path, '\0'); /* End of string */
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001233 w = PyString_FromStringAndSize(path, (int) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +00001234 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001235 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001236 return NULL;
1237 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001238 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001239 if (*p == '\0')
1240 break;
1241 path = p+1;
1242 }
1243 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001244}
1245
1246void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001247PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001248{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001249 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001250 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001251 Py_FatalError("can't create sys.path");
1252 if (PySys_SetObject("path", v) != 0)
1253 Py_FatalError("can't assign sys.path");
1254 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001255}
1256
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001257static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001258makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001259{
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001260 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +00001261 if (argc <= 0 || argv == NULL) {
1262 /* Ensure at least one (empty) argument is seen */
1263 static char *empty_argv[1] = {""};
1264 argv = empty_argv;
1265 argc = 1;
1266 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001267 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001268 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001269 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001270 for (i = 0; i < argc; i++) {
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001271#ifdef __VMS
1272 PyObject *v;
1273
1274 /* argv[0] is the script pathname if known */
1275 if (i == 0) {
1276 char* fn = decc$translate_vms(argv[0]);
1277 if ((fn == (char *)0) || fn == (char *)-1)
1278 v = PyString_FromString(argv[0]);
1279 else
1280 v = PyString_FromString(
1281 decc$translate_vms(argv[0]));
1282 } else
1283 v = PyString_FromString(argv[i]);
1284#else
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001285 PyObject *v = PyString_FromString(argv[i]);
Martin v. Löwisc16f3bd2003-05-03 09:14:54 +00001286#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001287 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001288 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001289 av = NULL;
1290 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001291 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001292 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001293 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +00001294 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001295 return av;
1296}
1297
1298void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001299PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001300{
Guido van Rossum162e38c2003-02-19 15:25:10 +00001301#if defined(HAVE_REALPATH)
1302 char fullpath[MAXPATHLEN];
1303#elif defined(MS_WINDOWS)
Thomas Heller27bb71e2003-01-08 14:33:48 +00001304 char fullpath[MAX_PATH];
1305#endif
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001306 PyObject *av = makeargvobject(argc, argv);
1307 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001308 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001309 Py_FatalError("no mem for sys.argv");
1310 if (PySys_SetObject("argv", av) != 0)
1311 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +00001312 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001313 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +00001314 char *p = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001315 Py_ssize_t n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001316 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +00001317#ifdef HAVE_READLINK
1318 char link[MAXPATHLEN+1];
1319 char argv0copy[2*MAXPATHLEN+1];
1320 int nr = 0;
Georg Brandl69537722005-09-15 13:00:34 +00001321 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0)
Guido van Rossumc474dea1997-04-25 15:38:31 +00001322 nr = readlink(argv0, link, MAXPATHLEN);
1323 if (nr > 0) {
1324 /* It's a symlink */
1325 link[nr] = '\0';
1326 if (link[0] == SEP)
1327 argv0 = link; /* Link to absolute path */
1328 else if (strchr(link, SEP) == NULL)
1329 ; /* Link without path */
1330 else {
1331 /* Must join(dirname(argv0), link) */
1332 char *q = strrchr(argv0, SEP);
1333 if (q == NULL)
1334 argv0 = link; /* argv0 without path */
1335 else {
1336 /* Must make a copy */
1337 strcpy(argv0copy, argv0);
1338 q = strrchr(argv0copy, SEP);
1339 strcpy(q+1, link);
1340 argv0 = argv0copy;
1341 }
1342 }
1343 }
1344#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +00001345#if SEP == '\\' /* Special case for MS filename syntax */
Georg Brandl69537722005-09-15 13:00:34 +00001346 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossumcc883411996-09-10 14:44:21 +00001347 char *q;
Thomas Heller27bb71e2003-01-08 14:33:48 +00001348#ifdef MS_WINDOWS
1349 char *ptemp;
1350 if (GetFullPathName(argv0,
1351 sizeof(fullpath),
1352 fullpath,
1353 &ptemp)) {
1354 argv0 = fullpath;
1355 }
1356#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001357 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +00001358 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +00001359 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +00001360 if (q != NULL)
1361 p = q;
1362 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +00001363 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +00001364 if (n > 1 && p[-1] != ':')
1365 n--; /* Drop trailing separator */
1366 }
1367 }
1368#else /* All other filename syntaxes */
Georg Brandl69537722005-09-15 13:00:34 +00001369 if (argc > 0 && argv0 != NULL && strcmp(argv0, "-c") != 0) {
Guido van Rossum162e38c2003-02-19 15:25:10 +00001370#if defined(HAVE_REALPATH)
1371 if (realpath(argv0, fullpath)) {
1372 argv0 = fullpath;
1373 }
1374#endif
Guido van Rossumc474dea1997-04-25 15:38:31 +00001375 p = strrchr(argv0, SEP);
Guido van Rossum162e38c2003-02-19 15:25:10 +00001376 }
Guido van Rossumcc883411996-09-10 14:44:21 +00001377 if (p != NULL) {
Guido van Rossumbceccf52001-04-10 22:07:43 +00001378#ifndef RISCOS
Guido van Rossumc474dea1997-04-25 15:38:31 +00001379 n = p + 1 - argv0;
Guido van Rossumbceccf52001-04-10 22:07:43 +00001380#else /* don't include trailing separator */
1381 n = p - argv0;
1382#endif /* RISCOS */
Guido van Rossumcc883411996-09-10 14:44:21 +00001383#if SEP == '/' /* Special case for Unix filename syntax */
1384 if (n > 1)
1385 n--; /* Drop trailing separator */
1386#endif /* Unix */
1387 }
1388#endif /* All others */
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001389 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +00001390 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001391 Py_FatalError("no mem for sys.path insertion");
1392 if (PyList_Insert(path, 0, a) < 0)
1393 Py_FatalError("sys.path.insert(0) failed");
1394 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +00001395 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +00001396 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001397}
Guido van Rossuma890e681998-05-12 14:59:24 +00001398
1399
1400/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
1401 Adapted from code submitted by Just van Rossum.
1402
1403 PySys_WriteStdout(format, ...)
1404 PySys_WriteStderr(format, ...)
1405
1406 The first function writes to sys.stdout; the second to sys.stderr. When
1407 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +00001408 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +00001409
1410 Both take a printf-style format string as their first argument followed
1411 by a variable length argument list determined by the format string.
1412
1413 *** WARNING ***
1414
1415 The format should limit the total size of the formatted output string to
1416 1000 bytes. In particular, this means that no unrestricted "%s" formats
1417 should occur; these should be limited using "%.<N>s where <N> is a
1418 decimal number calculated so that <N> plus the maximum size of other
1419 formatted text does not exceed 1000 bytes. Also watch out for "%f",
1420 which can print hundreds of digits for very large numbers.
1421
1422 */
1423
1424static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001425mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +00001426{
1427 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +00001428 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +00001429
Guido van Rossum8442af31998-10-12 18:22:10 +00001430 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001431 file = PySys_GetObject(name);
1432 if (file == NULL || PyFile_AsFile(file) == fp)
1433 vfprintf(fp, format, va);
1434 else {
1435 char buffer[1001];
Tim Peters080d5b32001-12-02 08:29:16 +00001436 const int written = PyOS_vsnprintf(buffer, sizeof(buffer),
1437 format, va);
Guido van Rossuma890e681998-05-12 14:59:24 +00001438 if (PyFile_WriteString(buffer, file) != 0) {
1439 PyErr_Clear();
1440 fputs(buffer, fp);
1441 }
Skip Montanaro53a6d1d2006-04-18 00:55:46 +00001442 if (written < 0 || (size_t)written >= sizeof(buffer)) {
Jeremy Hylton5d3d1342001-11-28 21:44:53 +00001443 const char *truncated = "... truncated";
1444 if (PyFile_WriteString(truncated, file) != 0) {
1445 PyErr_Clear();
1446 fputs(truncated, fp);
1447 }
1448 }
Guido van Rossuma890e681998-05-12 14:59:24 +00001449 }
Guido van Rossum8442af31998-10-12 18:22:10 +00001450 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +00001451}
1452
1453void
Guido van Rossuma890e681998-05-12 14:59:24 +00001454PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001455{
1456 va_list va;
1457
Guido van Rossuma890e681998-05-12 14:59:24 +00001458 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001459 mywrite("stdout", stdout, format, va);
1460 va_end(va);
1461}
1462
1463void
Guido van Rossuma890e681998-05-12 14:59:24 +00001464PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +00001465{
1466 va_list va;
1467
Guido van Rossuma890e681998-05-12 14:59:24 +00001468 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +00001469 mywrite("stderr", stderr, format, va);
1470 va_end(va);
1471}