TestCase: added method skip() for skipping tests [Closes #379]

Author: dg

src/Framework/TestCase.php

@@ -46,11 +46,20 @@ public function run(): void
 				$this->sendMethodList($methods);
 				return;
 			}
-			$this->runTest($method);
+
+			try {
+				$this->runTest($method);
+			} catch (TestCaseSkippedException $e) {
+				Environment::skip($e->getMessage());
+			}
 
 		} else {
 			foreach ($methods as $method) {
-				$this->runTest($method);
+				try {
+					$this->runTest($method);
+				} catch (TestCaseSkippedException $e) {
+					echo "\nSkipped:\n{$e->getMessage()}\n";
+				}
 			}
 		}
 	}
@@ -213,6 +222,15 @@ private function silentTearDown(): void
 	}
 
 
+	/**
+	 * Skips the test.
+	 */
+	protected function skip(string $message = ''): void
+	{
+		throw new TestCaseSkippedException($message);
+	}
+
+
 	private function sendMethodList(array $methods): void
 	{
 		Environment::$checkAssertions = false;
@@ -243,3 +261,8 @@ private function sendMethodList(array $methods): void
 class TestCaseException extends \Exception
 {
 }
+
+
+class TestCaseSkippedException extends \Exception
+{
+}

tests/Framework/TestCase.skip.phpt

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+class TestCaseTest extends Tester\TestCase
+{
+	public function testSkip()
+	{
+		$this->skip('foo');
+		thisIsNotExecuted();
+	}
+}
+
+
+Assert::exception(function () {
+	$test = new TestCaseTest;
+	$test->runTest('testSkip');
+}, Tester\TestCaseSkippedException::class, 'foo');
+
+Assert::noError(function () {
+	$test = new TestCaseTest;
+	$test->run();
+});

tests/Runner/Runner.multiple-fails.phpt

@@ -86,4 +86,11 @@ Assert::match(
 Assert::same(Test::FAILED, $logger->results['testcase-syntax-error.phptx'][0]);
 
 
-Assert::same(5, count($logger->results));
+Assert::match(
+	'foo',
+	trim($logger->results['testcase-skip.phptx'][1])
+);
+Assert::same(Test::SKIPPED, $logger->results['testcase-skip.phptx'][0]);
+
+
+Assert::same(6, count($logger->results));

tests/Runner/multiple-fails/testcase-skip.phptx

@@ -0,0 +1,20 @@
+<?php
+
+/**
+ * @testcase
+ */
+
+use Tester\TestCase;
+
+require __DIR__ . '/../../bootstrap.php';
+
+
+class MyTest extends TestCase
+{
+	public function testSkipped()
+	{
+		$this->skip('foo');
+	}
+}
+
+(new MyTest)->run();