GraphQL\Doctrine\DocBlockReader

Complexity

Total Complexity

10

Size/Duplication

Total Lines	65
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

<?php
final class DocBlockReader
{
    private readonly string $comment;

A parse error occurred: Syntax error, unexpected T_STRING, expecting T_VARIABLE on line 15 at column 21

    public function __construct(ReflectionMethod $method)
    {
        $this->comment = $method->getDocComment() ?: '';
    }

    /**
     * Get the description of a method from the doc block.
     */
    public function getMethodDescription(): ?string
    {
        // Remove the comment markers
        $description = preg_replace('~\*/$~', '', $this->comment);
        $description = preg_replace('~^\s*(/\*\*|\* ?|\*/)~m', '', $description);

        // Keep everything before the first annotation
        $description = trim(explode('@', $description ?? '')[0]);

        // Drop common "Get" or "Return" in front of comment
        $description = ucfirst(preg_replace('~^(set|get|return)s? ~i', '', $description) ?? '');

        return $description ?: null;
    }

    /**
     * Get the parameter description.
     */
    public function getParameterDescription(ReflectionParameter $param): ?string
    {
        $name = preg_quote($param->getName());

        if (preg_match('~@param\h+\H+\h+\$' . $name . '\h+(.*)~', $this->comment, $m)) {
            return ucfirst(trim($m[1]));
        }

        return null;
    }

    /**
     * Get the parameter type.
     */
    public function getParameterType(ReflectionParameter $param): ?string
    {
        $name = preg_quote($param->getName());

        if (preg_match('~@param\h+(\H+)\h+\$' . $name . '(\h|\n)~', $this->comment, $m)) {
            return trim($m[1]);
        }

        return null;
    }

    /**
     * Get the return type.
     */
    public function getReturnType(): ?string
    {
        if (preg_match('~@return\h+(\H+)(\h|\n)~', $this->comment, $m)) {
            return trim($m[1]);
        }

        return null;
    }