Add an example on how to implement an or-like dependency. Ref. #53, #57

Author: RKrahl

doc/examples/or_dependency.py

@@ -0,0 +1,63 @@
+import pytest
+from pytest_dependency import depends
+
+def depends_or(request, other, scope='module'):
+    """Add dependency on any of the other tests.
+
+    Call pytest.skip() unless a successful outcome of any of the tests
+    in other has been registered previously.  This helper is similar
+    to `pytest_dependency.depends()`.  It takes the same arguments.
+    But while `pytest_dependency.depends()` combines the tests in
+    `other` in an and-like manner, it skips the current test unless
+    all other tests did succeed, this function combines them in an
+    or-like manner, it runs the current test if at least one of the
+    other tests did succeed.
+    """
+    item = request.node
+    for o in other:
+        try:
+            depends(request, [o], scope)
+        except pytest.skip.Exception:
+            continue
+        else:
+            return
+    pytest.skip("%s depends on any of %s" % (item.name, ", ".join(other)))
+
+
+@pytest.mark.dependency()
+def test_ap():
+    pass
+
+@pytest.mark.dependency()
+@pytest.mark.xfail(reason="deliberate fail")
+def test_ax():
+    assert False
+
+@pytest.mark.dependency()
+def test_bp():
+    pass
+
+@pytest.mark.dependency()
+@pytest.mark.xfail(reason="deliberate fail")
+def test_bx():
+    assert False
+
+@pytest.mark.dependency()
+def test_c(request):
+    depends_or(request, ["test_ax", "test_bx"])    
+    pass
+
+@pytest.mark.dependency()
+def test_d(request):
+    depends_or(request, ["test_ax", "test_bp"])    
+    pass
+
+@pytest.mark.dependency()
+def test_e(request):
+    depends_or(request, ["test_ap", "test_bx"])    
+    pass
+
+@pytest.mark.dependency()
+def test_f(request):
+    depends_or(request, ["test_ap", "test_bp"])    
+    pass