NormalizesExpressions::normalizeArgument() - Code Metrics - Inspection of "declared strict types" - LaravelFreelancerNL/fluentaql - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Branch — next (ee2197)

by Bas
created 2021-10-17 19:30 UTC
NormalizesExpressions::normalizeArgument() A

↳ Parent: NormalizesExpressions
Complexity

Conditions	4
Paths	4
Size

Total Lines	17
Code Lines	7
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	8
CRAP Score	4
Importance

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

declare(strict_types=1);

namespace LaravelFreelancerNL\FluentAQL\Traits;

use LaravelFreelancerNL\FluentAQL\Exceptions\ExpressionTypeException;
use LaravelFreelancerNL\FluentAQL\Expressions\Expression;
use LaravelFreelancerNL\FluentAQL\Expressions\ListExpression;
use LaravelFreelancerNL\FluentAQL\Expressions\NullExpression;
use LaravelFreelancerNL\FluentAQL\Expressions\ObjectExpression;
use LaravelFreelancerNL\FluentAQL\Expressions\PredicateExpression;
use LaravelFreelancerNL\FluentAQL\Expressions\QueryExpression;
use LaravelFreelancerNL\FluentAQL\Expressions\StringExpression;
use LaravelFreelancerNL\FluentAQL\QueryBuilder;

trait NormalizesExpressions
{

    abstract public function bind(mixed $data, string $to = null);

    /**
     * @param null|string[] $allowedExpressionTypes
     * @throws ExpressionTypeException
     */
    public function normalizeArgument(
        mixed $argument,
        array|string $allowedExpressionTypes = null
    ): Expression {
        if ($argument instanceof Expression) {
            return $argument;
        }

        if (is_scalar($argument)) {
            return $this->normalizeScalar($argument, $allowedExpressionTypes);
        }

        if (is_null($argument)) {
            return new NullExpression();
        }

        return $this->normalizeCompound($argument, $allowedExpressionTypes);
    }

    /**
     * @param array<mixed>|string|int|float|bool|null $argument
     * @param array<string>|string|null  $allowedExpressionTypes
     * @throws ExpressionTypeException
     */
    protected function normalizeScalar(
        array|string|int|float|bool|null $argument,
filter:
    dependency_paths: ["lib/*"]
        null|array|string $allowedExpressionTypes = null
    ): Expression {
        $argumentType = $this->determineArgumentType($argument, $allowedExpressionTypes);

        return $this->createExpression($argument, $argumentType);
    }

    protected function createExpression(
        mixed $argument,
        string $argumentType
    ): Expression {
        $expressionType = $this->grammar->mapArgumentTypeToExpressionType($argumentType);
        if ($expressionType == 'Bind') {
            return $this->bind($argument);
        }
        if ($expressionType == 'CollectionBind') {
            return $this->bindCollection($argument);
            return $this->/** @scrutinizer ignore-call */ bindCollection($argument);
        }
        $expressionClass = '\LaravelFreelancerNL\FluentAQL\Expressions\\' . $expressionType . 'Expression';

        return new $expressionClass($argument);
    }

    /**
     * @param array<mixed>|object $argument
     * @param array<string>|string|null  $allowedExpressionTypes
     * @return Expression
     * @throws ExpressionTypeException
     */
    protected function normalizeCompound(
        array|object $argument,
        null|array|string $allowedExpressionTypes = null
    ): Expression {
        if (is_array($argument)) {

            return $this->normalizeArray($argument, $allowedExpressionTypes);
        }
        if (!is_iterable($argument)) {
            return $this->normalizeObject($argument, $allowedExpressionTypes);
        }

        return new ObjectExpression($this->normalizeIterable((array) $argument, $allowedExpressionTypes));
    }

    /**
     * @param array<mixed> $argument
     * @param array<string>|string|null $allowedExpressionTypes
     * @return array<mixed>|Expression
     * @throws ExpressionTypeException
     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
     */
    protected function normalizeIterable(
        array $argument,
        null|array|string $allowedExpressionTypes = null
    ): array|Expression {
        foreach ($argument as $attribute => $value) {
            $argument[$attribute] = $this->normalizeArgument($value);
        }

        return $argument;
    }

