Merge branch 'depend-function'.

Author: RKrahl

CHANGES

@@ -1,6 +1,13 @@
                History of changes to pytest-dependency
                =======================================
 
+* Version 0.2.0 (not yet released)
+
+** New features
+
+ + Issue #4: Add a depend() function to add a dependency to a test at
+   runtime.
+
 * Version 0.1.0 (2017-01-29)
 
  + Initial release as an independent Python module.

pytest_dependency.py

@@ -62,6 +62,26 @@ def checkDepend(self, depends):
                 pytest.skip("depends on %s" % i)
 
 
+def depends(request, other):
+    """Add dependency on other test.
+
+    Call pytest.skip() unless a successful outcome of all of the tests
+    in other has been registered previously.  This has the same effect
+    as the `depends` keyword argument to the `dependency` marker.  In
+    contrast to the marker, this function may be called at runtime
+    during a test.
+
+    :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.
+    :type other: iterable of :class:`str`
+    """
+    item = request.node
+    manager = DependencyManager.getManager(item)
+    manager.checkDepend(other)
+
+
 @pytest.hookimpl(tryfirst=True, hookwrapper=True)
 def pytest_runtest_makereport(item, call):
     """Store the test outcome if this item is marked "dependency".

tests/test_03_runtime.py

@@ -0,0 +1,40 @@
+"""Using depends() to mark dependencies at runtime.
+"""
+
+import pytest
+
+
+def test_skip_depend_runtime(ctestdir):
+    """One test is skipped, other dependent tests are skipped as well.
+    This also includes indirect dependencies.
+    """
+    ctestdir.makepyfile("""
+        import pytest
+        from pytest_dependency import depends
+
+        @pytest.mark.dependency()
+        def test_a():
+            pass
+
+        @pytest.mark.dependency()
+        def test_b():
+            pytest.skip("explicit skip")
+
+        @pytest.mark.dependency()
+        def test_c(request):
+            depends(request, ["test_b"])
+            pass
+
+        @pytest.mark.dependency()
+        def test_d(request):
+            depends(request, ["test_a", "test_c"])
+            pass
+    """)
+    result = ctestdir.runpytest("--verbose")
+    result.assert_outcomes(passed=1, skipped=3, failed=0)
+    result.stdout.fnmatch_lines("""
+        *::test_a PASSED
+        *::test_b SKIPPED
+        *::test_c SKIPPED
+        *::test_d SKIPPED
+    """)