Jasny\SwitchRoute\Endpoint

Complexity

Total Complexity

10

Size/Duplication

Total Lines	122
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	2
Bugs	0	Features	0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
A	getUniqueRoutes()	0	18	2
A	getRoutes()	0	3	1
A	getVars()	0	9	2
A	getAllowedMethods()	0	3	1
A	getPath()	0	3	1
A	withRoute()	0	13	2

<?php

declare(strict_types=1);

namespace Jasny\SwitchRoute;

use OutOfBoundsException;

/**
 * Endpoint for routing.
 * @internal
 */
final class Endpoint
{
    /**
     * @var string
     */
    protected $path;

    /**
     * @var array[]
     */
    protected $routes = [];

    /**
     * @var array[]
     */
    protected $vars = [];


    /**
     * Endpoint constructor.
     *
     * @param string $path
     */
    public function __construct(string $path)
    {
        $this->path = $path;
    }

    /**
     * Add a route for this endpoint.
     *
     * @param string $method
     * @param mixed  $route
     * @param array  $vars
     * @return static
     */
    public function withRoute(string $method, $route, array $vars): self
    {
        $method = strtoupper($method);

        if (isset($this->routes[$method])) {
            throw new InvalidRouteException("Duplicate route for '$method {$this->path}'");
        }

        $copy = clone $this;
        $copy->routes[$method] = $route;
        $copy->vars[$method] = $vars;

        return $copy;
    }

    /**
     * Get the path of this endpoint.
     *
     * @return string
     */
    public function getPath(): string
    {
        return $this->path;
    }

    /**
     * Get the allowed methods for this endpoint.
     *
     * @return array
     */
    public function getAllowedMethods(): array
    {
        return array_diff(array_keys($this->routes), ['']);
    }

    /**
     * Get all routes for this endpoint.
     *
     * @return array[]
     */
    public function getRoutes(): array
    {
        return $this->routes;
    }

    /**
     * Get vars for a route.
     *
     * @param string $method
     * @return array[]
     */
    public function getVars(string $method): array
    {
        $method = strtoupper($method);

        if (!isset($this->vars[$method])) {
            throw new OutOfBoundsException("Method '$method' not available for endpoint '{$this->path}'");
        }

        return $this->vars[$method];
    }


    /**
     * Get unique routes with methods and vars.
     *
     * @return \Generator
     */
    public function getUniqueRoutes(): \Generator
    {
        $queue = array_keys($this->routes);

        while ($queue !== []) {
            $method = reset($queue);

            $route = $this->routes[$method];
            $vars = $this->vars[$method];

            $methods = array_values(array_intersect(
                array_keys($this->routes, $route, true),
                array_keys($this->vars, $vars, true)
            ));

            yield [$methods, $route, $vars];

            $queue = array_diff($queue, $methods);
        }
    }
}