Detect and remove empty comment (#17)

ptscs/ruleset.xml

@@ -193,6 +193,7 @@
     <rule ref="SlevomatCodingStandard.Variables.UnusedVariable" />
     <rule ref="SlevomatCodingStandard.Functions.UnusedInheritedVariablePassedToClosure" />
     <rule ref="SlevomatCodingStandard.Commenting.DisallowOneLinePropertyDocComment" />
+    <rule ref="SlevomatCodingStandard.Commenting.EmptyComment" />
 
     <!-- Useless typehint -->
     <rule ref="SlevomatCodingStandard.TypeHints.PropertyTypeHint.UselessAnnotation" />

tests/Sniffs/Slevomat/Commenting/EmptyCommentTest.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+
+namespace Ptscs\Tests\Sniffs\Slevomat\Commenting;
+
+use Iterator;
+use Ptscs\Tests\SniffTestCase;
+use Ptscs\Tests\Utils\ErrorData;
+
+final class EmptyCommentTest extends SniffTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->appendExclude('Squiz.Classes.ClassFileName.NoMatch');
+    }
+
+    public static function provideTestData(): Iterator
+    {
+        yield[
+          [
+            new ErrorData(7, 'SlevomatCodingStandard.Commenting.EmptyComment.EmptyComment'),
+            new ErrorData(11, 'SlevomatCodingStandard.Commenting.EmptyComment.EmptyComment'),
+            new ErrorData(14, 'SlevomatCodingStandard.Commenting.EmptyComment.EmptyComment'),
+          ],
+        ];
+    }
+}

tests/Sniffs/Slevomat/Commenting/_data/EmptyComment.php.fixed

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace App;
+
+final class Foobar
+{
+    private $var1;
+
+    private $var2;
+
+    private $var3;
+}

tests/Sniffs/Slevomat/Commenting/_data/EmptyComment.php.inc

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+namespace App;
+
+final class Foobar
+{
+    /**
+     */
+    private $var1;
+
+    /***/
+    private $var2;
+
+    //
+    private $var3;
+}

tests/Sniffs/Slevomat/TypeHints/_data/ParameterTypeHint.php.fixed

@@ -4,8 +4,6 @@ namespace App;
 
 final class Foobar
 {
-    /**
-     */
     public function check(string $useless, array $list, $missing): void
     {
     }

tests/Sniffs/Slevomat/TypeHints/_data/ReturnTypeHint.php.fixed

@@ -4,8 +4,6 @@ namespace App;
 
 final class Foobar
 {
-    /**
-     */
     public function useless(): string
     {
         return $this->value;

tests/Sniffs/Slevomat/TypeHints/_data/UselessDocblock.php.fixed

@@ -17,8 +17,6 @@ final class Foobar
         $this->value = $value;
     }
 
-    /**
-     */
     public function getValue(): string
     {
         return $this->value;