Merge pull request #2014 from RonnyPfannschmidt/warning-record-namedtuple

turn RecordedWarning into a namedtuple

CHANGELOG.rst

@@ -28,6 +28,9 @@ Changes
   to ``io.UnsupportedOperation``. Thanks `@vlad-dragos`_ for the PR.
 
 
+* fix `#2013`_: turn RecordedWarning into namedtupe,
+  to give it a comprehensible repr while preventing unwarranted modification
+
 .. _@davidszotten: https://github.com/davidszotten
 .. _@fushi: https://github.com/fushi
 .. _@mattduck: https://github.com/mattduck
@@ -35,6 +38,7 @@ Changes
 .. _#1512: https://github.com/pytest-dev/pytest/issues/1512
 .. _#1874: https://github.com/pytest-dev/pytest/pull/1874
 .. _#1952: https://github.com/pytest-dev/pytest/pull/1952
+.. _#2013: https://github.com/pytest-dev/pytest/issues/2013
 
 
 3.0.4.dev

_pytest/recwarn.py

@@ -1,5 +1,4 @@
 """ recording warnings during test function execution. """
-
 import inspect
 
 import _pytest._code
@@ -7,6 +6,7 @@ import py
 import sys
 import warnings
 import pytest
+from collections import namedtuple
 
 
 @pytest.yield_fixture
@@ -110,14 +110,9 @@ def warns(expected_warning, *args, **kwargs):
             return func(*args[1:], **kwargs)
 
 
-class RecordedWarning(object):
-    def __init__(self, message, category, filename, lineno, file, line):
-        self.message = message
-        self.category = category
-        self.filename = filename
-        self.lineno = lineno
-        self.file = file
-        self.line = line
+RecordedWarning = namedtuple('RecordedWarning', (
+    'message', 'category', 'filename', 'lineno', 'file', 'line',
+))
     
 
 class WarningsRecorder(object):

doc/en/recwarn.rst

@@ -92,6 +92,9 @@ Each recorded warning has the attributes ``message``, ``category``,
 class of the warning. The ``message`` is the warning itself; calling
 ``str(message)`` will return the actual message of the warning.
 
+.. note::
+    :class:`RecordedWarning` was changed from a plain class to a namedtuple in pytest 3.1
+
 .. note::
     ``DeprecationWarning`` and ``PendingDeprecationWarning`` are treated
     differently; see :ref:`ensuring_function_triggers`.

testing/test_recwarn.py

@@ -203,6 +203,9 @@ class TestWarns(object):
         assert len(record) == 1
         assert str(record[0].message) == "user"
 
+        print(repr(record[0]))
+        assert str(record[0].message) in repr(record[0])
+
     def test_record_only(self):
         with pytest.warns(None) as record:
             warnings.warn("user", UserWarning)