PinkCrab\Route\Registration\Route_Manager

Complexity

Total Complexity

13

Size/Duplication

Total Lines	106
Duplicated Lines	0 %

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	from_route()	0	7	1
A	create_base_route_from_group()	0	13	3
A	execute()	0	2	1
A	unpack_group()	0	27	5
A	__construct()	0	3	1
A	from_group()	0	6	2

<?php

declare(strict_types=1);

/**
 * Handle the parsing and registering of route with WordPress.
 *
 * @package PinkCrab\Route\Route
 * @author Glynn Quelch glynn@pinkcrab.co.uk
 * @since 0.0.1
 */

namespace PinkCrab\Route\Registration;

use PinkCrab\Route\Route\Route;
use PinkCrab\Loader\Hook_Loader;
use PinkCrab\Route\Route_Exception;
use PinkCrab\Route\Route\Route_Group;
use PinkCrab\Route\Registration\WP_Rest_Registrar;

class Route_Manager {

	protected Hook_Loader $loader;
	protected WP_Rest_Registrar $registrar;

	public function __construct( WP_Rest_Registrar $registrar, Hook_Loader $hook_loader ) {
		$this->loader    = $hook_loader;
		$this->registrar = $registrar;
	}

	/**
	 * Registers a WP Rest Route from a passed Route model.
	 *
	 * @param Route $route
	 * @return self
	 */
	public function from_route( Route $route ): self {
		$this->loader->action(
			'rest_api_init',
			$this->registrar->create_callback( $route )
		);

		return $this;
	}

	/**
	 * Registers all routes from a group.
	 *
	 * @param \PinkCrab\Route\Route\Route_Group $group
	 * @return self
	 */
	public function from_group( Route_Group $group ): self {
		foreach ( $this->unpack_group( $group ) as $route ) {
			$this->from_route( $route );
		}

		return $this;
	}

	/**
	 * Unpacks a group into its routes with all shared (Auth & Argument) properties from the group
	 *
	 * @param \PinkCrab\Route\Route\Route_Group $group
	 * @return Route[]
	 * @throws Route_Exception code 102
	 */
	protected function unpack_group( Route_Group $group ): array {

		$routes = array();
		// Loop through each group
		foreach ( $group->get_rest_routes() as $method => $route ) {
			$populated_route = $this->create_base_route_from_group( $method, $group );

			// Replace args if set.
			foreach ( $route->get_arguments() as $key => $argument ) {
				$populated_route->argument( $argument );
			}

			// Extends any group based authentication with a route based.
			foreach ( $route->get_authentication() as $key => $auth_callback ) {
				$populated_route->authentication( $auth_callback );
			}

			// If we have no callback defined for route, throw.
			if ( is_null( $route->get_callback() ) ) {
				throw Route_Exception::callback_not_defined( $route );
			}

			$populated_route->callback( $route->get_callback() );

			$routes[ $method ] = $populated_route;
		}
		return $routes;
	}

	/**
	 * Generates a base route from a group for a defined method.
	 * Populates the groups namespace, authentication and arguemnts
	 * as inital values on the route.
	 *
	 * @param string $method
	 * @param Route_Group $group
	 * @return Route
	 */
	protected function create_base_route_from_group( string $method, Route_Group $group ): Route {
		$route = new Route( \strtoupper( $method ), $group->get_route() );
		$route->namespace( $group->get_namespace() );

		foreach ( $group->get_authentication() as $auth_callback ) {
			$route->authentication( $auth_callback );
		}

		foreach ( $group->get_arguments() as $argument ) {
			$route->argument( $argument );
		}

		return $route;
	}

	/**
	 * Registers all routes added to the loader
	 *
	 * @return void
	 */
	public function execute(): void {
		$this->loader->register_hooks();
	}

}