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 | a12fe4e | 2003-04-09 19:06:21 +0000 | [diff] [blame] | 20 | #include "eval.h" |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 21 | |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 22 | #include "osdefs.h" |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 23 | |
Mark Hammond | 8696ebc | 2002-10-08 02:44:31 +0000 | [diff] [blame] | 24 | #ifdef MS_WINDOWS |
| 25 | #define WIN32_LEAN_AND_MEAN |
| 26 | #include "windows.h" |
| 27 | #endif /* MS_WINDOWS */ |
| 28 | |
Guido van Rossum | 9b38a14 | 1996-09-11 23:12:24 +0000 | [diff] [blame] | 29 | #ifdef MS_COREDLL |
Guido van Rossum | c606fe1 | 1996-04-09 02:37:57 +0000 | [diff] [blame] | 30 | extern void *PyWin_DLLhModule; |
Guido van Rossum | 6c1e5f2 | 1997-09-29 23:34:23 +0000 | [diff] [blame] | 31 | /* A string loaded from the DLL at startup: */ |
| 32 | extern const char *PyWin_DLLVersionString; |
Guido van Rossum | c606fe1 | 1996-04-09 02:37:57 +0000 | [diff] [blame] | 33 | #endif |
| 34 | |
Martin v. Löwis | c16f3bd | 2003-05-03 09:14:54 +0000 | [diff] [blame] | 35 | #ifdef __VMS |
| 36 | #include <unixlib.h> |
| 37 | #endif |
| 38 | |
Martin v. Löwis | 5467d4c | 2003-05-10 07:10:12 +0000 | [diff] [blame] | 39 | #ifdef MS_WINDOWS |
| 40 | #include <windows.h> |
| 41 | #endif |
| 42 | |
| 43 | #ifdef HAVE_LANGINFO_H |
| 44 | #include <locale.h> |
| 45 | #include <langinfo.h> |
| 46 | #endif |
| 47 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 48 | PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 49 | PySys_GetObject(char *name) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 50 | { |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 51 | PyThreadState *tstate = PyThreadState_GET(); |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 52 | PyObject *sd = tstate->interp->sysdict; |
Guido van Rossum | be20336 | 1999-10-05 22:17:41 +0000 | [diff] [blame] | 53 | if (sd == NULL) |
| 54 | return NULL; |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 55 | return PyDict_GetItemString(sd, name); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 56 | } |
| 57 | |
| 58 | FILE * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 59 | PySys_GetFile(char *name, FILE *def) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 60 | { |
| 61 | FILE *fp = NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 62 | PyObject *v = PySys_GetObject(name); |
| 63 | if (v != NULL && PyFile_Check(v)) |
| 64 | fp = PyFile_AsFile(v); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 65 | if (fp == NULL) |
| 66 | fp = def; |
| 67 | return fp; |
| 68 | } |
| 69 | |
| 70 | int |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 71 | PySys_SetObject(char *name, PyObject *v) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 72 | { |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 73 | PyThreadState *tstate = PyThreadState_GET(); |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 74 | PyObject *sd = tstate->interp->sysdict; |
Guido van Rossum | 5ad58c6 | 1992-01-26 18:15:48 +0000 | [diff] [blame] | 75 | if (v == NULL) { |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 76 | if (PyDict_GetItemString(sd, name) == NULL) |
Guido van Rossum | 5ad58c6 | 1992-01-26 18:15:48 +0000 | [diff] [blame] | 77 | return 0; |
| 78 | else |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 79 | return PyDict_DelItemString(sd, name); |
Guido van Rossum | 5ad58c6 | 1992-01-26 18:15:48 +0000 | [diff] [blame] | 80 | } |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 81 | else |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 82 | return PyDict_SetItemString(sd, name, v); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 83 | } |
| 84 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 85 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 86 | sys_displayhook(PyObject *self, PyObject *o) |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 87 | { |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 88 | PyObject *outf; |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 89 | PyInterpreterState *interp = PyThreadState_GET()->interp; |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 90 | PyObject *modules = interp->modules; |
| 91 | PyObject *builtins = PyDict_GetItemString(modules, "__builtin__"); |
| 92 | |
Moshe Zadka | 03897ea | 2001-07-23 13:32:43 +0000 | [diff] [blame] | 93 | if (builtins == NULL) { |
| 94 | PyErr_SetString(PyExc_RuntimeError, "lost __builtin__"); |
| 95 | return NULL; |
| 96 | } |
| 97 | |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 98 | /* Print value except if None */ |
| 99 | /* After printing, also assign to '_' */ |
| 100 | /* Before, set '_' to None to avoid recursion */ |
| 101 | if (o == Py_None) { |
| 102 | Py_INCREF(Py_None); |
| 103 | return Py_None; |
| 104 | } |
| 105 | if (PyObject_SetAttrString(builtins, "_", Py_None) != 0) |
| 106 | return NULL; |
| 107 | if (Py_FlushLine() != 0) |
| 108 | return NULL; |
Greg Stein | ceb9b7c | 2001-01-11 09:27:34 +0000 | [diff] [blame] | 109 | outf = PySys_GetObject("stdout"); |
| 110 | if (outf == NULL) { |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 111 | PyErr_SetString(PyExc_RuntimeError, "lost sys.stdout"); |
| 112 | return NULL; |
| 113 | } |
Greg Stein | ceb9b7c | 2001-01-11 09:27:34 +0000 | [diff] [blame] | 114 | if (PyFile_WriteObject(o, outf, 0) != 0) |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 115 | return NULL; |
Greg Stein | ceb9b7c | 2001-01-11 09:27:34 +0000 | [diff] [blame] | 116 | PyFile_SoftSpace(outf, 1); |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 117 | if (Py_FlushLine() != 0) |
| 118 | return NULL; |
| 119 | if (PyObject_SetAttrString(builtins, "_", o) != 0) |
| 120 | return NULL; |
| 121 | Py_INCREF(Py_None); |
| 122 | return Py_None; |
| 123 | } |
| 124 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 125 | PyDoc_STRVAR(displayhook_doc, |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 126 | "displayhook(object) -> None\n" |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 127 | "\n" |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 128 | "Print an object to sys.stdout and also save it in __builtin__._\n" |
| 129 | ); |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 130 | |
| 131 | static PyObject * |
| 132 | sys_excepthook(PyObject* self, PyObject* args) |
| 133 | { |
| 134 | PyObject *exc, *value, *tb; |
Fred Drake | a768882 | 2001-10-24 20:47:48 +0000 | [diff] [blame] | 135 | if (!PyArg_UnpackTuple(args, "excepthook", 3, 3, &exc, &value, &tb)) |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 136 | return NULL; |
| 137 | PyErr_Display(exc, value, tb); |
| 138 | Py_INCREF(Py_None); |
| 139 | return Py_None; |
| 140 | } |
| 141 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 142 | PyDoc_STRVAR(excepthook_doc, |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 143 | "excepthook(exctype, value, traceback) -> None\n" |
| 144 | "\n" |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 145 | "Handle an exception by displaying it with a traceback on sys.stderr.\n" |
| 146 | ); |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 147 | |
| 148 | static PyObject * |
Guido van Rossum | 46d3dc3 | 2003-03-01 03:20:41 +0000 | [diff] [blame] | 149 | sys_exc_info(PyObject *self, PyObject *noargs) |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 150 | { |
| 151 | PyThreadState *tstate; |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 152 | tstate = PyThreadState_GET(); |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 153 | return Py_BuildValue( |
| 154 | "(OOO)", |
| 155 | tstate->exc_type != NULL ? tstate->exc_type : Py_None, |
| 156 | tstate->exc_value != NULL ? tstate->exc_value : Py_None, |
| 157 | tstate->exc_traceback != NULL ? |
| 158 | tstate->exc_traceback : Py_None); |
| 159 | } |
| 160 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 161 | PyDoc_STRVAR(exc_info_doc, |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 162 | "exc_info() -> (type, value, traceback)\n\ |
| 163 | \n\ |
Guido van Rossum | 46d3dc3 | 2003-03-01 03:20:41 +0000 | [diff] [blame] | 164 | Return information about the most recent exception caught by an except\n\ |
| 165 | clause in the current stack frame or in an older stack frame." |
| 166 | ); |
| 167 | |
| 168 | static PyObject * |
| 169 | sys_exc_clear(PyObject *self, PyObject *noargs) |
| 170 | { |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 171 | PyThreadState *tstate = PyThreadState_GET(); |
Guido van Rossum | 46d3dc3 | 2003-03-01 03:20:41 +0000 | [diff] [blame] | 172 | PyObject *tmp_type, *tmp_value, *tmp_tb; |
| 173 | tmp_type = tstate->exc_type; |
| 174 | tmp_value = tstate->exc_value; |
| 175 | tmp_tb = tstate->exc_traceback; |
| 176 | tstate->exc_type = NULL; |
| 177 | tstate->exc_value = NULL; |
| 178 | tstate->exc_traceback = NULL; |
| 179 | Py_XDECREF(tmp_type); |
| 180 | Py_XDECREF(tmp_value); |
| 181 | Py_XDECREF(tmp_tb); |
| 182 | /* For b/w compatibility */ |
| 183 | PySys_SetObject("exc_type", Py_None); |
| 184 | PySys_SetObject("exc_value", Py_None); |
| 185 | PySys_SetObject("exc_traceback", Py_None); |
| 186 | Py_INCREF(Py_None); |
| 187 | return Py_None; |
| 188 | } |
| 189 | |
| 190 | PyDoc_STRVAR(exc_clear_doc, |
| 191 | "exc_clear() -> None\n\ |
| 192 | \n\ |
| 193 | Clear global information on the current exception. Subsequent calls to\n\ |
| 194 | exc_info() will return (None,None,None) until another exception is raised\n\ |
| 195 | in the current thread or the execution stack returns to a frame where\n\ |
| 196 | another exception is being handled." |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 197 | ); |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 198 | |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 199 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 200 | sys_exit(PyObject *self, PyObject *args) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 201 | { |
Neal Norwitz | 0c766a0 | 2002-03-27 13:03:09 +0000 | [diff] [blame] | 202 | PyObject *exit_code = 0; |
| 203 | if (!PyArg_ParseTuple(args, "|O:exit", &exit_code)) |
| 204 | return NULL; |
Guido van Rossum | 6a468bf | 1991-12-31 13:15:35 +0000 | [diff] [blame] | 205 | /* Raise SystemExit so callers may catch it or clean up. */ |
Neal Norwitz | 0c766a0 | 2002-03-27 13:03:09 +0000 | [diff] [blame] | 206 | PyErr_SetObject(PyExc_SystemExit, exit_code); |
Guido van Rossum | 6a468bf | 1991-12-31 13:15:35 +0000 | [diff] [blame] | 207 | return NULL; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 208 | } |
| 209 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 210 | PyDoc_STRVAR(exit_doc, |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 211 | "exit([status])\n\ |
| 212 | \n\ |
| 213 | Exit the interpreter by raising SystemExit(status).\n\ |
| 214 | If the status is omitted or None, it defaults to zero (i.e., success).\n\ |
Neil Schemenauer | 0f2103f | 2002-03-23 20:46:35 +0000 | [diff] [blame] | 215 | If the status is numeric, it will be used as the system exit status.\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 216 | If it is another kind of object, it will be printed and the system\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 217 | exit status will be one (i.e., failure)." |
| 218 | ); |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 219 | |
Martin v. Löwis | 107b7da | 2001-11-09 20:59:39 +0000 | [diff] [blame] | 220 | #ifdef Py_USING_UNICODE |
| 221 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 222 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 223 | sys_getdefaultencoding(PyObject *self) |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 224 | { |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 225 | return PyString_FromString(PyUnicode_GetDefaultEncoding()); |
| 226 | } |
| 227 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 228 | PyDoc_STRVAR(getdefaultencoding_doc, |
Marc-André Lemburg | 99964b8 | 2000-06-07 09:13:41 +0000 | [diff] [blame] | 229 | "getdefaultencoding() -> string\n\ |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 230 | \n\ |
| 231 | Return the current default string encoding used by the Unicode \n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 232 | implementation." |
| 233 | ); |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 234 | |
| 235 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 236 | sys_setdefaultencoding(PyObject *self, PyObject *args) |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 237 | { |
| 238 | char *encoding; |
Marc-André Lemburg | 99964b8 | 2000-06-07 09:13:41 +0000 | [diff] [blame] | 239 | if (!PyArg_ParseTuple(args, "s:setdefaultencoding", &encoding)) |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 240 | return NULL; |
| 241 | if (PyUnicode_SetDefaultEncoding(encoding)) |
| 242 | return NULL; |
| 243 | Py_INCREF(Py_None); |
| 244 | return Py_None; |
| 245 | } |
| 246 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 247 | PyDoc_STRVAR(setdefaultencoding_doc, |
Marc-André Lemburg | 99964b8 | 2000-06-07 09:13:41 +0000 | [diff] [blame] | 248 | "setdefaultencoding(encoding)\n\ |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 249 | \n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 250 | Set the current default string encoding used by the Unicode implementation." |
| 251 | ); |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 252 | |
Martin v. Löwis | 73d538b | 2003-03-05 15:13:47 +0000 | [diff] [blame] | 253 | static PyObject * |
| 254 | sys_getfilesystemencoding(PyObject *self) |
| 255 | { |
| 256 | if (Py_FileSystemDefaultEncoding) |
| 257 | return PyString_FromString(Py_FileSystemDefaultEncoding); |
| 258 | Py_INCREF(Py_None); |
| 259 | return Py_None; |
| 260 | } |
| 261 | |
| 262 | PyDoc_STRVAR(getfilesystemencoding_doc, |
| 263 | "getfilesystemencoding() -> string\n\ |
| 264 | \n\ |
| 265 | Return the encoding used to convert Unicode filenames in\n\ |
| 266 | operating system filenames." |
| 267 | ); |
| 268 | |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 269 | #endif |
| 270 | |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 271 | /* |
| 272 | * Cached interned string objects used for calling the profile and |
| 273 | * trace functions. Initialized by trace_init(). |
| 274 | */ |
Nicholas Bastin | c69ebe8 | 2004-03-24 21:57:10 +0000 | [diff] [blame] | 275 | static PyObject *whatstrings[7] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL}; |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 276 | |
| 277 | static int |
| 278 | trace_init(void) |
| 279 | { |
Nicholas Bastin | c69ebe8 | 2004-03-24 21:57:10 +0000 | [diff] [blame] | 280 | static char *whatnames[7] = {"call", "exception", "line", "return", |
| 281 | "c_call", "c_exception", "c_return"}; |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 282 | PyObject *name; |
| 283 | int i; |
Nicholas Bastin | c69ebe8 | 2004-03-24 21:57:10 +0000 | [diff] [blame] | 284 | for (i = 0; i < 7; ++i) { |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 285 | if (whatstrings[i] == NULL) { |
| 286 | name = PyString_InternFromString(whatnames[i]); |
| 287 | if (name == NULL) |
| 288 | return -1; |
| 289 | whatstrings[i] = name; |
| 290 | } |
| 291 | } |
| 292 | return 0; |
| 293 | } |
| 294 | |
| 295 | |
| 296 | static PyObject * |
| 297 | call_trampoline(PyThreadState *tstate, PyObject* callback, |
| 298 | PyFrameObject *frame, int what, PyObject *arg) |
| 299 | { |
| 300 | PyObject *args = PyTuple_New(3); |
| 301 | PyObject *whatstr; |
| 302 | PyObject *result; |
| 303 | |
| 304 | if (args == NULL) |
| 305 | return NULL; |
| 306 | Py_INCREF(frame); |
| 307 | whatstr = whatstrings[what]; |
| 308 | Py_INCREF(whatstr); |
| 309 | if (arg == NULL) |
| 310 | arg = Py_None; |
| 311 | Py_INCREF(arg); |
| 312 | PyTuple_SET_ITEM(args, 0, (PyObject *)frame); |
| 313 | PyTuple_SET_ITEM(args, 1, whatstr); |
| 314 | PyTuple_SET_ITEM(args, 2, arg); |
| 315 | |
| 316 | /* call the Python-level function */ |
| 317 | PyFrame_FastToLocals(frame); |
| 318 | result = PyEval_CallObject(callback, args); |
| 319 | PyFrame_LocalsToFast(frame, 1); |
| 320 | if (result == NULL) |
| 321 | PyTraceBack_Here(frame); |
| 322 | |
| 323 | /* cleanup */ |
| 324 | Py_DECREF(args); |
| 325 | return result; |
| 326 | } |
| 327 | |
| 328 | static int |
| 329 | profile_trampoline(PyObject *self, PyFrameObject *frame, |
| 330 | int what, PyObject *arg) |
| 331 | { |
| 332 | PyThreadState *tstate = frame->f_tstate; |
| 333 | PyObject *result; |
| 334 | |
Fred Drake | 8f51f54 | 2001-10-04 14:48:42 +0000 | [diff] [blame] | 335 | if (arg == NULL) |
| 336 | arg = Py_None; |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 337 | result = call_trampoline(tstate, self, frame, what, arg); |
| 338 | if (result == NULL) { |
| 339 | PyEval_SetProfile(NULL, NULL); |
| 340 | return -1; |
| 341 | } |
| 342 | Py_DECREF(result); |
| 343 | return 0; |
| 344 | } |
| 345 | |
| 346 | static int |
| 347 | trace_trampoline(PyObject *self, PyFrameObject *frame, |
| 348 | int what, PyObject *arg) |
| 349 | { |
| 350 | PyThreadState *tstate = frame->f_tstate; |
| 351 | PyObject *callback; |
| 352 | PyObject *result; |
| 353 | |
| 354 | if (what == PyTrace_CALL) |
| 355 | callback = self; |
| 356 | else |
| 357 | callback = frame->f_trace; |
| 358 | if (callback == NULL) |
| 359 | return 0; |
| 360 | result = call_trampoline(tstate, callback, frame, what, arg); |
| 361 | if (result == NULL) { |
| 362 | PyEval_SetTrace(NULL, NULL); |
| 363 | Py_XDECREF(frame->f_trace); |
| 364 | frame->f_trace = NULL; |
| 365 | return -1; |
| 366 | } |
| 367 | if (result != Py_None) { |
| 368 | PyObject *temp = frame->f_trace; |
| 369 | frame->f_trace = NULL; |
| 370 | Py_XDECREF(temp); |
| 371 | frame->f_trace = result; |
| 372 | } |
| 373 | else { |
| 374 | Py_DECREF(result); |
| 375 | } |
| 376 | return 0; |
| 377 | } |
Fred Drake | d083839 | 2001-06-16 21:02:31 +0000 | [diff] [blame] | 378 | |
Fred Drake | 8b4d01d | 2000-05-09 19:57:01 +0000 | [diff] [blame] | 379 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 380 | sys_settrace(PyObject *self, PyObject *args) |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 381 | { |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 382 | if (trace_init() == -1) |
Fred Drake | d083839 | 2001-06-16 21:02:31 +0000 | [diff] [blame] | 383 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 384 | if (args == Py_None) |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 385 | PyEval_SetTrace(NULL, NULL); |
Guido van Rossum | e765f7d | 1992-04-05 14:17:55 +0000 | [diff] [blame] | 386 | else |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 387 | PyEval_SetTrace(trace_trampoline, args); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 388 | Py_INCREF(Py_None); |
| 389 | return Py_None; |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 390 | } |
| 391 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 392 | PyDoc_STRVAR(settrace_doc, |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 393 | "settrace(function)\n\ |
| 394 | \n\ |
| 395 | Set the global debug tracing function. It will be called on each\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 396 | function call. See the debugger chapter in the library manual." |
| 397 | ); |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 398 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 399 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 400 | sys_setprofile(PyObject *self, PyObject *args) |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 401 | { |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 402 | if (trace_init() == -1) |
Fred Drake | d083839 | 2001-06-16 21:02:31 +0000 | [diff] [blame] | 403 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 404 | if (args == Py_None) |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 405 | PyEval_SetProfile(NULL, NULL); |
Guido van Rossum | e765f7d | 1992-04-05 14:17:55 +0000 | [diff] [blame] | 406 | else |
Fred Drake | 5755ce6 | 2001-06-27 19:19:46 +0000 | [diff] [blame] | 407 | PyEval_SetProfile(profile_trampoline, args); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 408 | Py_INCREF(Py_None); |
| 409 | return Py_None; |
Guido van Rossum | e2437a1 | 1992-03-23 18:20:18 +0000 | [diff] [blame] | 410 | } |
| 411 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 412 | PyDoc_STRVAR(setprofile_doc, |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 413 | "setprofile(function)\n\ |
| 414 | \n\ |
| 415 | Set the profiling function. It will be called on each function call\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 416 | and return. See the profiler chapter in the library manual." |
| 417 | ); |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 418 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 419 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 420 | sys_setcheckinterval(PyObject *self, PyObject *args) |
Guido van Rossum | a0d7a23 | 1995-01-09 17:46:13 +0000 | [diff] [blame] | 421 | { |
Skip Montanaro | d581d77 | 2002-09-03 20:10:45 +0000 | [diff] [blame] | 422 | if (!PyArg_ParseTuple(args, "i:setcheckinterval", &_Py_CheckInterval)) |
Guido van Rossum | a0d7a23 | 1995-01-09 17:46:13 +0000 | [diff] [blame] | 423 | return NULL; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 424 | Py_INCREF(Py_None); |
| 425 | return Py_None; |
Guido van Rossum | a0d7a23 | 1995-01-09 17:46:13 +0000 | [diff] [blame] | 426 | } |
| 427 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 428 | PyDoc_STRVAR(setcheckinterval_doc, |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 429 | "setcheckinterval(n)\n\ |
| 430 | \n\ |
| 431 | Tell the Python interpreter to check for asynchronous events every\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 432 | n instructions. This also affects how often thread switches occur." |
| 433 | ); |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 434 | |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 435 | static PyObject * |
Tim Peters | e5e065b | 2003-07-06 18:36:54 +0000 | [diff] [blame] | 436 | sys_getcheckinterval(PyObject *self, PyObject *args) |
| 437 | { |
| 438 | return PyInt_FromLong(_Py_CheckInterval); |
| 439 | } |
| 440 | |
| 441 | PyDoc_STRVAR(getcheckinterval_doc, |
| 442 | "getcheckinterval() -> current check interval; see setcheckinterval()." |
| 443 | ); |
| 444 | |
Martin v. Löwis | f30d60e | 2004-06-08 08:17:44 +0000 | [diff] [blame] | 445 | #ifdef WITH_TSC |
| 446 | static PyObject * |
| 447 | sys_settscdump(PyObject *self, PyObject *args) |
| 448 | { |
| 449 | int bool; |
| 450 | PyThreadState *tstate = PyThreadState_Get(); |
| 451 | |
| 452 | if (!PyArg_ParseTuple(args, "i:settscdump", &bool)) |
| 453 | return NULL; |
| 454 | if (bool) |
| 455 | tstate->interp->tscdump = 1; |
| 456 | else |
| 457 | tstate->interp->tscdump = 0; |
| 458 | Py_INCREF(Py_None); |
| 459 | return Py_None; |
| 460 | |
| 461 | } |
| 462 | |
| 463 | PyDoc_STRVAR(settscdump_doc, |
| 464 | "settscdump(bool)\n\ |
| 465 | \n\ |
| 466 | If true, tell the Python interpreter to dump VM measurements to\n\ |
| 467 | stderr. If false, turn off dump. The measurements are based on the\n\ |
| 468 | Pentium time-stamp counter." |
| 469 | ); |
Neal Norwitz | 0f5aed4 | 2004-06-13 20:32:17 +0000 | [diff] [blame] | 470 | #endif /* TSC */ |
Martin v. Löwis | f30d60e | 2004-06-08 08:17:44 +0000 | [diff] [blame] | 471 | |
Tim Peters | e5e065b | 2003-07-06 18:36:54 +0000 | [diff] [blame] | 472 | static PyObject * |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 473 | sys_setrecursionlimit(PyObject *self, PyObject *args) |
| 474 | { |
| 475 | int new_limit; |
| 476 | if (!PyArg_ParseTuple(args, "i:setrecursionlimit", &new_limit)) |
| 477 | return NULL; |
| 478 | if (new_limit <= 0) { |
| 479 | PyErr_SetString(PyExc_ValueError, |
| 480 | "recursion limit must be positive"); |
| 481 | return NULL; |
| 482 | } |
| 483 | Py_SetRecursionLimit(new_limit); |
| 484 | Py_INCREF(Py_None); |
| 485 | return Py_None; |
| 486 | } |
| 487 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 488 | PyDoc_STRVAR(setrecursionlimit_doc, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 489 | "setrecursionlimit(n)\n\ |
| 490 | \n\ |
| 491 | Set the maximum depth of the Python interpreter stack to n. This\n\ |
| 492 | limit prevents infinite recursion from causing an overflow of the C\n\ |
| 493 | stack and crashing Python. The highest possible limit is platform-\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 494 | dependent." |
| 495 | ); |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 496 | |
| 497 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 498 | sys_getrecursionlimit(PyObject *self) |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 499 | { |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 500 | return PyInt_FromLong(Py_GetRecursionLimit()); |
| 501 | } |
| 502 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 503 | PyDoc_STRVAR(getrecursionlimit_doc, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 504 | "getrecursionlimit()\n\ |
| 505 | \n\ |
| 506 | Return the current value of the recursion limit, the maximum depth\n\ |
| 507 | of the Python interpreter stack. This limit prevents infinite\n\ |
Jack Jansen | e739a0d | 2002-06-26 20:39:20 +0000 | [diff] [blame] | 508 | recursion from causing an overflow of the C stack and crashing Python." |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 509 | ); |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 510 | |
Mark Hammond | 8696ebc | 2002-10-08 02:44:31 +0000 | [diff] [blame] | 511 | #ifdef MS_WINDOWS |
| 512 | PyDoc_STRVAR(getwindowsversion_doc, |
| 513 | "getwindowsversion()\n\ |
| 514 | \n\ |
| 515 | Return information about the running version of Windows.\n\ |
| 516 | The result is a tuple of (major, minor, build, platform, text)\n\ |
| 517 | All elements are numbers, except text which is a string.\n\ |
| 518 | Platform may be 0 for win32s, 1 for Windows 9x/ME, 2 for Windows NT/2000/XP\n\ |
| 519 | " |
| 520 | ); |
| 521 | |
| 522 | static PyObject * |
| 523 | sys_getwindowsversion(PyObject *self) |
| 524 | { |
| 525 | OSVERSIONINFO ver; |
| 526 | ver.dwOSVersionInfoSize = sizeof(ver); |
| 527 | if (!GetVersionEx(&ver)) |
| 528 | return PyErr_SetFromWindowsErr(0); |
| 529 | return Py_BuildValue("HHHHs", |
| 530 | ver.dwMajorVersion, |
| 531 | ver.dwMinorVersion, |
| 532 | ver.dwBuildNumber, |
| 533 | ver.dwPlatformId, |
| 534 | ver.szCSDVersion); |
| 535 | } |
| 536 | |
| 537 | #endif /* MS_WINDOWS */ |
| 538 | |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 539 | #ifdef HAVE_DLOPEN |
| 540 | static PyObject * |
| 541 | sys_setdlopenflags(PyObject *self, PyObject *args) |
| 542 | { |
| 543 | int new_val; |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 544 | PyThreadState *tstate = PyThreadState_GET(); |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 545 | if (!PyArg_ParseTuple(args, "i:setdlopenflags", &new_val)) |
| 546 | return NULL; |
| 547 | if (!tstate) |
| 548 | return NULL; |
| 549 | tstate->interp->dlopenflags = new_val; |
| 550 | Py_INCREF(Py_None); |
| 551 | return Py_None; |
| 552 | } |
| 553 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 554 | PyDoc_STRVAR(setdlopenflags_doc, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 555 | "setdlopenflags(n) -> None\n\ |
| 556 | \n\ |
| 557 | Set the flags that will be used for dlopen() calls. Among other\n\ |
Neal Norwitz | 2a47c0f | 2002-01-29 00:53:41 +0000 | [diff] [blame] | 558 | things, this will enable a lazy resolving of symbols when importing\n\ |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 559 | a module, if called as sys.setdlopenflags(0)\n\ |
Neal Norwitz | 2a47c0f | 2002-01-29 00:53:41 +0000 | [diff] [blame] | 560 | To share symbols across extension modules, call as\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 561 | sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)" |
| 562 | ); |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 563 | |
| 564 | static PyObject * |
| 565 | sys_getdlopenflags(PyObject *self, PyObject *args) |
| 566 | { |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 567 | PyThreadState *tstate = PyThreadState_GET(); |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 568 | if (!tstate) |
| 569 | return NULL; |
| 570 | return PyInt_FromLong(tstate->interp->dlopenflags); |
| 571 | } |
| 572 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 573 | PyDoc_STRVAR(getdlopenflags_doc, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 574 | "getdlopenflags() -> int\n\ |
| 575 | \n\ |
| 576 | Return the current value of the flags that are used for dlopen()\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 577 | calls. The flag constants are defined in the dl module." |
| 578 | ); |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 579 | #endif |
| 580 | |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 581 | #ifdef USE_MALLOPT |
| 582 | /* Link with -lmalloc (or -lmpc) on an SGI */ |
| 583 | #include <malloc.h> |
| 584 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 585 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 586 | sys_mdebug(PyObject *self, PyObject *args) |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 587 | { |
| 588 | int flag; |
Guido van Rossum | ffc0f4f | 2000-03-31 00:38:29 +0000 | [diff] [blame] | 589 | if (!PyArg_ParseTuple(args, "i:mdebug", &flag)) |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 590 | return NULL; |
| 591 | mallopt(M_DEBUG, flag); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 592 | Py_INCREF(Py_None); |
| 593 | return Py_None; |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 594 | } |
| 595 | #endif /* USE_MALLOPT */ |
| 596 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 597 | static PyObject * |
Fred Drake | a768882 | 2001-10-24 20:47:48 +0000 | [diff] [blame] | 598 | sys_getrefcount(PyObject *self, PyObject *arg) |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 599 | { |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 600 | return PyInt_FromLong(arg->ob_refcnt); |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 601 | } |
| 602 | |
Tim Peters | 4be93d0 | 2002-07-07 19:59:50 +0000 | [diff] [blame] | 603 | #ifdef Py_REF_DEBUG |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 604 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 605 | sys_gettotalrefcount(PyObject *self) |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 606 | { |
Mark Hammond | 440d898 | 2000-06-20 08:12:48 +0000 | [diff] [blame] | 607 | return PyInt_FromLong(_Py_RefTotal); |
| 608 | } |
| 609 | |
| 610 | #endif /* Py_TRACE_REFS */ |
| 611 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 612 | PyDoc_STRVAR(getrefcount_doc, |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 613 | "getrefcount(object) -> integer\n\ |
| 614 | \n\ |
Fred Drake | ba3ff1b | 2002-06-20 21:36:19 +0000 | [diff] [blame] | 615 | Return the reference count of object. The count returned is generally\n\ |
| 616 | one higher than you might expect, because it includes the (temporary)\n\ |
| 617 | reference as an argument to getrefcount()." |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 618 | ); |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 619 | |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 620 | #ifdef COUNT_ALLOCS |
| 621 | static PyObject * |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 622 | sys_getcounts(PyObject *self) |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 623 | { |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 624 | extern PyObject *get_counts(void); |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 625 | |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 626 | return get_counts(); |
| 627 | } |
| 628 | #endif |
| 629 | |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 630 | PyDoc_STRVAR(getframe_doc, |
Barry Warsaw | b6a54d2 | 2000-12-06 21:47:46 +0000 | [diff] [blame] | 631 | "_getframe([depth]) -> frameobject\n\ |
| 632 | \n\ |
| 633 | Return a frame object from the call stack. If optional integer depth is\n\ |
| 634 | given, return the frame object that many calls below the top of the stack.\n\ |
| 635 | If that is deeper than the call stack, ValueError is raised. The default\n\ |
| 636 | for depth is zero, returning the frame at the top of the call stack.\n\ |
| 637 | \n\ |
| 638 | This function should be used for internal and specialized\n\ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 639 | purposes only." |
| 640 | ); |
Barry Warsaw | b6a54d2 | 2000-12-06 21:47:46 +0000 | [diff] [blame] | 641 | |
| 642 | static PyObject * |
| 643 | sys_getframe(PyObject *self, PyObject *args) |
| 644 | { |
Nicholas Bastin | e5662ae | 2004-03-24 22:22:12 +0000 | [diff] [blame] | 645 | PyFrameObject *f = PyThreadState_GET()->frame; |
Barry Warsaw | b6a54d2 | 2000-12-06 21:47:46 +0000 | [diff] [blame] | 646 | int depth = -1; |
| 647 | |
| 648 | if (!PyArg_ParseTuple(args, "|i:_getframe", &depth)) |
| 649 | return NULL; |
| 650 | |
| 651 | while (depth > 0 && f != NULL) { |
| 652 | f = f->f_back; |
| 653 | --depth; |
| 654 | } |
| 655 | if (f == NULL) { |
| 656 | PyErr_SetString(PyExc_ValueError, |
| 657 | "call stack is not deep enough"); |
| 658 | return NULL; |
| 659 | } |
| 660 | Py_INCREF(f); |
| 661 | return (PyObject*)f; |
| 662 | } |
| 663 | |
Guido van Rossum | a12fe4e | 2003-04-09 19:06:21 +0000 | [diff] [blame] | 664 | PyDoc_STRVAR(call_tracing_doc, |
| 665 | "call_tracing(func, args) -> object\n\ |
| 666 | \n\ |
| 667 | Call func(*args), while tracing is enabled. The tracing state is\n\ |
| 668 | saved, and restored afterwards. This is intended to be called from\n\ |
| 669 | a debugger from a checkpoint, to recursively debug some other code." |
| 670 | ); |
| 671 | |
| 672 | static PyObject * |
| 673 | sys_call_tracing(PyObject *self, PyObject *args) |
| 674 | { |
| 675 | PyObject *func, *funcargs; |
| 676 | if (!PyArg_ParseTuple(args, "OO:call_tracing", &func, &funcargs)) |
| 677 | return NULL; |
| 678 | return _PyEval_CallTracing(func, funcargs); |
| 679 | } |
| 680 | |
Jeremy Hylton | 985eba5 | 2003-02-05 23:13:00 +0000 | [diff] [blame] | 681 | PyDoc_STRVAR(callstats_doc, |
| 682 | "callstats() -> tuple of integers\n\ |
| 683 | \n\ |
| 684 | Return a tuple of function call statistics, if CALL_PROFILE was defined\n\ |
| 685 | when Python was built. Otherwise, return None.\n\ |
| 686 | \n\ |
| 687 | When enabled, this function returns detailed, implementation-specific\n\ |
| 688 | details about the number of function calls executed. The return value is\n\ |
| 689 | a 11-tuple where the entries in the tuple are counts of:\n\ |
| 690 | 0. all function calls\n\ |
| 691 | 1. calls to PyFunction_Type objects\n\ |
| 692 | 2. PyFunction calls that do not create an argument tuple\n\ |
| 693 | 3. PyFunction calls that do not create an argument tuple\n\ |
| 694 | and bypass PyEval_EvalCodeEx()\n\ |
| 695 | 4. PyMethod calls\n\ |
| 696 | 5. PyMethod calls on bound methods\n\ |
| 697 | 6. PyType calls\n\ |
| 698 | 7. PyCFunction calls\n\ |
| 699 | 8. generator calls\n\ |
| 700 | 9. All other calls\n\ |
| 701 | 10. Number of stack pops performed by call_function()" |
| 702 | ); |
Barry Warsaw | b6a54d2 | 2000-12-06 21:47:46 +0000 | [diff] [blame] | 703 | |
Guido van Rossum | 7f3f2c1 | 1996-05-23 22:45:41 +0000 | [diff] [blame] | 704 | #ifdef Py_TRACE_REFS |
Guido van Rossum | ded690f | 1996-05-24 20:48:31 +0000 | [diff] [blame] | 705 | /* Defined in objects.c because it uses static globals if that file */ |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 706 | extern PyObject *_Py_GetObjects(PyObject *, PyObject *); |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 707 | #endif |
Guido van Rossum | ded690f | 1996-05-24 20:48:31 +0000 | [diff] [blame] | 708 | |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 709 | #ifdef DYNAMIC_EXECUTION_PROFILE |
| 710 | /* Defined in ceval.c because it uses static globals if that file */ |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 711 | extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *); |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 712 | #endif |
| 713 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 714 | static PyMethodDef sys_methods[] = { |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 715 | /* Might as well keep this in alphabetic order */ |
Jeremy Hylton | 985eba5 | 2003-02-05 23:13:00 +0000 | [diff] [blame] | 716 | {"callstats", (PyCFunction)PyEval_GetCallStats, METH_NOARGS, |
| 717 | callstats_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 718 | {"displayhook", sys_displayhook, METH_O, displayhook_doc}, |
Guido van Rossum | 46d3dc3 | 2003-03-01 03:20:41 +0000 | [diff] [blame] | 719 | {"exc_info", sys_exc_info, METH_NOARGS, exc_info_doc}, |
| 720 | {"exc_clear", sys_exc_clear, METH_NOARGS, exc_clear_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 721 | {"excepthook", sys_excepthook, METH_VARARGS, excepthook_doc}, |
Neal Norwitz | 0c766a0 | 2002-03-27 13:03:09 +0000 | [diff] [blame] | 722 | {"exit", sys_exit, METH_VARARGS, exit_doc}, |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 723 | #ifdef Py_USING_UNICODE |
Jeremy Hylton | 985eba5 | 2003-02-05 23:13:00 +0000 | [diff] [blame] | 724 | {"getdefaultencoding", (PyCFunction)sys_getdefaultencoding, |
| 725 | METH_NOARGS, getdefaultencoding_doc}, |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 726 | #endif |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 727 | #ifdef HAVE_DLOPEN |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 728 | {"getdlopenflags", (PyCFunction)sys_getdlopenflags, METH_NOARGS, |
| 729 | getdlopenflags_doc}, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 730 | #endif |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 731 | #ifdef COUNT_ALLOCS |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 732 | {"getcounts", (PyCFunction)sys_getcounts, METH_NOARGS}, |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 733 | #endif |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 734 | #ifdef DYNAMIC_EXECUTION_PROFILE |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 735 | {"getdxp", _Py_GetDXProfile, METH_VARARGS}, |
Guido van Rossum | 43f1b8d | 1997-01-24 04:07:45 +0000 | [diff] [blame] | 736 | #endif |
Martin v. Löwis | 73d538b | 2003-03-05 15:13:47 +0000 | [diff] [blame] | 737 | #ifdef Py_USING_UNICODE |
| 738 | {"getfilesystemencoding", (PyCFunction)sys_getfilesystemencoding, |
| 739 | METH_NOARGS, getfilesystemencoding_doc}, |
| 740 | #endif |
Guido van Rossum | 7f3f2c1 | 1996-05-23 22:45:41 +0000 | [diff] [blame] | 741 | #ifdef Py_TRACE_REFS |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 742 | {"getobjects", _Py_GetObjects, METH_VARARGS}, |
Tim Peters | 4be93d0 | 2002-07-07 19:59:50 +0000 | [diff] [blame] | 743 | #endif |
| 744 | #ifdef Py_REF_DEBUG |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 745 | {"gettotalrefcount", (PyCFunction)sys_gettotalrefcount, METH_NOARGS}, |
Sjoerd Mullender | 6ec3c65 | 1995-08-29 09:18:14 +0000 | [diff] [blame] | 746 | #endif |
Fred Drake | a768882 | 2001-10-24 20:47:48 +0000 | [diff] [blame] | 747 | {"getrefcount", (PyCFunction)sys_getrefcount, METH_O, getrefcount_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 748 | {"getrecursionlimit", (PyCFunction)sys_getrecursionlimit, METH_NOARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 749 | getrecursionlimit_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 750 | {"_getframe", sys_getframe, METH_VARARGS, getframe_doc}, |
Mark Hammond | 8696ebc | 2002-10-08 02:44:31 +0000 | [diff] [blame] | 751 | #ifdef MS_WINDOWS |
| 752 | {"getwindowsversion", (PyCFunction)sys_getwindowsversion, METH_NOARGS, |
| 753 | getwindowsversion_doc}, |
| 754 | #endif /* MS_WINDOWS */ |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 755 | #ifdef USE_MALLOPT |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 756 | {"mdebug", sys_mdebug, METH_VARARGS}, |
Guido van Rossum | 14b4adb | 1992-09-03 20:25:30 +0000 | [diff] [blame] | 757 | #endif |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 758 | #ifdef Py_USING_UNICODE |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 759 | {"setdefaultencoding", sys_setdefaultencoding, METH_VARARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 760 | setdefaultencoding_doc}, |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 761 | #endif |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 762 | {"setcheckinterval", sys_setcheckinterval, METH_VARARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 763 | setcheckinterval_doc}, |
Tim Peters | e5e065b | 2003-07-06 18:36:54 +0000 | [diff] [blame] | 764 | {"getcheckinterval", sys_getcheckinterval, METH_NOARGS, |
| 765 | getcheckinterval_doc}, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 766 | #ifdef HAVE_DLOPEN |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 767 | {"setdlopenflags", sys_setdlopenflags, METH_VARARGS, |
| 768 | setdlopenflags_doc}, |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 769 | #endif |
Neal Norwitz | 290d31e | 2002-03-03 15:12:58 +0000 | [diff] [blame] | 770 | {"setprofile", sys_setprofile, METH_O, setprofile_doc}, |
Martin v. Löwis | e3eb1f2 | 2001-08-16 13:15:00 +0000 | [diff] [blame] | 771 | {"setrecursionlimit", sys_setrecursionlimit, METH_VARARGS, |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 772 | setrecursionlimit_doc}, |
Martin v. Löwis | f30d60e | 2004-06-08 08:17:44 +0000 | [diff] [blame] | 773 | #ifdef WITH_TSC |
| 774 | {"settscdump", sys_settscdump, METH_VARARGS, settscdump_doc}, |
| 775 | #endif |
Neal Norwitz | 290d31e | 2002-03-03 15:12:58 +0000 | [diff] [blame] | 776 | {"settrace", sys_settrace, METH_O, settrace_doc}, |
Guido van Rossum | a12fe4e | 2003-04-09 19:06:21 +0000 | [diff] [blame] | 777 | {"call_tracing", sys_call_tracing, METH_VARARGS, call_tracing_doc}, |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 778 | {NULL, NULL} /* sentinel */ |
| 779 | }; |
| 780 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 781 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 782 | list_builtin_module_names(void) |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 783 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 784 | PyObject *list = PyList_New(0); |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 785 | int i; |
| 786 | if (list == NULL) |
| 787 | return NULL; |
Guido van Rossum | 25c649f | 1997-11-04 17:04:34 +0000 | [diff] [blame] | 788 | for (i = 0; PyImport_Inittab[i].name != NULL; i++) { |
Guido van Rossum | a027efa | 1997-05-05 20:56:21 +0000 | [diff] [blame] | 789 | PyObject *name = PyString_FromString( |
Guido van Rossum | 25c649f | 1997-11-04 17:04:34 +0000 | [diff] [blame] | 790 | PyImport_Inittab[i].name); |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 791 | if (name == NULL) |
| 792 | break; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 793 | PyList_Append(list, name); |
| 794 | Py_DECREF(name); |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 795 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 796 | if (PyList_Sort(list) != 0) { |
| 797 | Py_DECREF(list); |
Guido van Rossum | 1d5735e | 1994-08-30 08:27:36 +0000 | [diff] [blame] | 798 | list = NULL; |
| 799 | } |
Guido van Rossum | 8f49e12 | 1997-01-06 22:55:54 +0000 | [diff] [blame] | 800 | if (list) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 801 | PyObject *v = PyList_AsTuple(list); |
| 802 | Py_DECREF(list); |
Guido van Rossum | 8f49e12 | 1997-01-06 22:55:54 +0000 | [diff] [blame] | 803 | list = v; |
| 804 | } |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 805 | return list; |
| 806 | } |
| 807 | |
Guido van Rossum | 23fff91 | 2000-12-15 22:02:05 +0000 | [diff] [blame] | 808 | static PyObject *warnoptions = NULL; |
| 809 | |
| 810 | void |
| 811 | PySys_ResetWarnOptions(void) |
| 812 | { |
| 813 | if (warnoptions == NULL || !PyList_Check(warnoptions)) |
| 814 | return; |
| 815 | PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL); |
| 816 | } |
| 817 | |
| 818 | void |
| 819 | PySys_AddWarnOption(char *s) |
| 820 | { |
| 821 | PyObject *str; |
| 822 | |
| 823 | if (warnoptions == NULL || !PyList_Check(warnoptions)) { |
| 824 | Py_XDECREF(warnoptions); |
| 825 | warnoptions = PyList_New(0); |
| 826 | if (warnoptions == NULL) |
| 827 | return; |
| 828 | } |
| 829 | str = PyString_FromString(s); |
| 830 | if (str != NULL) { |
| 831 | PyList_Append(warnoptions, str); |
| 832 | Py_DECREF(str); |
| 833 | } |
| 834 | } |
| 835 | |
Guido van Rossum | 40552d0 | 1998-08-06 03:34:39 +0000 | [diff] [blame] | 836 | /* XXX This doc string is too long to be a single string literal in VC++ 5.0. |
| 837 | Two literals concatenated works just fine. If you have a K&R compiler |
| 838 | or other abomination that however *does* understand longer strings, |
| 839 | get rid of the !!! comment in the middle and the quotes that surround it. */ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 840 | PyDoc_VAR(sys_doc) = |
| 841 | PyDoc_STR( |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 842 | "This module provides access to some objects used or maintained by the\n\ |
| 843 | interpreter and to functions that interact strongly with the interpreter.\n\ |
| 844 | \n\ |
| 845 | Dynamic objects:\n\ |
| 846 | \n\ |
| 847 | argv -- command line arguments; argv[0] is the script pathname if known\n\ |
| 848 | path -- module search path; path[0] is the script directory, else ''\n\ |
| 849 | modules -- dictionary of loaded modules\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 850 | \n\ |
| 851 | displayhook -- called to show results in an interactive session\n\ |
| 852 | excepthook -- called to handle any uncaught exception other than SystemExit\n\ |
| 853 | To customize printing in an interactive session or to install a custom\n\ |
| 854 | top-level exception handler, assign other functions to replace these.\n\ |
| 855 | \n\ |
| 856 | exitfunc -- if sys.exitfunc exists, this routine is called when Python exits\n\ |
| 857 | 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] | 858 | \n\ |
| 859 | stdin -- standard input file object; used by raw_input() and input()\n\ |
| 860 | stdout -- standard output file object; used by the print statement\n\ |
| 861 | stderr -- standard error object; used for error messages\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 862 | By assigning other file objects (or objects that behave like files)\n\ |
| 863 | 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] | 864 | \n\ |
| 865 | last_type -- type of last uncaught exception\n\ |
| 866 | last_value -- value of last uncaught exception\n\ |
| 867 | last_traceback -- traceback of last uncaught exception\n\ |
| 868 | These three are only available in an interactive session after a\n\ |
| 869 | traceback has been printed.\n\ |
| 870 | \n\ |
| 871 | exc_type -- type of exception currently being handled\n\ |
| 872 | exc_value -- value of exception currently being handled\n\ |
| 873 | exc_traceback -- traceback of exception currently being handled\n\ |
| 874 | The function exc_info() should be used instead of these three,\n\ |
| 875 | because it is thread-safe.\n\ |
Guido van Rossum | a71b5f4 | 1999-01-14 19:07:00 +0000 | [diff] [blame] | 876 | " |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 877 | ) |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 878 | /* concatenating string here */ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 879 | PyDoc_STR( |
Guido van Rossum | a71b5f4 | 1999-01-14 19:07:00 +0000 | [diff] [blame] | 880 | "\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 881 | Static objects:\n\ |
| 882 | \n\ |
| 883 | 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] | 884 | maxunicode -- the largest supported character\n\ |
Neal Norwitz | 2a47c0f | 2002-01-29 00:53:41 +0000 | [diff] [blame] | 885 | builtin_module_names -- tuple of module names built into this interpreter\n\ |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 886 | version -- the version of this interpreter as a string\n\ |
| 887 | version_info -- version information as a tuple\n\ |
| 888 | hexversion -- version information encoded as a single integer\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 889 | copyright -- copyright notice pertaining to this interpreter\n\ |
| 890 | platform -- platform identifier\n\ |
| 891 | executable -- pathname of this Python interpreter\n\ |
| 892 | prefix -- prefix used to find the Python library\n\ |
| 893 | 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] | 894 | " |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 895 | ) |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 896 | #ifdef MS_WINDOWS |
| 897 | /* concatenating string here */ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 898 | PyDoc_STR( |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 899 | "dllhandle -- [Windows only] integer handle of the Python DLL\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 900 | winver -- [Windows only] version number of the Python DLL\n\ |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 901 | " |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 902 | ) |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 903 | #endif /* MS_WINDOWS */ |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 904 | PyDoc_STR( |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 905 | "__stdin__ -- the original stdin; don't touch!\n\ |
| 906 | __stdout__ -- the original stdout; don't touch!\n\ |
| 907 | __stderr__ -- the original stderr; don't touch!\n\ |
| 908 | __displayhook__ -- the original displayhook; don't touch!\n\ |
| 909 | __excepthook__ -- the original excepthook; don't touch!\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 910 | \n\ |
| 911 | Functions:\n\ |
| 912 | \n\ |
Moshe Zadka | f68f2fe | 2001-01-11 05:41:27 +0000 | [diff] [blame] | 913 | 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] | 914 | excepthook() -- print an exception and its traceback to sys.stderr\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 915 | exc_info() -- return thread-safe information about the current exception\n\ |
Guido van Rossum | 46d3dc3 | 2003-03-01 03:20:41 +0000 | [diff] [blame] | 916 | exc_clear() -- clear the exception state for the current thread\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 917 | exit() -- exit the interpreter by raising SystemExit\n\ |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 918 | getdlopenflags() -- returns flags to be used for dlopen() calls\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 919 | getrefcount() -- return the reference count for an object (plus one :-)\n\ |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 920 | getrecursionlimit() -- return the max recursion depth for the interpreter\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 921 | setcheckinterval() -- control how often the interpreter checks for events\n\ |
Martin v. Löwis | f0473d5 | 2001-07-18 16:17:16 +0000 | [diff] [blame] | 922 | setdlopenflags() -- set the flags to be used for dlopen() calls\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 923 | setprofile() -- set the global profiling function\n\ |
Jeremy Hylton | ee5adfb | 2000-08-31 19:23:01 +0000 | [diff] [blame] | 924 | setrecursionlimit() -- set the max recursion depth for the interpreter\n\ |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 925 | settrace() -- set the global debug tracing function\n\ |
Fred Drake | ccede59 | 2000-08-14 20:59:57 +0000 | [diff] [blame] | 926 | " |
Martin v. Löwis | a3fb4f7 | 2002-06-09 13:33:54 +0000 | [diff] [blame] | 927 | ) |
Fred Drake | ccede59 | 2000-08-14 20:59:57 +0000 | [diff] [blame] | 928 | /* end of sys_doc */ ; |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 929 | |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 930 | PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 931 | _PySys_Init(void) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 932 | { |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 933 | PyObject *m, *v, *sysdict; |
| 934 | PyObject *sysin, *sysout, *syserr; |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 935 | char *s; |
Martin v. Löwis | 5467d4c | 2003-05-10 07:10:12 +0000 | [diff] [blame] | 936 | #ifdef MS_WINDOWS |
| 937 | char buf[10]; |
| 938 | #endif |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 939 | |
Guido van Rossum | c3bc31e | 1998-06-27 19:43:25 +0000 | [diff] [blame] | 940 | m = Py_InitModule3("sys", sys_methods, sys_doc); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 941 | sysdict = PyModule_GetDict(m); |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 942 | |
| 943 | sysin = PyFile_FromFile(stdin, "<stdin>", "r", NULL); |
| 944 | sysout = PyFile_FromFile(stdout, "<stdout>", "w", NULL); |
| 945 | syserr = PyFile_FromFile(stderr, "<stderr>", "w", NULL); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 946 | if (PyErr_Occurred()) |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 947 | return NULL; |
Martin v. Löwis | 5467d4c | 2003-05-10 07:10:12 +0000 | [diff] [blame] | 948 | #ifdef MS_WINDOWS |
| 949 | if(isatty(_fileno(stdin))){ |
| 950 | sprintf(buf, "cp%d", GetConsoleCP()); |
| 951 | if (!PyFile_SetEncoding(sysin, buf)) |
| 952 | return NULL; |
| 953 | } |
| 954 | if(isatty(_fileno(stdout))) { |
| 955 | sprintf(buf, "cp%d", GetConsoleOutputCP()); |
| 956 | if (!PyFile_SetEncoding(sysout, buf)) |
| 957 | return NULL; |
| 958 | } |
| 959 | #endif |
| 960 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 961 | PyDict_SetItemString(sysdict, "stdin", sysin); |
| 962 | PyDict_SetItemString(sysdict, "stdout", sysout); |
| 963 | PyDict_SetItemString(sysdict, "stderr", syserr); |
Guido van Rossum | bd36dba | 1998-02-19 20:53:06 +0000 | [diff] [blame] | 964 | /* Make backup copies for cleanup */ |
| 965 | PyDict_SetItemString(sysdict, "__stdin__", sysin); |
| 966 | PyDict_SetItemString(sysdict, "__stdout__", sysout); |
| 967 | PyDict_SetItemString(sysdict, "__stderr__", syserr); |
Ka-Ping Yee | b5c5132 | 2001-03-23 02:46:52 +0000 | [diff] [blame] | 968 | PyDict_SetItemString(sysdict, "__displayhook__", |
| 969 | PyDict_GetItemString(sysdict, "displayhook")); |
| 970 | PyDict_SetItemString(sysdict, "__excepthook__", |
| 971 | PyDict_GetItemString(sysdict, "excepthook")); |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 972 | Py_XDECREF(sysin); |
| 973 | Py_XDECREF(sysout); |
| 974 | Py_XDECREF(syserr); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 975 | PyDict_SetItemString(sysdict, "version", |
| 976 | v = PyString_FromString(Py_GetVersion())); |
Barry Warsaw | 54892c4 | 1999-01-27 16:33:19 +0000 | [diff] [blame] | 977 | Py_XDECREF(v); |
Guido van Rossum | e0d7dae | 1999-01-03 12:55:39 +0000 | [diff] [blame] | 978 | PyDict_SetItemString(sysdict, "hexversion", |
| 979 | v = PyInt_FromLong(PY_VERSION_HEX)); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 980 | Py_XDECREF(v); |
Fred Drake | 93a20bf | 2000-04-13 17:44:51 +0000 | [diff] [blame] | 981 | /* |
| 982 | * These release level checks are mutually exclusive and cover |
| 983 | * the field, so don't get too fancy with the pre-processor! |
| 984 | */ |
| 985 | #if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 986 | s = "alpha"; |
Fred Drake | 592f2d6 | 2000-08-31 15:21:11 +0000 | [diff] [blame] | 987 | #elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 988 | s = "beta"; |
Fred Drake | 592f2d6 | 2000-08-31 15:21:11 +0000 | [diff] [blame] | 989 | #elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 990 | s = "candidate"; |
Fred Drake | 592f2d6 | 2000-08-31 15:21:11 +0000 | [diff] [blame] | 991 | #elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 992 | s = "final"; |
Fred Drake | 93a20bf | 2000-04-13 17:44:51 +0000 | [diff] [blame] | 993 | #endif |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 994 | PyDict_SetItemString(sysdict, "version_info", |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 995 | v = Py_BuildValue("iiisi", PY_MAJOR_VERSION, |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 996 | PY_MINOR_VERSION, |
Fred Drake | 6d27c1e | 2000-04-13 20:03:20 +0000 | [diff] [blame] | 997 | PY_MICRO_VERSION, s, |
Fred Drake | 93a20bf | 2000-04-13 17:44:51 +0000 | [diff] [blame] | 998 | PY_RELEASE_SERIAL)); |
Fred Drake | 801c08d | 2000-04-13 15:29:10 +0000 | [diff] [blame] | 999 | Py_XDECREF(v); |
Skip Montanaro | 8e790e7 | 2002-09-03 13:25:17 +0000 | [diff] [blame] | 1000 | PyDict_SetItemString(sysdict, "api_version", |
| 1001 | v = PyInt_FromLong(PYTHON_API_VERSION)); |
| 1002 | Py_XDECREF(v); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1003 | PyDict_SetItemString(sysdict, "copyright", |
| 1004 | v = PyString_FromString(Py_GetCopyright())); |
| 1005 | Py_XDECREF(v); |
| 1006 | PyDict_SetItemString(sysdict, "platform", |
| 1007 | v = PyString_FromString(Py_GetPlatform())); |
| 1008 | Py_XDECREF(v); |
Guido van Rossum | b2c8ec4 | 1997-05-22 20:41:20 +0000 | [diff] [blame] | 1009 | PyDict_SetItemString(sysdict, "executable", |
| 1010 | v = PyString_FromString(Py_GetProgramFullPath())); |
| 1011 | Py_XDECREF(v); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1012 | PyDict_SetItemString(sysdict, "prefix", |
| 1013 | v = PyString_FromString(Py_GetPrefix())); |
| 1014 | Py_XDECREF(v); |
| 1015 | PyDict_SetItemString(sysdict, "exec_prefix", |
| 1016 | v = PyString_FromString(Py_GetExecPrefix())); |
| 1017 | Py_XDECREF(v); |
| 1018 | PyDict_SetItemString(sysdict, "maxint", |
| 1019 | v = PyInt_FromLong(PyInt_GetMax())); |
| 1020 | Py_XDECREF(v); |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 1021 | #ifdef Py_USING_UNICODE |
Martin v. Löwis | ce9b5a5 | 2001-06-27 06:28:56 +0000 | [diff] [blame] | 1022 | PyDict_SetItemString(sysdict, "maxunicode", |
| 1023 | v = PyInt_FromLong(PyUnicode_GetMax())); |
| 1024 | Py_XDECREF(v); |
Martin v. Löwis | 339d0f7 | 2001-08-17 18:39:25 +0000 | [diff] [blame] | 1025 | #endif |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1026 | PyDict_SetItemString(sysdict, "builtin_module_names", |
Guido van Rossum | 1ae940a | 1995-01-02 19:04:15 +0000 | [diff] [blame] | 1027 | v = list_builtin_module_names()); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1028 | Py_XDECREF(v); |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 1029 | { |
| 1030 | /* Assumes that longs are at least 2 bytes long. |
| 1031 | Should be safe! */ |
| 1032 | unsigned long number = 1; |
Fred Drake | a2b6ad6 | 2000-08-15 04:24:43 +0000 | [diff] [blame] | 1033 | char *value; |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 1034 | |
| 1035 | s = (char *) &number; |
| 1036 | if (s[0] == 0) |
Fred Drake | a2b6ad6 | 2000-08-15 04:24:43 +0000 | [diff] [blame] | 1037 | value = "big"; |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 1038 | else |
Fred Drake | a2b6ad6 | 2000-08-15 04:24:43 +0000 | [diff] [blame] | 1039 | value = "little"; |
| 1040 | PyDict_SetItemString(sysdict, "byteorder", |
Barry Warsaw | f2581c9 | 2000-08-16 23:03:57 +0000 | [diff] [blame] | 1041 | v = PyString_FromString(value)); |
| 1042 | Py_XDECREF(v); |
Fred Drake | 099325e | 2000-08-14 15:47:03 +0000 | [diff] [blame] | 1043 | } |
Guido van Rossum | 8b9ea87 | 1996-08-23 18:14:47 +0000 | [diff] [blame] | 1044 | #ifdef MS_COREDLL |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1045 | PyDict_SetItemString(sysdict, "dllhandle", |
Guido van Rossum | 582acec | 2000-06-28 22:07:35 +0000 | [diff] [blame] | 1046 | v = PyLong_FromVoidPtr(PyWin_DLLhModule)); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1047 | Py_XDECREF(v); |
| 1048 | PyDict_SetItemString(sysdict, "winver", |
Guido van Rossum | 6c1e5f2 | 1997-09-29 23:34:23 +0000 | [diff] [blame] | 1049 | v = PyString_FromString(PyWin_DLLVersionString)); |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1050 | Py_XDECREF(v); |
Guido van Rossum | c606fe1 | 1996-04-09 02:37:57 +0000 | [diff] [blame] | 1051 | #endif |
Guido van Rossum | 23fff91 | 2000-12-15 22:02:05 +0000 | [diff] [blame] | 1052 | if (warnoptions == NULL) { |
| 1053 | warnoptions = PyList_New(0); |
| 1054 | } |
| 1055 | else { |
| 1056 | Py_INCREF(warnoptions); |
| 1057 | } |
| 1058 | if (warnoptions != NULL) { |
Guido van Rossum | 03df3b3 | 2001-01-13 22:06:05 +0000 | [diff] [blame] | 1059 | PyDict_SetItemString(sysdict, "warnoptions", warnoptions); |
Guido van Rossum | 23fff91 | 2000-12-15 22:02:05 +0000 | [diff] [blame] | 1060 | } |
| 1061 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1062 | if (PyErr_Occurred()) |
Guido van Rossum | 25ce566 | 1997-08-02 03:10:38 +0000 | [diff] [blame] | 1063 | return NULL; |
| 1064 | return m; |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1065 | } |
| 1066 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1067 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 1068 | makepathobject(char *path, int delim) |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1069 | { |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1070 | int i, n; |
| 1071 | char *p; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1072 | PyObject *v, *w; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1073 | |
| 1074 | n = 1; |
| 1075 | p = path; |
| 1076 | while ((p = strchr(p, delim)) != NULL) { |
| 1077 | n++; |
| 1078 | p++; |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1079 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1080 | v = PyList_New(n); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1081 | if (v == NULL) |
| 1082 | return NULL; |
| 1083 | for (i = 0; ; i++) { |
| 1084 | p = strchr(path, delim); |
| 1085 | if (p == NULL) |
| 1086 | p = strchr(path, '\0'); /* End of string */ |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1087 | w = PyString_FromStringAndSize(path, (int) (p - path)); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1088 | if (w == NULL) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1089 | Py_DECREF(v); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1090 | return NULL; |
| 1091 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1092 | PyList_SetItem(v, i, w); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1093 | if (*p == '\0') |
| 1094 | break; |
| 1095 | path = p+1; |
| 1096 | } |
| 1097 | return v; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 1098 | } |
| 1099 | |
| 1100 | void |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 1101 | PySys_SetPath(char *path) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 1102 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1103 | PyObject *v; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1104 | if ((v = makepathobject(path, DELIM)) == NULL) |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1105 | Py_FatalError("can't create sys.path"); |
| 1106 | if (PySys_SetObject("path", v) != 0) |
| 1107 | Py_FatalError("can't assign sys.path"); |
| 1108 | Py_DECREF(v); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1109 | } |
| 1110 | |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1111 | static PyObject * |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 1112 | makeargvobject(int argc, char **argv) |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1113 | { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1114 | PyObject *av; |
Guido van Rossum | ee3a299 | 1992-01-14 18:42:53 +0000 | [diff] [blame] | 1115 | if (argc <= 0 || argv == NULL) { |
| 1116 | /* Ensure at least one (empty) argument is seen */ |
| 1117 | static char *empty_argv[1] = {""}; |
| 1118 | argv = empty_argv; |
| 1119 | argc = 1; |
| 1120 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1121 | av = PyList_New(argc); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1122 | if (av != NULL) { |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1123 | int i; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1124 | for (i = 0; i < argc; i++) { |
Martin v. Löwis | c16f3bd | 2003-05-03 09:14:54 +0000 | [diff] [blame] | 1125 | #ifdef __VMS |
| 1126 | PyObject *v; |
| 1127 | |
| 1128 | /* argv[0] is the script pathname if known */ |
| 1129 | if (i == 0) { |
| 1130 | char* fn = decc$translate_vms(argv[0]); |
| 1131 | if ((fn == (char *)0) || fn == (char *)-1) |
| 1132 | v = PyString_FromString(argv[0]); |
| 1133 | else |
| 1134 | v = PyString_FromString( |
| 1135 | decc$translate_vms(argv[0])); |
| 1136 | } else |
| 1137 | v = PyString_FromString(argv[i]); |
| 1138 | #else |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1139 | PyObject *v = PyString_FromString(argv[i]); |
Martin v. Löwis | c16f3bd | 2003-05-03 09:14:54 +0000 | [diff] [blame] | 1140 | #endif |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1141 | if (v == NULL) { |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1142 | Py_DECREF(av); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1143 | av = NULL; |
| 1144 | break; |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1145 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1146 | PyList_SetItem(av, i, v); |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1147 | } |
Guido van Rossum | 5b3138b | 1990-11-18 17:41:40 +0000 | [diff] [blame] | 1148 | } |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1149 | return av; |
| 1150 | } |
| 1151 | |
| 1152 | void |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 1153 | PySys_SetArgv(int argc, char **argv) |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1154 | { |
Guido van Rossum | 162e38c | 2003-02-19 15:25:10 +0000 | [diff] [blame] | 1155 | #if defined(HAVE_REALPATH) |
| 1156 | char fullpath[MAXPATHLEN]; |
| 1157 | #elif defined(MS_WINDOWS) |
Thomas Heller | 27bb71e | 2003-01-08 14:33:48 +0000 | [diff] [blame] | 1158 | char fullpath[MAX_PATH]; |
| 1159 | #endif |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1160 | PyObject *av = makeargvobject(argc, argv); |
| 1161 | PyObject *path = PySys_GetObject("path"); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 1162 | if (av == NULL) |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1163 | Py_FatalError("no mem for sys.argv"); |
| 1164 | if (PySys_SetObject("argv", av) != 0) |
| 1165 | Py_FatalError("can't assign sys.argv"); |
Guido van Rossum | 94a9667 | 1996-07-30 20:35:50 +0000 | [diff] [blame] | 1166 | if (path != NULL) { |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1167 | char *argv0 = argv[0]; |
Guido van Rossum | 94a9667 | 1996-07-30 20:35:50 +0000 | [diff] [blame] | 1168 | char *p = NULL; |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1169 | int n = 0; |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1170 | PyObject *a; |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1171 | #ifdef HAVE_READLINK |
| 1172 | char link[MAXPATHLEN+1]; |
| 1173 | char argv0copy[2*MAXPATHLEN+1]; |
| 1174 | int nr = 0; |
| 1175 | if (argc > 0 && argv0 != NULL) |
| 1176 | nr = readlink(argv0, link, MAXPATHLEN); |
| 1177 | if (nr > 0) { |
| 1178 | /* It's a symlink */ |
| 1179 | link[nr] = '\0'; |
| 1180 | if (link[0] == SEP) |
| 1181 | argv0 = link; /* Link to absolute path */ |
| 1182 | else if (strchr(link, SEP) == NULL) |
| 1183 | ; /* Link without path */ |
| 1184 | else { |
| 1185 | /* Must join(dirname(argv0), link) */ |
| 1186 | char *q = strrchr(argv0, SEP); |
| 1187 | if (q == NULL) |
| 1188 | argv0 = link; /* argv0 without path */ |
| 1189 | else { |
| 1190 | /* Must make a copy */ |
| 1191 | strcpy(argv0copy, argv0); |
| 1192 | q = strrchr(argv0copy, SEP); |
| 1193 | strcpy(q+1, link); |
| 1194 | argv0 = argv0copy; |
| 1195 | } |
| 1196 | } |
| 1197 | } |
| 1198 | #endif /* HAVE_READLINK */ |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1199 | #if SEP == '\\' /* Special case for MS filename syntax */ |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1200 | if (argc > 0 && argv0 != NULL) { |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1201 | char *q; |
Thomas Heller | 27bb71e | 2003-01-08 14:33:48 +0000 | [diff] [blame] | 1202 | #ifdef MS_WINDOWS |
| 1203 | char *ptemp; |
| 1204 | if (GetFullPathName(argv0, |
| 1205 | sizeof(fullpath), |
| 1206 | fullpath, |
| 1207 | &ptemp)) { |
| 1208 | argv0 = fullpath; |
| 1209 | } |
| 1210 | #endif |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1211 | p = strrchr(argv0, SEP); |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1212 | /* Test for alternate separator */ |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1213 | q = strrchr(p ? p : argv0, '/'); |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1214 | if (q != NULL) |
| 1215 | p = q; |
| 1216 | if (p != NULL) { |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1217 | n = p + 1 - argv0; |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1218 | if (n > 1 && p[-1] != ':') |
| 1219 | n--; /* Drop trailing separator */ |
| 1220 | } |
| 1221 | } |
| 1222 | #else /* All other filename syntaxes */ |
Guido van Rossum | 162e38c | 2003-02-19 15:25:10 +0000 | [diff] [blame] | 1223 | if (argc > 0 && argv0 != NULL) { |
| 1224 | #if defined(HAVE_REALPATH) |
| 1225 | if (realpath(argv0, fullpath)) { |
| 1226 | argv0 = fullpath; |
| 1227 | } |
| 1228 | #endif |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1229 | p = strrchr(argv0, SEP); |
Guido van Rossum | 162e38c | 2003-02-19 15:25:10 +0000 | [diff] [blame] | 1230 | } |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1231 | if (p != NULL) { |
Guido van Rossum | bceccf5 | 2001-04-10 22:07:43 +0000 | [diff] [blame] | 1232 | #ifndef RISCOS |
Guido van Rossum | c474dea | 1997-04-25 15:38:31 +0000 | [diff] [blame] | 1233 | n = p + 1 - argv0; |
Guido van Rossum | bceccf5 | 2001-04-10 22:07:43 +0000 | [diff] [blame] | 1234 | #else /* don't include trailing separator */ |
| 1235 | n = p - argv0; |
| 1236 | #endif /* RISCOS */ |
Guido van Rossum | cc88341 | 1996-09-10 14:44:21 +0000 | [diff] [blame] | 1237 | #if SEP == '/' /* Special case for Unix filename syntax */ |
| 1238 | if (n > 1) |
| 1239 | n--; /* Drop trailing separator */ |
| 1240 | #endif /* Unix */ |
| 1241 | } |
| 1242 | #endif /* All others */ |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1243 | a = PyString_FromStringAndSize(argv0, n); |
Guido van Rossum | 94a9667 | 1996-07-30 20:35:50 +0000 | [diff] [blame] | 1244 | if (a == NULL) |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1245 | Py_FatalError("no mem for sys.path insertion"); |
| 1246 | if (PyList_Insert(path, 0, a) < 0) |
| 1247 | Py_FatalError("sys.path.insert(0) failed"); |
| 1248 | Py_DECREF(a); |
Guido van Rossum | a63d9f4 | 1996-07-24 01:31:37 +0000 | [diff] [blame] | 1249 | } |
Guido van Rossum | 65bf9f2 | 1997-04-29 18:33:38 +0000 | [diff] [blame] | 1250 | Py_DECREF(av); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 1251 | } |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1252 | |
| 1253 | |
| 1254 | /* APIs to write to sys.stdout or sys.stderr using a printf-like interface. |
| 1255 | Adapted from code submitted by Just van Rossum. |
| 1256 | |
| 1257 | PySys_WriteStdout(format, ...) |
| 1258 | PySys_WriteStderr(format, ...) |
| 1259 | |
| 1260 | The first function writes to sys.stdout; the second to sys.stderr. When |
| 1261 | 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] | 1262 | no exceptions are raised. |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1263 | |
| 1264 | Both take a printf-style format string as their first argument followed |
| 1265 | by a variable length argument list determined by the format string. |
| 1266 | |
| 1267 | *** WARNING *** |
| 1268 | |
| 1269 | The format should limit the total size of the formatted output string to |
| 1270 | 1000 bytes. In particular, this means that no unrestricted "%s" formats |
| 1271 | should occur; these should be limited using "%.<N>s where <N> is a |
| 1272 | decimal number calculated so that <N> plus the maximum size of other |
| 1273 | formatted text does not exceed 1000 bytes. Also watch out for "%f", |
| 1274 | which can print hundreds of digits for very large numbers. |
| 1275 | |
| 1276 | */ |
| 1277 | |
| 1278 | static void |
Thomas Wouters | f70ef4f | 2000-07-22 18:47:25 +0000 | [diff] [blame] | 1279 | mywrite(char *name, FILE *fp, const char *format, va_list va) |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1280 | { |
| 1281 | PyObject *file; |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1282 | PyObject *error_type, *error_value, *error_traceback; |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1283 | |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1284 | PyErr_Fetch(&error_type, &error_value, &error_traceback); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1285 | file = PySys_GetObject(name); |
| 1286 | if (file == NULL || PyFile_AsFile(file) == fp) |
| 1287 | vfprintf(fp, format, va); |
| 1288 | else { |
| 1289 | char buffer[1001]; |
Tim Peters | 080d5b3 | 2001-12-02 08:29:16 +0000 | [diff] [blame] | 1290 | const int written = PyOS_vsnprintf(buffer, sizeof(buffer), |
| 1291 | format, va); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1292 | if (PyFile_WriteString(buffer, file) != 0) { |
| 1293 | PyErr_Clear(); |
| 1294 | fputs(buffer, fp); |
| 1295 | } |
Tim Peters | faad5ad | 2001-12-03 00:43:33 +0000 | [diff] [blame] | 1296 | if (written < 0 || written >= sizeof(buffer)) { |
Jeremy Hylton | 5d3d134 | 2001-11-28 21:44:53 +0000 | [diff] [blame] | 1297 | const char *truncated = "... truncated"; |
| 1298 | if (PyFile_WriteString(truncated, file) != 0) { |
| 1299 | PyErr_Clear(); |
| 1300 | fputs(truncated, fp); |
| 1301 | } |
| 1302 | } |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1303 | } |
Guido van Rossum | 8442af3 | 1998-10-12 18:22:10 +0000 | [diff] [blame] | 1304 | PyErr_Restore(error_type, error_value, error_traceback); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1305 | } |
| 1306 | |
| 1307 | void |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1308 | PySys_WriteStdout(const char *format, ...) |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1309 | { |
| 1310 | va_list va; |
| 1311 | |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1312 | va_start(va, format); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1313 | mywrite("stdout", stdout, format, va); |
| 1314 | va_end(va); |
| 1315 | } |
| 1316 | |
| 1317 | void |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1318 | PySys_WriteStderr(const char *format, ...) |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1319 | { |
| 1320 | va_list va; |
| 1321 | |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1322 | va_start(va, format); |
Guido van Rossum | a890e68 | 1998-05-12 14:59:24 +0000 | [diff] [blame] | 1323 | mywrite("stderr", stderr, format, va); |
| 1324 | va_end(va); |
| 1325 | } |