InputParam::__construct() - Code Metrics - Inspection of "#[Input] Domain Parameters" - bearsunday/BEAR.Resource - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — 1.x (#321)

by Akihito
created 2025-06-25 19:01 UTC
InputParam::__construct() A

↳ Parent: InputParam
Complexity

Conditions	2
Paths	2
Size

Total Lines	7
Code Lines	3
Duplication

Lines	0
Ratio	0 %
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	2
eloc	3
nc	2
nop	2
dl	0
loc	7
rs	10
c	1
b	0
f	0
<?php

declare(strict_types=1);

namespace BEAR\Resource;

use BackedEnum;
use BEAR\Resource\Annotation\Input;
use BEAR\Resource\Exception\ParameterEnumTypeException;
use BEAR\Resource\Exception\ParameterException;
use BEAR\Resource\Exception\ParameterInvalidEnumException;
use InvalidArgumentException;
use Ray\Di\InjectorInterface;
use ReflectionClass;
use ReflectionEnum;
filter:
    dependency_paths: ["lib/*"]
use ReflectionMethod;
use ReflectionNamedType;
use ReflectionParameter;
use Throwable;
use UnitEnum;

use function assert;
use function class_exists;
use function count;
use function enum_exists;

use function is_a;
use function is_array;
use function is_int;
use function is_iterable;
use function is_string;
use function ltrim;
use function preg_replace;
use function strtolower;

final class InputParam implements ParamInterface
{
    private readonly string $type;
    private readonly bool $isDefaultAvailable;
    private readonly mixed $defaultValue;

    public function __construct(
        ReflectionNamedType $type,
        private readonly ReflectionParameter $parameter,
    ) {
        $this->type = $type->getName();

        $this->isDefaultAvailable = $parameter->isDefaultValueAvailable();

        $this->defaultValue = $this->isDefaultAvailable ? $parameter->getDefaultValue() : null;

    }

    /**
     * {@inheritDoc}
     */

    /** @param array<string, mixed> $query */
    public function __invoke(string $varName, array $query, InjectorInterface $injector): mixed
    {
        /** @var class-string $type */
        $type = $this->type;
        /** @psalm-suppress MixedArgument */
        assert(class_exists($type) || enum_exists($type));
        assert(class_exists($type) || /** @scrutinizer ignore-call */ enum_exists($type));
        $refClass = new ReflectionClass($type);

        // Handle enums
        if ($refClass->isEnum()) {
        if ($refClass->/** @scrutinizer ignore-call */ isEnum()) {
            return $this->createEnum($varName, $query);
        }

        $constructor = $refClass->getConstructor();
        if ($constructor === null) {
            // Handle classes without constructor (like ClassParam does)
            return $this->createWithoutConstructor($varName, $query);
        }

        // Check if this parameter has #[Input] attribute
        $inputAttr = $this->getInputAttribute($this->parameter);

        // If no #[Input] attribute, use ClassParam behavior (structured data with parameter name as key)
        if ($inputAttr === null) {
            return $this->createFromStructuredData($refClass, $constructor, $varName, $query, $injector);
        }

        // If #[Input] has key specified, use structured data approach
        if ($inputAttr->key !== null) {
            return $this->createFromStructuredData($refClass, $constructor, $inputAttr->key, $query, $injector);
        }

        try {
            /** @var list<mixed> $constructorArgs */
            $constructorArgs = [];

            foreach ($constructor->getParameters() as $param) {
                $paramName = $param->getName();

                // Check if parameter has #[Input] attribute for nested input objects
                $inputAttr = $this->getInputAttribute($param);
                if ($inputAttr !== null) {
                    $paramType = $param->getType();
                    if ($paramType instanceof ReflectionNamedType) {
                        $nestedInputParam = new InputParam($paramType, $param);
                        /** @psalm-suppress MixedAssignment */
                        $constructorArgs[] = $nestedInputParam($paramName, $query, $injector);
                        continue;
                    }
                }

                // Use query parameter if available (with snake_case/kebab-case support)
                $paramValue = $this->getParamValue($paramName, $query);
                if ($paramValue !== null) {
                    /** @psalm-suppress MixedAssignment */
                    $constructorArgs[] = $paramValue;
                    continue;
                }

                // Use default value if available
                if ($param->isDefaultValueAvailable()) {
                    /** @psalm-suppress MixedAssignment */
                    $constructorArgs[] = $param->getDefaultValue();
                    continue;
                }

                throw new ParameterException("Required parameter '{$paramName}' not found for {$this->type}");
            }

            return $refClass->newInstanceArgs($constructorArgs);
            return $refClass->newInstanceArgs(/** @scrutinizer ignore-type */ $constructorArgs);
        } catch (Throwable $e) {
            // Re-throw validation exceptions directly
            if ($e instanceof InvalidArgumentException) {
                throw $e;
            }

            throw new ParameterException("Failed to create {$this->type}: " . $e->getMessage(), 0, $e);
        }
    }

    private function getInputAttribute(ReflectionParameter $param): Input|null
    {
        $attributes = $param->getAttributes(Input::class);
        if (count($attributes) === 0) {
            return null;
        }

        return $attributes[0]->newInstance();
    }

    /**
     * Get parameter value from query with camelCase/kebab-case support
     *
     * @param array<string, mixed> $query
     */
    private function getParamValue(string $paramName, array $query): mixed
    {
        // Try exact match first
        if (isset($query[$paramName])) {
            return $query[$paramName];
        }

        // Try kebab-case version (camelCase -> kebab-case)
        $kebabName = ltrim(strtolower((string) preg_replace('/[A-Z]/', '-\0', $paramName)), '-');
        if (isset($query[$kebabName])) {
            return $query[$kebabName];
        }

        return null;
    }

    /**
     * Create object from structured data (ClassParam style)
     *
     * @param ReflectionClass<object> $refClass
     * @param array<string, mixed>    $query
     */
    private function createFromStructuredData(
        ReflectionClass $refClass,
        ReflectionMethod $constructor,
        string $key,
        array $query,
        InjectorInterface $injector,
    ): mixed {
        // Get structured data from the specified key
        if (! isset($query[$key])) {
            if ($this->isDefaultAvailable) {
                return $this->defaultValue;
            }

            throw new ParameterException("Required key '{$key}' not found for {$this->type}");
        }

        $data = $query[$key];
        if (! is_array($data)) {
            throw new ParameterException("Data under key '{$key}' must be an array for {$this->type}");
        }

        try {
            /** @var list<mixed> $constructorArgs */
            $constructorArgs = [];

            foreach ($constructor->getParameters() as $param) {
                $paramName = $param->getName();

                // Check if parameter has #[Input] attribute for nested input objects
                $inputAttr = $this->getInputAttribute($param);
                if ($inputAttr !== null) {
                    $paramType = $param->getType();
                    if ($paramType instanceof ReflectionNamedType) {
                        $nestedInputParam = new InputParam($paramType, $param);
                        /** @var array<string, mixed> $dataForNested */
                        $dataForNested = $data;
                        /** @psalm-suppress MixedAssignment */
                        $constructorArgs[] = $nestedInputParam($paramName, $dataForNested, $injector);
                        continue;
                    }
                }

                // Use data parameter if available
                if (isset($data[$paramName])) {
                    /** @psalm-suppress MixedAssignment */
                    $constructorArgs[] = $data[$paramName];
                    continue;
                }

                // Use default value if available
                if ($param->isDefaultValueAvailable()) {
                    /** @psalm-suppress MixedAssignment */
                    $constructorArgs[] = $param->getDefaultValue();
                    continue;
                }

                throw new ParameterException("Required parameter '{$paramName}' not found in key '{$key}' for {$this->type}");
            }

            return $refClass->newInstanceArgs($constructorArgs);
            return $refClass->newInstanceArgs(/** @scrutinizer ignore-type */ $constructorArgs);
        } catch (Throwable $e) {
            // Re-throw validation exceptions directly
            if ($e instanceof InvalidArgumentException) {
                throw $e;
            }

            throw new ParameterException("Failed to create {$this->type} from key '{$key}': " . $e->getMessage(), 0, $e);
        }
    }

    /**
     * Create enum from query parameter (ClassParam style)
     *
     * @param array<string, mixed> $query
     */
    private function createEnum(string $varName, array $query): mixed
    {
        // Get the value using ClassParam behavior (snake_case conversion)
        $props = $this->getPropsForClassParam($varName, $query);

        /** @var class-string<UnitEnum> $type */
        $type = $this->type;
        $refEnum = new ReflectionEnum($type);
        assert(enum_exists($type));
        assert(/** @scrutinizer ignore-call */ enum_exists($type));

        if (! $refEnum->isBacked()) {
            throw new NotBackedEnumException($type);
        }

        assert(is_a($type, BackedEnum::class, true));
        if (! (is_int($props) || is_string($props))) {
            // If props is not a scalar but we have a default value, return it
            if ($this->isDefaultAvailable) {
                return $this->defaultValue;
            }

            throw new ParameterEnumTypeException($varName);
        }

        // Get the backing type of the enum
        $backingType = $refEnum->getBackingType();
        if ($backingType instanceof ReflectionNamedType && $backingType->getName() === 'int' && is_string($props)) {
            // Convert string to int for int-backed enums
            $props = (int) $props;
        }

        /** @psalm-suppress MixedAssignment */
        $value = $type::tryFrom($props);
        if ($value === null) {
            throw new ParameterInvalidEnumException($varName);
        }

        return $value;
    }

    /**
     * Create object without constructor (ClassParam style)
     *
     * @param array<string, mixed> $query
     */
    private function createWithoutConstructor(string $varName, array $query): mixed
    {
        // Get the props using ClassParam behavior
        $props = $this->getPropsForClassParam($varName, $query);

        if (! is_iterable($props)) {
            if ($this->isDefaultAvailable) {
                return $this->defaultValue;
            }

            throw new ParameterException("Expected array data for {$this->type}");
        }

        /** @var class-string $type */
        $type = $this->type;
        /** @psalm-suppress MixedMethodCall */
        $obj = new $type();
        /** @psalm-suppress MixedAssignment */
        foreach ($props as $propName => $propValue) {
            $obj->{$propName} = $propValue;
        }

        return $obj;
    }

    /**
     * Get props using ClassParam behavior (snake_case conversion like QueryProp)
     *
     * @param array<string, mixed> $query
     */
    private function getPropsForClassParam(string $varName, array $query): mixed
    {
        if (isset($query[$varName])) {
            return $query[$varName];
        }

        // try snake_case variable name (ClassParam compatible)
        $snakeName = ltrim(strtolower((string) preg_replace('/[A-Z]/', '_\0', $varName)), '_');
        if (isset($query[$snakeName])) {
            return $query[$snakeName];
        }

        if ($this->isDefaultAvailable) {
            return $this->defaultValue;
        }

        throw new ParameterException($varName);
    }
}

bearsunday / BEAR.Resource

Pull Request — 1.x (#321)

InputParam::__construct() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
