PinkCrab\Perique\Services\View\Component\Component_Compiler

Complexity

Total Complexity

8

Size/Duplication

Total Lines	93
Duplicated Lines	0 %

Importance

Changes	2
Bugs	0	Features	1

4 Methods

Rating	Name	Duplication	Size	Complexity
A	compile()	0	2	1
A	get_annotation()	0	14	2
A	get_component_path()	0	28	4
A	__construct()	0	3	1

<?php

declare(strict_types=1);

/**
 * The base component class.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * @author Glynn Quelch <glynn.quelch@gmail.com>
 * @license http://www.opensource.org/licenses/mit-license.html  MIT License
 * @package PinkCrab\Perique\View
 * @since 1.2.0
 */

namespace PinkCrab\Perique\Services\View\Component;

use PinkCrab\Perique\Application\Hooks;
use PinkCrab\Perique\Services\View\View_Model;
use Doctrine\Common\Annotations\AnnotationReader;

The type Doctrine\Common\Annotations\AnnotationReader was not found. Maybe you did not declare it correctly or list all dependencies?

use Doctrine\Common\Annotations\AnnotationRegistry;

The type Doctrine\Common\Annotations\AnnotationRegistry was not found. Maybe you did not declare it correctly or list all dependencies?

use PinkCrab\Perique\Services\View\Component\Component;

class Component_Compiler {

	/**
	 * The base path for components.
	 *
	 * If blank will assume views/components
	 *
	 * @var string
	 */
	private string $component_base_path;

	/**
	 * All component aliases..
	 *
	 * @var array<string, string>
	 */
	private array $component_aliases = array();

	/**
	 * @param array<string, string> $component_aliases
	 */
	public function __construct( string $component_base_path = '', array $component_aliases = array() ) {
		$this->component_base_path = $component_base_path;
		$this->component_aliases   = \apply_filters( Hooks::COMPONENT_ALIASES, $component_aliases );
	}

	/**
	 * Compiles the component into a view model.
	 *
	 * @param Component $component
	 * @return View_Model
	 */
	public function compile( Component $component ): View_Model {
		return new View_Model( $this->get_component_path( $component ), $component->get_variables() );
	}

	/**
	 * Returns the path to the component.
	 *
	 * @param Component $component
	 * @return string
	 */
	private function get_component_path( Component $component ): string {

		// Check aliases.
		$aliases = \apply_filters( Hooks::COMPONENT_ALIASES, $this->component_aliases );

		if ( \array_key_exists( get_class( $component ), $this->component_aliases ) ) {
			return esc_attr( $aliases[ get_class( $component ) ] );
		}

		$from_annotation = $this->get_annotation( 'view', $component );

		// If it does have a path defined, use that.
		if ( ! empty( $from_annotation ) ) {
			return \trailingslashit( $this->component_base_path ) . $from_annotation;
		}

		// If the component has a defined path
		if ( $component->template() ) {

Are you sure the usage of $component->template() targeting PinkCrab\Perique\Services\View\Component\Component::template() seems to always return null.

			return \trailingslashit( $this->component_base_path ) . $component->template();

Are you sure $component->template() of type void can be used in concatenation?

Are you sure the usage of $component->template() targeting PinkCrab\Perique\Services\View\Component\Component::template() seems to always return null.

		}

		// Get path based on class name.
		$reflect    = new \ReflectionClass( $component );
		$short_name = $reflect->getShortName();
		// Add space between capitals, make lowercase and replace underscores with dashes.
		$short_name = strtolower( preg_replace( '/(?<!^)[A-Z]/', '$0', $short_name ) ?? '' );
		$short_name = str_replace( '_', '-', $short_name );
		return \trailingslashit( $this->component_base_path ) . $short_name;
	}

	/**
	 * Attempts to extract a defined Annotation from component class doc block.
	 *
	 * @param string    $annotation
	 * @param Component $component
	 * @return string|null
	 */
	private function get_annotation( string $annotation, Component $component ): ?string {
		$reflect = new \ReflectionClass( $component );
		$comment = $reflect->getDocComment();

		// if no comment, return null.
		if ( empty( $comment ) ) {
			return null;
		}

		// Check if the comment contains the annotation "@{$annotation}" using regex.
		$pattern = "/@{$annotation}\s+(.*)/";
		preg_match( $pattern, $comment, $matches );

		return $matches[1] ?? null;
	}
}