[ 2 => 'string $bli', 3 => 'int $bla', ], 'throws' => [ 0 => '\Exception', ], 'return' => [ 0 => 'bool', ], ], ); $expectedDoc = '/** * some desc * * @param string $bli * @param int $bla * * @throws \Exception * * @return bool */ '; $this->assertSame($expectedDoc, $docComment->render('')); } public function testNewLineIsNotAddedBetweenAnnotationsIfDisabled(): void { ParsedDocblock::addNewLineBetweenAnnotations(false); $docComment = new ParsedDocblock( 'some desc', [ 'param' => [ 2 => 'string $bli', 3 => 'int $bla', ], 'throws' => [ 0 => '\Exception', ], 'return' => [ 0 => 'bool', ], ], ); $expectedDoc = '/** * some desc * * @param string $bli * @param int $bla * @throws \Exception * @return bool */ '; $this->assertSame($expectedDoc, $docComment->render('')); } public function testNewLineIsAddedBetweenAnnotationsIfEnabled(): void { ParsedDocblock::addNewLineBetweenAnnotations(true); $docComment = new ParsedDocblock( 'some desc', [ 'param' => [ 2 => 'string $bli', 3 => 'int $bla', ], 'throws' => [ 0 => '\Exception', ], 'return' => [ 0 => 'bool', ], ], ); $expectedDoc = '/** * some desc * * @param string $bli * @param int $bla * * @throws \Exception * * @return bool */ '; $this->assertSame($expectedDoc, $docComment->render('')); } public function testParsingRoundtrip(): void { ParsedDocblock::addNewLineBetweenAnnotations(true); $expectedDoc = '/** * some desc * * @param string $bli * @param int $bla * * @throws \Exception * * @return bool */ '; $docComment = DocComment::parsePreservingLength( new Doc($expectedDoc), ); $this->assertSame($expectedDoc, $docComment->render('')); } public function testParsingWithIndentation(): void { ParsedDocblock::addNewLineBetweenAnnotations(true); $expectedDoc = '/** * some desc * * @param string $bli * @param int $bla * * @throws \Exception * * @return bool */ '; $docComment = DocComment::parsePreservingLength( new Doc($expectedDoc), ); $this->assertSame($expectedDoc, $docComment->render(' ')); } public function testParsingWithCommonPrefixes(): void { ParsedDocblock::addNewLineBetweenAnnotations(true); $expectedDoc = '/** * some self-referential desc with " * @return bool * " as part of it. * * @param string $bli * @param string $bli_this_suffix_is_kept * @param int $bla * * @throws \Exception * * @return bool */ '; $docComment = DocComment::parsePreservingLength( new Doc($expectedDoc), ); $this->assertSame($expectedDoc, $docComment->render('')); } }