Create "Decimal" rule

Signed-off-by: Henrique Moody <[email protected]>

docs/rules/Decimal.md

@@ -0,0 +1,53 @@
+# Decimal
+
+- `Decimal(int $decimals)`
+
+Validates whether the input matches the expected number of decimals.
+
+```php
+v::decimals(2)->validate('27990.50'); // true
+v::decimals(1)->validate('27990.50'); // false
+v::decimal(1)->validate(1.5); // true
+
+```
+
+## Known limitations
+
+When validating float types, it is not possible to determine the amount of
+ending zeros and because of that, validations like the ones below will pass.
+
+```php
+v::decimal(1)->validate(1.50); // true
+```
+
+
+## Categorization
+
+- Numbers
+
+## Changelog
+
+Version | Description
+--------|-------------
+  2.0.0 | Removed support to whitespaces by default
+  0.5.0 | Renamed from `Digits` to `Digit`
+  0.3.9 | Created as `Digits`
+
+***
+See also:
+
+- [Alnum](Alnum.md)
+- [Alpha](Alpha.md)
+- [Consonant](Consonant.md)
+- [CreditCard](CreditCard.md)
+- [Factor](Factor.md)
+- [Finite](Finite.md)
+- [Infinite](Infinite.md)
+- [IntType](IntType.md)
+- [IntVal](IntVal.md)
+- [NotEmoji](NotEmoji.md)
+- [NumericVal](NumericVal.md)
+- [Regex](Regex.md)
+- [Uuid](Uuid.md)
+- [Vowel](Vowel.md)
+- [Xdigit](Xdigit.md)

library/ChainedValidator.php

@@ -101,6 +101,8 @@ public function date(string $format = 'Y-m-d'): ChainedValidator;
 
     public function dateTime(?string $format = null): ChainedValidator;
 
+    public function decimal(int $decimals): ChainedValidator;
+
     public function digit(string ...$additionalChars): ChainedValidator;
 
     public function directory(): ChainedValidator;

library/Exceptions/DecimalException.php

@@ -0,0 +1,32 @@
+<?php
+
+/*
+ * This file is part of Respect/Validation.
+ *
+ * (c) Alexandre Gomes Gaigalas <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE file
+ * that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Respect\Validation\Exceptions;
+
+/**
+ * @author Henrique Moody <[email protected]>
+ */
+final class DecimalException extends ValidationException
+{
+    /**
+     * {@inheritDoc}
+     */
+    protected $defaultTemplates = [
+        self::MODE_DEFAULT => [
+            self::STANDARD => '{{name}} must have {{decimals}} decimals',
+        ],
+        self::MODE_NEGATIVE => [
+            self::STANDARD => '{{name}} must not have {{decimals}} decimals',
+        ],
+    ];
+}

library/Rules/Decimal.php

