FRZB\Component\TransactionalMessenger\Helper\ClassHelper

Complexity

Total Complexity

12

Size/Duplication

Total Lines	62
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	1	1
A	getShortName()	0	3	1
A	getParentReflectionClass()	0	3	2
A	getReflectionAttributes()	0	3	1
A	getReflectionClass()	0	6	3
A	getInheritanceList()	0	10	4

<?php

declare(strict_types=1);

/**
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 *
 * Copyright (c) 2024 Mykhailo Shtanko fractalzombie@gmail.com
 *
 * For the full copyright and license information, please view the LICENSE.MD
 * file that was distributed with this source code.
 */

namespace FRZB\Component\TransactionalMessenger\Helper;

use JetBrains\PhpStorm\Immutable;

/** @internal */
#[Immutable]
final class ClassHelper
{
    final public const DEFAULT_SHORT_NAME = 'InvalidClassName';

    private function __construct() {}

    public static function getShortName(object|string $target): string
    {
        return self::getReflectionClass($target)?->getShortName() ?? self::DEFAULT_SHORT_NAME;
    }

    public static function getInheritanceList(object|string $target): array
    {
        $isTargetObject = \is_object($target);
        $targetClass = $isTargetObject ? $target::class : $target;

        if (!class_exists($targetClass)) {
            return [];
        }

        return [$targetClass => $targetClass, ...(class_parents($target, false) ?: [])];
    }

    /**
     * @psalm-template TTarget
     *
     * @psalm-param class-string<TTarget>|TTarget $target
     *
     * @psalm-return ?\ReflectionClass<TTarget>
     */
    public static function getReflectionClass(object|string $target): ?\ReflectionClass
    {
        try {
            return $target instanceof \ReflectionClass ? $target : new \ReflectionClass($target);
        } catch (\ReflectionException) {
            return null;
        }
    }

    /**
     * @psalm-template TTarget
     *
     * @psalm-param class-string<TTarget>|TTarget $target
     *
     * @psalm-return ?\ReflectionClass<TTarget>
     */
    public static function getParentReflectionClass(object|string $target): ?\ReflectionClass
    {
        return self::getReflectionClass($target)?->getParentClass() ?: null;
    }

    /**
     * @psalm-template TTarget
     *
     * @psalm-param class-string<TTarget>|TTarget $target
     *
     * @psalm-return \Iterator<\ReflectionAttribute<TTarget>>
     */
    public static function getReflectionAttributes(object|string $target, string $attributeClass): iterable
    {
        return self::getReflectionClass($target)?->getAttributes($attributeClass, \ReflectionAttribute::IS_INSTANCEOF) ?? [];
    }
}