Homec4science
Diffusion libphutil (production) Browse

libphutil/src/parser/__tests__/PhutilDocblockParserTestCase.php
4f9915ecac81production

Last Change
Raw File

PhutilDocblockParserTestCase.php
View Options

<?php
/**
* Test cases for @{class:PhutilDocblockParser}.
*
* @group testcase
*/
final class PhutilDocblockParserTestCase extends PhutilTestCase {
public function testParser() {
$root = dirname(__FILE__).'/docblock/';
foreach (Filesystem::listDirectory($root, $hidden = false) as $file) {
$this->parseDocblock($root.$file);
}
}
private function parseDocblock($doc_file) {
$contents = Filesystem::readFile($doc_file);
$file = basename($doc_file);
$parser = new PhutilDocblockParser();
list($docblock, $specials) = $parser->parse($contents);
switch ($file) {
case 'embedded-specials.docblock':
$this->assertEqual(array(), $specials);
$this->assertEqual(
"So long as a @special does not appear at the beginning of a line,\n".
"it is parsed as normal text.",
$docblock);
break;
case 'indented-block.docblock':
$this->assertEqual(array(), $specials);
$this->assertEqual(
"Cozy lummox gives smart squid who asks for job pen.",
$docblock);
break;
case 'indented-text.docblock':
$this->assertEqual(array(), $specials);
$this->assertEqual(
"Cozy lummox gives smart squid who asks for job pen.",
$docblock);
break;
case 'multiline-special.docblock':
$this->assertEqual(
array(
'special' => "x y z",
),
$specials);
$this->assertEqual(
"",
$docblock);
break;
case 'multi-specials.docblock':
$this->assertEqual(
array(
'special' => "north\nsouth",
),
$specials);
$this->assertEqual(
"",
$docblock);
break;
case 'specials.docblock':
$this->assertEqual(
array(
'type' => 'type',
'task' => 'task',
),
$specials);
$this->assertEqual(
"",
$docblock);
break;
case 'linebreak-breaks-specials.docblock':
$this->assertEqual(
array(
'title' => 'title',
),
$specials);
$this->assertEqual(
"This is normal text, not part of the @title.",
$docblock);
break;
case 'specials-with-hyphen.docblock':
$this->assertEqual(
array(
'repeat-hyphen' => "a\nb",
'multiline-hyphen' => "mmm nnn",
'normal-hyphen' => "x",
),
$specials);
break;
case 'indented-specials.docblock':
$this->assertEqual(
array(
'title' => 'sendmail',
),
$specials);
break;
case 'flag-specials.docblock':
$this->assertEqual(
"stuff above\n\nstuff in the middle\n\nstuff below",
$docblock);
$this->assertEqual(
array(
'flag' => true,
'stuff' => true,
'zebra' => true,
'apple' => true,
),
$specials);
break;
default:
throw new Exception("No test case to handle file '{$file}'!");
}
}
}
c4science · Help