SilverLeague\IDEAnnotator\Extensions\Annotatable

Complexity

Total Complexity

14

Size/Duplication

Total Lines	89
Duplicated Lines	0 %

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
B	afterCallActionHandler()	0	18	5
B	displayMessage()	0	12	6
A	getPermissionChecker()	0	3	1
A	getAnnotator()	0	3	1
A	setUp()	0	4	1

<?php

namespace SilverLeague\IDEAnnotator\Extensions;

use Psr\Container\NotFoundExceptionInterface;
use ReflectionException;
use SilverLeague\IDEAnnotator\DataObjectAnnotator;
use SilverLeague\IDEAnnotator\Helpers\AnnotatePermissionChecker;
use SilverStripe\Control\Director;
use SilverStripe\Core\Config\Config;
use SilverStripe\Core\Extension;
use SilverStripe\Core\Injector\Injector;

/**
 * Class Annotatable
 *
 * Annotate extension for the provided DataObjects for autocompletion purposes.
 * Start annotation, if skipannotation is not set and the annotator is enabled.
 *
 * @package IDEAnnotator/Extensions
 * @property \SilverStripe\Dev\DevBuildController|\SilverLeague\IDEAnnotator\Annotatable $owner
 */
class Annotatable extends Extension
{

    /**
     * Keep track ot the annotation actions for extensions
     * An Extension can belong to many DataObjects.
     * This prevents that an Extension is ran twice on dev/build
     * @var array
     */
    public static $annotated_extensions = [];
    /**
     * @var DataObjectAnnotator
     */
    protected $annotator;
    /**
     * @var AnnotatePermissionChecker
     */
    protected $permissionChecker;

    /**
     * Annotated Controllers and Extensions
     * @throws NotFoundExceptionInterface
     * @throws ReflectionException
     */
    public function afterCallActionHandler()
    {
        $envIsAllowed = Director::isDev() && DataObjectAnnotator::config()->get('enabled');
        $skipAnnotation = $this->owner->getRequest()->getVar('skipannotation');

        // Only instatiate things when we want to run it, this is for when the module is accidentally installed
        // on non-dev environments for example
        if ($skipAnnotation === null && $envIsAllowed) {
            $this->setUp();

            $this->displayMessage("Generating class docblocks", true, false);

            $modules = $this->permissionChecker->enabledModules();
            foreach ($modules as $module) {
                $this->annotator->annotateModule($module);
            }

            $this->displayMessage("Docblock generation finished!", true, true);
        }
    }

    /**
     * Annotatable setup.
     * This is theoretically a constructor, but to save memory we're using setup
     * called from {@see afterCallActionHandler}
     * @throws NotFoundExceptionInterface
     */
    public function setUp()
    {
        $this->annotator = Injector::inst()->get(DataObjectAnnotator::class);
        $this->permissionChecker = Injector::inst()->get(AnnotatePermissionChecker::class);
    }

    /**
     * @param $message
     */
    public function displayMessage($message, $heading = false, $end = false)
    {
        if ($heading) {
            if (!$end) {
                echo Director::is_cli() ?
                    strtoupper("\n" . $message . "\n\n") :
                    "<div class='build'><p><b>$message</b><ul>";
            } else {
                echo Director::is_cli() ? strtoupper("\n" . $message) : "</ul><p><b>$message</b></b></div>";
            }
        } else {
            echo Director::is_cli() ? "\n" . $message . "\n\n" : "<li>$message</li>";
        }
    }

    /**
     * @return DataObjectAnnotator
     */
    public function getAnnotator()
    {
        return $this->annotator;
    }

    /**
     * @return AnnotatePermissionChecker
     */
    public function getPermissionChecker()
    {
        return $this->permissionChecker;
    }
}