Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 1 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 2 | /* System module */ |
| 3 | |
| 4 | /* |
| 5 | Various bits of information used by the interpreter are collected in |
| 6 | module 'sys'. |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 7 | Function member: |
Guido van Rossum | cc8914f | 1995-03-20 15:09:40 +0000 | [diff] [blame] | 8 | - exit(sts): raise SystemExit |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 9 | Data members: |
| 10 | - stdin, stdout, stderr: standard file objects |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 11 | - modules: the table of modules (dictionary) |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 12 | - 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 Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 15 | */ |
| 16 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 17 | #include "Python.h" |
Barry Warsaw | b6a54d2 | 2000-12-06 21:47:46 +0000 | [diff] [blame] | 18 | #include "compile.h" |
| 19 | #include "frameobject.h" |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 20 | |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 21 | #include "osdefs.h" |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 22 | |
Guido van Rossum | 1254d79 | 1997-05-20 15:57:25 +0000 | [diff] [blame] | 23 | #ifdef HAVE_UNISTD_H |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 24 | #include <unistd.h> |
| 25 | #endif |
| 26 | |
Guido van Rossum | 9b38a14 | 1996-09-11 23:12:24 +0000 | [diff] [blame] | 27 | #ifdef MS_COREDLL |
Guido van Rossum | c606fe1 | 1996-04-09 02:37:57 +0000 | [diff] [blame] | 28 | extern void *PyWin_DLLhModule; |
Guido van Rossum | 6c1e5f2 | 1997-09-29 23:34:23 +0000 | [diff] [blame] | 29 | /* A string loaded from the DLL at startup: */ |
| 30 | extern const char *PyWin_DLLVersionString; |
Guido van Rossum | c606fe1 | 1996-04-09 02:37:57 +0000 | [diff] [blame] | 31 | #endif |
| 32 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 33 | PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 34 | PySys_GetObject(char *name) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 35 | { |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 36 | PyThreadState *tstate = PyThreadState_Get(); |
| 37 | PyObject *sd = tstate->interp->sysdict; |
Guido van Rossum | be20336 | 1999-10-05 22:17:41 +0000 | [diff] [blame] | 38 | if (sd == NULL) |
| 39 | return NULL; |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 40 | return PyDict_GetItemString(sd, name); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 41 | } |
| 42 | |
| 43 | FILE * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 44 | PySys_GetFile(char *name, FILE *def) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 45 | { |
| 46 | FILE *fp = NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 47 | PyObject *v = PySys_GetObject(name); |
| 48 | if (v != NULL && PyFile_Check(v)) |
| 49 | fp = PyFile_AsFile(v); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 50 | if (fp == NULL) |
| 51 | fp = def; |
| 52 | return fp; |
| 53 | } |
| 54 | |
| 55 | int |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 56 | PySys_SetObject(char *name, PyObject *v) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 57 | { |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 58 | PyThreadState *tstate = PyThreadState_Get(); |
| 59 | PyObject *sd = tstate->interp->sysdict; |
Guido van Rossum | 5ad58c6 | 1992-01-26 18:15:48 +0000 | [diff] [blame] | 60 | if (v == NULL) { |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 61 | if (PyDict_GetItemString(sd, name) == NULL) |
Guido van Rossum | 5ad58c6 | 1992-01-26 18:15:48 +0000 | [diff] [blame] | 62 | return 0; |
| 63 | else |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 64 | return PyDict_DelItemString(sd, name); |
Guido van Rossum | 5ad58c6 | 1992-01-26 18:15:48 +0000 | [diff] [blame] | 65 | } |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 66 | else |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 67 | return PyDict_SetItemString(sd, name, v); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 68 | } |
| 69 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 70 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 71 | sys_displayhook(PyObject *self, PyObject *o) |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 72 | { |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 73 | PyObject *outf; |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 74 | PyInterpreterState *interp = PyThreadState_Get()->interp; |
| 75 | PyObject *modules = interp->modules; |
| 76 | PyObject *builtins = PyDict_GetItemString(modules, "__builtin__"); |
| 77 | |
Moshe Zadka | 03897ea | 2001-07-23 13:32:43 +0000 | [diff] [blame] | 78 | if (builtins == NULL) { |
| 79 | PyErr_SetString(PyExc_RuntimeError, "lost __builtin__"); |
| 80 | return NULL; |
| 81 | } |
| 82 | |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 83 | /* Print value except if None */ |
| 84 | /* After printing, also assign to '_' */ |
| 85 | /* Before, set '_' to None to avoid recursion */ |
| 86 | if (o == Py_None) { |
| 87 | Py_INCREF(Py_None); |
| 88 | return Py_None; |
| 89 | } |
| 90 | if (PyObject_SetAttrString(builtins, "_", Py_None) != 0) |
| 91 | return NULL; |
| 92 | if (Py_FlushLine() != 0) |
| 93 | return NULL; |
Greg Stein | ceb9b7c | 2001-01-11 09:27:34 +0000 | [diff] [blame] | 94 | outf = PySys_GetObject("stdout"); |
| 95 | if (outf == NULL) { |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 96 | PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout"); |
| 97 | return NULL; |
| 98 | } |
Greg Stein | ceb9b7c | 2001-01-11 09:27:34 +0000 | [diff] [blame] | 99 | if (PyFile_WriteObject(o, outf, 0) != 0) |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 100 | return NULL; |
Greg Stein | ceb9b7c | 2001-01-11 09:27:34 +0000 | [diff] [blame] | 101 | PyFile_SoftSpace(outf, 1); |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 102 | if (Py_FlushLine() != 0) |
| 103 | return NULL; |
| 104 | if (PyObject_SetAttrString(builtins, "_", o) != 0) |
| 105 | return NULL; |
| 106 | Py_INCREF(Py_None); |
| 107 | return Py_None; |
| 108 | } |
| 109 | |
| 110 | static char displayhook_doc[] = |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 111 | "displayhook(object) -> None\n" |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 112 | "\n" |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 113 | "Print an object to sys.stdout and also save it in __builtin__._\n"; |
| 114 | |
| 115 | static PyObject * |
| 116 | sys_excepthook(PyObject* self, PyObject* args) |
| 117 | { |
| 118 | PyObject *exc, *value, *tb; |
| 119 | if (!PyArg_ParseTuple(args, "OOO:excepthook", &exc, &value, &tb)) |
| 120 | return NULL; |
| 121 | PyErr_Display(exc, value, tb); |
| 122 | Py_INCREF(Py_None); |
| 123 | return Py_None; |
| 124 | } |
| 125 | |
| 126 | static char excepthook_doc[] = |
| 127 | "excepthook(exctype, value, traceback) -> None\n" |
| 128 | "\n" |
| 129 | "Handle an exception by displaying it with a traceback on sys.stderr.\n"; |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 130 | |
| 131 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 132 | sys_exc_info(PyObject *self) |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 133 | { |
| 134 | PyThreadState *tstate; |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 135 | tstate = PyThreadState_Get(); |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 136 | return Py_BuildValue( |
| 137 | "(OOO)", |
| 138 | tstate->exc_type != NULL ? tstate->exc_type : Py_None, |
| 139 | tstate->exc_value != NULL ? tstate->exc_value : Py_None, |
| 140 | tstate->exc_traceback != NULL ? |
| 141 | tstate->exc_traceback : Py_None); |
| 142 | } |
| 143 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 144 | static char exc_info_doc[] = |
| 145 | "exc_info() -> (type, value, traceback)\n\ |
| 146 | \n\ |
| 147 | Return information about the exception that is currently being handled.\n\ |
| 148 | This should be called from inside an except clause only."; |
| 149 | |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 150 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 151 | sys_exit(PyObject *self, PyObject *args) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 152 | { |
Guido van Rossum | 6a468bf | 1991-12-31 13:15:35 +0000 | [diff] [blame] | 153 | /* Raise SystemExit so callers may catch it or clean up. */ |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 154 | PyErr_SetObject(PyExc_SystemExit, args); |
Guido van Rossum | 6a468bf | 1991-12-31 13:15:35 +0000 | [diff] [blame] | 155 | return NULL; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 156 | } |
| 157 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 158 | static char exit_doc[] = |
| 159 | "exit([status])\n\ |
| 160 | \n\ |
| 161 | Exit the interpreter by raising SystemExit(status).\n\ |
| 162 | If the status is omitted or None, it defaults to zero (i.e., success).\n\ |
| 163 | If the status numeric, it will be used as the system exit status.\n\ |
| 164 | If it is another kind of object, it will be printed and the system\n\ |
| 165 | exit status will be one (i.e., failure)."; |
| 166 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 167 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 168 | sys_getdefaultencoding(PyObject *self) |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 169 | { |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 170 | return PyString_FromString(PyUnicode_GetDefaultEncoding()); |
| 171 | } |
| 172 | |
Marc-André Lemburg | 99964b8 | 2000-06-07 09:13:41 +0000 | [diff] [blame] | 173 | static char getdefaultencoding_doc[] = |
| 174 | "getdefaultencoding() -> string\n\ |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 175 | \n\ |
| 176 | Return the current default string encoding used by the Unicode \n\ |
| 177 | implementation."; |
| 178 | |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 179 | #ifdef Py_USING_UNICODE |
| 180 | |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 181 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 182 | sys_setdefaultencoding(PyObject *self, PyObject *args) |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 183 | { |
| 184 | char *encoding; |
Marc-André Lemburg | 99964b8 | 2000-06-07 09:13:41 +0000 | [diff] [blame] | 185 | if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding)) |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 186 | return NULL; |
| 187 | if (PyUnicode_SetDefaultEncoding(encoding)) |
| 188 | return NULL; |
| 189 | Py_INCREF(Py_None); |
| 190 | return Py_None; |
| 191 | } |
| 192 | |
Marc-André Lemburg | 99964b8 | 2000-06-07 09:13:41 +0000 | [diff] [blame] | 193 | static char setdefaultencoding_doc[] = |
| 194 | "setdefaultencoding(encoding)\n\ |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 195 | \n\ |
| 196 | Set the current default string encoding used by the Unicode implementation."; |
| 197 | |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 198 | #endif |
| 199 | |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 200 | /* |
| 201 | * Cached interned string objects used for calling the profile and |
| 202 | * trace functions. Initialized by trace_init(). |
| 203 | */ |
| 204 | static PyObject *whatstrings[4] = {NULL, NULL, NULL, NULL}; |
| 205 | |
| 206 | static int |
| 207 | trace_init(void) |
| 208 | { |
| 209 | static char *whatnames[4] = {"call", "exception", "line", "return"}; |
| 210 | PyObject *name; |
| 211 | int i; |
| 212 | for (i = 0; i < 4; ++i) { |
| 213 | if (whatstrings[i] == NULL) { |
| 214 | name = PyString_InternFromString(whatnames[i]); |
| 215 | if (name == NULL) |
| 216 | return -1; |
| 217 | whatstrings[i] = name; |
| 218 | } |
| 219 | } |
| 220 | return 0; |
| 221 | } |
| 222 | |
| 223 | |
| 224 | static PyObject * |
| 225 | call_trampoline(PyThreadState *tstate, PyObject* callback, |
| 226 | PyFrameObject *frame, int what, PyObject *arg) |
| 227 | { |
| 228 | PyObject *args = PyTuple_New(3); |
| 229 | PyObject *whatstr; |
| 230 | PyObject *result; |
| 231 | |
| 232 | if (args == NULL) |
| 233 | return NULL; |
| 234 | Py_INCREF(frame); |
| 235 | whatstr = whatstrings[what]; |
| 236 | Py_INCREF(whatstr); |
| 237 | if (arg == NULL) |
| 238 | arg = Py_None; |
| 239 | Py_INCREF(arg); |
| 240 | PyTuple_SET_ITEM(args, 0, (PyObject *)frame); |
| 241 | PyTuple_SET_ITEM(args, 1, whatstr); |
| 242 | PyTuple_SET_ITEM(args, 2, arg); |
| 243 | |
| 244 | /* call the Python-level function */ |
| 245 | PyFrame_FastToLocals(frame); |
| 246 | result = PyEval_CallObject(callback, args); |
| 247 | PyFrame_LocalsToFast(frame, 1); |
| 248 | if (result == NULL) |
| 249 | PyTraceBack_Here(frame); |
| 250 | |
| 251 | /* cleanup */ |
| 252 | Py_DECREF(args); |
| 253 | return result; |
| 254 | } |
| 255 | |
| 256 | static int |
| 257 | profile_trampoline(PyObject *self, PyFrameObject *frame, |
| 258 | int what, PyObject *arg) |
| 259 | { |
| 260 | PyThreadState *tstate = frame->f_tstate; |
| 261 | PyObject *result; |
| 262 | |
| 263 | result = call_trampoline(tstate, self, frame, what, arg); |
| 264 | if (result == NULL) { |
| 265 | PyEval_SetProfile(NULL, NULL); |
| 266 | return -1; |
| 267 | } |
| 268 | Py_DECREF(result); |
| 269 | return 0; |
| 270 | } |
| 271 | |
| 272 | static int |
| 273 | trace_trampoline(PyObject *self, PyFrameObject *frame, |
| 274 | int what, PyObject *arg) |
| 275 | { |
| 276 | PyThreadState *tstate = frame->f_tstate; |
| 277 | PyObject *callback; |
| 278 | PyObject *result; |
| 279 | |
| 280 | if (what == PyTrace_CALL) |
| 281 | callback = self; |
| 282 | else |
| 283 | callback = frame->f_trace; |
| 284 | if (callback == NULL) |
| 285 | return 0; |
| 286 | result = call_trampoline(tstate, callback, frame, what, arg); |
| 287 | if (result == NULL) { |
| 288 | PyEval_SetTrace(NULL, NULL); |
| 289 | Py_XDECREF(frame->f_trace); |
| 290 | frame->f_trace = NULL; |
| 291 | return -1; |
| 292 | } |
| 293 | if (result != Py_None) { |
| 294 | PyObject *temp = frame->f_trace; |
| 295 | frame->f_trace = NULL; |
| 296 | Py_XDECREF(temp); |
| 297 | frame->f_trace = result; |
| 298 | } |
| 299 | else { |
| 300 | Py_DECREF(result); |
| 301 | } |
| 302 | return 0; |
| 303 | } |
Fred Drake | d083839 | 2001-06-16 21:02:31 +0000 | [diff] [blame] | 304 | |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 305 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 306 | sys_settrace(PyObject *self, PyObject *args) |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 307 | { |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 308 | if (trace_init() == -1) |
Fred Drake | d083839 | 2001-06-16 21:02:31 +0000 | [diff] [blame] | 309 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 310 | if (args == Py_None) |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 311 | PyEval_SetTrace(NULL, NULL); |
Guido van Rossum | e765f7d | 1992-04-05 14:17:55 +0000 | [diff] [blame] | 312 | else |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 313 | PyEval_SetTrace(trace_trampoline, args); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 314 | Py_INCREF(Py_None); |
| 315 | return Py_None; |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 316 | } |
| 317 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 318 | static char settrace_doc[] = |
| 319 | "settrace(function)\n\ |
| 320 | \n\ |
| 321 | Set the global debug tracing function. It will be called on each\n\ |
| 322 | function call. See the debugger chapter in the library manual."; |
| 323 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 324 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 325 | sys_setprofile(PyObject *self, PyObject *args) |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 326 | { |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 327 | if (trace_init() == -1) |
Fred Drake | d083839 | 2001-06-16 21:02:31 +0000 | [diff] [blame] | 328 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 329 | if (args == Py_None) |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 330 | PyEval_SetProfile(NULL, NULL); |
Guido van Rossum | e765f7d | 1992-04-05 14:17:55 +0000 | [diff] [blame] | 331 | else |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 332 | PyEval_SetProfile(profile_trampoline, args); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 333 | Py_INCREF(Py_None); |
| 334 | return Py_None; |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 335 | } |
| 336 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 337 | static char setprofile_doc[] = |
| 338 | "setprofile(function)\n\ |
| 339 | \n\ |
| 340 | Set the profiling function. It will be called on each function call\n\ |
| 341 | and return. See the profiler chapter in the library manual."; |
| 342 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 343 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 344 | sys_setcheckinterval(PyObject *self, PyObject *args) |
Guido van Rossum | a0d7a23 | 1995-01-09 17:46:13 +0000 | [diff] [blame] | 345 | { |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 346 | PyThreadState *tstate = PyThreadState_Get(); |
Guido van Rossum | 43713e5 | 2000-02-29 13:59:29 +0000 | [diff] [blame] | 347 | if (!PyArg_ParseTuple(args, "i:setcheckinterval", &tstate->interp->checkinterval)) |
Guido van Rossum | a0d7a23 | 1995-01-09 17:46:13 +0000 | [diff] [blame] | 348 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 349 | Py_INCREF(Py_None); |
| 350 | return Py_None; |
Guido van Rossum | a0d7a23 | 1995-01-09 17:46:13 +0000 | [diff] [blame] | 351 | } |
| 352 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 353 | static char setcheckinterval_doc[] = |
| 354 | "setcheckinterval(n)\n\ |
| 355 | \n\ |
| 356 | Tell the Python interpreter to check for asynchronous events every\n\ |
| 357 | n instructions. This also affects how often thread switches occur."; |
| 358 | |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 359 | static PyObject * |
| 360 | sys_setrecursionlimit(PyObject *self, PyObject *args) |
| 361 | { |
| 362 | int new_limit; |
| 363 | if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit)) |
| 364 | return NULL; |
| 365 | if (new_limit <= 0) { |
| 366 | PyErr_SetString(PyExc_ValueError, |
| 367 | "recursion limit must be positive"); |
| 368 | return NULL; |
| 369 | } |
| 370 | Py_SetRecursionLimit(new_limit); |
| 371 | Py_INCREF(Py_None); |
| 372 | return Py_None; |
| 373 | } |
| 374 | |
| 375 | static char setrecursionlimit_doc[] = |
| 376 | "setrecursionlimit(n)\n\ |
| 377 | \n\ |
| 378 | Set the maximum depth of the Python interpreter stack to n. This\n\ |
| 379 | limit prevents infinite recursion from causing an overflow of the C\n\ |
| 380 | stack and crashing Python. The highest possible limit is platform-\n\ |
| 381 | dependent."; |
| 382 | |
| 383 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 384 | sys_getrecursionlimit(PyObject *self) |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 385 | { |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 386 | return PyInt_FromLong(Py_GetRecursionLimit()); |
| 387 | } |
| 388 | |
| 389 | static char getrecursionlimit_doc[] = |
| 390 | "getrecursionlimit()\n\ |
| 391 | \n\ |
| 392 | Return the current value of the recursion limit, the maximum depth\n\ |
| 393 | of the Python interpreter stack. This limit prevents infinite\n\ |
| 394 | recursion from causing an overflow of the C stack and crashing Python."; |
| 395 | |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 396 | #ifdef HAVE_DLOPEN |
| 397 | static PyObject * |
| 398 | sys_setdlopenflags(PyObject *self, PyObject *args) |
| 399 | { |
| 400 | int new_val; |
| 401 | PyThreadState *tstate = PyThreadState_Get(); |
| 402 | if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val)) |
| 403 | return NULL; |
| 404 | if (!tstate) |
| 405 | return NULL; |
| 406 | tstate->interp->dlopenflags = new_val; |
| 407 | Py_INCREF(Py_None); |
| 408 | return Py_None; |
| 409 | } |
| 410 | |
| 411 | static char setdlopenflags_doc[] = |
| 412 | "setdlopenflags(n) -> None\n\ |
| 413 | \n\ |
| 414 | Set the flags that will be used for dlopen() calls. Among other\n\ |
| 415 | things, this will enable a lazy resolving of symbols when imporing\n\ |
| 416 | a module, if called as sys.setdlopenflags(0)\n\ |
| 417 | To share symols across extension modules, call as\n\ |
| 418 | sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)"; |
| 419 | |
| 420 | static PyObject * |
| 421 | sys_getdlopenflags(PyObject *self, PyObject *args) |
| 422 | { |
| 423 | PyThreadState *tstate = PyThreadState_Get(); |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 424 | if (!tstate) |
| 425 | return NULL; |
| 426 | return PyInt_FromLong(tstate->interp->dlopenflags); |
| 427 | } |
| 428 | |
| 429 | static char getdlopenflags_doc[] = |
| 430 | "getdlopenflags() -> int\n\ |
| 431 | \n\ |
| 432 | Return the current value of the flags that are used for dlopen()\n\ |
| 433 | calls. The flag constants are defined in the dl module."; |
| 434 | #endif |
| 435 | |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 436 | #ifdef USE_MALLOPT |
| 437 | /* Link with -lmalloc (or -lmpc) on an SGI */ |
| 438 | #include <malloc.h> |
| 439 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 440 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 441 | sys_mdebug(PyObject *self, PyObject *args) |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 442 | { |
| 443 | int flag; |
Guido van Rossum | ffc0f4f | 2000-03-31 00:38:29 +0000 | [diff] [blame] | 444 | if (!PyArg_ParseTuple(args, "i:mdebug", &flag)) |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 445 | return NULL; |
| 446 | mallopt(M_DEBUG, flag); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 447 | Py_INCREF(Py_None); |
| 448 | return Py_None; |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 449 | } |
| 450 | #endif /* USE_MALLOPT */ |
| 451 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 452 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 453 | sys_getrefcount(PyObject *self, PyObject *args) |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 454 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 455 | PyObject *arg; |
Guido van Rossum | ffc0f4f | 2000-03-31 00:38:29 +0000 | [diff] [blame] | 456 | if (!PyArg_ParseTuple(args, "O:getrefcount", &arg)) |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 457 | return NULL; |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 458 | return PyInt_FromLong(arg->ob_refcnt); |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 459 | } |
| 460 | |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 461 | #ifdef Py_TRACE_REFS |
| 462 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 463 | sys_gettotalrefcount(PyObject *self) |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 464 | { |
| 465 | extern long _Py_RefTotal; |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 466 | return PyInt_FromLong(_Py_RefTotal); |
| 467 | } |
| 468 | |
| 469 | #endif /* Py_TRACE_REFS */ |
| 470 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 471 | static char getrefcount_doc[] = |
| 472 | "getrefcount(object) -> integer\n\ |
| 473 | \n\ |
| 474 | Return the current reference count for the object. This includes the\n\ |
| 475 | temporary reference in the argument list, so it is at least 2."; |
| 476 | |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 477 | #ifdef COUNT_ALLOCS |
| 478 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 479 | sys_getcounts(PyObject *self) |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 480 | { |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 481 | extern PyObject *get_counts(void); |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 482 | |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 483 | return get_counts(); |
| 484 | } |
| 485 | #endif |
| 486 | |
Barry Warsaw | b6a54d2 | 2000-12-06 21:47:46 +0000 | [diff] [blame] | 487 | static char getframe_doc[] = |
| 488 | "_getframe([depth]) -> frameobject\n\ |
| 489 | \n\ |
| 490 | Return a frame object from the call stack. If optional integer depth is\n\ |
| 491 | given, return the frame object that many calls below the top of the stack.\n\ |
| 492 | If that is deeper than the call stack, ValueError is raised. The default\n\ |
| 493 | for depth is zero, returning the frame at the top of the call stack.\n\ |
| 494 | \n\ |
| 495 | This function should be used for internal and specialized\n\ |
| 496 | purposes only."; |
| 497 | |
| 498 | static PyObject * |
| 499 | sys_getframe(PyObject *self, PyObject *args) |
| 500 | { |
| 501 | PyFrameObject *f = PyThreadState_Get()->frame; |
| 502 | int depth = -1; |
| 503 | |
| 504 | if (!PyArg_ParseTuple(args, "|i:_getframe", &depth)) |
| 505 | return NULL; |
| 506 | |
| 507 | while (depth > 0 && f != NULL) { |
| 508 | f = f->f_back; |
| 509 | --depth; |
| 510 | } |
| 511 | if (f == NULL) { |
| 512 | PyErr_SetString(PyExc_ValueError, |
| 513 | "call stack is not deep enough"); |
| 514 | return NULL; |
| 515 | } |
| 516 | Py_INCREF(f); |
| 517 | return (PyObject*)f; |
| 518 | } |
| 519 | |
| 520 | |
Guido van Rossum | 7f3f2c1 | 1996-05-23 22:45:41 +0000 | [diff] [blame] | 521 | #ifdef Py_TRACE_REFS |
Guido van Rossum | ded690f | 1996-05-24 20:48:31 +0000 | [diff] [blame] | 522 | /* Defined in objects.c because it uses static globals if that file */ |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 523 | extern PyObject *_Py_GetObjects(PyObject *, PyObject *); |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 524 | #endif |
Guido van Rossum | ded690f | 1996-05-24 20:48:31 +0000 | [diff] [blame] | 525 | |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 526 | #ifdef DYNAMIC_EXECUTION_PROFILE |
| 527 | /* Defined in ceval.c because it uses static globals if that file */ |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 528 | extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *); |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 529 | #endif |
| 530 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 531 | static PyMethodDef sys_methods[] = { |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 532 | /* Might as well keep this in alphabetic order */ |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 533 | {"displayhook", sys_displayhook, METH_O, displayhook_doc}, |
| 534 | {"exc_info", (PyCFunction)sys_exc_info, METH_NOARGS, exc_info_doc}, |
| 535 | {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc}, |
| 536 | {"exit", sys_exit, METH_OLDARGS, exit_doc}, |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 537 | #ifdef Py_USING_UNICODE |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 538 | {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding, METH_NOARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 539 | getdefaultencoding_doc}, |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 540 | #endif |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 541 | #ifdef HAVE_DLOPEN |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 542 | {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS, |
| 543 | getdlopenflags_doc}, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 544 | #endif |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 545 | #ifdef COUNT_ALLOCS |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 546 | {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS}, |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 547 | #endif |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 548 | #ifdef DYNAMIC_EXECUTION_PROFILE |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 549 | {"getdxp", _Py_GetDXProfile, METH_VARARGS}, |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 550 | #endif |
Guido van Rossum | 7f3f2c1 | 1996-05-23 22:45:41 +0000 | [diff] [blame] | 551 | #ifdef Py_TRACE_REFS |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 552 | {"getobjects", _Py_GetObjects, METH_VARARGS}, |
| 553 | {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS}, |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 554 | #endif |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 555 | {"getrefcount", sys_getrefcount, METH_VARARGS, getrefcount_doc}, |
| 556 | {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 557 | getrecursionlimit_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 558 | {"_getframe", sys_getframe, METH_VARARGS, getframe_doc}, |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 559 | #ifdef USE_MALLOPT |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 560 | {"mdebug", sys_mdebug, METH_VARARGS}, |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 561 | #endif |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 562 | #ifdef Py_USING_UNICODE |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 563 | {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 564 | setdefaultencoding_doc}, |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 565 | #endif |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 566 | {"setcheckinterval", sys_setcheckinterval, METH_VARARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 567 | setcheckinterval_doc}, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 568 | #ifdef HAVE_DLOPEN |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 569 | {"setdlopenflags", sys_setdlopenflags, METH_VARARGS, |
| 570 | setdlopenflags_doc}, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 571 | #endif |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 572 | {"setprofile", sys_setprofile, METH_OLDARGS, setprofile_doc}, |
| 573 | {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 574 | setrecursionlimit_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 575 | {"settrace", sys_settrace, METH_OLDARGS, settrace_doc}, |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 576 | {NULL, NULL} /* sentinel */ |
| 577 | }; |
| 578 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 579 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 580 | list_builtin_module_names(void) |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 581 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 582 | PyObject *list = PyList_New(0); |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 583 | int i; |
| 584 | if (list == NULL) |
| 585 | return NULL; |
Guido van Rossum | 25c649f | 1997-11-04 17:04:34 +0000 | [diff] [blame] | 586 | for (i = 0; PyImport_Inittab[i].name != NULL; i++) { |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 587 | PyObject *name = PyString_FromString( |
Guido van Rossum | 25c649f | 1997-11-04 17:04:34 +0000 | [diff] [blame] | 588 | PyImport_Inittab[i].name); |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 589 | if (name == NULL) |
| 590 | break; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 591 | PyList_Append(list, name); |
| 592 | Py_DECREF(name); |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 593 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 594 | if (PyList_Sort(list) != 0) { |
| 595 | Py_DECREF(list); |
Guido van Rossum | 1d5735e | 1994-08-30 08:27:36 +0000 | [diff] [blame] | 596 | list = NULL; |
| 597 | } |
Guido van Rossum | 8f49e12 | 1997-01-06 22:55:54 +0000 | [diff] [blame] | 598 | if (list) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 599 | PyObject *v = PyList_AsTuple(list); |
| 600 | Py_DECREF(list); |
Guido van Rossum | 8f49e12 | 1997-01-06 22:55:54 +0000 | [diff] [blame] | 601 | list = v; |
| 602 | } |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 603 | return list; |
| 604 | } |
| 605 | |
Guido van Rossum | 23fff91 | 2000-12-15 22:02:05 +0000 | [diff] [blame] | 606 | static PyObject *warnoptions = NULL; |
| 607 | |
| 608 | void |
| 609 | PySys_ResetWarnOptions(void) |
| 610 | { |
| 611 | if (warnoptions == NULL || !PyList_Check(warnoptions)) |
| 612 | return; |
| 613 | PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL); |
| 614 | } |
| 615 | |
| 616 | void |
| 617 | PySys_AddWarnOption(char *s) |
| 618 | { |
| 619 | PyObject *str; |
| 620 | |
| 621 | if (warnoptions == NULL || !PyList_Check(warnoptions)) { |
| 622 | Py_XDECREF(warnoptions); |
| 623 | warnoptions = PyList_New(0); |
| 624 | if (warnoptions == NULL) |
| 625 | return; |
| 626 | } |
| 627 | str = PyString_FromString(s); |
| 628 | if (str != NULL) { |
| 629 | PyList_Append(warnoptions, str); |
| 630 | Py_DECREF(str); |
| 631 | } |
| 632 | } |
| 633 | |
Guido van Rossum | 40552d0 | 1998-08-06 03:34:39 +0000 | [diff] [blame] | 634 | /* XXX This doc string is too long to be a single string literal in VC++ 5.0. |
| 635 | Two literals concatenated works just fine. If you have a K&R compiler |
| 636 | or other abomination that however *does* understand longer strings, |
| 637 | get rid of the !!! comment in the middle and the quotes that surround it. */ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 638 | static char sys_doc[] = |
| 639 | "This module provides access to some objects used or maintained by the\n\ |
| 640 | interpreter and to functions that interact strongly with the interpreter.\n\ |
| 641 | \n\ |
| 642 | Dynamic objects:\n\ |
| 643 | \n\ |
| 644 | argv -- command line arguments; argv[0] is the script pathname if known\n\ |
| 645 | path -- module search path; path[0] is the script directory, else ''\n\ |
| 646 | modules -- dictionary of loaded modules\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 647 | \n\ |
| 648 | displayhook -- called to show results in an interactive session\n\ |
| 649 | excepthook -- called to handle any uncaught exception other than SystemExit\n\ |
| 650 | To customize printing in an interactive session or to install a custom\n\ |
| 651 | top-level exception handler, assign other functions to replace these.\n\ |
| 652 | \n\ |
| 653 | exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\ |
| 654 | Assigning to sys.exitfunc is deprecated; use the atexit module instead.\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 655 | \n\ |
| 656 | stdin -- standard input file object; used by raw_input() and input()\n\ |
| 657 | stdout -- standard output file object; used by the print statement\n\ |
| 658 | stderr -- standard error object; used for error messages\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 659 | By assigning other file objects (or objects that behave like files)\n\ |
| 660 | to these, it is possible to redirect all of the interpreter's I/O.\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 661 | \n\ |
| 662 | last_type -- type of last uncaught exception\n\ |
| 663 | last_value -- value of last uncaught exception\n\ |
| 664 | last_traceback -- traceback of last uncaught exception\n\ |
| 665 | These three are only available in an interactive session after a\n\ |
| 666 | traceback has been printed.\n\ |
| 667 | \n\ |
| 668 | exc_type -- type of exception currently being handled\n\ |
| 669 | exc_value -- value of exception currently being handled\n\ |
| 670 | exc_traceback -- traceback of exception currently being handled\n\ |
| 671 | The function exc_info() should be used instead of these three,\n\ |
| 672 | because it is thread-safe.\n\ |
Guido van Rossum | a71b5f4 | 1999-01-14 19:07:00 +0000 | [diff] [blame] | 673 | " |
| 674 | #ifndef MS_WIN16 |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 675 | /* concatenating string here */ |
Guido van Rossum | a71b5f4 | 1999-01-14 19:07:00 +0000 | [diff] [blame] | 676 | "\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 677 | Static objects:\n\ |
| 678 | \n\ |
| 679 | maxint -- the largest supported integer (the smallest is -maxint-1)\n\ |
Martin v. Löwis | ce9b5a5 | 2001-06-27 06:28:56 +0000 | [diff] [blame] | 680 | maxunicode -- the largest supported character\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 681 | builtin_module_names -- tuple of module names built into this intepreter\n\ |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 682 | version -- the version of this interpreter as a string\n\ |
| 683 | version_info -- version information as a tuple\n\ |
| 684 | hexversion -- version information encoded as a single integer\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 685 | copyright -- copyright notice pertaining to this interpreter\n\ |
| 686 | platform -- platform identifier\n\ |
| 687 | executable -- pathname of this Python interpreter\n\ |
| 688 | prefix -- prefix used to find the Python library\n\ |
| 689 | exec_prefix -- prefix used to find the machine-specific Python library\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 690 | " |
| 691 | #ifdef MS_WINDOWS |
| 692 | /* concatenating string here */ |
| 693 | "dllhandle -- [Windows only] integer handle of the Python DLL\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 694 | winver -- [Windows only] version number of the Python DLL\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 695 | " |
| 696 | #endif /* MS_WINDOWS */ |
| 697 | "__stdin__ -- the original stdin; don't touch!\n\ |
| 698 | __stdout__ -- the original stdout; don't touch!\n\ |
| 699 | __stderr__ -- the original stderr; don't touch!\n\ |
| 700 | __displayhook__ -- the original displayhook; don't touch!\n\ |
| 701 | __excepthook__ -- the original excepthook; don't touch!\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 702 | \n\ |
| 703 | Functions:\n\ |
| 704 | \n\ |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 705 | displayhook() -- print an object to the screen, and save it in __builtin__._\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 706 | excepthook() -- print an exception and its traceback to sys.stderr\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 707 | exc_info() -- return thread-safe information about the current exception\n\ |
| 708 | exit() -- exit the interpreter by raising SystemExit\n\ |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 709 | getdlopenflags() -- returns flags to be used for dlopen() calls\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 710 | getrefcount() -- return the reference count for an object (plus one :-)\n\ |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 711 | getrecursionlimit() -- return the max recursion depth for the interpreter\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 712 | setcheckinterval() -- control how often the interpreter checks for events\n\ |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 713 | setdlopenflags() -- set the flags to be used for dlopen() calls\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 714 | setprofile() -- set the global profiling function\n\ |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 715 | setrecursionlimit() -- set the max recursion depth for the interpreter\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 716 | settrace() -- set the global debug tracing function\n\ |
Fred Drake | ccede59 | 2000-08-14 20:59:57 +0000 | [diff] [blame] | 717 | " |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 718 | #endif /* MS_WIN16 */ |
Fred Drake | ccede59 | 2000-08-14 20:59:57 +0000 | [diff] [blame] | 719 | /* end of sys_doc */ ; |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 720 | |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 721 | PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 722 | _PySys_Init(void) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 723 | { |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 724 | PyObject *m, *v, *sysdict; |
| 725 | PyObject *sysin, *sysout, *syserr; |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 726 | char *s; |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 727 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 728 | m = Py_InitModule3("sys", sys_methods, sys_doc); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 729 | sysdict = PyModule_GetDict(m); |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 730 | |
| 731 | sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL); |
| 732 | sysout = PyFile_FromFile(stdout, "<stdout>", "w", NULL); |
| 733 | syserr = PyFile_FromFile(stderr, "<stderr>", "w", NULL); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 734 | if (PyErr_Occurred()) |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 735 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 736 | PyDict_SetItemString(sysdict, "stdin", sysin); |
| 737 | PyDict_SetItemString(sysdict, "stdout", sysout); |
| 738 | PyDict_SetItemString(sysdict, "stderr", syserr); |
Guido van Rossum | bd36dba | 1998-02-19 20:53:06 +0000 | [diff] [blame] | 739 | /* Make backup copies for cleanup */ |
| 740 | PyDict_SetItemString(sysdict, "__stdin__", sysin); |
| 741 | PyDict_SetItemString(sysdict, "__stdout__", sysout); |
| 742 | PyDict_SetItemString(sysdict, "__stderr__", syserr); |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 743 | PyDict_SetItemString(sysdict, "__displayhook__", |
| 744 | PyDict_GetItemString(sysdict, "displayhook")); |
| 745 | PyDict_SetItemString(sysdict, "__excepthook__", |
| 746 | PyDict_GetItemString(sysdict, "excepthook")); |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 747 | Py_XDECREF(sysin); |
| 748 | Py_XDECREF(sysout); |
| 749 | Py_XDECREF(syserr); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 750 | PyDict_SetItemString(sysdict, "version", |
| 751 | v = PyString_FromString(Py_GetVersion())); |
Barry Warsaw | 54892c4 | 1999-01-27 16:33:19 +0000 | [diff] [blame] | 752 | Py_XDECREF(v); |
Guido van Rossum | e0d7dae | 1999-01-03 12:55:39 +0000 | [diff] [blame] | 753 | PyDict_SetItemString(sysdict, "hexversion", |
| 754 | v = PyInt_FromLong(PY_VERSION_HEX)); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 755 | Py_XDECREF(v); |
Fred Drake | 93a20bf | 2000-04-13 17:44:51 +0000 | [diff] [blame] | 756 | /* |
| 757 | * These release level checks are mutually exclusive and cover |
| 758 | * the field, so don't get too fancy with the pre-processor! |
| 759 | */ |
| 760 | #if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 761 | s = "alpha"; |
Fred Drake | 592f2d6 | 2000-08-31 15:21:11 +0000 | [diff] [blame] | 762 | #elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 763 | s = "beta"; |
Fred Drake | 592f2d6 | 2000-08-31 15:21:11 +0000 | [diff] [blame] | 764 | #elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 765 | s = "candidate"; |
Fred Drake | 592f2d6 | 2000-08-31 15:21:11 +0000 | [diff] [blame] | 766 | #elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 767 | s = "final"; |
Fred Drake | 93a20bf | 2000-04-13 17:44:51 +0000 | [diff] [blame] | 768 | #endif |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 769 | PyDict_SetItemString(sysdict, "version_info", |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 770 | v = Py_BuildValue("iiisi", PY_MAJOR_VERSION, |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 771 | PY_MINOR_VERSION, |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 772 | PY_MICRO_VERSION, s, |
Fred Drake | 93a20bf | 2000-04-13 17:44:51 +0000 | [diff] [blame] | 773 | PY_RELEASE_SERIAL)); |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 774 | Py_XDECREF(v); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 775 | PyDict_SetItemString(sysdict, "copyright", |
| 776 | v = PyString_FromString(Py_GetCopyright())); |
| 777 | Py_XDECREF(v); |
| 778 | PyDict_SetItemString(sysdict, "platform", |
| 779 | v = PyString_FromString(Py_GetPlatform())); |
| 780 | Py_XDECREF(v); |
Guido van Rossum | b2c8ec4 | 1997-05-22 20:41:20 +0000 | [diff] [blame] | 781 | PyDict_SetItemString(sysdict, "executable", |
| 782 | v = PyString_FromString(Py_GetProgramFullPath())); |
| 783 | Py_XDECREF(v); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 784 | PyDict_SetItemString(sysdict, "prefix", |
| 785 | v = PyString_FromString(Py_GetPrefix())); |
| 786 | Py_XDECREF(v); |
| 787 | PyDict_SetItemString(sysdict, "exec_prefix", |
| 788 | v = PyString_FromString(Py_GetExecPrefix())); |
| 789 | Py_XDECREF(v); |
| 790 | PyDict_SetItemString(sysdict, "maxint", |
| 791 | v = PyInt_FromLong(PyInt_GetMax())); |
| 792 | Py_XDECREF(v); |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 793 | #ifdef Py_USING_UNICODE |
Martin v. Löwis | ce9b5a5 | 2001-06-27 06:28:56 +0000 | [diff] [blame] | 794 | PyDict_SetItemString(sysdict, "maxunicode", |
| 795 | v = PyInt_FromLong(PyUnicode_GetMax())); |
| 796 | Py_XDECREF(v); |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 797 | #endif |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 798 | PyDict_SetItemString(sysdict, "builtin_module_names", |
Guido van Rossum | 1ae940a | 1995-01-02 19:04:15 +0000 | [diff] [blame] | 799 | v = list_builtin_module_names()); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 800 | Py_XDECREF(v); |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 801 | { |
| 802 | /* Assumes that longs are at least 2 bytes long. |
| 803 | Should be safe! */ |
| 804 | unsigned long number = 1; |
Fred Drake | a2b6ad6 | 2000-08-15 04:24:43 +0000 | [diff] [blame] | 805 | char *value; |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 806 | |
| 807 | s = (char *) &number; |
| 808 | if (s[0] == 0) |
Fred Drake | a2b6ad6 | 2000-08-15 04:24:43 +0000 | [diff] [blame] | 809 | value = "big"; |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 810 | else |
Fred Drake | a2b6ad6 | 2000-08-15 04:24:43 +0000 | [diff] [blame] | 811 | value = "little"; |
| 812 | PyDict_SetItemString(sysdict, "byteorder", |
Barry Warsaw | f2581c9 | 2000-08-16 23:03:57 +0000 | [diff] [blame] | 813 | v = PyString_FromString(value)); |
| 814 | Py_XDECREF(v); |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 815 | } |
Guido van Rossum | 8b9ea87 | 1996-08-23 18:14:47 +0000 | [diff] [blame] | 816 | #ifdef MS_COREDLL |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 817 | PyDict_SetItemString(sysdict, "dllhandle", |
Guido van Rossum | 582acec | 2000-06-28 22:07:35 +0000 | [diff] [blame] | 818 | v = PyLong_FromVoidPtr(PyWin_DLLhModule)); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 819 | Py_XDECREF(v); |
| 820 | PyDict_SetItemString(sysdict, "winver", |
Guido van Rossum | 6c1e5f2 | 1997-09-29 23:34:23 +0000 | [diff] [blame] | 821 | v = PyString_FromString(PyWin_DLLVersionString)); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 822 | Py_XDECREF(v); |
Guido van Rossum | c606fe1 | 1996-04-09 02:37:57 +0000 | [diff] [blame] | 823 | #endif |
Guido van Rossum | 23fff91 | 2000-12-15 22:02:05 +0000 | [diff] [blame] | 824 | if (warnoptions == NULL) { |
| 825 | warnoptions = PyList_New(0); |
| 826 | } |
| 827 | else { |
| 828 | Py_INCREF(warnoptions); |
| 829 | } |
| 830 | if (warnoptions != NULL) { |
Guido van Rossum | 03df3b3 | 2001-01-13 22:06:05 +0000 | [diff] [blame] | 831 | PyDict_SetItemString(sysdict, "warnoptions", warnoptions); |
Guido van Rossum | 23fff91 | 2000-12-15 22:02:05 +0000 | [diff] [blame] | 832 | } |
| 833 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 834 | if (PyErr_Occurred()) |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 835 | return NULL; |
| 836 | return m; |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 837 | } |
| 838 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 839 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 840 | makepathobject(char *path, int delim) |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 841 | { |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 842 | int i, n; |
| 843 | char *p; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 844 | PyObject *v, *w; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 845 | |
| 846 | n = 1; |
| 847 | p = path; |
| 848 | while ((p = strchr(p, delim)) != NULL) { |
| 849 | n++; |
| 850 | p++; |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 851 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 852 | v = PyList_New(n); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 853 | if (v == NULL) |
| 854 | return NULL; |
| 855 | for (i = 0; ; i++) { |
| 856 | p = strchr(path, delim); |
| 857 | if (p == NULL) |
| 858 | p = strchr(path, '\0'); /* End of string */ |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 859 | w = PyString_FromStringAndSize(path, (int) (p - path)); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 860 | if (w == NULL) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 861 | Py_DECREF(v); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 862 | return NULL; |
| 863 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 864 | PyList_SetItem(v, i, w); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 865 | if (*p == '\0') |
| 866 | break; |
| 867 | path = p+1; |
| 868 | } |
| 869 | return v; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 870 | } |
| 871 | |
| 872 | void |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 873 | PySys_SetPath(char *path) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 874 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 875 | PyObject *v; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 876 | if ((v = makepathobject(path, DELIM)) == NULL) |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 877 | Py_FatalError("can't create sys.path"); |
| 878 | if (PySys_SetObject("path", v) != 0) |
| 879 | Py_FatalError("can't assign sys.path"); |
| 880 | Py_DECREF(v); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 881 | } |
| 882 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 883 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 884 | makeargvobject(int argc, char **argv) |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 885 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 886 | PyObject *av; |
Guido van Rossum | ee3a299 | 1992-01-14 18:42:53 +0000 | [diff] [blame] | 887 | if (argc <= 0 || argv == NULL) { |
| 888 | /* Ensure at least one (empty) argument is seen */ |
| 889 | static char *empty_argv[1] = {""}; |
| 890 | argv = empty_argv; |
| 891 | argc = 1; |
| 892 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 893 | av = PyList_New(argc); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 894 | if (av != NULL) { |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 895 | int i; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 896 | for (i = 0; i < argc; i++) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 897 | PyObject *v = PyString_FromString(argv[i]); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 898 | if (v == NULL) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 899 | Py_DECREF(av); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 900 | av = NULL; |
| 901 | break; |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 902 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 903 | PyList_SetItem(av, i, v); |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 904 | } |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 905 | } |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 906 | return av; |
| 907 | } |
| 908 | |
| 909 | void |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 910 | PySys_SetArgv(int argc, char **argv) |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 911 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 912 | PyObject *av = makeargvobject(argc, argv); |
| 913 | PyObject *path = PySys_GetObject("path"); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 914 | if (av == NULL) |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 915 | Py_FatalError("no mem for sys.argv"); |
| 916 | if (PySys_SetObject("argv", av) != 0) |
| 917 | Py_FatalError("can't assign sys.argv"); |
Guido van Rossum | 94a9667 | 1996-07-30 20:35:50 +0000 | [diff] [blame] | 918 | if (path != NULL) { |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 919 | char *argv0 = argv[0]; |
Guido van Rossum | 94a9667 | 1996-07-30 20:35:50 +0000 | [diff] [blame] | 920 | char *p = NULL; |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 921 | int n = 0; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 922 | PyObject *a; |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 923 | #ifdef HAVE_READLINK |
| 924 | char link[MAXPATHLEN+1]; |
| 925 | char argv0copy[2*MAXPATHLEN+1]; |
| 926 | int nr = 0; |
| 927 | if (argc > 0 && argv0 != NULL) |
| 928 | nr = readlink(argv0, link, MAXPATHLEN); |
| 929 | if (nr > 0) { |
| 930 | /* It's a symlink */ |
| 931 | link[nr] = '\0'; |
| 932 | if (link[0] == SEP) |
| 933 | argv0 = link; /* Link to absolute path */ |
| 934 | else if (strchr(link, SEP) == NULL) |
| 935 | ; /* Link without path */ |
| 936 | else { |
| 937 | /* Must join(dirname(argv0), link) */ |
| 938 | char *q = strrchr(argv0, SEP); |
| 939 | if (q == NULL) |
| 940 | argv0 = link; /* argv0 without path */ |
| 941 | else { |
| 942 | /* Must make a copy */ |
| 943 | strcpy(argv0copy, argv0); |
| 944 | q = strrchr(argv0copy, SEP); |
| 945 | strcpy(q+1, link); |
| 946 | argv0 = argv0copy; |
| 947 | } |
| 948 | } |
| 949 | } |
| 950 | #endif /* HAVE_READLINK */ |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 951 | #if SEP == '\\' /* Special case for MS filename syntax */ |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 952 | if (argc > 0 && argv0 != NULL) { |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 953 | char *q; |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 954 | p = strrchr(argv0, SEP); |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 955 | /* Test for alternate separator */ |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 956 | q = strrchr(p ? p : argv0, '/'); |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 957 | if (q != NULL) |
| 958 | p = q; |
| 959 | if (p != NULL) { |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 960 | n = p + 1 - argv0; |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 961 | if (n > 1 && p[-1] != ':') |
| 962 | n--; /* Drop trailing separator */ |
| 963 | } |
| 964 | } |
| 965 | #else /* All other filename syntaxes */ |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 966 | if (argc > 0 && argv0 != NULL) |
| 967 | p = strrchr(argv0, SEP); |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 968 | if (p != NULL) { |
Guido van Rossum | bceccf5 | 2001-04-10 22:07:43 +0000 | [diff] [blame] | 969 | #ifndef RISCOS |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 970 | n = p + 1 - argv0; |
Guido van Rossum | bceccf5 | 2001-04-10 22:07:43 +0000 | [diff] [blame] | 971 | #else /* don't include trailing separator */ |
| 972 | n = p - argv0; |
| 973 | #endif /* RISCOS */ |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 974 | #if SEP == '/' /* Special case for Unix filename syntax */ |
| 975 | if (n > 1) |
| 976 | n--; /* Drop trailing separator */ |
| 977 | #endif /* Unix */ |
| 978 | } |
| 979 | #endif /* All others */ |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 980 | a = PyString_FromStringAndSize(argv0, n); |
Guido van Rossum | 94a9667 | 1996-07-30 20:35:50 +0000 | [diff] [blame] | 981 | if (a == NULL) |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 982 | Py_FatalError("no mem for sys.path insertion"); |
| 983 | if (PyList_Insert(path, 0, a) < 0) |
| 984 | Py_FatalError("sys.path.insert(0) failed"); |
| 985 | Py_DECREF(a); |
Guido van Rossum | a63d9f4 | 1996-07-24 01:31:37 +0000 | [diff] [blame] | 986 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 987 | Py_DECREF(av); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 988 | } |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 989 | |
| 990 | |
| 991 | /* APIs to write to sys.stdout or sys.stderr using a printf-like interface. |
| 992 | Adapted from code submitted by Just van Rossum. |
| 993 | |
| 994 | PySys_WriteStdout(format, ...) |
| 995 | PySys_WriteStderr(format, ...) |
| 996 | |
| 997 | The first function writes to sys.stdout; the second to sys.stderr. When |
| 998 | there is a problem, they write to the real (C level) stdout or stderr; |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 999 | no exceptions are raised. |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1000 | |
| 1001 | Both take a printf-style format string as their first argument followed |
| 1002 | by a variable length argument list determined by the format string. |
| 1003 | |
| 1004 | *** WARNING *** |
| 1005 | |
| 1006 | The format should limit the total size of the formatted output string to |
| 1007 | 1000 bytes. In particular, this means that no unrestricted "%s" formats |
| 1008 | should occur; these should be limited using "%.<N>s where <N> is a |
| 1009 | decimal number calculated so that <N> plus the maximum size of other |
| 1010 | formatted text does not exceed 1000 bytes. Also watch out for "%f", |
| 1011 | which can print hundreds of digits for very large numbers. |
| 1012 | |
| 1013 | */ |
| 1014 | |
| 1015 | static void |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 1016 | mywrite(char *name, FILE *fp, const char *format, va_list va) |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1017 | { |
| 1018 | PyObject *file; |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1019 | PyObject *error_type, *error_value, *error_traceback; |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1020 | |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1021 | PyErr_Fetch(&error_type, &error_value, &error_traceback); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1022 | file = PySys_GetObject(name); |
| 1023 | if (file == NULL || PyFile_AsFile(file) == fp) |
| 1024 | vfprintf(fp, format, va); |
| 1025 | else { |
| 1026 | char buffer[1001]; |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1027 | if (vsprintf(buffer, format, va) >= sizeof(buffer)) |
| 1028 | Py_FatalError("PySys_WriteStdout/err: buffer overrun"); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1029 | if (PyFile_WriteString(buffer, file) != 0) { |
| 1030 | PyErr_Clear(); |
| 1031 | fputs(buffer, fp); |
| 1032 | } |
| 1033 | } |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1034 | PyErr_Restore(error_type, error_value, error_traceback); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1035 | } |
| 1036 | |
| 1037 | void |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1038 | PySys_WriteStdout(const char *format, ...) |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1039 | { |
| 1040 | va_list va; |
| 1041 | |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1042 | va_start(va, format); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1043 | mywrite("stdout", stdout, format, va); |
| 1044 | va_end(va); |
| 1045 | } |
| 1046 | |
| 1047 | void |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1048 | PySys_WriteStderr(const char *format, ...) |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1049 | { |
| 1050 | va_list va; |
| 1051 | |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1052 | va_start(va, format); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1053 | mywrite("stderr", stderr, format, va); |
| 1054 | va_end(va); |
| 1055 | } |