blob: e4850a448f0b78921b65fde7be83b5a8b0d9845c [file] [log] [blame]
Brett Cannone9746892008-04-12 23:44:07 +00001from contextlib import contextmanager
Brett Cannon905c31c2007-12-20 10:09:52 +00002import linecache
Raymond Hettingerdc9dcf12003-07-13 06:15:11 +00003import os
Brett Cannon905c31c2007-12-20 10:09:52 +00004import StringIO
Brett Cannon855da6c2007-08-17 20:16:15 +00005import sys
Raymond Hettingerd6f6e502003-07-13 08:37:40 +00006import unittest
Philip Jenveyaebbaeb2010-04-06 23:24:45 +00007import subprocess
Raymond Hettingerd6f6e502003-07-13 08:37:40 +00008from test import test_support
Antoine Pitrou9c9e1b92010-11-10 14:03:31 +00009from test.script_helper import assert_python_ok
Jeremy Hylton85014662003-07-11 15:37:59 +000010
Walter Dörwalde1a9b422007-04-03 16:53:43 +000011import warning_tests
12
Brett Cannon667bb4f2008-04-13 02:42:36 +000013import warnings as original_warnings
14
Nick Coghlan5533ff62009-04-22 15:26:04 +000015py_warnings = test_support.import_fresh_module('warnings', blocked=['_warnings'])
16c_warnings = test_support.import_fresh_module('warnings', fresh=['_warnings'])
Brett Cannon667bb4f2008-04-13 02:42:36 +000017
Brett Cannone9746892008-04-12 23:44:07 +000018@contextmanager
19def warnings_state(module):
20 """Use a specific warnings implementation in warning_tests."""
21 global __warningregistry__
22 for to_clear in (sys, warning_tests):
23 try:
24 to_clear.__warningregistry__.clear()
25 except AttributeError:
26 pass
27 try:
28 __warningregistry__.clear()
29 except NameError:
30 pass
31 original_warnings = warning_tests.warnings
Florent Xiclunafd37dd42010-03-25 20:39:10 +000032 original_filters = module.filters
Brett Cannone9746892008-04-12 23:44:07 +000033 try:
Florent Xiclunafd37dd42010-03-25 20:39:10 +000034 module.filters = original_filters[:]
35 module.simplefilter("once")
Brett Cannone9746892008-04-12 23:44:07 +000036 warning_tests.warnings = module
37 yield
38 finally:
39 warning_tests.warnings = original_warnings
Florent Xiclunafd37dd42010-03-25 20:39:10 +000040 module.filters = original_filters
Brett Cannone9746892008-04-12 23:44:07 +000041
42
Brett Cannon667bb4f2008-04-13 02:42:36 +000043class BaseTest(unittest.TestCase):
Brett Cannone9746892008-04-12 23:44:07 +000044
Brett Cannon667bb4f2008-04-13 02:42:36 +000045 """Basic bookkeeping required for testing."""
Brett Cannone9746892008-04-12 23:44:07 +000046
47 def setUp(self):
Brett Cannon667bb4f2008-04-13 02:42:36 +000048 # The __warningregistry__ needs to be in a pristine state for tests
49 # to work properly.
50 if '__warningregistry__' in globals():
51 del globals()['__warningregistry__']
52 if hasattr(warning_tests, '__warningregistry__'):
53 del warning_tests.__warningregistry__
54 if hasattr(sys, '__warningregistry__'):
55 del sys.__warningregistry__
56 # The 'warnings' module must be explicitly set so that the proper
57 # interaction between _warnings and 'warnings' can be controlled.
58 sys.modules['warnings'] = self.module
59 super(BaseTest, self).setUp()
60
61 def tearDown(self):
62 sys.modules['warnings'] = original_warnings
63 super(BaseTest, self).tearDown()
64
65
66class FilterTests(object):
67
68 """Testing the filtering functionality."""
Brett Cannone9746892008-04-12 23:44:07 +000069
70 def test_error(self):
Brett Cannon672237d2008-09-09 00:49:16 +000071 with original_warnings.catch_warnings(module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +000072 self.module.resetwarnings()
73 self.module.filterwarnings("error", category=UserWarning)
74 self.assertRaises(UserWarning, self.module.warn,
75 "FilterTests.test_error")
76
77 def test_ignore(self):
Brett Cannon672237d2008-09-09 00:49:16 +000078 with original_warnings.catch_warnings(record=True,
79 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +000080 self.module.resetwarnings()
81 self.module.filterwarnings("ignore", category=UserWarning)
82 self.module.warn("FilterTests.test_ignore", UserWarning)
Ezio Melotti2623a372010-11-21 13:34:58 +000083 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +000084
85 def test_always(self):
Brett Cannon672237d2008-09-09 00:49:16 +000086 with original_warnings.catch_warnings(record=True,
87 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +000088 self.module.resetwarnings()
89 self.module.filterwarnings("always", category=UserWarning)
90 message = "FilterTests.test_always"
91 self.module.warn(message, UserWarning)
Benjamin Peterson5c8da862009-06-30 22:57:08 +000092 self.assertTrue(message, w[-1].message)
Brett Cannone9746892008-04-12 23:44:07 +000093 self.module.warn(message, UserWarning)
Benjamin Peterson5c8da862009-06-30 22:57:08 +000094 self.assertTrue(w[-1].message, message)
Brett Cannone9746892008-04-12 23:44:07 +000095
96 def test_default(self):
Brett Cannon672237d2008-09-09 00:49:16 +000097 with original_warnings.catch_warnings(record=True,
98 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +000099 self.module.resetwarnings()
100 self.module.filterwarnings("default", category=UserWarning)
101 message = UserWarning("FilterTests.test_default")
102 for x in xrange(2):
103 self.module.warn(message, UserWarning)
104 if x == 0:
Ezio Melotti2623a372010-11-21 13:34:58 +0000105 self.assertEqual(w[-1].message, message)
Brett Cannon672237d2008-09-09 00:49:16 +0000106 del w[:]
Brett Cannone9746892008-04-12 23:44:07 +0000107 elif x == 1:
Ezio Melotti2623a372010-11-21 13:34:58 +0000108 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000109 else:
110 raise ValueError("loop variant unhandled")
111
112 def test_module(self):
Brett Cannon672237d2008-09-09 00:49:16 +0000113 with original_warnings.catch_warnings(record=True,
114 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000115 self.module.resetwarnings()
116 self.module.filterwarnings("module", category=UserWarning)
117 message = UserWarning("FilterTests.test_module")
118 self.module.warn(message, UserWarning)
Ezio Melotti2623a372010-11-21 13:34:58 +0000119 self.assertEqual(w[-1].message, message)
Brett Cannon672237d2008-09-09 00:49:16 +0000120 del w[:]
Brett Cannone9746892008-04-12 23:44:07 +0000121 self.module.warn(message, UserWarning)
Ezio Melotti2623a372010-11-21 13:34:58 +0000122 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000123
124 def test_once(self):
Brett Cannon672237d2008-09-09 00:49:16 +0000125 with original_warnings.catch_warnings(record=True,
126 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000127 self.module.resetwarnings()
128 self.module.filterwarnings("once", category=UserWarning)
129 message = UserWarning("FilterTests.test_once")
130 self.module.warn_explicit(message, UserWarning, "test_warnings.py",
131 42)
Ezio Melotti2623a372010-11-21 13:34:58 +0000132 self.assertEqual(w[-1].message, message)
Brett Cannon672237d2008-09-09 00:49:16 +0000133 del w[:]
Brett Cannone9746892008-04-12 23:44:07 +0000134 self.module.warn_explicit(message, UserWarning, "test_warnings.py",
135 13)
Ezio Melotti2623a372010-11-21 13:34:58 +0000136 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000137 self.module.warn_explicit(message, UserWarning, "test_warnings2.py",
138 42)
Ezio Melotti2623a372010-11-21 13:34:58 +0000139 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000140
141 def test_inheritance(self):
Brett Cannon672237d2008-09-09 00:49:16 +0000142 with original_warnings.catch_warnings(module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000143 self.module.resetwarnings()
144 self.module.filterwarnings("error", category=Warning)
145 self.assertRaises(UserWarning, self.module.warn,
146 "FilterTests.test_inheritance", UserWarning)
147
148 def test_ordering(self):
Brett Cannon672237d2008-09-09 00:49:16 +0000149 with original_warnings.catch_warnings(record=True,
150 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000151 self.module.resetwarnings()
152 self.module.filterwarnings("ignore", category=UserWarning)
153 self.module.filterwarnings("error", category=UserWarning,
154 append=True)
Brett Cannon672237d2008-09-09 00:49:16 +0000155 del w[:]
Brett Cannone9746892008-04-12 23:44:07 +0000156 try:
157 self.module.warn("FilterTests.test_ordering", UserWarning)
158 except UserWarning:
159 self.fail("order handling for actions failed")
Ezio Melotti2623a372010-11-21 13:34:58 +0000160 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000161
162 def test_filterwarnings(self):
163 # Test filterwarnings().
164 # Implicitly also tests resetwarnings().
Brett Cannon672237d2008-09-09 00:49:16 +0000165 with original_warnings.catch_warnings(record=True,
166 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000167 self.module.filterwarnings("error", "", Warning, "", 0)
168 self.assertRaises(UserWarning, self.module.warn, 'convert to error')
169
170 self.module.resetwarnings()
171 text = 'handle normally'
172 self.module.warn(text)
Brett Cannon672237d2008-09-09 00:49:16 +0000173 self.assertEqual(str(w[-1].message), text)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000174 self.assertTrue(w[-1].category is UserWarning)
Brett Cannone9746892008-04-12 23:44:07 +0000175
176 self.module.filterwarnings("ignore", "", Warning, "", 0)
177 text = 'filtered out'
178 self.module.warn(text)
Brett Cannon672237d2008-09-09 00:49:16 +0000179 self.assertNotEqual(str(w[-1].message), text)
Brett Cannone9746892008-04-12 23:44:07 +0000180
181 self.module.resetwarnings()
182 self.module.filterwarnings("error", "hex*", Warning, "", 0)
183 self.assertRaises(UserWarning, self.module.warn, 'hex/oct')
184 text = 'nonmatching text'
185 self.module.warn(text)
Brett Cannon672237d2008-09-09 00:49:16 +0000186 self.assertEqual(str(w[-1].message), text)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000187 self.assertTrue(w[-1].category is UserWarning)
Brett Cannone9746892008-04-12 23:44:07 +0000188
Brett Cannon667bb4f2008-04-13 02:42:36 +0000189class CFilterTests(BaseTest, FilterTests):
Brett Cannone9746892008-04-12 23:44:07 +0000190 module = c_warnings
191
Brett Cannon667bb4f2008-04-13 02:42:36 +0000192class PyFilterTests(BaseTest, FilterTests):
Brett Cannone9746892008-04-12 23:44:07 +0000193 module = py_warnings
194
195
196class WarnTests(unittest.TestCase):
197
198 """Test warnings.warn() and warnings.warn_explicit()."""
199
200 def test_message(self):
Brett Cannon672237d2008-09-09 00:49:16 +0000201 with original_warnings.catch_warnings(record=True,
202 module=self.module) as w:
Florent Xiclunafd37dd42010-03-25 20:39:10 +0000203 self.module.simplefilter("once")
Walter Dörwalde6dae6c2007-04-03 18:33:29 +0000204 for i in range(4):
Brett Cannone9746892008-04-12 23:44:07 +0000205 text = 'multi %d' %i # Different text on each call.
206 self.module.warn(text)
Brett Cannon672237d2008-09-09 00:49:16 +0000207 self.assertEqual(str(w[-1].message), text)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000208 self.assertTrue(w[-1].category is UserWarning)
Raymond Hettingerd6f6e502003-07-13 08:37:40 +0000209
Walter Dörwalde1a9b422007-04-03 16:53:43 +0000210 def test_filename(self):
Brett Cannone9746892008-04-12 23:44:07 +0000211 with warnings_state(self.module):
Brett Cannon672237d2008-09-09 00:49:16 +0000212 with original_warnings.catch_warnings(record=True,
213 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000214 warning_tests.inner("spam1")
Brett Cannon672237d2008-09-09 00:49:16 +0000215 self.assertEqual(os.path.basename(w[-1].filename),
216 "warning_tests.py")
Brett Cannone9746892008-04-12 23:44:07 +0000217 warning_tests.outer("spam2")
Brett Cannon672237d2008-09-09 00:49:16 +0000218 self.assertEqual(os.path.basename(w[-1].filename),
219 "warning_tests.py")
Walter Dörwalde1a9b422007-04-03 16:53:43 +0000220
221 def test_stacklevel(self):
222 # Test stacklevel argument
223 # make sure all messages are different, so the warning won't be skipped
Brett Cannone9746892008-04-12 23:44:07 +0000224 with warnings_state(self.module):
Brett Cannon672237d2008-09-09 00:49:16 +0000225 with original_warnings.catch_warnings(record=True,
226 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000227 warning_tests.inner("spam3", stacklevel=1)
Brett Cannon672237d2008-09-09 00:49:16 +0000228 self.assertEqual(os.path.basename(w[-1].filename),
229 "warning_tests.py")
Brett Cannone9746892008-04-12 23:44:07 +0000230 warning_tests.outer("spam4", stacklevel=1)
Brett Cannon672237d2008-09-09 00:49:16 +0000231 self.assertEqual(os.path.basename(w[-1].filename),
232 "warning_tests.py")
Walter Dörwalde1a9b422007-04-03 16:53:43 +0000233
Brett Cannone9746892008-04-12 23:44:07 +0000234 warning_tests.inner("spam5", stacklevel=2)
Brett Cannon672237d2008-09-09 00:49:16 +0000235 self.assertEqual(os.path.basename(w[-1].filename),
236 "test_warnings.py")
Brett Cannone9746892008-04-12 23:44:07 +0000237 warning_tests.outer("spam6", stacklevel=2)
Brett Cannon672237d2008-09-09 00:49:16 +0000238 self.assertEqual(os.path.basename(w[-1].filename),
239 "warning_tests.py")
Brett Cannone3dcb012008-05-06 04:37:31 +0000240 warning_tests.outer("spam6.5", stacklevel=3)
Brett Cannon672237d2008-09-09 00:49:16 +0000241 self.assertEqual(os.path.basename(w[-1].filename),
242 "test_warnings.py")
Walter Dörwalde1a9b422007-04-03 16:53:43 +0000243
Brett Cannone9746892008-04-12 23:44:07 +0000244 warning_tests.inner("spam7", stacklevel=9999)
Brett Cannon672237d2008-09-09 00:49:16 +0000245 self.assertEqual(os.path.basename(w[-1].filename),
246 "sys")
Brett Cannone9746892008-04-12 23:44:07 +0000247
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000248 def test_missing_filename_not_main(self):
249 # If __file__ is not specified and __main__ is not the module name,
250 # then __file__ should be set to the module name.
251 filename = warning_tests.__file__
252 try:
253 del warning_tests.__file__
254 with warnings_state(self.module):
Brett Cannon672237d2008-09-09 00:49:16 +0000255 with original_warnings.catch_warnings(record=True,
256 module=self.module) as w:
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000257 warning_tests.inner("spam8", stacklevel=1)
Brett Cannon672237d2008-09-09 00:49:16 +0000258 self.assertEqual(w[-1].filename, warning_tests.__name__)
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000259 finally:
260 warning_tests.__file__ = filename
261
Serhiy Storchaka32e23e72013-11-03 23:15:46 +0200262 @unittest.skipUnless(hasattr(sys, 'argv'), 'test needs sys.argv')
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000263 def test_missing_filename_main_with_argv(self):
264 # If __file__ is not specified and the caller is __main__ and sys.argv
265 # exists, then use sys.argv[0] as the file.
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000266 filename = warning_tests.__file__
267 module_name = warning_tests.__name__
268 try:
269 del warning_tests.__file__
270 warning_tests.__name__ = '__main__'
271 with warnings_state(self.module):
Brett Cannon672237d2008-09-09 00:49:16 +0000272 with original_warnings.catch_warnings(record=True,
273 module=self.module) as w:
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000274 warning_tests.inner('spam9', stacklevel=1)
Brett Cannon672237d2008-09-09 00:49:16 +0000275 self.assertEqual(w[-1].filename, sys.argv[0])
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000276 finally:
277 warning_tests.__file__ = filename
278 warning_tests.__name__ = module_name
279
280 def test_missing_filename_main_without_argv(self):
281 # If __file__ is not specified, the caller is __main__, and sys.argv
282 # is not set, then '__main__' is the file name.
283 filename = warning_tests.__file__
284 module_name = warning_tests.__name__
285 argv = sys.argv
286 try:
287 del warning_tests.__file__
288 warning_tests.__name__ = '__main__'
289 del sys.argv
290 with warnings_state(self.module):
Brett Cannon672237d2008-09-09 00:49:16 +0000291 with original_warnings.catch_warnings(record=True,
292 module=self.module) as w:
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000293 warning_tests.inner('spam10', stacklevel=1)
Brett Cannon672237d2008-09-09 00:49:16 +0000294 self.assertEqual(w[-1].filename, '__main__')
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000295 finally:
296 warning_tests.__file__ = filename
297 warning_tests.__name__ = module_name
298 sys.argv = argv
299
300 def test_missing_filename_main_with_argv_empty_string(self):
301 # If __file__ is not specified, the caller is __main__, and sys.argv[0]
302 # is the empty string, then '__main__ is the file name.
303 # Tests issue 2743.
304 file_name = warning_tests.__file__
305 module_name = warning_tests.__name__
306 argv = sys.argv
307 try:
308 del warning_tests.__file__
309 warning_tests.__name__ = '__main__'
310 sys.argv = ['']
311 with warnings_state(self.module):
Brett Cannon672237d2008-09-09 00:49:16 +0000312 with original_warnings.catch_warnings(record=True,
313 module=self.module) as w:
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000314 warning_tests.inner('spam11', stacklevel=1)
Brett Cannon672237d2008-09-09 00:49:16 +0000315 self.assertEqual(w[-1].filename, '__main__')
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000316 finally:
317 warning_tests.__file__ = file_name
318 warning_tests.__name__ = module_name
319 sys.argv = argv
320
Brett Cannondea1b562008-06-27 00:31:13 +0000321 def test_warn_explicit_type_errors(self):
Ezio Melottic2077b02011-03-16 12:34:31 +0200322 # warn_explicit() should error out gracefully if it is given objects
Brett Cannondea1b562008-06-27 00:31:13 +0000323 # of the wrong types.
324 # lineno is expected to be an integer.
325 self.assertRaises(TypeError, self.module.warn_explicit,
326 None, UserWarning, None, None)
327 # Either 'message' needs to be an instance of Warning or 'category'
328 # needs to be a subclass.
329 self.assertRaises(TypeError, self.module.warn_explicit,
330 None, None, None, 1)
331 # 'registry' must be a dict or None.
332 self.assertRaises((TypeError, AttributeError),
333 self.module.warn_explicit,
334 None, Warning, None, 1, registry=42)
335
Hirokazu Yamamotoe78e5d22009-07-17 06:20:46 +0000336 def test_bad_str(self):
337 # issue 6415
338 # Warnings instance with a bad format string for __str__ should not
339 # trigger a bus error.
340 class BadStrWarning(Warning):
341 """Warning with a bad format string for __str__."""
342 def __str__(self):
343 return ("A bad formatted string %(err)" %
344 {"err" : "there is no %(err)s"})
345
346 with self.assertRaises(ValueError):
347 self.module.warn(BadStrWarning())
348
Brett Cannon64a4bbe2008-05-03 03:19:39 +0000349
Brett Cannon667bb4f2008-04-13 02:42:36 +0000350class CWarnTests(BaseTest, WarnTests):
Brett Cannone9746892008-04-12 23:44:07 +0000351 module = c_warnings
352
Nick Coghlancd2e7042009-04-11 13:31:31 +0000353 # As an early adopter, we sanity check the
354 # test_support.import_fresh_module utility function
355 def test_accelerated(self):
356 self.assertFalse(original_warnings is self.module)
357 self.assertFalse(hasattr(self.module.warn, 'func_code'))
358
Brett Cannon667bb4f2008-04-13 02:42:36 +0000359class PyWarnTests(BaseTest, WarnTests):
Brett Cannone9746892008-04-12 23:44:07 +0000360 module = py_warnings
361
Nick Coghlancd2e7042009-04-11 13:31:31 +0000362 # As an early adopter, we sanity check the
363 # test_support.import_fresh_module utility function
364 def test_pure_python(self):
365 self.assertFalse(original_warnings is self.module)
366 self.assertTrue(hasattr(self.module.warn, 'func_code'))
367
Brett Cannone9746892008-04-12 23:44:07 +0000368
369class WCmdLineTests(unittest.TestCase):
370
371 def test_improper_input(self):
372 # Uses the private _setoption() function to test the parsing
373 # of command-line warning arguments
Brett Cannon672237d2008-09-09 00:49:16 +0000374 with original_warnings.catch_warnings(module=self.module):
Brett Cannone9746892008-04-12 23:44:07 +0000375 self.assertRaises(self.module._OptionError,
376 self.module._setoption, '1:2:3:4:5:6')
377 self.assertRaises(self.module._OptionError,
378 self.module._setoption, 'bogus::Warning')
379 self.assertRaises(self.module._OptionError,
380 self.module._setoption, 'ignore:2::4:-5')
381 self.module._setoption('error::Warning::0')
382 self.assertRaises(UserWarning, self.module.warn, 'convert to error')
383
Antoine Pitrou9c9e1b92010-11-10 14:03:31 +0000384 def test_improper_option(self):
385 # Same as above, but check that the message is printed out when
386 # the interpreter is executed. This also checks that options are
387 # actually parsed at all.
388 rc, out, err = assert_python_ok("-Wxxx", "-c", "pass")
389 self.assertIn(b"Invalid -W option ignored: invalid action: 'xxx'", err)
390
391 def test_warnings_bootstrap(self):
392 # Check that the warnings module does get loaded when -W<some option>
393 # is used (see issue #10372 for an example of silent bootstrap failure).
394 rc, out, err = assert_python_ok("-Wi", "-c",
395 "import sys; sys.modules['warnings'].warn('foo', RuntimeWarning)")
396 # '-Wi' was observed
397 self.assertFalse(out.strip())
398 self.assertNotIn(b'RuntimeWarning', err)
399
Brett Cannon667bb4f2008-04-13 02:42:36 +0000400class CWCmdLineTests(BaseTest, WCmdLineTests):
Brett Cannone9746892008-04-12 23:44:07 +0000401 module = c_warnings
402
Brett Cannon667bb4f2008-04-13 02:42:36 +0000403class PyWCmdLineTests(BaseTest, WCmdLineTests):
Brett Cannone9746892008-04-12 23:44:07 +0000404 module = py_warnings
405
406
Brett Cannon667bb4f2008-04-13 02:42:36 +0000407class _WarningsTests(BaseTest):
Brett Cannone9746892008-04-12 23:44:07 +0000408
409 """Tests specific to the _warnings module."""
410
411 module = c_warnings
412
413 def test_filter(self):
414 # Everything should function even if 'filters' is not in warnings.
Brett Cannon672237d2008-09-09 00:49:16 +0000415 with original_warnings.catch_warnings(module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000416 self.module.filterwarnings("error", "", Warning, "", 0)
417 self.assertRaises(UserWarning, self.module.warn,
418 'convert to error')
419 del self.module.filters
420 self.assertRaises(UserWarning, self.module.warn,
421 'convert to error')
422
423 def test_onceregistry(self):
424 # Replacing or removing the onceregistry should be okay.
425 global __warningregistry__
426 message = UserWarning('onceregistry test')
427 try:
428 original_registry = self.module.onceregistry
429 __warningregistry__ = {}
Brett Cannon672237d2008-09-09 00:49:16 +0000430 with original_warnings.catch_warnings(record=True,
431 module=self.module) as w:
Brett Cannone9746892008-04-12 23:44:07 +0000432 self.module.resetwarnings()
433 self.module.filterwarnings("once", category=UserWarning)
434 self.module.warn_explicit(message, UserWarning, "file", 42)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000435 self.assertEqual(w[-1].message, message)
Brett Cannon672237d2008-09-09 00:49:16 +0000436 del w[:]
Brett Cannone9746892008-04-12 23:44:07 +0000437 self.module.warn_explicit(message, UserWarning, "file", 42)
Ezio Melotti2623a372010-11-21 13:34:58 +0000438 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000439 # Test the resetting of onceregistry.
440 self.module.onceregistry = {}
441 __warningregistry__ = {}
442 self.module.warn('onceregistry test')
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000443 self.assertEqual(w[-1].message.args, message.args)
Brett Cannone9746892008-04-12 23:44:07 +0000444 # Removal of onceregistry is okay.
Brett Cannon672237d2008-09-09 00:49:16 +0000445 del w[:]
Brett Cannone9746892008-04-12 23:44:07 +0000446 del self.module.onceregistry
447 __warningregistry__ = {}
448 self.module.warn_explicit(message, UserWarning, "file", 42)
Ezio Melotti2623a372010-11-21 13:34:58 +0000449 self.assertEqual(len(w), 0)
Brett Cannone9746892008-04-12 23:44:07 +0000450 finally:
451 self.module.onceregistry = original_registry
452
Brett Cannon15ba4da2009-04-01 18:03:59 +0000453 def test_default_action(self):
454 # Replacing or removing defaultaction should be okay.
455 message = UserWarning("defaultaction test")
456 original = self.module.defaultaction
457 try:
458 with original_warnings.catch_warnings(record=True,
459 module=self.module) as w:
460 self.module.resetwarnings()
461 registry = {}
462 self.module.warn_explicit(message, UserWarning, "<test>", 42,
463 registry=registry)
464 self.assertEqual(w[-1].message, message)
465 self.assertEqual(len(w), 1)
466 self.assertEqual(len(registry), 1)
467 del w[:]
468 # Test removal.
469 del self.module.defaultaction
470 __warningregistry__ = {}
471 registry = {}
472 self.module.warn_explicit(message, UserWarning, "<test>", 43,
473 registry=registry)
474 self.assertEqual(w[-1].message, message)
475 self.assertEqual(len(w), 1)
476 self.assertEqual(len(registry), 1)
477 del w[:]
478 # Test setting.
479 self.module.defaultaction = "ignore"
480 __warningregistry__ = {}
481 registry = {}
482 self.module.warn_explicit(message, UserWarning, "<test>", 44,
483 registry=registry)
484 self.assertEqual(len(w), 0)
485 finally:
486 self.module.defaultaction = original
487
Brett Cannone9746892008-04-12 23:44:07 +0000488 def test_showwarning_missing(self):
489 # Test that showwarning() missing is okay.
490 text = 'del showwarning test'
Brett Cannon672237d2008-09-09 00:49:16 +0000491 with original_warnings.catch_warnings(module=self.module):
Brett Cannone9746892008-04-12 23:44:07 +0000492 self.module.filterwarnings("always", category=UserWarning)
493 del self.module.showwarning
494 with test_support.captured_output('stderr') as stream:
495 self.module.warn(text)
496 result = stream.getvalue()
Ezio Melottiaa980582010-01-23 23:04:36 +0000497 self.assertIn(text, result)
Brett Cannone9746892008-04-12 23:44:07 +0000498
Benjamin Petersond2950322008-05-06 22:18:11 +0000499 def test_showwarning_not_callable(self):
Brett Cannonce3d2212009-04-01 20:25:48 +0000500 with original_warnings.catch_warnings(module=self.module):
501 self.module.filterwarnings("always", category=UserWarning)
502 old_showwarning = self.module.showwarning
503 self.module.showwarning = 23
504 try:
505 self.assertRaises(TypeError, self.module.warn, "Warning!")
506 finally:
507 self.module.showwarning = old_showwarning
Benjamin Petersond2950322008-05-06 22:18:11 +0000508
Brett Cannone9746892008-04-12 23:44:07 +0000509 def test_show_warning_output(self):
510 # With showarning() missing, make sure that output is okay.
511 text = 'test show_warning'
Brett Cannon672237d2008-09-09 00:49:16 +0000512 with original_warnings.catch_warnings(module=self.module):
Brett Cannone9746892008-04-12 23:44:07 +0000513 self.module.filterwarnings("always", category=UserWarning)
514 del self.module.showwarning
515 with test_support.captured_output('stderr') as stream:
516 warning_tests.inner(text)
517 result = stream.getvalue()
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000518 self.assertEqual(result.count('\n'), 2,
Brett Cannone9746892008-04-12 23:44:07 +0000519 "Too many newlines in %r" % result)
520 first_line, second_line = result.split('\n', 1)
521 expected_file = os.path.splitext(warning_tests.__file__)[0] + '.py'
Brett Cannonc4774272008-04-13 17:41:31 +0000522 first_line_parts = first_line.rsplit(':', 3)
Brett Cannon25bb8182008-04-13 17:09:43 +0000523 path, line, warning_class, message = first_line_parts
Brett Cannone9746892008-04-12 23:44:07 +0000524 line = int(line)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000525 self.assertEqual(expected_file, path)
526 self.assertEqual(warning_class, ' ' + UserWarning.__name__)
527 self.assertEqual(message, ' ' + text)
Brett Cannone9746892008-04-12 23:44:07 +0000528 expected_line = ' ' + linecache.getline(path, line).strip() + '\n'
529 assert expected_line
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000530 self.assertEqual(second_line, expected_line)
Walter Dörwalde1a9b422007-04-03 16:53:43 +0000531
Victor Stinner65c15352011-07-04 03:05:37 +0200532 def test_filename_none(self):
533 # issue #12467: race condition if a warning is emitted at shutdown
534 globals_dict = globals()
535 oldfile = globals_dict['__file__']
536 try:
537 with original_warnings.catch_warnings(module=self.module) as w:
538 self.module.filterwarnings("always", category=UserWarning)
539 globals_dict['__file__'] = None
540 self.module.warn('test', UserWarning)
541 finally:
542 globals_dict['__file__'] = oldfile
543
Brett Cannon53ab5b72006-06-22 16:49:14 +0000544
Brett Cannon905c31c2007-12-20 10:09:52 +0000545class WarningsDisplayTests(unittest.TestCase):
546
Brett Cannone9746892008-04-12 23:44:07 +0000547 """Test the displaying of warnings and the ability to overload functions
548 related to displaying warnings."""
549
Brett Cannon905c31c2007-12-20 10:09:52 +0000550 def test_formatwarning(self):
551 message = "msg"
552 category = Warning
553 file_name = os.path.splitext(warning_tests.__file__)[0] + '.py'
554 line_num = 3
555 file_line = linecache.getline(file_name, line_num).strip()
Brett Cannone9746892008-04-12 23:44:07 +0000556 format = "%s:%s: %s: %s\n %s\n"
557 expect = format % (file_name, line_num, category.__name__, message,
558 file_line)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000559 self.assertEqual(expect, self.module.formatwarning(message,
Brett Cannone9746892008-04-12 23:44:07 +0000560 category, file_name, line_num))
561 # Test the 'line' argument.
562 file_line += " for the win!"
563 expect = format % (file_name, line_num, category.__name__, message,
564 file_line)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000565 self.assertEqual(expect, self.module.formatwarning(message,
Brett Cannone9746892008-04-12 23:44:07 +0000566 category, file_name, line_num, file_line))
Brett Cannon905c31c2007-12-20 10:09:52 +0000567
568 def test_showwarning(self):
569 file_name = os.path.splitext(warning_tests.__file__)[0] + '.py'
570 line_num = 3
571 expected_file_line = linecache.getline(file_name, line_num).strip()
572 message = 'msg'
573 category = Warning
574 file_object = StringIO.StringIO()
Brett Cannone9746892008-04-12 23:44:07 +0000575 expect = self.module.formatwarning(message, category, file_name,
576 line_num)
577 self.module.showwarning(message, category, file_name, line_num,
Brett Cannon905c31c2007-12-20 10:09:52 +0000578 file_object)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000579 self.assertEqual(file_object.getvalue(), expect)
Brett Cannone9746892008-04-12 23:44:07 +0000580 # Test 'line' argument.
581 expected_file_line += "for the win!"
582 expect = self.module.formatwarning(message, category, file_name,
583 line_num, expected_file_line)
584 file_object = StringIO.StringIO()
585 self.module.showwarning(message, category, file_name, line_num,
586 file_object, expected_file_line)
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000587 self.assertEqual(expect, file_object.getvalue())
Brett Cannone9746892008-04-12 23:44:07 +0000588
Brett Cannon667bb4f2008-04-13 02:42:36 +0000589class CWarningsDisplayTests(BaseTest, WarningsDisplayTests):
Brett Cannone9746892008-04-12 23:44:07 +0000590 module = c_warnings
591
Brett Cannon667bb4f2008-04-13 02:42:36 +0000592class PyWarningsDisplayTests(BaseTest, WarningsDisplayTests):
Brett Cannone9746892008-04-12 23:44:07 +0000593 module = py_warnings
Brett Cannon905c31c2007-12-20 10:09:52 +0000594
595
Brett Cannon1eaf0742008-09-02 01:25:16 +0000596class CatchWarningTests(BaseTest):
Nick Coghlan38469e22008-07-13 12:23:47 +0000597
Brett Cannon1eaf0742008-09-02 01:25:16 +0000598 """Test catch_warnings()."""
599
600 def test_catch_warnings_restore(self):
Nick Coghlan38469e22008-07-13 12:23:47 +0000601 wmod = self.module
602 orig_filters = wmod.filters
603 orig_showwarning = wmod.showwarning
Nick Coghland2e09382008-09-11 12:11:06 +0000604 # Ensure both showwarning and filters are restored when recording
605 with wmod.catch_warnings(module=wmod, record=True):
Nick Coghlan38469e22008-07-13 12:23:47 +0000606 wmod.filters = wmod.showwarning = object()
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000607 self.assertTrue(wmod.filters is orig_filters)
608 self.assertTrue(wmod.showwarning is orig_showwarning)
Nick Coghland2e09382008-09-11 12:11:06 +0000609 # Same test, but with recording disabled
Brett Cannon1eaf0742008-09-02 01:25:16 +0000610 with wmod.catch_warnings(module=wmod, record=False):
Nick Coghlan38469e22008-07-13 12:23:47 +0000611 wmod.filters = wmod.showwarning = object()
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000612 self.assertTrue(wmod.filters is orig_filters)
613 self.assertTrue(wmod.showwarning is orig_showwarning)
Nick Coghlan38469e22008-07-13 12:23:47 +0000614
Brett Cannon1eaf0742008-09-02 01:25:16 +0000615 def test_catch_warnings_recording(self):
Nick Coghlan38469e22008-07-13 12:23:47 +0000616 wmod = self.module
Nick Coghland2e09382008-09-11 12:11:06 +0000617 # Ensure warnings are recorded when requested
Brett Cannon1eaf0742008-09-02 01:25:16 +0000618 with wmod.catch_warnings(module=wmod, record=True) as w:
619 self.assertEqual(w, [])
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000620 self.assertTrue(type(w) is list)
Nick Coghlan38469e22008-07-13 12:23:47 +0000621 wmod.simplefilter("always")
622 wmod.warn("foo")
Brett Cannon672237d2008-09-09 00:49:16 +0000623 self.assertEqual(str(w[-1].message), "foo")
Nick Coghlan38469e22008-07-13 12:23:47 +0000624 wmod.warn("bar")
Brett Cannon672237d2008-09-09 00:49:16 +0000625 self.assertEqual(str(w[-1].message), "bar")
Brett Cannon1eaf0742008-09-02 01:25:16 +0000626 self.assertEqual(str(w[0].message), "foo")
627 self.assertEqual(str(w[1].message), "bar")
Brett Cannon672237d2008-09-09 00:49:16 +0000628 del w[:]
Brett Cannon1eaf0742008-09-02 01:25:16 +0000629 self.assertEqual(w, [])
Nick Coghland2e09382008-09-11 12:11:06 +0000630 # Ensure warnings are not recorded when not requested
Nick Coghlan38469e22008-07-13 12:23:47 +0000631 orig_showwarning = wmod.showwarning
Brett Cannon1eaf0742008-09-02 01:25:16 +0000632 with wmod.catch_warnings(module=wmod, record=False) as w:
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000633 self.assertTrue(w is None)
634 self.assertTrue(wmod.showwarning is orig_showwarning)
Nick Coghlan38469e22008-07-13 12:23:47 +0000635
Nick Coghland2e09382008-09-11 12:11:06 +0000636 def test_catch_warnings_reentry_guard(self):
637 wmod = self.module
638 # Ensure catch_warnings is protected against incorrect usage
639 x = wmod.catch_warnings(module=wmod, record=True)
640 self.assertRaises(RuntimeError, x.__exit__)
641 with x:
642 self.assertRaises(RuntimeError, x.__enter__)
643 # Same test, but with recording disabled
644 x = wmod.catch_warnings(module=wmod, record=False)
645 self.assertRaises(RuntimeError, x.__exit__)
646 with x:
647 self.assertRaises(RuntimeError, x.__enter__)
648
649 def test_catch_warnings_defaults(self):
650 wmod = self.module
651 orig_filters = wmod.filters
652 orig_showwarning = wmod.showwarning
653 # Ensure default behaviour is not to record warnings
654 with wmod.catch_warnings(module=wmod) as w:
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000655 self.assertTrue(w is None)
656 self.assertTrue(wmod.showwarning is orig_showwarning)
657 self.assertTrue(wmod.filters is not orig_filters)
658 self.assertTrue(wmod.filters is orig_filters)
Nick Coghland2e09382008-09-11 12:11:06 +0000659 if wmod is sys.modules['warnings']:
660 # Ensure the default module is this one
661 with wmod.catch_warnings() as w:
Benjamin Peterson5c8da862009-06-30 22:57:08 +0000662 self.assertTrue(w is None)
663 self.assertTrue(wmod.showwarning is orig_showwarning)
664 self.assertTrue(wmod.filters is not orig_filters)
665 self.assertTrue(wmod.filters is orig_filters)
Nick Coghland2e09382008-09-11 12:11:06 +0000666
667 def test_check_warnings(self):
668 # Explicit tests for the test_support convenience wrapper
669 wmod = self.module
Florent Xicluna73588542010-03-18 19:51:47 +0000670 if wmod is not sys.modules['warnings']:
671 return
672 with test_support.check_warnings(quiet=False) as w:
673 self.assertEqual(w.warnings, [])
674 wmod.simplefilter("always")
675 wmod.warn("foo")
676 self.assertEqual(str(w.message), "foo")
677 wmod.warn("bar")
678 self.assertEqual(str(w.message), "bar")
679 self.assertEqual(str(w.warnings[0].message), "foo")
680 self.assertEqual(str(w.warnings[1].message), "bar")
681 w.reset()
682 self.assertEqual(w.warnings, [])
Nick Coghland2e09382008-09-11 12:11:06 +0000683
Florent Xicluna73588542010-03-18 19:51:47 +0000684 with test_support.check_warnings():
685 # defaults to quiet=True without argument
686 pass
687 with test_support.check_warnings(('foo', UserWarning)):
688 wmod.warn("foo")
689
690 with self.assertRaises(AssertionError):
691 with test_support.check_warnings(('', RuntimeWarning)):
692 # defaults to quiet=False with argument
693 pass
694 with self.assertRaises(AssertionError):
695 with test_support.check_warnings(('foo', RuntimeWarning)):
696 wmod.warn("foo")
Nick Coghland2e09382008-09-11 12:11:06 +0000697
698
Brett Cannon1eaf0742008-09-02 01:25:16 +0000699class CCatchWarningTests(CatchWarningTests):
Nick Coghlan38469e22008-07-13 12:23:47 +0000700 module = c_warnings
701
Brett Cannon1eaf0742008-09-02 01:25:16 +0000702class PyCatchWarningTests(CatchWarningTests):
Nick Coghlan38469e22008-07-13 12:23:47 +0000703 module = py_warnings
704
705
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000706class EnvironmentVariableTests(BaseTest):
707
708 def test_single_warning(self):
709 newenv = os.environ.copy()
710 newenv["PYTHONWARNINGS"] = "ignore::DeprecationWarning"
711 p = subprocess.Popen([sys.executable,
712 "-c", "import sys; sys.stdout.write(str(sys.warnoptions))"],
713 stdout=subprocess.PIPE, env=newenv)
Philip Jenveycdd98fb2010-04-10 20:27:15 +0000714 self.assertEqual(p.communicate()[0], "['ignore::DeprecationWarning']")
715 self.assertEqual(p.wait(), 0)
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000716
717 def test_comma_separated_warnings(self):
718 newenv = os.environ.copy()
719 newenv["PYTHONWARNINGS"] = ("ignore::DeprecationWarning,"
720 "ignore::UnicodeWarning")
721 p = subprocess.Popen([sys.executable,
722 "-c", "import sys; sys.stdout.write(str(sys.warnoptions))"],
723 stdout=subprocess.PIPE, env=newenv)
Philip Jenveycdd98fb2010-04-10 20:27:15 +0000724 self.assertEqual(p.communicate()[0],
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000725 "['ignore::DeprecationWarning', 'ignore::UnicodeWarning']")
Philip Jenveycdd98fb2010-04-10 20:27:15 +0000726 self.assertEqual(p.wait(), 0)
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000727
728 def test_envvar_and_command_line(self):
729 newenv = os.environ.copy()
730 newenv["PYTHONWARNINGS"] = "ignore::DeprecationWarning"
731 p = subprocess.Popen([sys.executable, "-W" "ignore::UnicodeWarning",
732 "-c", "import sys; sys.stdout.write(str(sys.warnoptions))"],
733 stdout=subprocess.PIPE, env=newenv)
Philip Jenveycdd98fb2010-04-10 20:27:15 +0000734 self.assertEqual(p.communicate()[0],
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000735 "['ignore::UnicodeWarning', 'ignore::DeprecationWarning']")
Philip Jenveycdd98fb2010-04-10 20:27:15 +0000736 self.assertEqual(p.wait(), 0)
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000737
738class CEnvironmentVariableTests(EnvironmentVariableTests):
739 module = c_warnings
740
741class PyEnvironmentVariableTests(EnvironmentVariableTests):
742 module = py_warnings
743
744
Brett Cannone9746892008-04-12 23:44:07 +0000745def test_main():
Amaury Forgeot d'Arc607bff12008-04-18 23:31:33 +0000746 py_warnings.onceregistry.clear()
747 c_warnings.onceregistry.clear()
Brett Cannon1eaf0742008-09-02 01:25:16 +0000748 test_support.run_unittest(CFilterTests, PyFilterTests,
749 CWarnTests, PyWarnTests,
Brett Cannone9746892008-04-12 23:44:07 +0000750 CWCmdLineTests, PyWCmdLineTests,
751 _WarningsTests,
752 CWarningsDisplayTests, PyWarningsDisplayTests,
Brett Cannon1eaf0742008-09-02 01:25:16 +0000753 CCatchWarningTests, PyCatchWarningTests,
Philip Jenveyaebbaeb2010-04-06 23:24:45 +0000754 CEnvironmentVariableTests,
755 PyEnvironmentVariableTests
Brett Cannone9746892008-04-12 23:44:07 +0000756 )
757
758
Raymond Hettingerd6f6e502003-07-13 08:37:40 +0000759if __name__ == "__main__":
Brett Cannone9746892008-04-12 23:44:07 +0000760 test_main()