Restoring authorship annotation for <deshevoy@yandex-team.ru>. Commit 1 of 2.

1 files changed, 410 insertions, 410 deletions

diff --git a/contrib/python/pytest/py2/_pytest/nodes.py b/contrib/python/pytest/py2/_pytest/nodes.py
index 206e9ae163..271c92dbc2 100644
--- a/contrib/python/pytest/py2/_pytest/nodes.py
+++ b/contrib/python/pytest/py2/_pytest/nodes.py
@@ -1,332 +1,332 @@
 # -*- coding: utf-8 -*-
-from __future__ import absolute_import
-from __future__ import division
-from __future__ import print_function
-
-import os
-import warnings
-
-import py
-import six
-
-import _pytest._code
-from _pytest.compat import getfslineno
-from _pytest.mark.structures import NodeKeywords
-from _pytest.outcomes import fail
-
-SEP = "/"
-
-tracebackcutdir = py.path.local(_pytest.__file__).dirpath()
-
-
-def _splitnode(nodeid):
-    """Split a nodeid into constituent 'parts'.
-
-    Node IDs are strings, and can be things like:
-        ''
-        'testing/code'
-        'testing/code/test_excinfo.py'
-        'testing/code/test_excinfo.py::TestFormattedExcinfo'
-
-    Return values are lists e.g.
-        []
-        ['testing', 'code']
-        ['testing', 'code', 'test_excinfo.py']
-        ['testing', 'code', 'test_excinfo.py', 'TestFormattedExcinfo', '()']
-    """
-    if nodeid == "":
-        # If there is no root node at all, return an empty list so the caller's logic can remain sane
-        return []
-    parts = nodeid.split(SEP)
-    # Replace single last element 'test_foo.py::Bar' with multiple elements 'test_foo.py', 'Bar'
-    parts[-1:] = parts[-1].split("::")
-    return parts
-
-
-def ischildnode(baseid, nodeid):
-    """Return True if the nodeid is a child node of the baseid.
-
-    E.g. 'foo/bar::Baz' is a child of 'foo', 'foo/bar' and 'foo/bar::Baz', but not of 'foo/blorp'
-    """
-    base_parts = _splitnode(baseid)
-    node_parts = _splitnode(nodeid)
-    if len(node_parts) < len(base_parts):
-        return False
-    return node_parts[: len(base_parts)] == base_parts
-
-
-class Node(object):
-    """ base class for Collector and Item the test collection tree.
-    Collector subclasses have children, Items are terminal nodes."""
-
-    def __init__(
-        self, name, parent=None, config=None, session=None, fspath=None, nodeid=None
-    ):
-        #: a unique name within the scope of the parent node
-        self.name = name
-
-        #: the parent collector node.
-        self.parent = parent
-
-        #: the pytest config object
-        self.config = config or parent.config
-
-        #: the session this node is part of
-        self.session = session or parent.session
-
-        #: filesystem path where this node was collected from (can be None)
-        self.fspath = fspath or getattr(parent, "fspath", None)
-
-        #: keywords/markers collected from all scopes
-        self.keywords = NodeKeywords(self)
-
-        #: the marker objects belonging to this node
-        self.own_markers = []
-
-        #: allow adding of extra keywords to use for matching
-        self.extra_keyword_matches = set()
-
-        # used for storing artificial fixturedefs for direct parametrization
-        self._name2pseudofixturedef = {}
-
-        if nodeid is not None:
-            assert "::()" not in nodeid
-            self._nodeid = nodeid
-        else:
-            self._nodeid = self.parent.nodeid
-            if self.name != "()":
-                self._nodeid += "::" + self.name
-
-    @property
-    def ihook(self):
-        """ fspath sensitive hook proxy used to call pytest hooks"""
-        return self.session.gethookproxy(self.fspath)
-
-    def __repr__(self):
+from __future__ import absolute_import 
+from __future__ import division 
+from __future__ import print_function 
+ 
+import os 
+import warnings 
+ 
+import py 
+import six 
+ 
+import _pytest._code 
+from _pytest.compat import getfslineno 
+from _pytest.mark.structures import NodeKeywords 
+from _pytest.outcomes import fail 
+ 
+SEP = "/" 
+ 
+tracebackcutdir = py.path.local(_pytest.__file__).dirpath() 
+ 
+ 
+def _splitnode(nodeid): 
+    """Split a nodeid into constituent 'parts'. 
+ 
+    Node IDs are strings, and can be things like: 
+        '' 
+        'testing/code' 
+        'testing/code/test_excinfo.py' 
+        'testing/code/test_excinfo.py::TestFormattedExcinfo' 
+ 
+    Return values are lists e.g. 
+        [] 
+        ['testing', 'code'] 
+        ['testing', 'code', 'test_excinfo.py'] 
+        ['testing', 'code', 'test_excinfo.py', 'TestFormattedExcinfo', '()'] 
+    """ 
+    if nodeid == "": 
+        # If there is no root node at all, return an empty list so the caller's logic can remain sane 
+        return [] 
+    parts = nodeid.split(SEP) 
+    # Replace single last element 'test_foo.py::Bar' with multiple elements 'test_foo.py', 'Bar' 
+    parts[-1:] = parts[-1].split("::") 
+    return parts 
+ 
+ 
+def ischildnode(baseid, nodeid): 
+    """Return True if the nodeid is a child node of the baseid. 
+ 
+    E.g. 'foo/bar::Baz' is a child of 'foo', 'foo/bar' and 'foo/bar::Baz', but not of 'foo/blorp' 
+    """ 
+    base_parts = _splitnode(baseid) 
+    node_parts = _splitnode(nodeid) 
+    if len(node_parts) < len(base_parts): 
+        return False 
+    return node_parts[: len(base_parts)] == base_parts 
+ 
+ 
+class Node(object): 
+    """ base class for Collector and Item the test collection tree. 
+    Collector subclasses have children, Items are terminal nodes.""" 
+ 
+    def __init__( 
+        self, name, parent=None, config=None, session=None, fspath=None, nodeid=None 
+    ): 
+        #: a unique name within the scope of the parent node 
+        self.name = name 
+ 
+        #: the parent collector node. 
+        self.parent = parent 
+ 
+        #: the pytest config object 
+        self.config = config or parent.config 
+ 
+        #: the session this node is part of 
+        self.session = session or parent.session 
+ 
+        #: filesystem path where this node was collected from (can be None) 
+        self.fspath = fspath or getattr(parent, "fspath", None) 
+ 
+        #: keywords/markers collected from all scopes 
+        self.keywords = NodeKeywords(self) 
+ 
+        #: the marker objects belonging to this node 
+        self.own_markers = [] 
+ 
+        #: allow adding of extra keywords to use for matching 
+        self.extra_keyword_matches = set() 
+ 
+        # used for storing artificial fixturedefs for direct parametrization 
+        self._name2pseudofixturedef = {} 
+ 
+        if nodeid is not None: 
+            assert "::()" not in nodeid 
+            self._nodeid = nodeid 
+        else: 
+            self._nodeid = self.parent.nodeid 
+            if self.name != "()": 
+                self._nodeid += "::" + self.name 
+ 
+    @property 
+    def ihook(self): 
+        """ fspath sensitive hook proxy used to call pytest hooks""" 
+        return self.session.gethookproxy(self.fspath) 
+ 
+    def __repr__(self): 
         return "<%s %s>" % (self.__class__.__name__, getattr(self, "name", None))