@@ -0,0 +1,75 @@
+<?php
+
+/*
+ * This file is part of Respect/Validation.
+ *
+ * (c) Alexandre Gomes Gaigalas <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE file
+ * that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Respect\Validation\Rules;
+
+use function is_numeric;
+use function is_string;
+use function number_format;
+use function preg_replace;
+use function var_export;
+
+/**
+ * Validates the decimal
+ *
+ * @author Henrique Moody <[email protected]>
+ */
+final class Decimal extends AbstractRule
+{
+    /**
+     * @var int
+     */
+    private $decimals;
+
+    public function __construct(int $decimals)
+    {
+        $this->decimals = $decimals;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function validate($input): bool
+    {
+        if (!is_numeric($input)) {
+            return false;
+        }
+
+        return $this->toFormattedString($input) === $this->toRawString($input);
+    }
+
+    /**
+     * @param mixed $input
+     */
+    private function toRawString($input): string
+    {
+        if (is_string($input)) {
+            return $input;
+        }
+
+        return var_export($input, true);
+    }
+
+    /**
+     * @param mixed $input
+     */
+    private function toFormattedString($input): string
+    {
+        $formatted = number_format((float) $input, $this->decimals, '.', '');
+        if (is_string($input)) {
+            return $formatted;
+        }
+
+        return preg_replace('/^(\d.\d)0*/', '$1', $formatted);
+    }
+}

library/StaticValidator.php

@@ -101,6 +101,8 @@ public static function date(string $format = 'Y-m-d'): ChainedValidator;
 
     public static function dateTime(?string $format = null): ChainedValidator;
 
+    public static function decimal(int $decimals): ChainedValidator;
+
     public static function digit(string ...$additionalChars): ChainedValidator;
 
     public static function directory(): ChainedValidator;

tests/integration/rules/decimal.phpt

@@ -0,0 +1,42 @@
+--CREDITS--
+Henrique Moody <[email protected]>
+--FILE--
+<?php
+
+declare(strict_types=1);
+
+require 'vendor/autoload.php';
+
+use Respect\Validation\Exceptions\DecimalException;
+use Respect\Validation\Exceptions\NestedValidationException;
+use Respect\Validation\Validator as v;
+
+try {
+    v::decimal(3)->check(0.1234);
+} catch (DecimalException $exception) {
+    echo $exception->getMessage() . PHP_EOL;
+}
+
+try {
+    v::decimal(2)->assert(0.123);
+} catch (NestedValidationException $exception) {
+    echo $exception->getFullMessage() . PHP_EOL;
+}
+
+try {
+    v::not(v::decimal(5))->check(0.12345);
+} catch (DecimalException $exception) {
+    echo $exception->getMessage() . PHP_EOL;
+}
+
+try {
+    v::not(v::decimal(2))->assert(0.34);
+} catch (NestedValidationException $exception) {
+    echo $exception->getFullMessage() . PHP_EOL;
+}
+?>
+--EXPECT--
+0.1234 must have 3 decimals
+- 0.123 must have 2 decimals
+0.12345 must not have 5 decimals
+- 0.34 must not have 2 decimals

tests/unit/Rules/DecimalTest.php

@@ -0,0 +1,75 @@
+<?php
+
+/*
+ * This file is part of Respect/Validation.
+ *
+ * (c) Alexandre Gomes Gaigalas <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE file
+ * that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Respect\Validation\Rules;
+
+use Respect\Validation\Test\RuleTestCase;
+use stdClass;
+
+use function acos;
+use function sqrt;
+
+use const NAN;
+
+/**
+ * @group rule
+ *
+ * @covers \Respect\Validation\Rules\Decimal
+ *
+ * @author Henrique Moody <[email protected]>
+ * @author Ismael Elias <[email protected]>
+ * @author Vitaliy <[email protected]>
+ */
+final class DecimalTest extends RuleTestCase
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function providerForValidInput(): array
+    {
+        return [
+            [new Decimal(0), 1],
+            [new Decimal(1), 1.0],
+            [new Decimal(2), 1.00],
+            [new Decimal(3), 1.000],
+            [new Decimal(2), 1.000],
+            [new Decimal(1), 1.000],
+            [new Decimal(2), '27990.50'],
+            [new Decimal(1), 1.1],
+            [new Decimal(1), '1.3'],
+            [new Decimal(1), 1.50],
+            [new Decimal(3), '1.000'],
+            [new Decimal(3), 123456789.001],
+        ];
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function providerForInvalidInput(): array
+    {
+        return [
+            [new Decimal(1), '1.50'],
+            [new Decimal(1), '27990.50'],
+            [new Decimal(0), 2.0],
+            [new Decimal(0), acos(1.01)],
+            [new Decimal(0), sqrt(-1)],
+            [new Decimal(0), NAN],
+            [new Decimal(0), -NAN],
+            [new Decimal(0), false],
+            [new Decimal(0), true],
+            [new Decimal(0), []],
+            [new Decimal(0), new stdClass()],
+        ];
+    }
+}