blob: 3df85ff02289297233d53fb9d400c97f61639a53 [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"
Barry Warsawb6a54d22000-12-06 21:47:46 +000018#include "compile.h"
19#include "frameobject.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000020
Guido van Rossume2437a11992-03-23 18:20:18 +000021#include "osdefs.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +000022
Guido van Rossum1254d791997-05-20 15:57:25 +000023#ifdef HAVE_UNISTD_H
Guido van Rossumc474dea1997-04-25 15:38:31 +000024#include <unistd.h>
25#endif
26
Guido van Rossum9b38a141996-09-11 23:12:24 +000027#ifdef MS_COREDLL
Guido van Rossumc606fe11996-04-09 02:37:57 +000028extern void *PyWin_DLLhModule;
Guido van Rossum6c1e5f21997-09-29 23:34:23 +000029/* A string loaded from the DLL at startup: */
30extern const char *PyWin_DLLVersionString;
Guido van Rossumc606fe11996-04-09 02:37:57 +000031#endif
32
Guido van Rossum65bf9f21997-04-29 18:33:38 +000033PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000034PySys_GetObject(char *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000035{
Guido van Rossum25ce5661997-08-02 03:10:38 +000036 PyThreadState *tstate = PyThreadState_Get();
37 PyObject *sd = tstate->interp->sysdict;
Guido van Rossumbe203361999-10-05 22:17:41 +000038 if (sd == NULL)
39 return NULL;
Guido van Rossum25ce5661997-08-02 03:10:38 +000040 return PyDict_GetItemString(sd, name);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000041}
42
43FILE *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000044PySys_GetFile(char *name, FILE *def)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000045{
46 FILE *fp = NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +000047 PyObject *v = PySys_GetObject(name);
48 if (v != NULL && PyFile_Check(v))
49 fp = PyFile_AsFile(v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000050 if (fp == NULL)
51 fp = def;
52 return fp;
53}
54
55int
Thomas Woutersf70ef4f2000-07-22 18:47:25 +000056PySys_SetObject(char *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000057{
Guido van Rossum25ce5661997-08-02 03:10:38 +000058 PyThreadState *tstate = PyThreadState_Get();
59 PyObject *sd = tstate->interp->sysdict;
Guido van Rossum5ad58c61992-01-26 18:15:48 +000060 if (v == NULL) {
Guido van Rossum25ce5661997-08-02 03:10:38 +000061 if (PyDict_GetItemString(sd, name) == NULL)
Guido van Rossum5ad58c61992-01-26 18:15:48 +000062 return 0;
63 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000064 return PyDict_DelItemString(sd, name);
Guido van Rossum5ad58c61992-01-26 18:15:48 +000065 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000066 else
Guido van Rossum25ce5661997-08-02 03:10:38 +000067 return PyDict_SetItemString(sd, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000068}
69
Guido van Rossum65bf9f21997-04-29 18:33:38 +000070static PyObject *
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000071sys_displayhook(PyObject *self, PyObject *args)
72{
Greg Steinceb9b7c2001-01-11 09:27:34 +000073 PyObject *o, *outf;
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000074 PyInterpreterState *interp = PyThreadState_Get()->interp;
75 PyObject *modules = interp->modules;
76 PyObject *builtins = PyDict_GetItemString(modules, "__builtin__");
77
78 /* parse arguments */
79 if (!PyArg_ParseTuple(args, "O:displayhook", &o))
80 return NULL;
81
82 /* Print value except if None */
83 /* After printing, also assign to '_' */
84 /* Before, set '_' to None to avoid recursion */
85 if (o == Py_None) {
86 Py_INCREF(Py_None);
87 return Py_None;
88 }
89 if (PyObject_SetAttrString(builtins, "_", Py_None) != 0)
90 return NULL;
91 if (Py_FlushLine() != 0)
92 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +000093 outf = PySys_GetObject("stdout");
94 if (outf == NULL) {
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000095 PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout");
96 return NULL;
97 }
Greg Steinceb9b7c2001-01-11 09:27:34 +000098 if (PyFile_WriteObject(o, outf, 0) != 0)
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +000099 return NULL;
Greg Steinceb9b7c2001-01-11 09:27:34 +0000100 PyFile_SoftSpace(outf, 1);
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000101 if (Py_FlushLine() != 0)
102 return NULL;
103 if (PyObject_SetAttrString(builtins, "_", o) != 0)
104 return NULL;
105 Py_INCREF(Py_None);
106 return Py_None;
107}
108
109static char displayhook_doc[] =
110"displayhook(o) -> None\n"
111"\n"
112"Print o to the stdout, and save it in __builtin__._\n";
113
114static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000115sys_exc_info(PyObject *self, PyObject *args)
Guido van Rossuma027efa1997-05-05 20:56:21 +0000116{
117 PyThreadState *tstate;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000118 if (!PyArg_ParseTuple(args, ":exc_info"))
Guido van Rossuma027efa1997-05-05 20:56:21 +0000119 return NULL;
120 tstate = PyThreadState_Get();
Guido van Rossuma027efa1997-05-05 20:56:21 +0000121 return Py_BuildValue(
122 "(OOO)",
123 tstate->exc_type != NULL ? tstate->exc_type : Py_None,
124 tstate->exc_value != NULL ? tstate->exc_value : Py_None,
125 tstate->exc_traceback != NULL ?
126 tstate->exc_traceback : Py_None);
127}
128
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000129static char exc_info_doc[] =
130"exc_info() -> (type, value, traceback)\n\
131\n\
132Return information about the exception that is currently being handled.\n\
133This should be called from inside an except clause only.";
134
Guido van Rossuma027efa1997-05-05 20:56:21 +0000135static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000136sys_exit(PyObject *self, PyObject *args)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000137{
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000138 /* Raise SystemExit so callers may catch it or clean up. */
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000139 PyErr_SetObject(PyExc_SystemExit, args);
Guido van Rossum6a468bf1991-12-31 13:15:35 +0000140 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000141}
142
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000143static char exit_doc[] =
144"exit([status])\n\
145\n\
146Exit the interpreter by raising SystemExit(status).\n\
147If the status is omitted or None, it defaults to zero (i.e., success).\n\
148If the status numeric, it will be used as the system exit status.\n\
149If it is another kind of object, it will be printed and the system\n\
150exit status will be one (i.e., failure).";
151
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000152static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000153sys_getdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000154{
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000155 if (!PyArg_ParseTuple(args, ":getdefaultencoding"))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000156 return NULL;
157 return PyString_FromString(PyUnicode_GetDefaultEncoding());
158}
159
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000160static char getdefaultencoding_doc[] =
161"getdefaultencoding() -> string\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000162\n\
163Return the current default string encoding used by the Unicode \n\
164implementation.";
165
166static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000167sys_setdefaultencoding(PyObject *self, PyObject *args)
Fred Drake8b4d01d2000-05-09 19:57:01 +0000168{
169 char *encoding;
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000170 if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding))
Fred Drake8b4d01d2000-05-09 19:57:01 +0000171 return NULL;
172 if (PyUnicode_SetDefaultEncoding(encoding))
173 return NULL;
174 Py_INCREF(Py_None);
175 return Py_None;
176}
177
Marc-André Lemburg99964b82000-06-07 09:13:41 +0000178static char setdefaultencoding_doc[] =
179"setdefaultencoding(encoding)\n\
Fred Drake8b4d01d2000-05-09 19:57:01 +0000180\n\
181Set the current default string encoding used by the Unicode implementation.";
182
183static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000184sys_settrace(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000185{
Guido van Rossuma027efa1997-05-05 20:56:21 +0000186 PyThreadState *tstate = PyThreadState_Get();
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000187 if (args == Py_None)
Guido van Rossume2437a11992-03-23 18:20:18 +0000188 args = NULL;
Guido van Rossume765f7d1992-04-05 14:17:55 +0000189 else
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000190 Py_XINCREF(args);
Guido van Rossuma027efa1997-05-05 20:56:21 +0000191 Py_XDECREF(tstate->sys_tracefunc);
192 tstate->sys_tracefunc = args;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000193 Py_INCREF(Py_None);
194 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000195}
196
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000197static char settrace_doc[] =
198"settrace(function)\n\
199\n\
200Set the global debug tracing function. It will be called on each\n\
201function call. See the debugger chapter in the library manual.";
202
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000203static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000204sys_setprofile(PyObject *self, PyObject *args)
Guido van Rossume2437a11992-03-23 18:20:18 +0000205{
Guido van Rossuma027efa1997-05-05 20:56:21 +0000206 PyThreadState *tstate = PyThreadState_Get();
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000207 if (args == Py_None)
Guido van Rossume2437a11992-03-23 18:20:18 +0000208 args = NULL;
Guido van Rossume765f7d1992-04-05 14:17:55 +0000209 else
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000210 Py_XINCREF(args);
Guido van Rossuma027efa1997-05-05 20:56:21 +0000211 Py_XDECREF(tstate->sys_profilefunc);
212 tstate->sys_profilefunc = args;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000213 Py_INCREF(Py_None);
214 return Py_None;
Guido van Rossume2437a11992-03-23 18:20:18 +0000215}
216
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000217static char setprofile_doc[] =
218"setprofile(function)\n\
219\n\
220Set the profiling function. It will be called on each function call\n\
221and return. See the profiler chapter in the library manual.";
222
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000223static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000224sys_setcheckinterval(PyObject *self, PyObject *args)
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000225{
Guido van Rossuma027efa1997-05-05 20:56:21 +0000226 PyThreadState *tstate = PyThreadState_Get();
Guido van Rossum43713e52000-02-29 13:59:29 +0000227 if (!PyArg_ParseTuple(args, "i:setcheckinterval", &tstate->interp->checkinterval))
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000228 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000229 Py_INCREF(Py_None);
230 return Py_None;
Guido van Rossuma0d7a231995-01-09 17:46:13 +0000231}
232
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000233static char setcheckinterval_doc[] =
234"setcheckinterval(n)\n\
235\n\
236Tell the Python interpreter to check for asynchronous events every\n\
237n instructions. This also affects how often thread switches occur.";
238
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000239static PyObject *
240sys_setrecursionlimit(PyObject *self, PyObject *args)
241{
242 int new_limit;
243 if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit))
244 return NULL;
245 if (new_limit <= 0) {
246 PyErr_SetString(PyExc_ValueError,
247 "recursion limit must be positive");
248 return NULL;
249 }
250 Py_SetRecursionLimit(new_limit);
251 Py_INCREF(Py_None);
252 return Py_None;
253}
254
255static char setrecursionlimit_doc[] =
256"setrecursionlimit(n)\n\
257\n\
258Set the maximum depth of the Python interpreter stack to n. This\n\
259limit prevents infinite recursion from causing an overflow of the C\n\
260stack and crashing Python. The highest possible limit is platform-\n\
261dependent.";
262
263static PyObject *
264sys_getrecursionlimit(PyObject *self, PyObject *args)
265{
266 if (!PyArg_ParseTuple(args, ":getrecursionlimit"))
267 return NULL;
268 return PyInt_FromLong(Py_GetRecursionLimit());
269}
270
271static char getrecursionlimit_doc[] =
272"getrecursionlimit()\n\
273\n\
274Return the current value of the recursion limit, the maximum depth\n\
275of the Python interpreter stack. This limit prevents infinite\n\
276recursion from causing an overflow of the C stack and crashing Python.";
277
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000278#ifdef USE_MALLOPT
279/* Link with -lmalloc (or -lmpc) on an SGI */
280#include <malloc.h>
281
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000282static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000283sys_mdebug(PyObject *self, PyObject *args)
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000284{
285 int flag;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000286 if (!PyArg_ParseTuple(args, "i:mdebug", &flag))
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000287 return NULL;
288 mallopt(M_DEBUG, flag);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000289 Py_INCREF(Py_None);
290 return Py_None;
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000291}
292#endif /* USE_MALLOPT */
293
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000294static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000295sys_getrefcount(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000296{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000297 PyObject *arg;
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000298 if (!PyArg_ParseTuple(args, "O:getrefcount", &arg))
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000299 return NULL;
Mark Hammond440d8982000-06-20 08:12:48 +0000300 return PyInt_FromLong(arg->ob_refcnt);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000301}
302
Mark Hammond440d8982000-06-20 08:12:48 +0000303#ifdef Py_TRACE_REFS
304static PyObject *
305sys_gettotalrefcount(PyObject *self, PyObject *args)
306{
307 extern long _Py_RefTotal;
308 if (!PyArg_ParseTuple(args, ":gettotalrefcount"))
309 return NULL;
310 return PyInt_FromLong(_Py_RefTotal);
311}
312
313#endif /* Py_TRACE_REFS */
314
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000315static char getrefcount_doc[] =
316"getrefcount(object) -> integer\n\
317\n\
318Return the current reference count for the object. This includes the\n\
319temporary reference in the argument list, so it is at least 2.";
320
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000321#ifdef COUNT_ALLOCS
322static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000323sys_getcounts(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000324{
Tim Petersdbd9ba62000-07-09 03:09:57 +0000325 extern PyObject *get_counts(void);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000326
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000327 if (!PyArg_ParseTuple(args, ":getcounts"))
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000328 return NULL;
329 return get_counts();
330}
331#endif
332
Barry Warsawb6a54d22000-12-06 21:47:46 +0000333static char getframe_doc[] =
334"_getframe([depth]) -> frameobject\n\
335\n\
336Return a frame object from the call stack. If optional integer depth is\n\
337given, return the frame object that many calls below the top of the stack.\n\
338If that is deeper than the call stack, ValueError is raised. The default\n\
339for depth is zero, returning the frame at the top of the call stack.\n\
340\n\
341This function should be used for internal and specialized\n\
342purposes only.";
343
344static PyObject *
345sys_getframe(PyObject *self, PyObject *args)
346{
347 PyFrameObject *f = PyThreadState_Get()->frame;
348 int depth = -1;
349
350 if (!PyArg_ParseTuple(args, "|i:_getframe", &depth))
351 return NULL;
352
353 while (depth > 0 && f != NULL) {
354 f = f->f_back;
355 --depth;
356 }
357 if (f == NULL) {
358 PyErr_SetString(PyExc_ValueError,
359 "call stack is not deep enough");
360 return NULL;
361 }
362 Py_INCREF(f);
363 return (PyObject*)f;
364}
365
366
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000367#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000368/* Defined in objects.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000369extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000370#endif
Guido van Rossumded690f1996-05-24 20:48:31 +0000371
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000372#ifdef DYNAMIC_EXECUTION_PROFILE
373/* Defined in ceval.c because it uses static globals if that file */
Tim Petersdbd9ba62000-07-09 03:09:57 +0000374extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000375#endif
376
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000377static PyMethodDef sys_methods[] = {
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000378 /* Might as well keep this in alphabetic order */
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000379 {"displayhook", sys_displayhook, 1, displayhook_doc},
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000380 {"exc_info", sys_exc_info, 1, exc_info_doc},
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000381 {"exit", sys_exit, 0, exit_doc},
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000382 {"getdefaultencoding", sys_getdefaultencoding, 1,
383 getdefaultencoding_doc},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000384#ifdef COUNT_ALLOCS
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000385 {"getcounts", sys_getcounts, 1},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000386#endif
Guido van Rossum43f1b8d1997-01-24 04:07:45 +0000387#ifdef DYNAMIC_EXECUTION_PROFILE
388 {"getdxp", _Py_GetDXProfile, 1},
389#endif
Guido van Rossum7f3f2c11996-05-23 22:45:41 +0000390#ifdef Py_TRACE_REFS
Guido van Rossumded690f1996-05-24 20:48:31 +0000391 {"getobjects", _Py_GetObjects, 1},
Mark Hammond440d8982000-06-20 08:12:48 +0000392 {"gettotalrefcount", sys_gettotalrefcount, 1},
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000393#endif
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000394 {"getrefcount", sys_getrefcount, 1, getrefcount_doc},
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000395 {"getrecursionlimit", sys_getrecursionlimit, 1,
396 getrecursionlimit_doc},
Barry Warsawb6a54d22000-12-06 21:47:46 +0000397 {"_getframe", sys_getframe, 1, getframe_doc},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000398#ifdef USE_MALLOPT
Guido van Rossumffc0f4f2000-03-31 00:38:29 +0000399 {"mdebug", sys_mdebug, 1},
Guido van Rossum14b4adb1992-09-03 20:25:30 +0000400#endif
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000401 {"setdefaultencoding", sys_setdefaultencoding, 1,
402 setdefaultencoding_doc},
403 {"setcheckinterval", sys_setcheckinterval, 1,
404 setcheckinterval_doc},
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000405 {"setprofile", sys_setprofile, 0, setprofile_doc},
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000406 {"setrecursionlimit", sys_setrecursionlimit, 1,
407 setrecursionlimit_doc},
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000408 {"settrace", sys_settrace, 0, settrace_doc},
Guido van Rossum3f5da241990-12-20 15:06:42 +0000409 {NULL, NULL} /* sentinel */
410};
411
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000412static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000413list_builtin_module_names(void)
Guido van Rossum34679b71993-01-26 13:33:44 +0000414{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000415 PyObject *list = PyList_New(0);
Guido van Rossum34679b71993-01-26 13:33:44 +0000416 int i;
417 if (list == NULL)
418 return NULL;
Guido van Rossum25c649f1997-11-04 17:04:34 +0000419 for (i = 0; PyImport_Inittab[i].name != NULL; i++) {
Guido van Rossuma027efa1997-05-05 20:56:21 +0000420 PyObject *name = PyString_FromString(
Guido van Rossum25c649f1997-11-04 17:04:34 +0000421 PyImport_Inittab[i].name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000422 if (name == NULL)
423 break;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000424 PyList_Append(list, name);
425 Py_DECREF(name);
Guido van Rossum34679b71993-01-26 13:33:44 +0000426 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000427 if (PyList_Sort(list) != 0) {
428 Py_DECREF(list);
Guido van Rossum1d5735e1994-08-30 08:27:36 +0000429 list = NULL;
430 }
Guido van Rossum8f49e121997-01-06 22:55:54 +0000431 if (list) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000432 PyObject *v = PyList_AsTuple(list);
433 Py_DECREF(list);
Guido van Rossum8f49e121997-01-06 22:55:54 +0000434 list = v;
435 }
Guido van Rossum34679b71993-01-26 13:33:44 +0000436 return list;
437}
438
Guido van Rossum23fff912000-12-15 22:02:05 +0000439static PyObject *warnoptions = NULL;
440
441void
442PySys_ResetWarnOptions(void)
443{
444 if (warnoptions == NULL || !PyList_Check(warnoptions))
445 return;
446 PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
447}
448
449void
450PySys_AddWarnOption(char *s)
451{
452 PyObject *str;
453
454 if (warnoptions == NULL || !PyList_Check(warnoptions)) {
455 Py_XDECREF(warnoptions);
456 warnoptions = PyList_New(0);
457 if (warnoptions == NULL)
458 return;
459 }
460 str = PyString_FromString(s);
461 if (str != NULL) {
462 PyList_Append(warnoptions, str);
463 Py_DECREF(str);
464 }
465}
466
Guido van Rossum40552d01998-08-06 03:34:39 +0000467/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
468 Two literals concatenated works just fine. If you have a K&R compiler
469 or other abomination that however *does* understand longer strings,
470 get rid of the !!! comment in the middle and the quotes that surround it. */
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000471static char sys_doc[] =
472"This module provides access to some objects used or maintained by the\n\
473interpreter and to functions that interact strongly with the interpreter.\n\
474\n\
475Dynamic objects:\n\
476\n\
477argv -- command line arguments; argv[0] is the script pathname if known\n\
478path -- module search path; path[0] is the script directory, else ''\n\
479modules -- dictionary of loaded modules\n\
480exitfunc -- you may set this to a function to be called when Python exits\n\
481\n\
482stdin -- standard input file object; used by raw_input() and input()\n\
483stdout -- standard output file object; used by the print statement\n\
484stderr -- standard error object; used for error messages\n\
485 By assigning another file object (or an object that behaves like a file)\n\
486 to one of these, it is possible to redirect all of the interpreter's I/O.\n\
487\n\
488last_type -- type of last uncaught exception\n\
489last_value -- value of last uncaught exception\n\
490last_traceback -- traceback of last uncaught exception\n\
491 These three are only available in an interactive session after a\n\
492 traceback has been printed.\n\
493\n\
494exc_type -- type of exception currently being handled\n\
495exc_value -- value of exception currently being handled\n\
496exc_traceback -- traceback of exception currently being handled\n\
497 The function exc_info() should be used instead of these three,\n\
498 because it is thread-safe.\n\
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000499"
500#ifndef MS_WIN16
501/* Concatenating string here */
502"\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000503Static objects:\n\
504\n\
505maxint -- the largest supported integer (the smallest is -maxint-1)\n\
506builtin_module_names -- tuple of module names built into this intepreter\n\
Fred Drake801c08d2000-04-13 15:29:10 +0000507version -- the version of this interpreter as a string\n\
508version_info -- version information as a tuple\n\
509hexversion -- version information encoded as a single integer\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000510copyright -- copyright notice pertaining to this interpreter\n\
511platform -- platform identifier\n\
512executable -- pathname of this Python interpreter\n\
513prefix -- prefix used to find the Python library\n\
514exec_prefix -- prefix used to find the machine-specific Python library\n\
515dllhandle -- [Windows only] integer handle of the Python DLL\n\
516winver -- [Windows only] version number of the Python DLL\n\
517__stdin__ -- the original stdin; don't use!\n\
518__stdout__ -- the original stdout; don't use!\n\
519__stderr__ -- the original stderr; don't use!\n\
520\n\
521Functions:\n\
522\n\
Moshe Zadkaf68f2fe2001-01-11 05:41:27 +0000523displayhook() -- print an object to the screen, and save it in __builtin__._\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000524exc_info() -- return thread-safe information about the current exception\n\
525exit() -- exit the interpreter by raising SystemExit\n\
526getrefcount() -- return the reference count for an object (plus one :-)\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000527getrecursionlimit() -- return the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000528setcheckinterval() -- control how often the interpreter checks for events\n\
529setprofile() -- set the global profiling function\n\
Jeremy Hyltonee5adfb2000-08-31 19:23:01 +0000530setrecursionlimit() -- set the max recursion depth for the interpreter\n\
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000531settrace() -- set the global debug tracing function\n\
Fred Drakeccede592000-08-14 20:59:57 +0000532"
Guido van Rossuma71b5f41999-01-14 19:07:00 +0000533#endif
Fred Drakeccede592000-08-14 20:59:57 +0000534/* end of sys_doc */ ;
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000535
Guido van Rossum25ce5661997-08-02 03:10:38 +0000536PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000537_PySys_Init(void)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000538{
Guido van Rossum25ce5661997-08-02 03:10:38 +0000539 PyObject *m, *v, *sysdict;
540 PyObject *sysin, *sysout, *syserr;
Fred Drake6d27c1e2000-04-13 20:03:20 +0000541 char *s;
Guido van Rossum25ce5661997-08-02 03:10:38 +0000542
Guido van Rossumc3bc31e1998-06-27 19:43:25 +0000543 m = Py_InitModule3("sys", sys_methods, sys_doc);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000544 sysdict = PyModule_GetDict(m);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000545
546 sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL);
547 sysout = PyFile_FromFile(stdout, "<stdout>", "w", NULL);
548 syserr = PyFile_FromFile(stderr, "<stderr>", "w", NULL);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000549 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +0000550 return NULL;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000551 PyDict_SetItemString(sysdict, "stdin", sysin);
552 PyDict_SetItemString(sysdict, "stdout", sysout);
553 PyDict_SetItemString(sysdict, "stderr", syserr);
Guido van Rossumbd36dba1998-02-19 20:53:06 +0000554 /* Make backup copies for cleanup */
555 PyDict_SetItemString(sysdict, "__stdin__", sysin);
556 PyDict_SetItemString(sysdict, "__stdout__", sysout);
557 PyDict_SetItemString(sysdict, "__stderr__", syserr);
Guido van Rossum25ce5661997-08-02 03:10:38 +0000558 Py_XDECREF(sysin);
559 Py_XDECREF(sysout);
560 Py_XDECREF(syserr);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000561 PyDict_SetItemString(sysdict, "version",
562 v = PyString_FromString(Py_GetVersion()));
Barry Warsaw54892c41999-01-27 16:33:19 +0000563 Py_XDECREF(v);
Guido van Rossume0d7dae1999-01-03 12:55:39 +0000564 PyDict_SetItemString(sysdict, "hexversion",
565 v = PyInt_FromLong(PY_VERSION_HEX));
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000566 Py_XDECREF(v);
Fred Drake93a20bf2000-04-13 17:44:51 +0000567 /*
568 * These release level checks are mutually exclusive and cover
569 * the field, so don't get too fancy with the pre-processor!
570 */
571#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
Fred Drake6d27c1e2000-04-13 20:03:20 +0000572 s = "alpha";
Fred Drake592f2d62000-08-31 15:21:11 +0000573#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
Fred Drake6d27c1e2000-04-13 20:03:20 +0000574 s = "beta";
Fred Drake592f2d62000-08-31 15:21:11 +0000575#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
Fred Drake6d27c1e2000-04-13 20:03:20 +0000576 s = "candidate";
Fred Drake592f2d62000-08-31 15:21:11 +0000577#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
Fred Drake6d27c1e2000-04-13 20:03:20 +0000578 s = "final";
Fred Drake93a20bf2000-04-13 17:44:51 +0000579#endif
Fred Drake801c08d2000-04-13 15:29:10 +0000580 PyDict_SetItemString(sysdict, "version_info",
Fred Drake6d27c1e2000-04-13 20:03:20 +0000581 v = Py_BuildValue("iiisi", PY_MAJOR_VERSION,
Fred Drake801c08d2000-04-13 15:29:10 +0000582 PY_MINOR_VERSION,
Fred Drake6d27c1e2000-04-13 20:03:20 +0000583 PY_MICRO_VERSION, s,
Fred Drake93a20bf2000-04-13 17:44:51 +0000584 PY_RELEASE_SERIAL));
Fred Drake801c08d2000-04-13 15:29:10 +0000585 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000586 PyDict_SetItemString(sysdict, "copyright",
587 v = PyString_FromString(Py_GetCopyright()));
588 Py_XDECREF(v);
589 PyDict_SetItemString(sysdict, "platform",
590 v = PyString_FromString(Py_GetPlatform()));
591 Py_XDECREF(v);
Guido van Rossumb2c8ec41997-05-22 20:41:20 +0000592 PyDict_SetItemString(sysdict, "executable",
593 v = PyString_FromString(Py_GetProgramFullPath()));
594 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000595 PyDict_SetItemString(sysdict, "prefix",
596 v = PyString_FromString(Py_GetPrefix()));
597 Py_XDECREF(v);
598 PyDict_SetItemString(sysdict, "exec_prefix",
599 v = PyString_FromString(Py_GetExecPrefix()));
600 Py_XDECREF(v);
601 PyDict_SetItemString(sysdict, "maxint",
602 v = PyInt_FromLong(PyInt_GetMax()));
603 Py_XDECREF(v);
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000604 PyDict_SetItemString(sysdict, "builtin_module_names",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000605 v = list_builtin_module_names());
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000606 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +0000607 {
608 /* Assumes that longs are at least 2 bytes long.
609 Should be safe! */
610 unsigned long number = 1;
Fred Drakea2b6ad62000-08-15 04:24:43 +0000611 char *value;
Fred Drake099325e2000-08-14 15:47:03 +0000612
613 s = (char *) &number;
614 if (s[0] == 0)
Fred Drakea2b6ad62000-08-15 04:24:43 +0000615 value = "big";
Fred Drake099325e2000-08-14 15:47:03 +0000616 else
Fred Drakea2b6ad62000-08-15 04:24:43 +0000617 value = "little";
618 PyDict_SetItemString(sysdict, "byteorder",
Barry Warsawf2581c92000-08-16 23:03:57 +0000619 v = PyString_FromString(value));
620 Py_XDECREF(v);
Fred Drake099325e2000-08-14 15:47:03 +0000621 }
Guido van Rossum8b9ea871996-08-23 18:14:47 +0000622#ifdef MS_COREDLL
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000623 PyDict_SetItemString(sysdict, "dllhandle",
Guido van Rossum582acec2000-06-28 22:07:35 +0000624 v = PyLong_FromVoidPtr(PyWin_DLLhModule));
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000625 Py_XDECREF(v);
626 PyDict_SetItemString(sysdict, "winver",
Guido van Rossum6c1e5f21997-09-29 23:34:23 +0000627 v = PyString_FromString(PyWin_DLLVersionString));
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000628 Py_XDECREF(v);
Guido van Rossumc606fe11996-04-09 02:37:57 +0000629#endif
Guido van Rossum23fff912000-12-15 22:02:05 +0000630 if (warnoptions == NULL) {
631 warnoptions = PyList_New(0);
632 }
633 else {
634 Py_INCREF(warnoptions);
635 }
636 if (warnoptions != NULL) {
Guido van Rossum03df3b32001-01-13 22:06:05 +0000637 PyDict_SetItemString(sysdict, "warnoptions", warnoptions);
Guido van Rossum23fff912000-12-15 22:02:05 +0000638 }
639
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000640 if (PyErr_Occurred())
Guido van Rossum25ce5661997-08-02 03:10:38 +0000641 return NULL;
642 return m;
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000643}
644
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000645static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000646makepathobject(char *path, int delim)
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000647{
Guido van Rossum3f5da241990-12-20 15:06:42 +0000648 int i, n;
649 char *p;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000650 PyObject *v, *w;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000651
652 n = 1;
653 p = path;
654 while ((p = strchr(p, delim)) != NULL) {
655 n++;
656 p++;
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000657 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000658 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000659 if (v == NULL)
660 return NULL;
661 for (i = 0; ; i++) {
662 p = strchr(path, delim);
663 if (p == NULL)
664 p = strchr(path, '\0'); /* End of string */
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000665 w = PyString_FromStringAndSize(path, (int) (p - path));
Guido van Rossum3f5da241990-12-20 15:06:42 +0000666 if (w == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000667 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000668 return NULL;
669 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000670 PyList_SetItem(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000671 if (*p == '\0')
672 break;
673 path = p+1;
674 }
675 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000676}
677
678void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000679PySys_SetPath(char *path)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000680{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000681 PyObject *v;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000682 if ((v = makepathobject(path, DELIM)) == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000683 Py_FatalError("can't create sys.path");
684 if (PySys_SetObject("path", v) != 0)
685 Py_FatalError("can't assign sys.path");
686 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000687}
688
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000689static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000690makeargvobject(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000691{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000692 PyObject *av;
Guido van Rossumee3a2991992-01-14 18:42:53 +0000693 if (argc <= 0 || argv == NULL) {
694 /* Ensure at least one (empty) argument is seen */
695 static char *empty_argv[1] = {""};
696 argv = empty_argv;
697 argc = 1;
698 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000699 av = PyList_New(argc);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000700 if (av != NULL) {
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000701 int i;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000702 for (i = 0; i < argc; i++) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000703 PyObject *v = PyString_FromString(argv[i]);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000704 if (v == NULL) {
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000705 Py_DECREF(av);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000706 av = NULL;
707 break;
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000708 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000709 PyList_SetItem(av, i, v);
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000710 }
Guido van Rossum5b3138b1990-11-18 17:41:40 +0000711 }
Guido van Rossum3f5da241990-12-20 15:06:42 +0000712 return av;
713}
714
715void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000716PySys_SetArgv(int argc, char **argv)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000717{
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000718 PyObject *av = makeargvobject(argc, argv);
719 PyObject *path = PySys_GetObject("path");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000720 if (av == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000721 Py_FatalError("no mem for sys.argv");
722 if (PySys_SetObject("argv", av) != 0)
723 Py_FatalError("can't assign sys.argv");
Guido van Rossum94a96671996-07-30 20:35:50 +0000724 if (path != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +0000725 char *argv0 = argv[0];
Guido van Rossum94a96671996-07-30 20:35:50 +0000726 char *p = NULL;
Guido van Rossumcc883411996-09-10 14:44:21 +0000727 int n = 0;
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000728 PyObject *a;
Guido van Rossumc474dea1997-04-25 15:38:31 +0000729#ifdef HAVE_READLINK
730 char link[MAXPATHLEN+1];
731 char argv0copy[2*MAXPATHLEN+1];
732 int nr = 0;
733 if (argc > 0 && argv0 != NULL)
734 nr = readlink(argv0, link, MAXPATHLEN);
735 if (nr > 0) {
736 /* It's a symlink */
737 link[nr] = '\0';
738 if (link[0] == SEP)
739 argv0 = link; /* Link to absolute path */
740 else if (strchr(link, SEP) == NULL)
741 ; /* Link without path */
742 else {
743 /* Must join(dirname(argv0), link) */
744 char *q = strrchr(argv0, SEP);
745 if (q == NULL)
746 argv0 = link; /* argv0 without path */
747 else {
748 /* Must make a copy */
749 strcpy(argv0copy, argv0);
750 q = strrchr(argv0copy, SEP);
751 strcpy(q+1, link);
752 argv0 = argv0copy;
753 }
754 }
755 }
756#endif /* HAVE_READLINK */
Guido van Rossumcc883411996-09-10 14:44:21 +0000757#if SEP == '\\' /* Special case for MS filename syntax */
Guido van Rossumc474dea1997-04-25 15:38:31 +0000758 if (argc > 0 && argv0 != NULL) {
Guido van Rossumcc883411996-09-10 14:44:21 +0000759 char *q;
Guido van Rossumc474dea1997-04-25 15:38:31 +0000760 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +0000761 /* Test for alternate separator */
Guido van Rossumc474dea1997-04-25 15:38:31 +0000762 q = strrchr(p ? p : argv0, '/');
Guido van Rossumcc883411996-09-10 14:44:21 +0000763 if (q != NULL)
764 p = q;
765 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +0000766 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +0000767 if (n > 1 && p[-1] != ':')
768 n--; /* Drop trailing separator */
769 }
770 }
771#else /* All other filename syntaxes */
Guido van Rossumc474dea1997-04-25 15:38:31 +0000772 if (argc > 0 && argv0 != NULL)
773 p = strrchr(argv0, SEP);
Guido van Rossumcc883411996-09-10 14:44:21 +0000774 if (p != NULL) {
Guido van Rossumc474dea1997-04-25 15:38:31 +0000775 n = p + 1 - argv0;
Guido van Rossumcc883411996-09-10 14:44:21 +0000776#if SEP == '/' /* Special case for Unix filename syntax */
777 if (n > 1)
778 n--; /* Drop trailing separator */
779#endif /* Unix */
780 }
781#endif /* All others */
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000782 a = PyString_FromStringAndSize(argv0, n);
Guido van Rossum94a96671996-07-30 20:35:50 +0000783 if (a == NULL)
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000784 Py_FatalError("no mem for sys.path insertion");
785 if (PyList_Insert(path, 0, a) < 0)
786 Py_FatalError("sys.path.insert(0) failed");
787 Py_DECREF(a);
Guido van Rossuma63d9f41996-07-24 01:31:37 +0000788 }
Guido van Rossum65bf9f21997-04-29 18:33:38 +0000789 Py_DECREF(av);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000790}
Guido van Rossuma890e681998-05-12 14:59:24 +0000791
792
793/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
794 Adapted from code submitted by Just van Rossum.
795
796 PySys_WriteStdout(format, ...)
797 PySys_WriteStderr(format, ...)
798
799 The first function writes to sys.stdout; the second to sys.stderr. When
800 there is a problem, they write to the real (C level) stdout or stderr;
Guido van Rossum8442af31998-10-12 18:22:10 +0000801 no exceptions are raised.
Guido van Rossuma890e681998-05-12 14:59:24 +0000802
803 Both take a printf-style format string as their first argument followed
804 by a variable length argument list determined by the format string.
805
806 *** WARNING ***
807
808 The format should limit the total size of the formatted output string to
809 1000 bytes. In particular, this means that no unrestricted "%s" formats
810 should occur; these should be limited using "%.<N>s where <N> is a
811 decimal number calculated so that <N> plus the maximum size of other
812 formatted text does not exceed 1000 bytes. Also watch out for "%f",
813 which can print hundreds of digits for very large numbers.
814
815 */
816
817static void
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000818mywrite(char *name, FILE *fp, const char *format, va_list va)
Guido van Rossuma890e681998-05-12 14:59:24 +0000819{
820 PyObject *file;
Guido van Rossum8442af31998-10-12 18:22:10 +0000821 PyObject *error_type, *error_value, *error_traceback;
Guido van Rossuma890e681998-05-12 14:59:24 +0000822
Guido van Rossum8442af31998-10-12 18:22:10 +0000823 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +0000824 file = PySys_GetObject(name);
825 if (file == NULL || PyFile_AsFile(file) == fp)
826 vfprintf(fp, format, va);
827 else {
828 char buffer[1001];
Guido van Rossum8442af31998-10-12 18:22:10 +0000829 if (vsprintf(buffer, format, va) >= sizeof(buffer))
830 Py_FatalError("PySys_WriteStdout/err: buffer overrun");
Guido van Rossuma890e681998-05-12 14:59:24 +0000831 if (PyFile_WriteString(buffer, file) != 0) {
832 PyErr_Clear();
833 fputs(buffer, fp);
834 }
835 }
Guido van Rossum8442af31998-10-12 18:22:10 +0000836 PyErr_Restore(error_type, error_value, error_traceback);
Guido van Rossuma890e681998-05-12 14:59:24 +0000837}
838
839void
Guido van Rossuma890e681998-05-12 14:59:24 +0000840PySys_WriteStdout(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +0000841{
842 va_list va;
843
Guido van Rossuma890e681998-05-12 14:59:24 +0000844 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +0000845 mywrite("stdout", stdout, format, va);
846 va_end(va);
847}
848
849void
Guido van Rossuma890e681998-05-12 14:59:24 +0000850PySys_WriteStderr(const char *format, ...)
Guido van Rossuma890e681998-05-12 14:59:24 +0000851{
852 va_list va;
853
Guido van Rossuma890e681998-05-12 14:59:24 +0000854 va_start(va, format);
Guido van Rossuma890e681998-05-12 14:59:24 +0000855 mywrite("stderr", stderr, format, va);
856 va_end(va);
857}