Add the scope argument in the reference documentation.

Author: RKrahl

doc/src/reference.rst

@@ -1,7 +1,7 @@
 Reference
 =========
 
-.. py:decorator:: pytest.mark.dependency(name=None, depends=[])
+.. py:decorator:: pytest.mark.dependency(name=None, depends=[], scope='module')
 
     Mark a test to be used as a dependency for other tests or to
     depend on other tests.
@@ -11,16 +11,23 @@ Reference
     for the test may be set in the depends argument.
 
     :param name: the name of the test to be used for referencing by
-	dependent tests.  If not set, it defaults to the node ID
-	defined by pytest, that is the name of the test function,
-	extended by the parameters if applicable.  The name must be
-	unique in the scope, which is currently the test module.
+        dependent tests.  If not set, it defaults to the node ID
+        defined by pytest, that is the name of the test function,
+        extended by the parameters if applicable.  The name must be
+        unique in the scope, which is currently the test module.
     :type name: :class:`str`
     :param depends: dependencies, a list of names of tests that this
         test depends on.  The test will be skipped unless all of the
-	dependencies have been run successfully.  The dependencies
-	must also have been decorated by the marker.
+        dependencies have been run successfully.  The dependencies
+        must also have been decorated by the marker.  The names of the
+        dependencies must be adapted to the scope.
     :type depends: iterable of :class:`str`
+    :param scope: the scope to search for the dependencies.  Must be
+        either `session`, `package`, `module`, or `class`.
+    :type scope: :class:`str`
+
+    .. versionchanged:: 0.5.0
+        the scope parameter has been added.
 
 .. py:module:: pytest_dependency
 

pytest_dependency.py

@@ -87,7 +87,7 @@ def checkDepend(self, depends, item):
             pytest.skip("%s depends on %s" % (item.name, i))
 
 
-def depends(request, other):
+def depends(request, other, scope="module"):
     """Add dependency on other test.
 
     Call pytest.skip() unless a successful outcome of all of the tests in
@@ -99,10 +99,17 @@ def depends(request, other):
     :param request: the value of the `request` pytest fixture related
         to the current test.
     :param other: dependencies, a list of names of tests that this
-        test depends on.
+        test depends on.  The names of the dependencies must be
+        adapted to the scope.
     :type other: iterable of :class:`str`
+    :param scope: the scope to search for the dependencies.  Must be
+        either `session`, `package`, `module`, or `class`.
+    :type scope: :class:`str`
 
     .. versionadded:: 0.2
+
+    .. versionchanged:: 0.5.0
+        the scope parameter has been added.
     """
     item = request.node
     manager = DependencyManager.getManager(item)