    /**
     * @param array<mixed>|PredicateExpression $predicates
     * @return array<mixed>|PredicateExpression
     * @throws ExpressionTypeException
     */
    public function normalizePredicates(
        array|PredicateExpression $predicates
    ): array|PredicateExpression {
        if ($this->grammar->isPredicate($predicates)) {
            return $this->normalizePredicate($predicates);
        }

        $normalizedPredicates = [];
        if (is_iterable($predicates)) {
            foreach ($predicates as $predicate) {
                $normalizedPredicates[] = $this->normalizePredicates($predicate);
            }
        }

        return $normalizedPredicates;
    }

    /**
     * @param array<mixed>|PredicateExpression $predicate
     * @return PredicateExpression
     * @throws ExpressionTypeException
     */
    protected function normalizePredicate(array|PredicateExpression $predicate): PredicateExpression
    {
        if ($predicate instanceof PredicateExpression) {

            return $predicate;
        }

        $leftOperand = $this->normalizeArgument($predicate[0]);

        $comparisonOperator = null;
        if (isset($predicate[1])) {
            $comparisonOperator = $predicate[1];
        }


        $rightOperand = null;
        if (isset($predicate[2])) {
            $rightOperand = $this->normalizeArgument($predicate[2]);
        }

        $logicalOperator = 'AND';
        if (isset($predicate[3]) && $this->grammar->isLogicalOperator($predicate[3])) {
            $logicalOperator = $predicate[3];
        }

        return new PredicateExpression(
            $leftOperand,
            $comparisonOperator,
            $rightOperand,
            $logicalOperator
        );
    }

    /**
     * Return the first matching expression type for the argument from the allowed types.
     *
     * @param array<string>|string|null  $allowedExpressionTypes
     * @throws ExpressionTypeException
     */
    protected function determineArgumentType(
        mixed $argument,
        null|array|string $allowedExpressionTypes = null
    ): string {
        if (is_string($allowedExpressionTypes)) {

            $allowedExpressionTypes = [$allowedExpressionTypes];
        }
        if ($allowedExpressionTypes == null) {
            $allowedExpressionTypes = $this->grammar->getAllowedExpressionTypes();
        }

        foreach ($allowedExpressionTypes as $allowedExpressionType) {
            $check = 'is' . $allowedExpressionType;
            if ($allowedExpressionType == 'Reference' || $allowedExpressionType == 'RegisteredVariable') {
                if ($this->grammar->$check($argument, $this->variables)) {
                    return $allowedExpressionType;
                }
            }

            if ($this->grammar->$check($argument)) {
                return $allowedExpressionType;
            }
        }

        throw new ExpressionTypeException(
            "This argument, 
            '{$argument}', does not match one of these expression types: "
                . implode(', ', $allowedExpressionTypes)
                . '.'
        );
    }

    /**
     * @param array<mixed> $argument
     * @param array<string>|string|null  $allowedExpressionTypes
     * @throws ExpressionTypeException
     */
    protected function normalizeArray(
        array $argument,
        null|array|string $allowedExpressionTypes = null
    ): Expression {
        if ($this->grammar->isAssociativeArray($argument)) {
            return new ObjectExpression($this->normalizeIterable($argument, $allowedExpressionTypes));
        }

        return new ListExpression($this->normalizeIterable($argument, $allowedExpressionTypes));
    }

    /**
     * @param array<string>|string|null $allowedExpressionTypes
     * @throws ExpressionTypeException
     */
    protected function normalizeObject(
        object $argument,
        null|array|string $allowedExpressionTypes = null
    ): Expression {
        if ($argument instanceof \DateTimeInterface) {
            return new StringExpression($argument->format(\DateTime::ATOM));
        }

        if ($argument instanceof QueryBuilder) {
            return new QueryExpression($argument);
        }

        return new ObjectExpression($this->normalizeIterable((array) $argument, $allowedExpressionTypes));
    }
}

LaravelFreelancerNL / fluentaql

Branch — next (ee2197)

NormalizesExpressions::normalizeArgument() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
