RAHHH

backend/lib/python3.12/site-packages/twisted/trial/test/test_skip.py

@@ -0,0 +1,93 @@
+# Copyright (c) Twisted Matrix Laboratories.
+# See LICENSE for details.
+#
+
+"""
+Tests for L{twisted.trial.util}
+"""
+
+from unittest import skipIf
+
+from twisted.trial.unittest import TestCase
+
+
+@skipIf(True, "Skip all tests when @skipIf is used on a class")
+class SkipDecoratorUsedOnClass(TestCase):
+    """
+    All tests should be skipped because @skipIf decorator is used on
+    this class.
+    """
+
+    def test_shouldNeverRun_1(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+    def test_shouldNeverRun_2(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+
+@skipIf(True, "")
+class SkipDecoratorUsedOnClassWithEmptyReason(TestCase):
+    """
+    All tests should be skipped because @skipIf decorator is used on
+    this class, even if the reason is an empty string
+    """
+
+    def test_shouldNeverRun_1(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+    def test_shouldNeverRun_2(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+
+class SkipDecoratorUsedOnMethods(TestCase):
+    """
+    Only methods where @skipIf decorator is used should be skipped.
+    """
+
+    @skipIf(True, "skipIf decorator used so skip test")
+    def test_shouldNeverRun(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+    @skipIf(True, "")
+    def test_shouldNeverRunWithEmptyReason(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+    def test_shouldShouldRun(self) -> None:
+        self.assertTrue(True, "Test should run and not be skipped")
+
+    @skipIf(False, "should not skip")
+    def test_shouldShouldRunWithSkipIfFalse(self) -> None:
+        self.assertTrue(True, "Test should run and not be skipped")
+
+    @skipIf(False, "")
+    def test_shouldShouldRunWithSkipIfFalseEmptyReason(self) -> None:
+        self.assertTrue(True, "Test should run and not be skipped")
+
+
+class SkipAttributeOnClass(TestCase):
+    """
+    All tests should be skipped because skip attribute is set on
+    this class.
+    """
+
+    skip = "'skip' attribute set on this class, so skip all tests"
+
+    def test_one(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+    def test_two(self) -> None:
+        raise Exception("Test should skip and never reach here")
+
+
+class SkipAttributeOnMethods(TestCase):
+    """
+    Only methods where @skipIf decorator is used should be skipped.
+    """
+
+    def test_one(self) -> None:
+        raise Exception("Should never reach here")
+
+    test_one.skip = "skip test, skip attribute set on method"  # type: ignore[attr-defined]
+
+    def test_shouldNotSkip(self) -> None:
+        self.assertTrue(True, "Test should run and not be skipped")