Apply contribution guidelines to "PrimeNumber" rule

Co-Authored-By: Henrique Moody <henriquemoody@gmail.com>

library/Exceptions/PrimeNumberException.php

@@ -13,8 +13,16 @@ declare(strict_types=1);
 
 namespace Respect\Validation\Exceptions;
 
-class PrimeNumberException extends ValidationException
+/**
+ * @author Henrique Moody <henriquemoody@gmail.com>
+ * @author Ismael Elias <ismael.esq@hotmail.com>
+ * @author Kleber Hamada Sato <kleberhs007@yahoo.com>
+ */
+final class PrimeNumberException extends ValidationException
 {
+    /**
+     * {@inheritdoc}
+     */
     public static $defaultTemplates = [
         self::MODE_DEFAULT => [
             self::STANDARD => '{{name}} must be a valid prime number',

library/Rules/PrimeNumber.php

@@ -13,8 +13,24 @@ declare(strict_types=1);
 
 namespace Respect\Validation\Rules;
 
-class PrimeNumber extends AbstractRule
+use function ceil;
+use function is_numeric;
+use function sqrt;
+
+/**
+ * Validates whether the input is a prime number.
+ *
+ * @author Alexandre Gomes Gaigalas <alexandre@gaigalas.net>
+ * @author Camilo Teixeira de Melo <kmilotxm@users.noreply.github.com>
+ * @author Henrique Moody <henriquemoody@gmail.com>
+ * @author Ismael Elias <ismael.esq@hotmail.com>
+ * @author Kleber Hamada Sato <kleberhs007@yahoo.com>
+ */
+final class PrimeNumber extends AbstractRule
 {
+    /**
+     * {@inheritdoc}
+     */
     public function validate($input): bool
     {
         if (!is_numeric($input) || $input <= 1) {

tests/integration/rules/primeNumber.phpt

@@ -0,0 +1,37 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use Respect\Validation\Exceptions\NestedValidationException;
+use Respect\Validation\Exceptions\PrimeNumberException;
+use Respect\Validation\Validator as v;
+
+try {
+    v::primeNumber()->check(10);
+} catch (PrimeNumberException $exception) {
+    echo $exception->getMessage().PHP_EOL;
+}
+
+try {
+    v::not(v::primeNumber())->check(3);
+} catch (PrimeNumberException $exception) {
+    echo $exception->getMessage().PHP_EOL;
+}
+
+try {
+    v::primeNumber()->assert('Foo');
+} catch (NestedValidationException $exception) {
+    echo $exception->getFullMessage().PHP_EOL;
+}
+
+try {
+    v::not(v::primeNumber())->assert('+7');
+} catch (NestedValidationException $exception) {
+    echo $exception->getFullMessage().PHP_EOL;
+}
+?>
+--EXPECTF--
+10 must be a valid prime number
+3 must not be a valid prime number
+- "Foo" must be a valid prime number
+- "+7" must not be a valid prime number

tests/unit/Rules/PrimeNumberTest.php

@@ -13,70 +13,58 @@ declare(strict_types=1);
 
 namespace Respect\Validation\Rules;
 
-use PHPUnit\Framework\TestCase;
+use Respect\Validation\Test\RuleTestCase;
 
 /**
- * @group  rule
+ * @group rule
+ *
  * @covers \Respect\Validation\Rules\PrimeNumber
- * @covers \Respect\Validation\Exceptions\PrimeNumberException
+ *
+ * @author Gabriel Caruso <carusogabriel34@gmail.com>
+ * @author Henrique Moody <henriquemoody@gmail.com>
+ * @author Ismael Elias <ismael.esq@hotmail.com>
+ * @author Kleber Hamada Sato <kleberhs007@yahoo.com>
  */
-class PrimeNumberTest extends TestCase
+final class PrimeNumberTest extends RuleTestCase
 {
-    protected $object;
-
-    protected function setUp(): void
+    /*
+    * {@inheritdoc}
+    */
+    public function providerForValidInput(): array
     {
-        $this->object = new PrimeNumber();
-    }
+        $rule = new PrimeNumber();
 
-    /**
-     * @dataProvider providerForPrimeNumber
-     */
-    public function testPrimeNumber($input): void
-    {
-        self::assertTrue($this->object->__invoke($input));
-        $this->object->check($input);
-        $this->object->assert($input);
-    }
-
-    /**
-     * @dataProvider providerForNotPrimeNumber
-     * @expectedException \Respect\Validation\Exceptions\PrimeNumberException
-     */
-    public function testNotPrimeNumber($input): void
-    {
-        self::assertFalse($this->object->__invoke($input));
-        $this->object->assert($input);
-    }
-
-    public function providerForPrimeNumber()
-    {
         return [
-            [3],
-            [5],
-            [7],
-            ['3'],
-            ['5'],
-            ['+7'],
+            [$rule, 3],
+            [$rule, 5],
+            [$rule, 7],
+            [$rule, '3'],
+            [$rule, '5'],
+            [$rule, '+7'],
         ];
     }
 
-    public function providerForNotPrimeNumber()
+    /*
+    * {@inheritdoc}
+    */
+    public function providerForInvalidInput(): array
     {
+        $rule = new PrimeNumber();
+
         return [
-            [''],
-            [null],
-            [0],
-            [10],
-            [25],
-            [36],
-            [-1],
-            ['-1'],
-            ['25'],
-            ['0'],
-            ['a'],
-            [' '],
-            ['Foo'],
+            [$rule, ''],
+            [$rule, null],
+            [$rule, 0],
+            [$rule, 10],
+            [$rule, 25],
+            [$rule, 36],
+            [$rule, -1],
+            [$rule, '-1'],
+            [$rule, '25'],
+            [$rule, '0'],
+            [$rule, 'a'],
+            [$rule, ' '],
+            [$rule, 'Foo'],
         ];
     }
 }