-
+ 
     def warn(self, warning):
-        """Issue a warning for this item.
-
+        """Issue a warning for this item. 
+ 
         Warnings will be displayed after the test session, unless explicitly suppressed
-
+ 
         :param Warning warning: the warning instance to issue. Must be a subclass of PytestWarning.
-
+ 
         :raise ValueError: if ``warning`` instance is not a subclass of PytestWarning.
-
+ 
         Example usage:
-
-        .. code-block:: python
-
-            node.warn(PytestWarning("some message"))
-
-        """
-        from _pytest.warning_types import PytestWarning
-
-        if not isinstance(warning, PytestWarning):
-            raise ValueError(
-                "warning must be an instance of PytestWarning or subclass, got {!r}".format(
-                    warning
-                )
-            )
-        path, lineno = get_fslocation_from_item(self)
-        warnings.warn_explicit(
-            warning,
-            category=None,
-            filename=str(path),
-            lineno=lineno + 1 if lineno is not None else None,
-        )
-
-    # methods for ordering nodes
-    @property
-    def nodeid(self):
-        """ a ::-separated string denoting its collection tree address. """
-        return self._nodeid
-
-    def __hash__(self):
-        return hash(self.nodeid)
-
-    def setup(self):
-        pass
-
-    def teardown(self):
-        pass
-
-    def listchain(self):
-        """ return list of all parent collectors up to self,
-            starting from root of collection tree. """
-        chain = []
-        item = self
-        while item is not None:
-            chain.append(item)
-            item = item.parent
-        chain.reverse()
-        return chain
-
-    def add_marker(self, marker, append=True):
-        """dynamically add a marker object to the node.
-
-        :type marker: ``str`` or ``pytest.mark.*``  object
-        :param marker:
-            ``append=True`` whether to append the marker,
-            if ``False`` insert at position ``0``.
-        """
-        from _pytest.mark import MarkDecorator, MARK_GEN
-
-        if isinstance(marker, six.string_types):
-            marker = getattr(MARK_GEN, marker)
-        elif not isinstance(marker, MarkDecorator):
-            raise ValueError("is not a string or pytest.mark.* Marker")
-        self.keywords[marker.name] = marker
-        if append:
-            self.own_markers.append(marker.mark)
-        else:
-            self.own_markers.insert(0, marker.mark)
-
-    def iter_markers(self, name=None):
-        """
-        :param name: if given, filter the results by the name attribute
-
-        iterate over all markers of the node
-        """
-        return (x[1] for x in self.iter_markers_with_node(name=name))
-
-    def iter_markers_with_node(self, name=None):
-        """
-        :param name: if given, filter the results by the name attribute
-
-        iterate over all markers of the node
-        returns sequence of tuples (node, mark)
-        """
-        for node in reversed(self.listchain()):
-            for mark in node.own_markers:
-                if name is None or getattr(mark, "name", None) == name:
-                    yield node, mark
-
-    def get_closest_marker(self, name, default=None):
-        """return the first marker matching the name, from closest (for example function) to farther level (for example
-        module level).
-
-        :param default: fallback return value of no marker was found
-        :param name: name to filter by
-        """
-        return next(self.iter_markers(name=name), default)
-
-    def listextrakeywords(self):
-        """ Return a set of all extra keywords in self and any parents."""
-        extra_keywords = set()
-        for item in self.listchain():
-            extra_keywords.update(item.extra_keyword_matches)
-        return extra_keywords
-
-    def listnames(self):
-        return [x.name for x in self.listchain()]
-
-    def addfinalizer(self, fin):
-        """ register a function to be called when this node is finalized.
-
-        This method can only be called when this node is active
-        in a setup chain, for example during self.setup().
-        """
-        self.session._setupstate.addfinalizer(fin, self)
-
-    def getparent(self, cls):
-        """ get the next parent node (including ourself)
-        which is an instance of the given class"""
-        current = self
-        while current and not isinstance(current, cls):
-            current = current.parent
-        return current
-
-    def _prunetraceback(self, excinfo):
-        pass
-
-    def _repr_failure_py(self, excinfo, style=None):
-        if excinfo.errisinstance(fail.Exception):
-            if not excinfo.value.pytrace:
-                return six.text_type(excinfo.value)
-        fm = self.session._fixturemanager
-        if excinfo.errisinstance(fm.FixtureLookupError):
-            return excinfo.value.formatrepr()
-        tbfilter = True
+ 
+        .. code-block:: python 
+ 
+            node.warn(PytestWarning("some message")) 
+ 
+        """ 
+        from _pytest.warning_types import PytestWarning 
+ 
+        if not isinstance(warning, PytestWarning): 
+            raise ValueError( 
+                "warning must be an instance of PytestWarning or subclass, got {!r}".format( 
+                    warning 
+                ) 
+            ) 
+        path, lineno = get_fslocation_from_item(self) 
+        warnings.warn_explicit( 
+            warning, 
+            category=None, 
+            filename=str(path), 
+            lineno=lineno + 1 if lineno is not None else None, 
+        ) 
+ 
+    # methods for ordering nodes 
+    @property 
+    def nodeid(self): 
+        """ a ::-separated string denoting its collection tree address. """ 
+        return self._nodeid 
+ 
+    def __hash__(self): 
+        return hash(self.nodeid) 
+ 
+    def setup(self): 
+        pass 
+ 
+    def teardown(self): 
+        pass 
+ 
+    def listchain(self): 
+        """ return list of all parent collectors up to self, 
+            starting from root of collection tree. """ 
+        chain = [] 
+        item = self 
+        while item is not None: 
+            chain.append(item) 
+            item = item.parent 
+        chain.reverse() 
+        return chain 
+ 
+    def add_marker(self, marker, append=True): 
+        """dynamically add a marker object to the node. 
+ 
+        :type marker: ``str`` or ``pytest.mark.*``  object 
+        :param marker: 
+            ``append=True`` whether to append the marker, 
+            if ``False`` insert at position ``0``. 
+        """ 
+        from _pytest.mark import MarkDecorator, MARK_GEN 
+ 
+        if isinstance(marker, six.string_types): 
+            marker = getattr(MARK_GEN, marker) 
+        elif not isinstance(marker, MarkDecorator): 
+            raise ValueError("is not a string or pytest.mark.* Marker") 
+        self.keywords[marker.name] = marker 
+        if append: 
+            self.own_markers.append(marker.mark) 
+        else: 
+            self.own_markers.insert(0, marker.mark) 
+ 
+    def iter_markers(self, name=None): 
+        """ 
+        :param name: if given, filter the results by the name attribute 
+ 
+        iterate over all markers of the node 
+        """ 
+        return (x[1] for x in self.iter_markers_with_node(name=name)) 
+ 
+    def iter_markers_with_node(self, name=None): 
+        """ 
+        :param name: if given, filter the results by the name attribute 
+ 
+        iterate over all markers of the node 
+        returns sequence of tuples (node, mark) 
+        """ 
+        for node in reversed(self.listchain()): 
+            for mark in node.own_markers: 
+                if name is None or getattr(mark, "name", None) == name: 
+                    yield node, mark 
+ 
+    def get_closest_marker(self, name, default=None): 
+        """return the first marker matching the name, from closest (for example function) to farther level (for example 
+        module level). 
+ 
+        :param default: fallback return value of no marker was found 
+        :param name: name to filter by 
+        """ 
+        return next(self.iter_markers(name=name), default) 
+ 
+    def listextrakeywords(self): 
+        """ Return a set of all extra keywords in self and any parents.""" 
+        extra_keywords = set() 
+        for item in self.listchain(): 
+            extra_keywords.update(item.extra_keyword_matches) 
+        return extra_keywords 
+ 
+    def listnames(self): 
+        return [x.name for x in self.listchain()] 
+ 
+    def addfinalizer(self, fin): 
+        """ register a function to be called when this node is finalized. 
+ 
+        This method can only be called when this node is active 
+        in a setup chain, for example during self.setup(). 
+        """ 
+        self.session._setupstate.addfinalizer(fin, self) 
+ 
+    def getparent(self, cls): 
+        """ get the next parent node (including ourself) 
+        which is an instance of the given class""" 
+        current = self 
+        while current and not isinstance(current, cls): 
+            current = current.parent 
+        return current 
+ 
+    def _prunetraceback(self, excinfo): 
+        pass 
+ 
+    def _repr_failure_py(self, excinfo, style=None): 
+        if excinfo.errisinstance(fail.Exception): 
+            if not excinfo.value.pytrace: 
+                return six.text_type(excinfo.value) 
+        fm = self.session._fixturemanager 
+        if excinfo.errisinstance(fm.FixtureLookupError): 
+            return excinfo.value.formatrepr() 
+        tbfilter = True 
         if self.config.getoption("fulltrace", False):
