Rule::formatMessage() - Code Metrics - Inspection of "Make use of PHP 8 attributes" - yiisoft/validator - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#175)

by Alexander
created 2022-02-21 07:26 UTC
Rule::formatMessage() A

↳ Parent: Rule
Complexity

Conditions	2
Paths	2
Size

Total Lines	9
Code Lines	5
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	4
CRAP Score	2
Importance

Changes	2
Bugs	0	Features	0
Metric	Value
cc	2
eloc	5
nc	2
nop	2
dl	0
loc	9
ccs	4
cts	4
cp	1
crap	2
rs	10
c	2
b	0
f	0
<?php

declare(strict_types=1);

namespace Yiisoft\Validator;

use function is_callable;

/**
 * Rule represents a single value validation rule.
 */
abstract class Rule implements RuleInterface, ParametrizedRuleInterface, FormattableRuleInterface
{
    /**
     * To create an instance of a rule class, the static factory method `rule()` must be implemented
     * in the final class.
     *
     * Simple example:
     *
     * ```php
     * public static function rule(): self
     * {
     *     return new self();
     * }
     * ```
     *
     * Example with parameters:
     *
     * ```php
     * public static function rule(int $count, ConnectionInterface $connection): self
     * {
     *     $rule = new self();
     *     $rule->count = $count;
     *     $rule->connection = $connection;
     *     return $rule;
     * }
     * ```
     */
    public function __construct(
        private ?FormatterInterface $formatter = null,
        private bool $skipOnEmpty = false,
        private bool $skipOnError = false,
        /**
         * @var callable|null
         */
        private $when = null,
    ) {
    }

    /**
     * An alternative to chain calls for setting properties.
     *
     * Example:
     *
     * ```php
     * Rule::rule()->applyConfig(['skipOnError' => true]);
     * ```
     * is equivalent to:
     *
     * ```php
     * Rule::rule()->skipOnError(true);
     * ```
     *
     * @param array $config
     *
     * @return $this
     */
    final public function applyConfig($config): self
    {
        $rule = $this;
        foreach ($config as $methodName => $value) {
            $rule = $rule->$methodName($value);
        }

        return $rule;
    }

    /**
     * Validates the value
     *
     * @param mixed $value Value to be validated.
     * @param ValidationContext|null $context Optional validation context.
     *
     * @return Result
     */
    final public function validate($value, ?ValidationContext $context = null): Result
    {
        if ($this->skipOnEmpty && $this->isEmpty($value)) {
            return new Result();
        }

        if (
            ($this->skipOnError && $context && $context->getParameter(RuleSet::PARAMETER_PREVIOUS_RULES_ERRORED) === true) ||
            (is_callable($this->when) && !($this->when)($value, $context))
        ) {
            return new Result();
        }

        return $this->validateValue($value, $context);
    }

    /**
     * Validates the value. The method should be implemented by concrete validation rules.
     *
     * @param mixed $value Value to be validated.
     * @param ValidationContext|null $context Optional validation context.
     *
     * @return Result
     */
    abstract protected function validateValue($value, ?ValidationContext $context = null): Result;

    /**
     * @return static
     */
    public function withFormatter(?FormatterInterface $formatter): self
    {
        $new = clone $this;
        $new->formatter = $formatter;
        return $new;
    }

    protected function formatMessage(string $message, array $parameters = []): string
    {
        if ($this->formatter === null) {
            $this->formatter = new Formatter();
        }

        return $this->formatter->format(
        return $this->formatter->/** @scrutinizer ignore-call */ format(
            $message,
            $parameters
        );
    }

    /**
     * Add a PHP callable whose return value determines whether this rule should be applied.
     * By default, rule will always be applied.
     *
     * The signature of the callable should be `function ($value, ValidationContext $context): bool`,
     * where `$value` and `$context` refer to the value validated and the validation context.
     * The callable should return a boolean value.
     *
     * The following example will enable the validator only when the country currently selected is USA:
     *
     * ```php
     * function ($value, ValidationContext $context)) {
     *     if ($context === null) {
     *         return false;
     *     }
     *
     *     $dataSet = $context->getDataSet();
     *     if ($dataSet === null) {
     *         return false;
     *     }
     *
     *     return $dataSet->getAttributeValue('country') === Country::USA;
     * }
     * ```
     *
     * @param callable $callback
     *
     * @return static
     */
    public function when(callable $callback): self
    {
        $new = clone $this;
        $new->when = $callback;
        return $new;
    }

    public function skipOnError(bool $value): self
    {
        $new = clone $this;
        $new->skipOnError = $value;
        return $new;
    }

    /**
     * @param bool $value if validation should be skipped if value validated is empty
     *
     * @return static
     */
    public function skipOnEmpty(bool $value): self
    {
        $new = clone $this;
        $new->skipOnEmpty = $value;
        return $new;
    }

    /**
     * Checks if the given value is empty.
     * A value is considered empty if it is null, an empty array, or an empty string.
     * Note that this method is different from PHP empty(). It will return false when the value is 0.
     *
     * @param mixed $value the value to be checked
     *
     * @return bool whether the value is empty
     */
    protected function isEmpty($value): bool
    {
        return $value === null || $value === [] || $value === '';
    }

    /**
     * Get name of the rule to be used when rule is converted to array.
     * By default it returns base name of the class, first letter in lowercase.
     *
     * @return string
     */
    public function getName(): string
    {
        $className = static::class;
        return lcfirst(substr($className, strrpos($className, '\\') + 1));
    }

    /**
     * Returns rule options as array.
     *
     * @return array
     */
    public function getOptions(): array
    {
        return [
            'skipOnEmpty' => $this->skipOnEmpty,
            'skipOnError' => $this->skipOnError,
        ];
    }
}

yiisoft / validator

Pull Request — master (#175)

Rule::formatMessage() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
