1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
<?php declare(strict_types = 1);
namespace TheSeer\phpDox\DocBlock;
use PHPUnit\Framework\TestCase;
use TheSeer\fDOM\fDOMDocument;
/**
* Class DocBlockTest
*
* @covers \TheSeer\phpDox\DocBlock\DocBlock
*
* @uses \TheSeer\phpDox\DocBlock\GenericElement
*/
class DocBlockTest extends TestCase {
/**
* @var DocBlock
*/
private $docBlock;
/**
* @var GenericElement
*/
private $element;
protected function setUp(): void {
$this->docBlock = new DocBlock();
$this->element = $this->getMockBuilder('TheSeer\\phpDox\\DocBlock\\GenericElement')
->disableOriginalConstructor()
->getMock();
$this->element->expects($this->any())
->method('getAnnotationName')
->willReturn('stub');
}
public function testHasElementByNameReturnsFalseIfNotPresent(): void {
$this->assertFalse($this->docBlock->hasElementByName('not-set'));
}
/**
* @covers \TheSeer\phpDox\DocBlock\DocBlock::appendElement
* @covers \TheSeer\phpDox\DocBlock\DocBlock::hasElementByName
*/
public function testElementCanBeAdded(): void {
$this->docBlock->appendElement($this->element);
$this->assertTrue($this->docBlock->hasElementByName('stub'));
}
/**
* @covers \TheSeer\phpDox\DocBlock\DocBlock::appendElement
*/
public function testSameTypeElementCanBeAddedMultipleTimes(): void {
$this->docBlock->appendElement($this->element);
$this->docBlock->appendElement($this->element);
$this->assertTrue($this->docBlock->hasElementByName('stub'));
$this->assertCount(2, $this->docBlock->getElementByName('stub'));
}
/**
* @covers \TheSeer\phpDox\DocBlock\DocBlock::getElementByName
*/
public function testTryingToGetANonExistingElementThrowsException(): void {
$this->expectException('\TheSeer\phpDox\DocBlock\DocBlockException');
$this->docBlock->getElementByName('non-set');
}
/**
* @covers \TheSeer\phpDox\DocBlock\DocBlock::getElementByName
*/
public function testElementCanBeRetreived(): void {
$this->docBlock->appendElement($this->element);
$this->assertEquals($this->element, $this->docBlock->getElementByName('stub'));
}
public function testDocBlockCanBeSerializedToDom(): void {
$dom = new fDOMDocument();
$dom->registerNamespace('test', 'http://xml.phpdox.net/src');
$this->element->expects($this->once())
->method('asDom')
->will($this->returnValue($dom->createElementNS('http://xml.phpdox.net/src', 'stub')));
$this->docBlock->appendElement($this->element);
$node = $this->docBlock->asDom($dom);
$this->assertEquals(
'<docblock xmlns="http://xml.phpdox.net/src"><stub/></docblock>',
$dom->saveXML($node)
);
}
public function testDocBlockWithMultipleOccurencesOfAnnotationCanBeSerializedToDom(): void {
$dom = new fDOMDocument();
$dom->registerNamespace('test', 'http://xml.phpdox.net/src');
$element2 = clone $this->element;
$this->element->expects($this->once())
->method('asDom')
->willReturn($dom->createElementNS('http://xml.phpdox.net/src', 'stub'));
$element2->expects($this->once())
->method('asDom')
->willReturn($dom->createElementNS('http://xml.phpdox.net/src', 'stub'));
$this->docBlock->appendElement($this->element);
$this->docBlock->appendElement($element2);
$node = $this->docBlock->asDom($dom);
$this->assertEquals(
'<docblock xmlns="http://xml.phpdox.net/src"><stub/><stub/></docblock>',
$dom->saveXML($node)
);
}
}
|
