nystudio107\autocomplete\base\Generator

Complexity

Total Complexity

10

Size/Duplication

Total Lines	92
Duplicated Lines	0 %

Importance

Changes	5
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	getGeneratorName()	0	3	1
A	regenerate()	0	2	1
A	generate()	0	2	1
A	getGeneratorStubsPath()	0	3	1
A	saveTemplate()	0	10	2
A	getGeneratedFilePath()	0	3	1
A	shouldRegenerateFile()	0	3	1
A	getStubFilePath()	0	3	1
A	delete()	0	3	1

<?php
/**
 * Autocomplete plugin for Craft CMS 3.x
 *
 * Provides Twig template IDE autocomplete of Craft CMS & plugin variables
 *
 * @link      https://nystudio107.com

The tag in position 1 should be the @copyright tag

 * @link      https://putyourlightson.com
 * @copyright Copyright (c) 2021 nystudio107

@copyright tag must contain a year and the name of the copyright holder

 * @copyright Copyright (c) 2021 PutYourLightsOn

@copyright tag must contain a year and the name of the copyright holder

 */

PHP version not specified

Missing @category tag in file comment

Missing @package tag in file comment

Missing @author tag in file comment

Missing @license tag in file comment

namespace nystudio107\autocomplete\base;

use nystudio107\autocomplete\Autocomplete;

use Craft;

/**

Missing short description in doc comment

 * @author    nystudio107

The tag in position 1 should be the @package tag

Content of the @author tag must be in the form "Display Name <username@example.com>"

Tag value for @author tag indented incorrectly; expected 2 spaces but found 4

 * @package   autocomplete

Package name "autocomplete" is not valid; consider "Autocomplete" instead

Tag value for @package tag indented incorrectly; expected 1 spaces but found 3

 * @since     1.0.0

The tag in position 3 should be the @author tag

Tag value for @since tag indented incorrectly; expected 3 spaces but found 5

 */

Missing @category tag in class comment

Missing @license tag in class comment

Missing @link tag in class comment

abstract class Generator implements GeneratorInterface
{
    // Public Static Methods
    // =========================================================================

    /**

Missing short description in doc comment

     * @inheritDoc
     */

Missing @return tag in function comment

    public static function getGeneratorName(): string
    {
        return '';
    }

    /**

Missing short description in doc comment

     * @inheritDoc
     */

Missing @return tag in function comment

    public static function getGeneratorStubsPath(): string
    {
        return Autocomplete::getInstance()->basePath . self::STUBS_DIR;
    }

    /**

Missing short description in doc comment

     * @inheritDoc
     */

Missing @return tag in function comment

    public static function generate()
    {
    }

    /**

Missing short description in doc comment

     * @inheritDoc
     */

Missing @return tag in function comment

    public static function regenerate()
    {
    }

    /**

Missing short description in doc comment

     * @inheritDoc
     */

Missing @return tag in function comment

    public static function delete()
    {
        unlink(static::getGeneratedFilePath());
    }

    // Protected Static Methods
    // =========================================================================

    /**
     * Save the template to disk, with variable substitution
     *
     * @param array $vars key/value variables to be replaced in the stub

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return bool Whether the template was successfully saved

Tag @return cannot be grouped with parameter tags in a doc comment

     */
    protected static function saveTemplate(array $vars): bool
    {
        $stub = file_get_contents(static::getStubFilePath());
        if ($stub) {
            $template = str_replace(array_keys($vars), array_values($vars), $stub);

            return !(file_put_contents(static::getGeneratedFilePath(), $template) === false);
        }

        return false;
    }

    /**
     * Don't regenerate the file if it already exists
     *
     * @return bool
     */
    protected static function shouldRegenerateFile(): bool
    {
        return !is_file(static::getGeneratedFilePath());
    }

    /**
     * Return a path to the generated autocomplete template file
     *
     * @return string
     */
    protected static function getGeneratedFilePath(): string
    {
        return Craft::$app->getPath()->getCompiledClassesPath() . DIRECTORY_SEPARATOR . static::getGeneratorName() . self::TEMPLATE_EXTENSION;
    }

    /**
     * Return a path to the autocomplete template stub
     *
     * @return string
     */
    protected static function getStubFilePath(): string
    {
        return static::getGeneratorStubsPath() . DIRECTORY_SEPARATOR . static::getGeneratorName() . self::STUBS_EXTENSION;
    }
}