Add testcase method's name to the test's title. (#451)

Resolves #448.

src/Framework/Helpers.php

@@ -71,7 +71,7 @@ public static function findCommonDirectory(array $paths): string
 
 
 	/**
-	 * Parse phpDoc comment.
+	 * Parse the first docblock encountered in the provided string.
 	 * @internal
 	 */
 	public static function parseDocComment(string $s): array

src/Runner/Test.php

@@ -100,6 +100,18 @@ public function getOutput(): string
 	}
 
 
+	public function withTitle(string $title): self
+	{
+		if ($this->hasResult()) {
+			throw new \LogicException('Cannot change title to test which already has a result.');
+		}
+
+		$me = clone $this;
+		$me->title = $title;
+		return $me;
+	}
+
+
 	/**
 	 * @return static
 	 */

src/Runner/TestHandler.php

@@ -228,7 +228,9 @@ private function initiateTestCase(Test $test, $foo, PhpInterpreter $interpreter)
 		}
 
 		return array_map(
-			fn(string $method): Test => $test->withArguments(['method' => $method]),
+			fn(string $method): Test => $test
+				->withTitle("$test->title $method")
+				->withArguments(['method' => $method]),
 			$methods,
 		);
 	}

tests/Runner/Job.phpt

@@ -10,7 +10,7 @@ require __DIR__ . '/../../src/Runner/Test.php';
 require __DIR__ . '/../bootstrap.php';
 
 
-test('', function () {
+test('appending arguments to Test', function () {
 	$test = (new Test('Job.test.phptx'))->withArguments(['one', 'two' => 1])->withArguments(['three', 'two' => 2]);
 	$job = new Job($test, createInterpreter());
 	$job->setTempDirectory(Tester\Helpers::prepareTempDir(sys_get_temp_dir()));
@@ -28,3 +28,13 @@ test('', function () {
 		Assert::contains('Nette Tester', $job->getHeaders());
 	}
 });
+
+
+test('appending title to a Test', function () {
+	$testA = (new Test('Job.test.phptx'));
+	Assert::null($testA->title);
+
+	$testB = $testA->withTitle('title');
+	Assert::notSame($testB, $testA);
+	Assert::same('title', $testB->title);
+});