blob: f33e477ad7bd7905eb43c4192106d49ca8fad75e [file] [log] [blame]
Christian Heimes33fe8092008-04-13 13:53:33 +00001#include "Python.h"
2#include "frameobject.h"
3
4#define MODULE_NAME "_warnings"
Christian Heimes33fe8092008-04-13 13:53:33 +00005
6PyDoc_STRVAR(warnings__doc__,
7MODULE_NAME " provides basic warning filtering support.\n"
8"It is a helper module to speed up interpreter start-up.");
9
10/* Both 'filters' and 'onceregistry' can be set in warnings.py;
11 get_warnings_attr() will reset these variables accordingly. */
12static PyObject *_filters; /* List */
13static PyObject *_once_registry; /* Dict */
Brett Cannon0759dd62009-04-01 18:13:07 +000014static PyObject *_default_action; /* String */
Christian Heimes33fe8092008-04-13 13:53:33 +000015
16
17static int
18check_matched(PyObject *obj, PyObject *arg)
19{
20 PyObject *result;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +020021 _Py_IDENTIFIER(match);
Christian Heimes33fe8092008-04-13 13:53:33 +000022 int rc;
23
24 if (obj == Py_None)
25 return 1;
Martin v. Löwisafe55bb2011-10-09 10:38:36 +020026 result = _PyObject_CallMethodId(obj, &PyId_match, "O", arg);
Christian Heimes33fe8092008-04-13 13:53:33 +000027 if (result == NULL)
28 return -1;
29
30 rc = PyObject_IsTrue(result);
31 Py_DECREF(result);
32 return rc;
33}
34
35/*
36 Returns a new reference.
37 A NULL return value can mean false or an error.
38*/
39static PyObject *
40get_warnings_attr(const char *attr)
41{
42 static PyObject *warnings_str = NULL;
43 PyObject *all_modules;
44 PyObject *warnings_module;
45 int result;
46
47 if (warnings_str == NULL) {
48 warnings_str = PyUnicode_InternFromString("warnings");
49 if (warnings_str == NULL)
50 return NULL;
51 }
52
53 all_modules = PyImport_GetModuleDict();
54 result = PyDict_Contains(all_modules, warnings_str);
55 if (result == -1 || result == 0)
56 return NULL;
57
58 warnings_module = PyDict_GetItem(all_modules, warnings_str);
59 if (!PyObject_HasAttrString(warnings_module, attr))
60 return NULL;
61 return PyObject_GetAttrString(warnings_module, attr);
62}
63
64
Neal Norwitz32dde222008-04-15 06:43:13 +000065static PyObject *
Christian Heimes33fe8092008-04-13 13:53:33 +000066get_once_registry(void)
67{
68 PyObject *registry;
69
70 registry = get_warnings_attr("onceregistry");
71 if (registry == NULL) {
72 if (PyErr_Occurred())
73 return NULL;
74 return _once_registry;
75 }
76 Py_DECREF(_once_registry);
77 _once_registry = registry;
78 return registry;
79}
80
81
Brett Cannon0759dd62009-04-01 18:13:07 +000082static PyObject *
83get_default_action(void)
84{
85 PyObject *default_action;
86
87 default_action = get_warnings_attr("defaultaction");
88 if (default_action == NULL) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000089 if (PyErr_Occurred()) {
90 return NULL;
91 }
92 return _default_action;
Brett Cannon0759dd62009-04-01 18:13:07 +000093 }
94
95 Py_DECREF(_default_action);
96 _default_action = default_action;
97 return default_action;
98}
99
100
Christian Heimes33fe8092008-04-13 13:53:33 +0000101/* The item is a borrowed reference. */
102static const char *
103get_filter(PyObject *category, PyObject *text, Py_ssize_t lineno,
104 PyObject *module, PyObject **item)
105{
Brett Cannon0759dd62009-04-01 18:13:07 +0000106 PyObject *action;
Christian Heimes33fe8092008-04-13 13:53:33 +0000107 Py_ssize_t i;
108 PyObject *warnings_filters;
109
110 warnings_filters = get_warnings_attr("filters");
111 if (warnings_filters == NULL) {
112 if (PyErr_Occurred())
113 return NULL;
114 }
115 else {
116 Py_DECREF(_filters);
117 _filters = warnings_filters;
118 }
119
Victor Stinner7d79b8b2010-05-19 20:40:50 +0000120 if (_filters == NULL || !PyList_Check(_filters)) {
Christian Heimes33fe8092008-04-13 13:53:33 +0000121 PyErr_SetString(PyExc_ValueError,
122 MODULE_NAME ".filters must be a list");
123 return NULL;
124 }
125
126 /* _filters could change while we are iterating over it. */
127 for (i = 0; i < PyList_GET_SIZE(_filters); i++) {
128 PyObject *tmp_item, *action, *msg, *cat, *mod, *ln_obj;
129 Py_ssize_t ln;
130 int is_subclass, good_msg, good_mod;
131
132 tmp_item = *item = PyList_GET_ITEM(_filters, i);
133 if (PyTuple_Size(tmp_item) != 5) {
134 PyErr_Format(PyExc_ValueError,
135 MODULE_NAME ".filters item %zd isn't a 5-tuple", i);
136 return NULL;
137 }
138
139 /* Python code: action, msg, cat, mod, ln = item */
140 action = PyTuple_GET_ITEM(tmp_item, 0);
141 msg = PyTuple_GET_ITEM(tmp_item, 1);
142 cat = PyTuple_GET_ITEM(tmp_item, 2);
143 mod = PyTuple_GET_ITEM(tmp_item, 3);
144 ln_obj = PyTuple_GET_ITEM(tmp_item, 4);
145
146 good_msg = check_matched(msg, text);
147 good_mod = check_matched(mod, module);
148 is_subclass = PyObject_IsSubclass(category, cat);
149 ln = PyLong_AsSsize_t(ln_obj);
150 if (good_msg == -1 || good_mod == -1 || is_subclass == -1 ||
151 (ln == -1 && PyErr_Occurred()))
152 return NULL;
153
154 if (good_msg && is_subclass && good_mod && (ln == 0 || lineno == ln))
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000155 return _PyUnicode_AsString(action);
Christian Heimes33fe8092008-04-13 13:53:33 +0000156 }
157
Brett Cannon0759dd62009-04-01 18:13:07 +0000158 action = get_default_action();
159 if (action != NULL) {
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000160 return _PyUnicode_AsString(action);
Brett Cannon0759dd62009-04-01 18:13:07 +0000161 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000162
163 PyErr_SetString(PyExc_ValueError,
Brett Cannon0759dd62009-04-01 18:13:07 +0000164 MODULE_NAME ".defaultaction not found");
Christian Heimes33fe8092008-04-13 13:53:33 +0000165 return NULL;
166}
167
Brett Cannon0759dd62009-04-01 18:13:07 +0000168
Christian Heimes33fe8092008-04-13 13:53:33 +0000169static int
170already_warned(PyObject *registry, PyObject *key, int should_set)
171{
172 PyObject *already_warned;
173
174 if (key == NULL)
175 return -1;
176
177 already_warned = PyDict_GetItem(registry, key);
178 if (already_warned != NULL) {
179 int rc = PyObject_IsTrue(already_warned);
180 if (rc != 0)
181 return rc;
182 }
183
184 /* This warning wasn't found in the registry, set it. */
185 if (should_set)
186 return PyDict_SetItem(registry, key, Py_True);
187 return 0;
188}
189
190/* New reference. */
191static PyObject *
192normalize_module(PyObject *filename)
193{
194 PyObject *module;
195 const char *mod_str;
196 Py_ssize_t len;
197
198 int rc = PyObject_IsTrue(filename);
199 if (rc == -1)
200 return NULL;
201 else if (rc == 0)
202 return PyUnicode_FromString("<unknown>");
203
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000204 mod_str = _PyUnicode_AsString(filename);
Christian Heimes33fe8092008-04-13 13:53:33 +0000205 if (mod_str == NULL)
Victor Stinner9e30aa52011-11-21 02:49:52 +0100206 return NULL;
207 len = PyUnicode_GetLength(filename);
Christian Heimes33fe8092008-04-13 13:53:33 +0000208 if (len < 0)
209 return NULL;
210 if (len >= 3 &&
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000211 strncmp(mod_str + (len - 3), ".py", 3) == 0) {
Victor Stinner9e30aa52011-11-21 02:49:52 +0100212 module = PyUnicode_Substring(filename, 0, len-3);
Christian Heimes33fe8092008-04-13 13:53:33 +0000213 }
214 else {
215 module = filename;
216 Py_INCREF(module);
217 }
218 return module;
219}
220
221static int
222update_registry(PyObject *registry, PyObject *text, PyObject *category,
223 int add_zero)
224{
225 PyObject *altkey, *zero = NULL;
226 int rc;
227
228 if (add_zero) {
229 zero = PyLong_FromLong(0);
230 if (zero == NULL)
231 return -1;
232 altkey = PyTuple_Pack(3, text, category, zero);
233 }
234 else
235 altkey = PyTuple_Pack(2, text, category);
236
237 rc = already_warned(registry, altkey, 1);
238 Py_XDECREF(zero);
239 Py_XDECREF(altkey);
240 return rc;
241}
242
243static void
244show_warning(PyObject *filename, int lineno, PyObject *text, PyObject
245 *category, PyObject *sourceline)
246{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000247 PyObject *f_stderr;
248 PyObject *name;
Christian Heimes33fe8092008-04-13 13:53:33 +0000249 char lineno_str[128];
Martin v. Löwisbd928fe2011-10-14 10:20:37 +0200250 _Py_IDENTIFIER(__name__);
Christian Heimes33fe8092008-04-13 13:53:33 +0000251
252 PyOS_snprintf(lineno_str, sizeof(lineno_str), ":%d: ", lineno);
253
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +0200254 name = _PyObject_GetAttrId(category, &PyId___name__);
Christian Heimes33fe8092008-04-13 13:53:33 +0000255 if (name == NULL) /* XXX Can an object lack a '__name__' attribute? */
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000256 return;
Christian Heimes33fe8092008-04-13 13:53:33 +0000257
258 f_stderr = PySys_GetObject("stderr");
259 if (f_stderr == NULL) {
260 fprintf(stderr, "lost sys.stderr\n");
261 Py_DECREF(name);
262 return;
263 }
264
265 /* Print "filename:lineno: category: text\n" */
266 PyFile_WriteObject(filename, f_stderr, Py_PRINT_RAW);
267 PyFile_WriteString(lineno_str, f_stderr);
268 PyFile_WriteObject(name, f_stderr, Py_PRINT_RAW);
269 PyFile_WriteString(": ", f_stderr);
270 PyFile_WriteObject(text, f_stderr, Py_PRINT_RAW);
271 PyFile_WriteString("\n", f_stderr);
272 Py_XDECREF(name);
273
274 /* Print " source_line\n" */
Christian Heimes33fe8092008-04-13 13:53:33 +0000275 if (sourceline) {
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000276 char *source_line_str = _PyUnicode_AsString(sourceline);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000277 if (source_line_str == NULL)
278 return;
Christian Heimes33fe8092008-04-13 13:53:33 +0000279 while (*source_line_str == ' ' || *source_line_str == '\t' ||
280 *source_line_str == '\014')
281 source_line_str++;
282
283 PyFile_WriteString(source_line_str, f_stderr);
284 PyFile_WriteString("\n", f_stderr);
285 }
286 else
Victor Stinner0fe25a42010-06-17 23:08:50 +0000287 if (_Py_DisplaySourceLine(f_stderr, filename, lineno, 2) < 0)
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000288 return;
Christian Heimes33fe8092008-04-13 13:53:33 +0000289 PyErr_Clear();
290}
291
292static PyObject *
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000293warn_explicit(PyObject *category, PyObject *message,
Christian Heimes33fe8092008-04-13 13:53:33 +0000294 PyObject *filename, int lineno,
295 PyObject *module, PyObject *registry, PyObject *sourceline)
296{
297 PyObject *key = NULL, *text = NULL, *result = NULL, *lineno_obj = NULL;
298 PyObject *item = Py_None;
299 const char *action;
300 int rc;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000301
Brett Cannondb734912008-06-27 00:52:15 +0000302 if (registry && !PyDict_Check(registry) && (registry != Py_None)) {
303 PyErr_SetString(PyExc_TypeError, "'registry' must be a dict");
304 return NULL;
305 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000306
307 /* Normalize module. */
308 if (module == NULL) {
309 module = normalize_module(filename);
310 if (module == NULL)
311 return NULL;
312 }
313 else
314 Py_INCREF(module);
315
316 /* Normalize message. */
317 Py_INCREF(message); /* DECREF'ed in cleanup. */
318 rc = PyObject_IsInstance(message, PyExc_Warning);
319 if (rc == -1) {
320 goto cleanup;
321 }
322 if (rc == 1) {
323 text = PyObject_Str(message);
Hirokazu Yamamoto1c0c0032009-07-17 06:55:42 +0000324 if (text == NULL)
325 goto cleanup;
Christian Heimes33fe8092008-04-13 13:53:33 +0000326 category = (PyObject*)message->ob_type;
327 }
328 else {
329 text = message;
330 message = PyObject_CallFunction(category, "O", message);
Brett Cannondb734912008-06-27 00:52:15 +0000331 if (message == NULL)
332 goto cleanup;
Christian Heimes33fe8092008-04-13 13:53:33 +0000333 }
334
335 lineno_obj = PyLong_FromLong(lineno);
336 if (lineno_obj == NULL)
337 goto cleanup;
338
339 /* Create key. */
340 key = PyTuple_Pack(3, text, category, lineno_obj);
341 if (key == NULL)
342 goto cleanup;
343
Brett Cannondb734912008-06-27 00:52:15 +0000344 if ((registry != NULL) && (registry != Py_None)) {
Christian Heimes33fe8092008-04-13 13:53:33 +0000345 rc = already_warned(registry, key, 0);
346 if (rc == -1)
347 goto cleanup;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000348 else if (rc == 1)
Christian Heimes33fe8092008-04-13 13:53:33 +0000349 goto return_none;
350 /* Else this warning hasn't been generated before. */
351 }
352
353 action = get_filter(category, text, lineno, module, &item);
354 if (action == NULL)
355 goto cleanup;
356
357 if (strcmp(action, "error") == 0) {
358 PyErr_SetObject(category, message);
359 goto cleanup;
360 }
361
362 /* Store in the registry that we've been here, *except* when the action
363 is "always". */
364 rc = 0;
365 if (strcmp(action, "always") != 0) {
Brett Cannondb734912008-06-27 00:52:15 +0000366 if (registry != NULL && registry != Py_None &&
367 PyDict_SetItem(registry, key, Py_True) < 0)
Christian Heimes33fe8092008-04-13 13:53:33 +0000368 goto cleanup;
369 else if (strcmp(action, "ignore") == 0)
370 goto return_none;
371 else if (strcmp(action, "once") == 0) {
Brett Cannondb734912008-06-27 00:52:15 +0000372 if (registry == NULL || registry == Py_None) {
Christian Heimes33fe8092008-04-13 13:53:33 +0000373 registry = get_once_registry();
374 if (registry == NULL)
375 goto cleanup;
376 }
377 /* _once_registry[(text, category)] = 1 */
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000378 rc = update_registry(registry, text, category, 0);
Christian Heimes33fe8092008-04-13 13:53:33 +0000379 }
380 else if (strcmp(action, "module") == 0) {
381 /* registry[(text, category, 0)] = 1 */
Brett Cannondb734912008-06-27 00:52:15 +0000382 if (registry != NULL && registry != Py_None)
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000383 rc = update_registry(registry, text, category, 0);
Christian Heimes33fe8092008-04-13 13:53:33 +0000384 }
385 else if (strcmp(action, "default") != 0) {
386 PyObject *to_str = PyObject_Str(item);
387 const char *err_str = "???";
388
Brett Cannon54bd41d2008-09-02 04:01:42 +0000389 if (to_str != NULL) {
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000390 err_str = _PyUnicode_AsString(to_str);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000391 if (err_str == NULL)
392 goto cleanup;
393 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000394 PyErr_Format(PyExc_RuntimeError,
395 "Unrecognized action (%s) in warnings.filters:\n %s",
396 action, err_str);
397 Py_XDECREF(to_str);
398 goto cleanup;
399 }
400 }
401
Christian Heimes1a8501c2008-10-02 19:56:01 +0000402 if (rc == 1) /* Already warned for this module. */
Christian Heimes33fe8092008-04-13 13:53:33 +0000403 goto return_none;
404 if (rc == 0) {
405 PyObject *show_fxn = get_warnings_attr("showwarning");
406 if (show_fxn == NULL) {
407 if (PyErr_Occurred())
408 goto cleanup;
409 show_warning(filename, lineno, text, category, sourceline);
410 }
411 else {
Brett Cannonec92e182008-09-02 02:46:59 +0000412 PyObject *res;
Christian Heimes8dc226f2008-05-06 23:45:46 +0000413
Brett Cannon52a7d982011-07-17 19:17:55 -0700414 if (!PyCallable_Check(show_fxn)) {
Brett Cannonec92e182008-09-02 02:46:59 +0000415 PyErr_SetString(PyExc_TypeError,
416 "warnings.showwarning() must be set to a "
Brett Cannon52a7d982011-07-17 19:17:55 -0700417 "callable");
Christian Heimes8dc226f2008-05-06 23:45:46 +0000418 Py_DECREF(show_fxn);
Brett Cannonec92e182008-09-02 02:46:59 +0000419 goto cleanup;
Christian Heimes8dc226f2008-05-06 23:45:46 +0000420 }
Brett Cannonec92e182008-09-02 02:46:59 +0000421
422 res = PyObject_CallFunctionObjArgs(show_fxn, message, category,
423 filename, lineno_obj,
424 NULL);
425 Py_DECREF(show_fxn);
426 Py_XDECREF(res);
427 if (res == NULL)
428 goto cleanup;
Christian Heimes33fe8092008-04-13 13:53:33 +0000429 }
430 }
431 else /* if (rc == -1) */
432 goto cleanup;
433
434 return_none:
435 result = Py_None;
436 Py_INCREF(result);
437
438 cleanup:
439 Py_XDECREF(key);
440 Py_XDECREF(text);
441 Py_XDECREF(lineno_obj);
442 Py_DECREF(module);
Brett Cannondb734912008-06-27 00:52:15 +0000443 Py_XDECREF(message);
Christian Heimes33fe8092008-04-13 13:53:33 +0000444 return result; /* Py_None or NULL. */
445}
446
447/* filename, module, and registry are new refs, globals is borrowed */
448/* Returns 0 on error (no new refs), 1 on success */
449static int
450setup_context(Py_ssize_t stack_level, PyObject **filename, int *lineno,
451 PyObject **module, PyObject **registry)
452{
453 PyObject *globals;
454
455 /* Setup globals and lineno. */
456 PyFrameObject *f = PyThreadState_GET()->frame;
Christian Heimes5d8da202008-05-06 13:58:24 +0000457 while (--stack_level > 0 && f != NULL)
Christian Heimes33fe8092008-04-13 13:53:33 +0000458 f = f->f_back;
Christian Heimes33fe8092008-04-13 13:53:33 +0000459
460 if (f == NULL) {
461 globals = PyThreadState_Get()->interp->sysdict;
462 *lineno = 1;
463 }
464 else {
465 globals = f->f_globals;
Alexandre Vassalotti7b82b402009-07-21 04:30:03 +0000466 *lineno = PyFrame_GetLineNumber(f);
Christian Heimes33fe8092008-04-13 13:53:33 +0000467 }
468
469 *module = NULL;
470
471 /* Setup registry. */
472 assert(globals != NULL);
473 assert(PyDict_Check(globals));
474 *registry = PyDict_GetItemString(globals, "__warningregistry__");
475 if (*registry == NULL) {
476 int rc;
477
478 *registry = PyDict_New();
479 if (*registry == NULL)
480 return 0;
481
482 rc = PyDict_SetItemString(globals, "__warningregistry__", *registry);
483 if (rc < 0)
484 goto handle_error;
485 }
486 else
487 Py_INCREF(*registry);
488
489 /* Setup module. */
490 *module = PyDict_GetItemString(globals, "__name__");
491 if (*module == NULL) {
492 *module = PyUnicode_FromString("<string>");
493 if (*module == NULL)
494 goto handle_error;
495 }
496 else
497 Py_INCREF(*module);
498
499 /* Setup filename. */
500 *filename = PyDict_GetItemString(globals, "__file__");
Victor Stinner8b0508e2011-07-04 02:43:09 +0200501 if (*filename != NULL && PyUnicode_Check(*filename)) {
Victor Stinnerb62a7b22011-10-06 02:34:51 +0200502 Py_ssize_t len;
503 int kind;
504 void *data;
505
506 if (PyUnicode_READY(*filename))
507 goto handle_error;
508
Victor Stinner9e30aa52011-11-21 02:49:52 +0100509 len = PyUnicode_GetLength(*filename);
Victor Stinnerb62a7b22011-10-06 02:34:51 +0200510 kind = PyUnicode_KIND(*filename);
511 data = PyUnicode_DATA(*filename);
Christian Heimes33fe8092008-04-13 13:53:33 +0000512
Benjamin Peterson21e0da22012-01-11 21:00:42 -0500513#define ascii_lower(c) ((c <= 127) ? Py_TOLOWER(c) : 0)
Christian Heimes33fe8092008-04-13 13:53:33 +0000514 /* if filename.lower().endswith((".pyc", ".pyo")): */
515 if (len >= 4 &&
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200516 PyUnicode_READ(kind, data, len-4) == '.' &&
Benjamin Peterson21e0da22012-01-11 21:00:42 -0500517 ascii_lower(PyUnicode_READ(kind, data, len-3)) == 'p' &&
518 ascii_lower(PyUnicode_READ(kind, data, len-2)) == 'y' &&
519 (ascii_lower(PyUnicode_READ(kind, data, len-1)) == 'c' ||
520 ascii_lower(PyUnicode_READ(kind, data, len-1)) == 'o'))
Christian Heimes81ee3ef2008-05-04 22:42:01 +0000521 {
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200522 *filename = PyUnicode_Substring(*filename, 0,
523 PyUnicode_GET_LENGTH(*filename)-1);
Victor Stinner2e5f1172010-08-08 22:12:45 +0000524 if (*filename == NULL)
525 goto handle_error;
526 }
527 else
Christian Heimes33fe8092008-04-13 13:53:33 +0000528 Py_INCREF(*filename);
529 }
530 else {
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000531 const char *module_str = _PyUnicode_AsString(*module);
Benjamin Petersonbb4a7472011-07-04 22:27:16 -0500532 *filename = NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000533 if (module_str == NULL)
534 goto handle_error;
Brett Cannon54bd41d2008-09-02 04:01:42 +0000535 if (strcmp(module_str, "__main__") == 0) {
Christian Heimes33fe8092008-04-13 13:53:33 +0000536 PyObject *argv = PySys_GetObject("argv");
537 if (argv != NULL && PyList_Size(argv) > 0) {
Christian Heimes81ee3ef2008-05-04 22:42:01 +0000538 int is_true;
Christian Heimes33fe8092008-04-13 13:53:33 +0000539 *filename = PyList_GetItem(argv, 0);
540 Py_INCREF(*filename);
Christian Heimes81ee3ef2008-05-04 22:42:01 +0000541 /* If sys.argv[0] is false, then use '__main__'. */
542 is_true = PyObject_IsTrue(*filename);
543 if (is_true < 0) {
544 Py_DECREF(*filename);
545 goto handle_error;
546 }
547 else if (!is_true) {
548 Py_DECREF(*filename);
Benjamin Peterson9f4bf1d2008-05-04 23:22:13 +0000549 *filename = PyUnicode_FromString("__main__");
Christian Heimes81ee3ef2008-05-04 22:42:01 +0000550 if (*filename == NULL)
551 goto handle_error;
552 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000553 }
554 else {
555 /* embedded interpreters don't have sys.argv, see bug #839151 */
556 *filename = PyUnicode_FromString("__main__");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000557 if (*filename == NULL)
558 goto handle_error;
Christian Heimes33fe8092008-04-13 13:53:33 +0000559 }
560 }
561 if (*filename == NULL) {
562 *filename = *module;
563 Py_INCREF(*filename);
564 }
565 }
566
567 return 1;
568
569 handle_error:
570 /* filename not XDECREF'ed here as there is no way to jump here with a
571 dangling reference. */
572 Py_XDECREF(*registry);
573 Py_XDECREF(*module);
574 return 0;
575}
576
577static PyObject *
578get_category(PyObject *message, PyObject *category)
579{
580 int rc;
581
582 /* Get category. */
583 rc = PyObject_IsInstance(message, PyExc_Warning);
584 if (rc == -1)
585 return NULL;
586
587 if (rc == 1)
588 category = (PyObject*)message->ob_type;
589 else if (category == NULL)
590 category = PyExc_UserWarning;
591
592 /* Validate category. */
593 rc = PyObject_IsSubclass(category, PyExc_Warning);
594 if (rc == -1)
595 return NULL;
596 if (rc == 0) {
597 PyErr_SetString(PyExc_ValueError,
598 "category is not a subclass of Warning");
599 return NULL;
600 }
601
602 return category;
603}
604
605static PyObject *
606do_warn(PyObject *message, PyObject *category, Py_ssize_t stack_level)
607{
608 PyObject *filename, *module, *registry, *res;
609 int lineno;
610
611 if (!setup_context(stack_level, &filename, &lineno, &module, &registry))
612 return NULL;
613
614 res = warn_explicit(category, message, filename, lineno, module, registry,
615 NULL);
616 Py_DECREF(filename);
617 Py_DECREF(registry);
618 Py_DECREF(module);
619 return res;
620}
621
622static PyObject *
623warnings_warn(PyObject *self, PyObject *args, PyObject *kwds)
624{
625 static char *kw_list[] = { "message", "category", "stacklevel", 0 };
626 PyObject *message, *category = NULL;
627 Py_ssize_t stack_level = 1;
628
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000629 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|On:warn", kw_list,
Christian Heimes33fe8092008-04-13 13:53:33 +0000630 &message, &category, &stack_level))
631 return NULL;
632
633 category = get_category(message, category);
634 if (category == NULL)
635 return NULL;
636 return do_warn(message, category, stack_level);
637}
638
639static PyObject *
640warnings_warn_explicit(PyObject *self, PyObject *args, PyObject *kwds)
641{
642 static char *kwd_list[] = {"message", "category", "filename", "lineno",
643 "module", "registry", "module_globals", 0};
644 PyObject *message;
645 PyObject *category;
646 PyObject *filename;
647 int lineno;
648 PyObject *module = NULL;
649 PyObject *registry = NULL;
650 PyObject *module_globals = NULL;
651
652 if (!PyArg_ParseTupleAndKeywords(args, kwds, "OOOi|OOO:warn_explicit",
653 kwd_list, &message, &category, &filename, &lineno, &module,
654 &registry, &module_globals))
655 return NULL;
656
657 if (module_globals) {
Martin v. Löwis1c67dd92011-10-14 15:16:45 +0200658 _Py_IDENTIFIER(get_source);
659 _Py_IDENTIFIER(splitlines);
660 PyObject *tmp;
Christian Heimes33fe8092008-04-13 13:53:33 +0000661 PyObject *loader;
662 PyObject *module_name;
663 PyObject *source;
664 PyObject *source_list;
665 PyObject *source_line;
666 PyObject *returned;
667
Martin v. Löwis1c67dd92011-10-14 15:16:45 +0200668 if ((tmp = _PyUnicode_FromId(&PyId_get_source)) == NULL)
669 return NULL;
Martin v. Löwis1c67dd92011-10-14 15:16:45 +0200670 if ((tmp = _PyUnicode_FromId(&PyId_splitlines)) == NULL)
671 return NULL;
Christian Heimes33fe8092008-04-13 13:53:33 +0000672
673 /* Check/get the requisite pieces needed for the loader. */
674 loader = PyDict_GetItemString(module_globals, "__loader__");
675 module_name = PyDict_GetItemString(module_globals, "__name__");
676
677 if (loader == NULL || module_name == NULL)
678 goto standard_call;
679
680 /* Make sure the loader implements the optional get_source() method. */
Martin v. Löwis1c67dd92011-10-14 15:16:45 +0200681 if (!_PyObject_HasAttrId(loader, &PyId_get_source))
Christian Heimes33fe8092008-04-13 13:53:33 +0000682 goto standard_call;
683 /* Call get_source() to get the source code. */
Martin v. Löwis1c67dd92011-10-14 15:16:45 +0200684 source = PyObject_CallMethodObjArgs(loader, PyId_get_source.object,
685 module_name, NULL);
Christian Heimes33fe8092008-04-13 13:53:33 +0000686 if (!source)
687 return NULL;
688 else if (source == Py_None) {
689 Py_DECREF(Py_None);
690 goto standard_call;
691 }
692
693 /* Split the source into lines. */
Victor Stinner9e30aa52011-11-21 02:49:52 +0100694 source_list = PyObject_CallMethodObjArgs(source,
Martin v. Löwis1c67dd92011-10-14 15:16:45 +0200695 PyId_splitlines.object,
696 NULL);
Christian Heimes33fe8092008-04-13 13:53:33 +0000697 Py_DECREF(source);
698 if (!source_list)
699 return NULL;
700
701 /* Get the source line. */
702 source_line = PyList_GetItem(source_list, lineno-1);
703 if (!source_line) {
704 Py_DECREF(source_list);
705 return NULL;
706 }
707
708 /* Handle the warning. */
709 returned = warn_explicit(category, message, filename, lineno, module,
710 registry, source_line);
711 Py_DECREF(source_list);
712 return returned;
713 }
714
715 standard_call:
716 return warn_explicit(category, message, filename, lineno, module,
717 registry, NULL);
718}
719
720
721/* Function to issue a warning message; may raise an exception. */
Victor Stinner4a2b7a12010-08-13 14:03:48 +0000722
723static int
724warn_unicode(PyObject *category, PyObject *message,
725 Py_ssize_t stack_level)
Christian Heimes33fe8092008-04-13 13:53:33 +0000726{
727 PyObject *res;
Christian Heimes33fe8092008-04-13 13:53:33 +0000728
729 if (category == NULL)
730 category = PyExc_RuntimeWarning;
731
732 res = do_warn(message, category, stack_level);
Christian Heimes33fe8092008-04-13 13:53:33 +0000733 if (res == NULL)
734 return -1;
735 Py_DECREF(res);
736
737 return 0;
738}
739
Victor Stinner4a2b7a12010-08-13 14:03:48 +0000740int
741PyErr_WarnFormat(PyObject *category, Py_ssize_t stack_level,
742 const char *format, ...)
743{
744 int ret;
745 PyObject *message;
746 va_list vargs;
747
748#ifdef HAVE_STDARG_PROTOTYPES
749 va_start(vargs, format);
750#else
751 va_start(vargs);
752#endif
753 message = PyUnicode_FromFormatV(format, vargs);
754 if (message != NULL) {
755 ret = warn_unicode(category, message, stack_level);
756 Py_DECREF(message);
757 }
758 else
759 ret = -1;
760 va_end(vargs);
761 return ret;
762}
763
764int
765PyErr_WarnEx(PyObject *category, const char *text, Py_ssize_t stack_level)
766{
767 int ret;
768 PyObject *message = PyUnicode_FromString(text);
769 if (message == NULL)
770 return -1;
771 ret = warn_unicode(category, message, stack_level);
772 Py_DECREF(message);
773 return ret;
774}
775
Ezio Melotti42da6632011-03-15 05:18:48 +0200776/* PyErr_Warn is only for backwards compatibility and will be removed.
Christian Heimes33fe8092008-04-13 13:53:33 +0000777 Use PyErr_WarnEx instead. */
778
779#undef PyErr_Warn
780
781PyAPI_FUNC(int)
782PyErr_Warn(PyObject *category, char *text)
783{
784 return PyErr_WarnEx(category, text, 1);
785}
786
787/* Warning with explicit origin */
788int
789PyErr_WarnExplicit(PyObject *category, const char *text,
790 const char *filename_str, int lineno,
791 const char *module_str, PyObject *registry)
792{
793 PyObject *res;
794 PyObject *message = PyUnicode_FromString(text);
Victor Stinnercb428f02010-12-27 20:10:36 +0000795 PyObject *filename = PyUnicode_DecodeFSDefault(filename_str);
Christian Heimes33fe8092008-04-13 13:53:33 +0000796 PyObject *module = NULL;
797 int ret = -1;
798
799 if (message == NULL || filename == NULL)
800 goto exit;
801 if (module_str != NULL) {
802 module = PyUnicode_FromString(module_str);
803 if (module == NULL)
804 goto exit;
805 }
806
807 if (category == NULL)
808 category = PyExc_RuntimeWarning;
809 res = warn_explicit(category, message, filename, lineno, module, registry,
810 NULL);
811 if (res == NULL)
812 goto exit;
813 Py_DECREF(res);
814 ret = 0;
815
816 exit:
817 Py_XDECREF(message);
818 Py_XDECREF(module);
819 Py_XDECREF(filename);
820 return ret;
821}
822
823
824PyDoc_STRVAR(warn_doc,
825"Issue a warning, or maybe ignore it or raise an exception.");
826
827PyDoc_STRVAR(warn_explicit_doc,
828"Low-level inferface to warnings functionality.");
829
830static PyMethodDef warnings_functions[] = {
831 {"warn", (PyCFunction)warnings_warn, METH_VARARGS | METH_KEYWORDS,
832 warn_doc},
833 {"warn_explicit", (PyCFunction)warnings_warn_explicit,
834 METH_VARARGS | METH_KEYWORDS, warn_explicit_doc},
Christian Heimes1a8501c2008-10-02 19:56:01 +0000835 /* XXX(brett.cannon): add showwarning? */
836 /* XXX(brett.cannon): Reasonable to add formatwarning? */
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000837 {NULL, NULL} /* sentinel */
Christian Heimes33fe8092008-04-13 13:53:33 +0000838};
839
840
841static PyObject *
842create_filter(PyObject *category, const char *action)
843{
844 static PyObject *ignore_str = NULL;
845 static PyObject *error_str = NULL;
846 static PyObject *default_str = NULL;
Georg Brandl08be72d2010-10-24 15:11:22 +0000847 static PyObject *always_str = NULL;
Christian Heimes33fe8092008-04-13 13:53:33 +0000848 PyObject *action_obj = NULL;
849 PyObject *lineno, *result;
850
851 if (!strcmp(action, "ignore")) {
852 if (ignore_str == NULL) {
853 ignore_str = PyUnicode_InternFromString("ignore");
854 if (ignore_str == NULL)
855 return NULL;
856 }
857 action_obj = ignore_str;
858 }
859 else if (!strcmp(action, "error")) {
860 if (error_str == NULL) {
861 error_str = PyUnicode_InternFromString("error");
862 if (error_str == NULL)
863 return NULL;
864 }
865 action_obj = error_str;
866 }
867 else if (!strcmp(action, "default")) {
868 if (default_str == NULL) {
869 default_str = PyUnicode_InternFromString("default");
870 if (default_str == NULL)
871 return NULL;
872 }
873 action_obj = default_str;
874 }
Georg Brandl08be72d2010-10-24 15:11:22 +0000875 else if (!strcmp(action, "always")) {
876 if (always_str == NULL) {
877 always_str = PyUnicode_InternFromString("always");
878 if (always_str == NULL)
879 return NULL;
880 }
881 action_obj = always_str;
882 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000883 else {
884 Py_FatalError("unknown action");
885 }
886
887 /* This assumes the line number is zero for now. */
888 lineno = PyLong_FromLong(0);
889 if (lineno == NULL)
890 return NULL;
891 result = PyTuple_Pack(5, action_obj, Py_None, category, Py_None, lineno);
892 Py_DECREF(lineno);
893 return result;
894}
895
896static PyObject *
897init_filters(void)
898{
Georg Brandl08be72d2010-10-24 15:11:22 +0000899 PyObject *filters = PyList_New(5);
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000900 unsigned int pos = 0; /* Post-incremented in each use. */
901 unsigned int x;
Georg Brandl08be72d2010-10-24 15:11:22 +0000902 const char *bytes_action, *resource_action;
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000903
Christian Heimes33fe8092008-04-13 13:53:33 +0000904 if (filters == NULL)
905 return NULL;
906
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000907 PyList_SET_ITEM(filters, pos++,
908 create_filter(PyExc_DeprecationWarning, "ignore"));
909 PyList_SET_ITEM(filters, pos++,
Christian Heimes33fe8092008-04-13 13:53:33 +0000910 create_filter(PyExc_PendingDeprecationWarning, "ignore"));
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000911 PyList_SET_ITEM(filters, pos++,
912 create_filter(PyExc_ImportWarning, "ignore"));
Christian Heimes33fe8092008-04-13 13:53:33 +0000913 if (Py_BytesWarningFlag > 1)
914 bytes_action = "error";
915 else if (Py_BytesWarningFlag)
916 bytes_action = "default";
917 else
918 bytes_action = "ignore";
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000919 PyList_SET_ITEM(filters, pos++, create_filter(PyExc_BytesWarning,
Christian Heimes33fe8092008-04-13 13:53:33 +0000920 bytes_action));
Georg Brandl08be72d2010-10-24 15:11:22 +0000921 /* resource usage warnings are enabled by default in pydebug mode */
922#ifdef Py_DEBUG
923 resource_action = "always";
924#else
925 resource_action = "ignore";
926#endif
927 PyList_SET_ITEM(filters, pos++, create_filter(PyExc_ResourceWarning,
928 resource_action));
Benjamin Peterson7ab4b8d2010-06-28 00:01:59 +0000929 for (x = 0; x < pos; x += 1) {
930 if (PyList_GET_ITEM(filters, x) == NULL) {
931 Py_DECREF(filters);
932 return NULL;
933 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000934 }
935
936 return filters;
937}
938
Martin v. Löwis1a214512008-06-11 05:26:20 +0000939static struct PyModuleDef warningsmodule = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000940 PyModuleDef_HEAD_INIT,
941 MODULE_NAME,
942 warnings__doc__,
943 0,
944 warnings_functions,
945 NULL,
946 NULL,
947 NULL,
948 NULL
Martin v. Löwis1a214512008-06-11 05:26:20 +0000949};
950
Christian Heimes33fe8092008-04-13 13:53:33 +0000951
952PyMODINIT_FUNC
953_PyWarnings_Init(void)
954{
Brett Cannon0759dd62009-04-01 18:13:07 +0000955 PyObject *m;
Christian Heimes33fe8092008-04-13 13:53:33 +0000956
Martin v. Löwis1a214512008-06-11 05:26:20 +0000957 m = PyModule_Create(&warningsmodule);
Christian Heimes33fe8092008-04-13 13:53:33 +0000958 if (m == NULL)
Martin v. Löwis1a214512008-06-11 05:26:20 +0000959 return NULL;
Christian Heimes33fe8092008-04-13 13:53:33 +0000960
Antoine Pitrouaa5c5c62012-01-18 21:45:15 +0100961 if (_filters == NULL) {
962 _filters = init_filters();
963 if (_filters == NULL)
964 return NULL;
965 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000966 Py_INCREF(_filters);
967 if (PyModule_AddObject(m, "filters", _filters) < 0)
Martin v. Löwis1a214512008-06-11 05:26:20 +0000968 return NULL;
Christian Heimes33fe8092008-04-13 13:53:33 +0000969
Antoine Pitrouaa5c5c62012-01-18 21:45:15 +0100970 if (_once_registry == NULL) {
971 _once_registry = PyDict_New();
972 if (_once_registry == NULL)
973 return NULL;
974 }
Christian Heimes33fe8092008-04-13 13:53:33 +0000975 Py_INCREF(_once_registry);
Brett Cannonef0e6c32010-09-04 18:24:04 +0000976 if (PyModule_AddObject(m, "_onceregistry", _once_registry) < 0)
Martin v. Löwis1a214512008-06-11 05:26:20 +0000977 return NULL;
Christian Heimes33fe8092008-04-13 13:53:33 +0000978
Antoine Pitrouaa5c5c62012-01-18 21:45:15 +0100979 if (_default_action == NULL) {
980 _default_action = PyUnicode_FromString("default");
981 if (_default_action == NULL)
982 return NULL;
983 }
984 Py_INCREF(_default_action);
Brett Cannonef0e6c32010-09-04 18:24:04 +0000985 if (PyModule_AddObject(m, "_defaultaction", _default_action) < 0)
Martin v. Löwis1a214512008-06-11 05:26:20 +0000986 return NULL;
987 return m;
Christian Heimes33fe8092008-04-13 13:53:33 +0000988}