2 #include "frameobject.h"
4 #define MODULE_NAME "_warnings"
6 PyDoc_STRVAR(warnings__doc__
,
7 MODULE_NAME
" provides basic warning filtering support.\n"
8 "It is a helper module to speed up interpreter start-up.");
10 /* Both 'filters' and 'onceregistry' can be set in warnings.py;
11 get_warnings_attr() will reset these variables accordingly. */
12 static PyObject
*_filters
; /* List */
13 static PyObject
*_once_registry
; /* Dict */
14 static PyObject
*_default_action
; /* String */
18 check_matched(PyObject
*obj
, PyObject
*arg
)
25 result
= PyObject_CallMethod(obj
, "match", "O", arg
);
29 rc
= PyObject_IsTrue(result
);
35 Returns a new reference.
36 A NULL return value can mean false or an error.
39 get_warnings_attr(const char *attr
)
41 static PyObject
*warnings_str
= NULL
;
42 PyObject
*all_modules
;
43 PyObject
*warnings_module
;
46 if (warnings_str
== NULL
) {
47 warnings_str
= PyString_InternFromString("warnings");
48 if (warnings_str
== NULL
)
52 all_modules
= PyImport_GetModuleDict();
53 result
= PyDict_Contains(all_modules
, warnings_str
);
54 if (result
== -1 || result
== 0)
57 warnings_module
= PyDict_GetItem(all_modules
, warnings_str
);
58 if (!PyObject_HasAttrString(warnings_module
, attr
))
60 return PyObject_GetAttrString(warnings_module
, attr
);
65 get_once_registry(void)
69 registry
= get_warnings_attr("onceregistry");
70 if (registry
== NULL
) {
73 return _once_registry
;
75 Py_DECREF(_once_registry
);
76 _once_registry
= registry
;
82 get_default_action(void)
84 PyObject
*default_action
;
86 default_action
= get_warnings_attr("defaultaction");
87 if (default_action
== NULL
) {
88 if (PyErr_Occurred()) {
91 return _default_action
;
94 Py_DECREF(_default_action
);
95 _default_action
= default_action
;
96 return default_action
;
100 /* The item is a borrowed reference. */
102 get_filter(PyObject
*category
, PyObject
*text
, Py_ssize_t lineno
,
103 PyObject
*module
, PyObject
**item
)
107 PyObject
*warnings_filters
;
109 warnings_filters
= get_warnings_attr("filters");
110 if (warnings_filters
== NULL
) {
111 if (PyErr_Occurred())
116 _filters
= warnings_filters
;
119 if (!PyList_Check(_filters
)) {
120 PyErr_SetString(PyExc_ValueError
,
121 MODULE_NAME
".filters must be a list");
125 /* _filters could change while we are iterating over it. */
126 for (i
= 0; i
< PyList_GET_SIZE(_filters
); i
++) {
127 PyObject
*tmp_item
, *action
, *msg
, *cat
, *mod
, *ln_obj
;
129 int is_subclass
, good_msg
, good_mod
;
131 tmp_item
= *item
= PyList_GET_ITEM(_filters
, i
);
132 if (PyTuple_Size(tmp_item
) != 5) {
133 PyErr_Format(PyExc_ValueError
,
134 MODULE_NAME
".filters item %zd isn't a 5-tuple", i
);
138 /* Python code: action, msg, cat, mod, ln = item */
139 action
= PyTuple_GET_ITEM(tmp_item
, 0);
140 msg
= PyTuple_GET_ITEM(tmp_item
, 1);
141 cat
= PyTuple_GET_ITEM(tmp_item
, 2);
142 mod
= PyTuple_GET_ITEM(tmp_item
, 3);
143 ln_obj
= PyTuple_GET_ITEM(tmp_item
, 4);
145 good_msg
= check_matched(msg
, text
);
146 good_mod
= check_matched(mod
, module
);
147 is_subclass
= PyObject_IsSubclass(category
, cat
);
148 ln
= PyInt_AsSsize_t(ln_obj
);
149 if (good_msg
== -1 || good_mod
== -1 || is_subclass
== -1 ||
150 (ln
== -1 && PyErr_Occurred()))
153 if (good_msg
&& is_subclass
&& good_mod
&& (ln
== 0 || lineno
== ln
))
154 return PyString_AsString(action
);
157 action
= get_default_action();
158 if (action
!= NULL
) {
159 return PyString_AsString(action
);
162 PyErr_SetString(PyExc_ValueError
,
163 MODULE_NAME
".defaultaction not found");
169 already_warned(PyObject
*registry
, PyObject
*key
, int should_set
)
171 PyObject
*already_warned
;
176 already_warned
= PyDict_GetItem(registry
, key
);
177 if (already_warned
!= NULL
) {
178 int rc
= PyObject_IsTrue(already_warned
);
183 /* This warning wasn't found in the registry, set it. */
185 return PyDict_SetItem(registry
, key
, Py_True
);
191 normalize_module(PyObject
*filename
)
197 int rc
= PyObject_IsTrue(filename
);
201 return PyString_FromString("<unknown>");
203 mod_str
= PyString_AsString(filename
);
206 len
= PyString_Size(filename
);
210 strncmp(mod_str
+ (len
- 3), ".py", 3) == 0) {
211 module
= PyString_FromStringAndSize(mod_str
, len
-3);
221 update_registry(PyObject
*registry
, PyObject
*text
, PyObject
*category
,
224 PyObject
*altkey
, *zero
= NULL
;
228 zero
= PyInt_FromLong(0);
231 altkey
= PyTuple_Pack(3, text
, category
, zero
);
234 altkey
= PyTuple_Pack(2, text
, category
);
236 rc
= already_warned(registry
, altkey
, 1);
243 show_warning(PyObject
*filename
, int lineno
, PyObject
*text
, PyObject
244 *category
, PyObject
*sourceline
)
248 char lineno_str
[128];
250 PyOS_snprintf(lineno_str
, sizeof(lineno_str
), ":%d: ", lineno
);
252 name
= PyObject_GetAttrString(category
, "__name__");
253 if (name
== NULL
) /* XXX Can an object lack a '__name__' attribute? */
256 f_stderr
= PySys_GetObject("stderr");
257 if (f_stderr
== NULL
) {
258 fprintf(stderr
, "lost sys.stderr\n");
263 /* Print "filename:lineno: category: text\n" */
264 PyFile_WriteObject(filename
, f_stderr
, Py_PRINT_RAW
);
265 PyFile_WriteString(lineno_str
, f_stderr
);
266 PyFile_WriteObject(name
, f_stderr
, Py_PRINT_RAW
);
267 PyFile_WriteString(": ", f_stderr
);
268 PyFile_WriteObject(text
, f_stderr
, Py_PRINT_RAW
);
269 PyFile_WriteString("\n", f_stderr
);
272 /* Print " source_line\n" */
274 char *source_line_str
= PyString_AS_STRING(sourceline
);
275 while (*source_line_str
== ' ' || *source_line_str
== '\t' ||
276 *source_line_str
== '\014')
279 PyFile_WriteString(source_line_str
, f_stderr
);
280 PyFile_WriteString("\n", f_stderr
);
283 _Py_DisplaySourceLine(f_stderr
, PyString_AS_STRING(filename
),
289 warn_explicit(PyObject
*category
, PyObject
*message
,
290 PyObject
*filename
, int lineno
,
291 PyObject
*module
, PyObject
*registry
, PyObject
*sourceline
)
293 PyObject
*key
= NULL
, *text
= NULL
, *result
= NULL
, *lineno_obj
= NULL
;
294 PyObject
*item
= Py_None
;
298 if (registry
&& !PyDict_Check(registry
) && (registry
!= Py_None
)) {
299 PyErr_SetString(PyExc_TypeError
, "'registry' must be a dict");
303 /* Normalize module. */
304 if (module
== NULL
) {
305 module
= normalize_module(filename
);
312 /* Normalize message. */
313 Py_INCREF(message
); /* DECREF'ed in cleanup. */
314 rc
= PyObject_IsInstance(message
, PyExc_Warning
);
319 text
= PyObject_Str(message
);
320 category
= (PyObject
*)message
->ob_type
;
324 message
= PyObject_CallFunction(category
, "O", message
);
329 lineno_obj
= PyInt_FromLong(lineno
);
330 if (lineno_obj
== NULL
)
334 key
= PyTuple_Pack(3, text
, category
, lineno_obj
);
338 if ((registry
!= NULL
) && (registry
!= Py_None
)) {
339 rc
= already_warned(registry
, key
, 0);
344 /* Else this warning hasn't been generated before. */
347 action
= get_filter(category
, text
, lineno
, module
, &item
);
351 if (strcmp(action
, "error") == 0) {
352 PyErr_SetObject(category
, message
);
356 /* Store in the registry that we've been here, *except* when the action
359 if (strcmp(action
, "always") != 0) {
360 if (registry
!= NULL
&& registry
!= Py_None
&&
361 PyDict_SetItem(registry
, key
, Py_True
) < 0)
363 else if (strcmp(action
, "ignore") == 0)
365 else if (strcmp(action
, "once") == 0) {
366 if (registry
== NULL
|| registry
== Py_None
) {
367 registry
= get_once_registry();
368 if (registry
== NULL
)
371 /* _once_registry[(text, category)] = 1 */
372 rc
= update_registry(registry
, text
, category
, 0);
374 else if (strcmp(action
, "module") == 0) {
375 /* registry[(text, category, 0)] = 1 */
376 if (registry
!= NULL
&& registry
!= Py_None
)
377 rc
= update_registry(registry
, text
, category
, 0);
379 else if (strcmp(action
, "default") != 0) {
380 PyObject
*to_str
= PyObject_Str(item
);
381 const char *err_str
= "???";
384 err_str
= PyString_AS_STRING(to_str
);
385 PyErr_Format(PyExc_RuntimeError
,
386 "Unrecognized action (%s) in warnings.filters:\n %s",
393 if (rc
== 1) /* Already warned for this module. */
396 PyObject
*show_fxn
= get_warnings_attr("showwarning");
397 if (show_fxn
== NULL
) {
398 if (PyErr_Occurred())
400 show_warning(filename
, lineno
, text
, category
, sourceline
);
405 if (!PyMethod_Check(show_fxn
) && !PyFunction_Check(show_fxn
)) {
406 PyErr_SetString(PyExc_TypeError
,
407 "warnings.showwarning() must be set to a "
408 "function or method");
413 res
= PyObject_CallFunctionObjArgs(show_fxn
, message
, category
,
414 filename
, lineno_obj
,
422 else /* if (rc == -1) */
432 Py_XDECREF(lineno_obj
);
435 return result
; /* Py_None or NULL. */
438 /* filename, module, and registry are new refs, globals is borrowed */
439 /* Returns 0 on error (no new refs), 1 on success */
441 setup_context(Py_ssize_t stack_level
, PyObject
**filename
, int *lineno
,
442 PyObject
**module
, PyObject
**registry
)
446 /* Setup globals and lineno. */
447 PyFrameObject
*f
= PyThreadState_GET()->frame
;
448 while (--stack_level
> 0 && f
!= NULL
)
452 globals
= PyThreadState_Get()->interp
->sysdict
;
456 globals
= f
->f_globals
;
457 *lineno
= PyCode_Addr2Line(f
->f_code
, f
->f_lasti
);
462 /* Setup registry. */
463 assert(globals
!= NULL
);
464 assert(PyDict_Check(globals
));
465 *registry
= PyDict_GetItemString(globals
, "__warningregistry__");
466 if (*registry
== NULL
) {
469 *registry
= PyDict_New();
470 if (*registry
== NULL
)
473 rc
= PyDict_SetItemString(globals
, "__warningregistry__", *registry
);
478 Py_INCREF(*registry
);
481 *module
= PyDict_GetItemString(globals
, "__name__");
482 if (*module
== NULL
) {
483 *module
= PyString_FromString("<string>");
490 /* Setup filename. */
491 *filename
= PyDict_GetItemString(globals
, "__file__");
492 if (*filename
!= NULL
) {
493 Py_ssize_t len
= PyString_Size(*filename
);
494 const char *file_str
= PyString_AsString(*filename
);
495 if (file_str
== NULL
|| (len
< 0 && PyErr_Occurred()))
498 /* if filename.lower().endswith((".pyc", ".pyo")): */
500 file_str
[len
-4] == '.' &&
501 tolower(file_str
[len
-3]) == 'p' &&
502 tolower(file_str
[len
-2]) == 'y' &&
503 (tolower(file_str
[len
-1]) == 'c' ||
504 tolower(file_str
[len
-1]) == 'o'))
506 *filename
= PyString_FromStringAndSize(file_str
, len
-1);
507 if (*filename
== NULL
)
511 Py_INCREF(*filename
);
514 const char *module_str
= PyString_AsString(*module
);
515 if (module_str
&& strcmp(module_str
, "__main__") == 0) {
516 PyObject
*argv
= PySys_GetObject("argv");
517 if (argv
!= NULL
&& PyList_Size(argv
) > 0) {
519 *filename
= PyList_GetItem(argv
, 0);
520 Py_INCREF(*filename
);
521 /* If sys.argv[0] is false, then use '__main__'. */
522 is_true
= PyObject_IsTrue(*filename
);
524 Py_DECREF(*filename
);
528 Py_DECREF(*filename
);
529 *filename
= PyString_FromString("__main__");
530 if (*filename
== NULL
)
535 /* embedded interpreters don't have sys.argv, see bug #839151 */
536 *filename
= PyString_FromString("__main__");
537 if (*filename
== NULL
)
541 if (*filename
== NULL
) {
543 Py_INCREF(*filename
);
550 /* filename not XDECREF'ed here as there is no way to jump here with a
551 dangling reference. */
552 Py_XDECREF(*registry
);
558 get_category(PyObject
*message
, PyObject
*category
)
563 rc
= PyObject_IsInstance(message
, PyExc_Warning
);
568 category
= (PyObject
*)message
->ob_type
;
569 else if (category
== NULL
)
570 category
= PyExc_UserWarning
;
572 /* Validate category. */
573 rc
= PyObject_IsSubclass(category
, PyExc_Warning
);
577 PyErr_SetString(PyExc_ValueError
,
578 "category is not a subclass of Warning");
586 do_warn(PyObject
*message
, PyObject
*category
, Py_ssize_t stack_level
)
588 PyObject
*filename
, *module
, *registry
, *res
;
591 if (!setup_context(stack_level
, &filename
, &lineno
, &module
, ®istry
))
594 res
= warn_explicit(category
, message
, filename
, lineno
, module
, registry
,
603 warnings_warn(PyObject
*self
, PyObject
*args
, PyObject
*kwds
)
605 static char *kw_list
[] = { "message", "category", "stacklevel", 0 };
606 PyObject
*message
, *category
= NULL
;
607 Py_ssize_t stack_level
= 1;
609 if (!PyArg_ParseTupleAndKeywords(args
, kwds
, "O|On:warn", kw_list
,
610 &message
, &category
, &stack_level
))
613 category
= get_category(message
, category
);
614 if (category
== NULL
)
616 return do_warn(message
, category
, stack_level
);
620 warnings_warn_explicit(PyObject
*self
, PyObject
*args
, PyObject
*kwds
)
622 static char *kwd_list
[] = {"message", "category", "filename", "lineno",
623 "module", "registry", "module_globals", 0};
628 PyObject
*module
= NULL
;
629 PyObject
*registry
= NULL
;
630 PyObject
*module_globals
= NULL
;
632 if (!PyArg_ParseTupleAndKeywords(args
, kwds
, "OOOi|OOO:warn_explicit",
633 kwd_list
, &message
, &category
, &filename
, &lineno
, &module
,
634 ®istry
, &module_globals
))
637 if (module_globals
) {
638 static PyObject
*get_source_name
= NULL
;
639 static PyObject
*splitlines_name
= NULL
;
641 PyObject
*module_name
;
643 PyObject
*source_list
;
644 PyObject
*source_line
;
647 if (get_source_name
== NULL
) {
648 get_source_name
= PyString_InternFromString("get_source");
649 if (!get_source_name
)
652 if (splitlines_name
== NULL
) {
653 splitlines_name
= PyString_InternFromString("splitlines");
654 if (!splitlines_name
)
658 /* Check/get the requisite pieces needed for the loader. */
659 loader
= PyDict_GetItemString(module_globals
, "__loader__");
660 module_name
= PyDict_GetItemString(module_globals
, "__name__");
662 if (loader
== NULL
|| module_name
== NULL
)
665 /* Make sure the loader implements the optional get_source() method. */
666 if (!PyObject_HasAttrString(loader
, "get_source"))
668 /* Call get_source() to get the source code. */
669 source
= PyObject_CallMethodObjArgs(loader
, get_source_name
,
673 else if (source
== Py_None
) {
678 /* Split the source into lines. */
679 source_list
= PyObject_CallMethodObjArgs(source
, splitlines_name
,
685 /* Get the source line. */
686 source_line
= PyList_GetItem(source_list
, lineno
-1);
688 Py_DECREF(source_list
);
692 /* Handle the warning. */
693 returned
= warn_explicit(category
, message
, filename
, lineno
, module
,
694 registry
, source_line
);
695 Py_DECREF(source_list
);
700 return warn_explicit(category
, message
, filename
, lineno
, module
,
705 /* Function to issue a warning message; may raise an exception. */
707 PyErr_WarnEx(PyObject
*category
, const char *text
, Py_ssize_t stack_level
)
710 PyObject
*message
= PyString_FromString(text
);
714 if (category
== NULL
)
715 category
= PyExc_RuntimeWarning
;
717 res
= do_warn(message
, category
, stack_level
);
726 /* PyErr_Warn is only for backwards compatability and will be removed.
727 Use PyErr_WarnEx instead. */
732 PyErr_Warn(PyObject
*category
, char *text
)
734 return PyErr_WarnEx(category
, text
, 1);
737 /* Warning with explicit origin */
739 PyErr_WarnExplicit(PyObject
*category
, const char *text
,
740 const char *filename_str
, int lineno
,
741 const char *module_str
, PyObject
*registry
)
744 PyObject
*message
= PyString_FromString(text
);
745 PyObject
*filename
= PyString_FromString(filename_str
);
746 PyObject
*module
= NULL
;
749 if (message
== NULL
|| filename
== NULL
)
751 if (module_str
!= NULL
) {
752 module
= PyString_FromString(module_str
);
757 if (category
== NULL
)
758 category
= PyExc_RuntimeWarning
;
759 res
= warn_explicit(category
, message
, filename
, lineno
, module
, registry
,
769 Py_XDECREF(filename
);
774 PyDoc_STRVAR(warn_doc
,
775 "Issue a warning, or maybe ignore it or raise an exception.");
777 PyDoc_STRVAR(warn_explicit_doc
,
778 "Low-level inferface to warnings functionality.");
780 static PyMethodDef warnings_functions
[] = {
781 {"warn", (PyCFunction
)warnings_warn
, METH_VARARGS
| METH_KEYWORDS
,
783 {"warn_explicit", (PyCFunction
)warnings_warn_explicit
,
784 METH_VARARGS
| METH_KEYWORDS
, warn_explicit_doc
},
785 /* XXX(brett.cannon): add showwarning? */
786 /* XXX(brett.cannon): Reasonable to add formatwarning? */
787 {NULL
, NULL
} /* sentinel */
792 create_filter(PyObject
*category
, const char *action
)
794 static PyObject
*ignore_str
= NULL
;
795 static PyObject
*error_str
= NULL
;
796 static PyObject
*default_str
= NULL
;
797 PyObject
*action_obj
= NULL
;
798 PyObject
*lineno
, *result
;
800 if (!strcmp(action
, "ignore")) {
801 if (ignore_str
== NULL
) {
802 ignore_str
= PyString_InternFromString("ignore");
803 if (ignore_str
== NULL
)
806 action_obj
= ignore_str
;
808 else if (!strcmp(action
, "error")) {
809 if (error_str
== NULL
) {
810 error_str
= PyString_InternFromString("error");
811 if (error_str
== NULL
)
814 action_obj
= error_str
;
816 else if (!strcmp(action
, "default")) {
817 if (default_str
== NULL
) {
818 default_str
= PyString_InternFromString("default");
819 if (default_str
== NULL
)
822 action_obj
= default_str
;
825 Py_FatalError("unknown action");
828 /* This assumes the line number is zero for now. */
829 lineno
= PyInt_FromLong(0);
832 result
= PyTuple_Pack(5, action_obj
, Py_None
, category
, Py_None
, lineno
);
840 PyObject
*filters
= PyList_New(3);
841 const char *bytes_action
;
845 PyList_SET_ITEM(filters
, 0,
846 create_filter(PyExc_PendingDeprecationWarning
, "ignore"));
847 PyList_SET_ITEM(filters
, 1, create_filter(PyExc_ImportWarning
, "ignore"));
848 if (Py_BytesWarningFlag
> 1)
849 bytes_action
= "error";
850 else if (Py_BytesWarningFlag
)
851 bytes_action
= "default";
853 bytes_action
= "ignore";
854 PyList_SET_ITEM(filters
, 2, create_filter(PyExc_BytesWarning
,
857 if (PyList_GET_ITEM(filters
, 0) == NULL
||
858 PyList_GET_ITEM(filters
, 1) == NULL
||
859 PyList_GET_ITEM(filters
, 2) == NULL
) {
869 _PyWarnings_Init(void)
873 m
= Py_InitModule3(MODULE_NAME
, warnings_functions
, warnings__doc__
);
877 _filters
= init_filters();
878 if (_filters
== NULL
)
881 if (PyModule_AddObject(m
, "filters", _filters
) < 0)
884 _once_registry
= PyDict_New();
885 if (_once_registry
== NULL
)
887 Py_INCREF(_once_registry
);
888 if (PyModule_AddObject(m
, "once_registry", _once_registry
) < 0)
891 _default_action
= PyString_FromString("default");
892 if (_default_action
== NULL
)
894 if (PyModule_AddObject(m
, "default_action", _default_action
) < 0)