Merge branch 'feature/167' into develop

Close #167

Author: michalbundyra

CHANGELOG.md

@@ -8,6 +8,8 @@ All notable changes to this project will be documented in this file, in reverse
 
 - [#170](https://github.com/zendframework/zend-code/pull/170) adds class constant visibility modifiers support.
 
+- [#167](https://github.com/zendframework/zend-code/pull/167) adds the ability to remove doc block of a member.
+
 ### Changed
 
 - [#166](https://github.com/zendframework/zend-code/pull/166) changes omitting default property value if it is null.

src/Generator/AbstractMemberGenerator.php

@@ -36,7 +36,7 @@ abstract class AbstractMemberGenerator extends AbstractGenerator
     /**#@-*/
 
     /**
-     * @var DocBlockGenerator
+     * @var DocBlockGenerator|null
      */
     protected $docBlock;
 
@@ -236,8 +236,13 @@ public function setDocBlock($docBlock)
         return $this;
     }
 
+    public function removeDocBlock(): void
+    {
+        $this->docBlock = null;
+    }
+
     /**
-     * @return DocBlockGenerator
+     * @return DocBlockGenerator|null
      */
     public function getDocBlock()
     {

test/Generator/AbstractMemberGeneratorTest.php

@@ -11,6 +11,7 @@
 
 use PHPUnit\Framework\TestCase;
 use Zend\Code\Generator\AbstractMemberGenerator;
+use Zend\Code\Generator\DocBlockGenerator;
 use Zend\Code\Generator\Exception\InvalidArgumentException;
 
 class AbstractMemberGeneratorTest extends TestCase
@@ -43,4 +44,21 @@ public function testSetDocBlockThrowsExceptionWithInvalidType()
         $this->expectException(InvalidArgumentException::class);
         $this->fixture->setDocBlock(new \stdClass());
     }
+
+    public function testRemoveDocBlock(): void
+    {
+        $this->fixture->setDocBlock(new DocBlockGenerator());
+
+        $this->fixture->removeDocBlock();
+
+        $this->assertNull($this->fixture->getDocBlock());
+    }
+
+    public function testRemoveDocBlockIsIdempotent(): void
+    {
+        $this->fixture->removeDocBlock();
+        $this->fixture->removeDocBlock();
+
+        $this->assertNull($this->fixture->getDocBlock());
+    }
 }