-            style = "long"
-        else:
-            tb = _pytest._code.Traceback([excinfo.traceback[-1]])
-            self._prunetraceback(excinfo)
-            if len(excinfo.traceback) == 0:
-                excinfo.traceback = tb
-            tbfilter = False  # prunetraceback already does it
-            if style == "auto":
-                style = "long"
-        # XXX should excinfo.getrepr record all data and toterminal() process it?
-        if style is None:
+            style = "long" 
+        else: 
+            tb = _pytest._code.Traceback([excinfo.traceback[-1]]) 
+            self._prunetraceback(excinfo) 
+            if len(excinfo.traceback) == 0: 
+                excinfo.traceback = tb 
+            tbfilter = False  # prunetraceback already does it 
+            if style == "auto": 
+                style = "long" 
+        # XXX should excinfo.getrepr record all data and toterminal() process it? 
+        if style is None: 
             if self.config.getoption("tbstyle", "auto") == "short":
-                style = "short"
-            else:
-                style = "long"
-
+                style = "short" 
+            else: 
+                style = "long" 
+ 
         if self.config.getoption("verbose", 0) > 1:
-            truncate_locals = False
-        else:
-            truncate_locals = True
-
-        try:
-            os.getcwd()
-            abspath = False
-        except OSError:
-            abspath = True
-
-        return excinfo.getrepr(
-            funcargs=True,
-            abspath=abspath,
+            truncate_locals = False 
+        else: 
+            truncate_locals = True 
+ 
+        try: 
+            os.getcwd() 
+            abspath = False 
+        except OSError: 
+            abspath = True 
+ 
+        return excinfo.getrepr( 
+            funcargs=True, 
+            abspath=abspath, 
             showlocals=self.config.getoption("showlocals", False),
-            style=style,
-            tbfilter=tbfilter,
-            truncate_locals=truncate_locals,
-        )
-
-    repr_failure = _repr_failure_py
-
-
-def get_fslocation_from_item(item):
-    """Tries to extract the actual location from an item, depending on available attributes:
-
-    * "fslocation": a pair (path, lineno)
-    * "obj": a Python object that the item wraps.
-    * "fspath": just a path
-
-    :rtype: a tuple of (str|LocalPath, int) with filename and line number.
-    """
-    result = getattr(item, "location", None)
-    if result is not None:
-        return result[:2]
-    obj = getattr(item, "obj", None)
-    if obj is not None:
-        return getfslineno(obj)
-    return getattr(item, "fspath", "unknown location"), -1
-
-
-class Collector(Node):
-    """ Collector instances create children through collect()
-        and thus iteratively build a tree.
-    """
-
-    class CollectError(Exception):
-        """ an error during collection, contains a custom message. """
-
-    def collect(self):
-        """ returns a list of children (items and collectors)
-            for this collection node.
-        """
-        raise NotImplementedError("abstract")
-
-    def repr_failure(self, excinfo):
-        """ represent a collection failure. """
-        if excinfo.errisinstance(self.CollectError):
-            exc = excinfo.value
-            return str(exc.args[0])
-
+            style=style, 
+            tbfilter=tbfilter, 
+            truncate_locals=truncate_locals, 
+        ) 
+ 
+    repr_failure = _repr_failure_py 
+ 
+ 
+def get_fslocation_from_item(item): 
+    """Tries to extract the actual location from an item, depending on available attributes: 
+ 
+    * "fslocation": a pair (path, lineno) 
+    * "obj": a Python object that the item wraps. 
+    * "fspath": just a path 
+ 
+    :rtype: a tuple of (str|LocalPath, int) with filename and line number. 
+    """ 
+    result = getattr(item, "location", None) 
+    if result is not None: 
+        return result[:2] 
+    obj = getattr(item, "obj", None) 
+    if obj is not None: 
+        return getfslineno(obj) 
+    return getattr(item, "fspath", "unknown location"), -1 
+ 
+ 
+class Collector(Node): 
+    """ Collector instances create children through collect() 
+        and thus iteratively build a tree. 
+    """ 
+ 
+    class CollectError(Exception): 
+        """ an error during collection, contains a custom message. """ 
+ 
+    def collect(self): 
+        """ returns a list of children (items and collectors) 
+            for this collection node. 
+        """ 
+        raise NotImplementedError("abstract") 
+ 
+    def repr_failure(self, excinfo): 
+        """ represent a collection failure. """ 
+        if excinfo.errisinstance(self.CollectError): 
+            exc = excinfo.value 
+            return str(exc.args[0]) 
+ 
         # Respect explicit tbstyle option, but default to "short"
         # (None._repr_failure_py defaults to "long" without "fulltrace" option).
         tbstyle = self.config.getoption("tbstyle", "auto")
