Mailcode\Mailcode_Translator

Complexity

Total Complexity

12

Size/Duplication

Total Lines	110
Duplicated Lines	0 %

Importance

Changes	2
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	2
A	getSyntaxes()	0	3	1
A	create()	0	7	2
A	resolveSyntaxClasses()	0	6	1
A	createApacheVelocity()	0	5	1
A	createHubL()	0	5	1
A	syntaxExists()	0	3	1
A	createSyntax()	0	14	2
A	getSyntaxNames()	0	3	1

<?php
/**
 * @package Mailcode
 * @subpackage Translator
 */

declare(strict_types=1);

namespace Mailcode;

use AppUtils\ClassHelper;
use Mailcode\Translator\Syntax\ApacheVelocitySyntax;
use Mailcode\Translator\Syntax\HubLSyntax;
use Mailcode\Translator\SyntaxInterface;

/**
 * Used to translate mailcode syntax to other syntaxes.
 *
 * @package Mailcode
 * @subpackage Translator
 * @author Sebastian Mordziol <s.mordziol@mistralys.eu>
 */
class Mailcode_Translator
{
    public const ERROR_INVALID_SYNTAX_NAME = 73001;

    /**
     * @var array<string,SyntaxInterface>
     */
    private array $syntaxes = array();

    private static ?Mailcode_Translator $instance = null;

    public static function create() : Mailcode_Translator
    {
        if(is_null(self::$instance)) {
            self::$instance = new self();
        }

        return self::$instance;

The expression return self::instance could return the type null which is incompatible with the type-hinted return Mailcode\Mailcode_Translator. Consider adding an additional type-check to rule them out.

    }

    public function __construct()
    {
        foreach($this->resolveSyntaxClasses() as $class) {
            $syntax = new $class();
            $this->syntaxes[$syntax->getTypeID()] = $syntax;
        }
    }

    /**
     * Creates an instance of the specified syntax.
     *
     * @param string $name The name of the syntax, e.g. {@see ApacheVelocitySyntax::SYNTAX_NAME}.
     * @return SyntaxInterface
     */
    public function createSyntax(string $name) : SyntaxInterface
    {
        if(isset($this->syntaxes[$name])) {
            return $this->syntaxes[$name];
        }

        throw new Mailcode_Exception(
            'Invalid translation syntax',
            sprintf(
                'The syntax [%s] does not exist. Possible values are: [%s].',
                $name,
                implode(', ', $this->getSyntaxNames())
            ),
            self::ERROR_INVALID_SYNTAX_NAME
        );
    }

    public function createApacheVelocity() : ApacheVelocitySyntax
    {
        return ClassHelper::requireObjectInstanceOf(
            ApacheVelocitySyntax::class,
            $this->createSyntax(ApacheVelocitySyntax::SYNTAX_NAME)
        );
    }

    public function createHubL() : HubLSyntax
    {
        return ClassHelper::requireObjectInstanceOf(
            HubLSyntax::class,
            $this->createSyntax(HubLSyntax::SYNTAX_NAME)
        );
    }

    /**
     * Retrieves an instance for each syntax available
     * in the system.
     *
     * @return SyntaxInterface[]
     */
    public function getSyntaxes() : array
    {
        return array_values($this->syntaxes);
    }

    /**
     * Retrieves a list of names for all syntaxes supported
     * by the system.
     *
     * @return string[]
     */
    public function getSyntaxNames() : array
    {
        return array_keys($this->syntaxes);
    }

    /**
     * @return class-string<SyntaxInterface>[]

The doc comment class-string<SyntaxInterface>[] at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<SyntaxInterface>[].

     */
    private function resolveSyntaxClasses() : array
    {
        return ClassCache::findClassesInFolder(
            __DIR__.'/Translator/Syntax',
            false,
            SyntaxInterface::class
        );
    }

    /**
     * Checks whether the specified syntax exists.
     *
     * @param string $name The syntax name, e.g. {@see ApacheVelocitySyntax::SYNTAX_NAME}.
     * @return bool
     */
    public function syntaxExists(string $name) : bool
    {
        return isset($this->syntaxes[$name]);
    }
}