SilverLeague\IDEAnnotator\Generators\DocBlockGenerator

Complexity

Total Complexity

19

Size/Duplication

Total Lines	155
Duplicated Lines	0 %

Importance

Changes	4
Bugs	1	Features	0

7 Methods

Rating	Name	Duplication	Size	Complexity
B	mergeGeneratedTagsIntoDocBlock()	0	38	11
A	__construct()	0	10	2
A	getExistingTags()	0	10	2
A	removeExistingSupportedTags()	0	9	1
A	getExistingDocBlock()	0	3	1
A	getGeneratedTags()	0	3	1
A	getGeneratedDocBlock()	0	5	1

<?php

namespace SilverLeague\IDEAnnotator\Generators;

use phpDocumentor\Reflection\DocBlock;
use phpDocumentor\Reflection\DocBlock\Serializer;
use phpDocumentor\Reflection\DocBlock\Tag;
use phpDocumentor\Reflection\DocBlockFactory;
use SilverStripe\Control\Controller;
use InvalidArgumentException;
use LogicException;
use phpDocumentor\Reflection\DocBlock\Tags\BaseTag;
use phpDocumentor\Reflection\DocBlock\Tags\Method;
use phpDocumentor\Reflection\DocBlock\Tags\Mixin;
use phpDocumentor\Reflection\DocBlock\Tags\Property;
use ReflectionClass;
use ReflectionException;
use ReflectionObject;

/**
 * Class DocBlockGenerator
 *
 * @package IDEAnnotator/Generators
 */
class DocBlockGenerator
{
    /**
     * The current class we are working with
     * @var string
     */
    protected $className = '';

    /**
     * @var ReflectionClass
     */
    protected $reflector;

    /**
     * @var AbstractTagGenerator
     */
    protected $tagGenerator;

    /**
     * @var DocBlockFactory
     */
    protected $docBlockFactory;

    /**
     * DocBlockGenerator constructor.
     *
     * @param $className
     * @throws ReflectionException
     * @throws InvalidArgumentException
     */
    public function __construct($className)
    {
        $this->className = $className;
        $this->reflector = new ReflectionClass($className);
        $this->docBlockFactory = DocBlockFactory::createInstance();

        $generatorClass = $this->reflector->isSubclassOf(Controller::class)
            ? ControllerTagGenerator::class : OrmTagGenerator::class;

        $this->tagGenerator = new $generatorClass($className, $this->getExistingTags());
    }

    /**
     * @return Tag[]
     * @throws InvalidArgumentException
     */
    public function getExistingTags()
    {
        $docBlock = $this->getExistingDocBlock();
        if (!$docBlock) {
            return [];
        }

        $docBlock = $this->docBlockFactory->create($docBlock);

        return $docBlock->getTags();
    }

    /**
     * Not that in case there are multiple doblocks for a class,
     * the last one will be returned
     *
     * If we file old style generated docblocks we remove them
     *
     * @return bool|string
     */
    public function getExistingDocBlock()
    {
        return $this->reflector->getDocComment();
    }

    /**
     * @return DocBlock|string
     * @throws LogicException
     * @throws InvalidArgumentException
     */
    public function getGeneratedDocBlock()
    {
        $docBlock = $this->getExistingDocBlock();

        return $this->mergeGeneratedTagsIntoDocBlock($docBlock);
    }

    /**
     * @param string $existingDocBlock
     * @return string
     * @throws LogicException
     * @throws InvalidArgumentException
     */
    protected function mergeGeneratedTagsIntoDocBlock($existingDocBlock)
    {
        $docBlock = $this->docBlockFactory->create(($existingDocBlock ?: "/**\n*/"));

        $summary = $docBlock->getSummary();
        if (!$summary) {
            $summary = sprintf('Class \\%s', $this->className);
        }

        $generatedTags = $this->getGeneratedTags();
        $mergedTags = [];
        foreach ($generatedTags as $generatedTag) {
            $currentTag = $docBlock->getTagsByName($generatedTag->getName())[0] ?? null;

            // If there is an existing tag with the same name, preserve its description
            // There is no setDescription method so we use reflection
            if ($currentTag && $currentTag instanceof BaseTag && $currentTag->getDescription()) {
                $refObject = new ReflectionObject($generatedTag);
                $refProperty = $refObject->getProperty('description');
                $refProperty->setAccessible(true);
                $refProperty->setValue($generatedTag, $currentTag->getDescription());
            }
            $mergedTags[] = $generatedTag;
        }
        foreach ($docBlock->getTags() as $existingTag) {
            // Skip any property, method or mixin tag
            if ($existingTag instanceof Property || $existingTag instanceof Method || $existingTag instanceof Mixin) {
                continue;
            }
            $mergedTags[] = $existingTag;
        }

        $docBlock = new DocBlock($summary, $docBlock->getDescription(), $mergedTags);

        $serializer = new Serializer();
        $docBlock = $serializer->getDocComment($docBlock);

        return $docBlock;
    }

    /**
     * Remove all existing tags that are supported by this module.
     *
     * This will make sure that removed ORM properties and Extenions will not remain in the docblock,
     * while providing the option to manually add docblocks like @author etc.
     *
     * @param $docBlock
     * @return string
     */
    public function removeExistingSupportedTags($docBlock)
    {
        $replacements = [
            "/ \* @property ([\s\S]*?)\n/",
            "/ \* @method ([\s\S]*?)\n/",
            "/ \* @mixin ([\s\S]*?)\n/"
        ];

        return (string)preg_replace($replacements, '', $docBlock);
    }

    /**
     * @return Tag[]
     */
    public function getGeneratedTags()
    {
        return $this->tagGenerator->getTags();
    }
}