@@ -335,95 +335,95 @@ class Collector(Node):
 
         return self._repr_failure_py(excinfo, style=tbstyle)
 
-    def _prunetraceback(self, excinfo):
-        if hasattr(self, "fspath"):
-            traceback = excinfo.traceback
-            ntraceback = traceback.cut(path=self.fspath)
-            if ntraceback == traceback:
-                ntraceback = ntraceback.cut(excludepath=tracebackcutdir)
-            excinfo.traceback = ntraceback.filter()
-
-
-def _check_initialpaths_for_relpath(session, fspath):
-    for initial_path in session._initialpaths:
-        if fspath.common(initial_path) == initial_path:
-            return fspath.relto(initial_path)
-
-
-class FSCollector(Collector):
-    def __init__(self, fspath, parent=None, config=None, session=None, nodeid=None):
-        fspath = py.path.local(fspath)  # xxx only for test_resultlog.py?
-        name = fspath.basename
-        if parent is not None:
-            rel = fspath.relto(parent.fspath)
-            if rel:
-                name = rel
-            name = name.replace(os.sep, SEP)
-        self.fspath = fspath
-
-        session = session or parent.session
-
-        if nodeid is None:
-            nodeid = self.fspath.relto(session.config.rootdir)
-
-            if not nodeid:
-                nodeid = _check_initialpaths_for_relpath(session, fspath)
-            if nodeid and os.sep != SEP:
-                nodeid = nodeid.replace(os.sep, SEP)
-
-        super(FSCollector, self).__init__(
-            name, parent, config, session, nodeid=nodeid, fspath=fspath
-        )
-
-
-class File(FSCollector):
-    """ base class for collecting tests from a file. """
-
-
-class Item(Node):
-    """ a basic test invocation item. Note that for a single function
-    there might be multiple test invocation items.
-    """
-
-    nextitem = None
-
-    def __init__(self, name, parent=None, config=None, session=None, nodeid=None):
-        super(Item, self).__init__(name, parent, config, session, nodeid=nodeid)
-        self._report_sections = []
-
-        #: user properties is a list of tuples (name, value) that holds user
-        #: defined properties for this test.
-        self.user_properties = []
-
-    def add_report_section(self, when, key, content):
-        """
-        Adds a new report section, similar to what's done internally to add stdout and
-        stderr captured output::
-
-            item.add_report_section("call", "stdout", "report section contents")
-
-        :param str when:
-            One of the possible capture states, ``"setup"``, ``"call"``, ``"teardown"``.
-        :param str key:
-            Name of the section, can be customized at will. Pytest uses ``"stdout"`` and
-            ``"stderr"`` internally.
-
-        :param str content:
-            The full contents as a string.
-        """
-        if content:
-            self._report_sections.append((when, key, content))
-
-    def reportinfo(self):
-        return self.fspath, None, ""
-
-    @property
-    def location(self):
-        try:
-            return self._location
-        except AttributeError:
-            location = self.reportinfo()
-            fspath = self.session._node_location_to_relpath(location[0])
-            location = (fspath, location[1], str(location[2]))
-            self._location = location
-            return location
+    def _prunetraceback(self, excinfo): 
+        if hasattr(self, "fspath"): 
+            traceback = excinfo.traceback 
+            ntraceback = traceback.cut(path=self.fspath) 
+            if ntraceback == traceback: 
+                ntraceback = ntraceback.cut(excludepath=tracebackcutdir) 
+            excinfo.traceback = ntraceback.filter() 
+ 
+ 
+def _check_initialpaths_for_relpath(session, fspath): 
+    for initial_path in session._initialpaths: 
+        if fspath.common(initial_path) == initial_path: 
+            return fspath.relto(initial_path) 
+ 
+ 
+class FSCollector(Collector): 
+    def __init__(self, fspath, parent=None, config=None, session=None, nodeid=None): 
+        fspath = py.path.local(fspath)  # xxx only for test_resultlog.py? 
+        name = fspath.basename 
+        if parent is not None: 
+            rel = fspath.relto(parent.fspath) 
+            if rel: 
+                name = rel 
+            name = name.replace(os.sep, SEP) 
+        self.fspath = fspath 
+ 
+        session = session or parent.session 
+ 
+        if nodeid is None: 
+            nodeid = self.fspath.relto(session.config.rootdir) 
+ 
+            if not nodeid: 
+                nodeid = _check_initialpaths_for_relpath(session, fspath) 
+            if nodeid and os.sep != SEP: 
+                nodeid = nodeid.replace(os.sep, SEP) 
+ 
+        super(FSCollector, self).__init__( 
+            name, parent, config, session, nodeid=nodeid, fspath=fspath 
+        ) 
+ 
+ 
+class File(FSCollector): 
+    """ base class for collecting tests from a file. """ 
+ 
+ 
+class Item(Node): 
+    """ a basic test invocation item. Note that for a single function 
+    there might be multiple test invocation items. 
+    """ 
+ 
+    nextitem = None 
+ 
+    def __init__(self, name, parent=None, config=None, session=None, nodeid=None): 
+        super(Item, self).__init__(name, parent, config, session, nodeid=nodeid) 
+        self._report_sections = [] 
+ 
+        #: user properties is a list of tuples (name, value) that holds user 
+        #: defined properties for this test. 
+        self.user_properties = [] 
+ 
+    def add_report_section(self, when, key, content): 
+        """ 
+        Adds a new report section, similar to what's done internally to add stdout and 
+        stderr captured output:: 
+ 
+            item.add_report_section("call", "stdout", "report section contents") 
+ 
+        :param str when: 
+            One of the possible capture states, ``"setup"``, ``"call"``, ``"teardown"``. 
+        :param str key: 
+            Name of the section, can be customized at will. Pytest uses ``"stdout"`` and 
+            ``"stderr"`` internally. 
+ 
+        :param str content: 
+            The full contents as a string. 
+        """ 
+        if content: 
+            self._report_sections.append((when, key, content)) 
+ 
+    def reportinfo(self): 
+        return self.fspath, None, "" 
+ 
+    @property 
+    def location(self): 
+        try: 
+            return self._location 
+        except AttributeError: 
+            location = self.reportinfo() 
+            fspath = self.session._node_location_to_relpath(location[0]) 
+            location = (fspath, location[1], str(location[2])) 
+            self._location = location 
+            return location