OpenApi::createPatternedPathFromRoute() - Code Metrics - Inspection of "WIP! v2.0.0" - sunrise-php/http-router - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — master (#34)

by Anatoly

created 2019-12-03 21:04 UTC

OpenApi::createPatternedPathFromRoute() A

↳ Parent: OpenApi

Complexity

Conditions	2
Paths	2

Size

Total Lines	10
Code Lines	5

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	6

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
eloc	5
c	1
b	0
f	0
dl	0
loc	10
ccs	0
cts	8
cp	0
rs	10
cc	2
nc	2
nop	1
crap	6

<?php declare(strict_types=1);

/**
 * It's free open-source software released under the MIT License.
 *
 * @author Anatoly Fenric <[email protected]>
 * @copyright Copyright (c) 2018, Anatoly Fenric
 * @license https://github.com/sunrise-php/http-router/blob/master/LICENSE
 * @link https://github.com/sunrise-php/http-router
 */

namespace Sunrise\Http\Router\OpenApi;

/**
 * Import classes
 */
use Doctrine\Common\Annotations\SimpleAnnotationReader;
use Sunrise\Http\Router\Annotation\OpenApi\Operation;
use Sunrise\Http\Router\Annotation\OpenApi\Parameter;
use Sunrise\Http\Router\Annotation\OpenApi\Schema;
use Sunrise\Http\Router\RouteCollectionInterface;
use Sunrise\Http\Router\RouteInterface;
use ReflectionClass;

/**
 * Import functions
 */
use function Sunrise\Http\Router\path_parse;

use function array_walk_recursive;
use function class_exists;
use function str_replace;
use function strtolower;

/**
 * OpenApi
 */
class OpenApi
{

    /**
     * @var RouteCollectionInterface
     */
    private $routes;

    /**
     * @var SimpleAnnotationReader
     */
    private $annotationReader;

    /**
     * @var array
     */
    private $description = [];

    /**
     * Constructor of the class
     *
     * @param string $title
     * @param string $version
     * @param RouteCollectionInterface $routes
     */
    public function __construct(string $title, string $version, RouteCollectionInterface $routes)
    {
        $this->routes = $routes;

        $this->annotationReader = new SimpleAnnotationReader();
        $this->annotationReader->addNamespace('Sunrise\Http\Router\Annotation');

        $this->description['openapi'] = '3.0.2';
        $this->description['info']['title'] = $title;
        $this->description['info']['version'] = $version;

        // auto build...
        $this->build();
    }

    /**
     * @return array
     */
    public function toArray() : array
    {
        return $this->description;
    }

    /**
     * @return void
     */
    private function build() : void
    {
        foreach ($this->routes->all() as $route) {
            $path = $this->createPatternedPathFromRoute($route);
            $operation = $this->createOperationAnnotationFromRoute($route);

            foreach ($route->getMethods() as $method) {
                $method = strtolower($method);

                $this->description['paths'][$path][$method]['operationId'] = $route->getName();
                $this->description['paths'][$path][$method] += $operation->toArray();
            }
        }

        $this->handleComponentSchemas();
    }

    /**
     * @param RouteInterface $route
     *
     * @return string
     *
     * @link https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#patterned-fields
     */
    private function createPatternedPathFromRoute(RouteInterface $route) : string
    {
        $path = $route->getPath();
        $attributes = path_parse($path);
        $attributes = /** @scrutinizer ignore-call */ path_parse($path);

        foreach ($attributes as $attribute) {
            $path = str_replace($attribute['raw'], '{' . $attribute['name'] . '}', $path);
        }

        return str_replace(['(', ')'], '', $path);
    }

    /**
     * @param RouteInterface $route
     *
     * @return Operation
     */
    private function createOperationAnnotationFromRoute(RouteInterface $route) : Operation
    {
        $source = $route->getRequestHandler();

        $operation = $this->annotationReader->getClassAnnotation(new ReflectionClass($source), Operation::class);

        if (!$operation) {
            $operation = new Operation();
        }

        $attributes = path_parse($route->getPath());
        $attributes = /** @scrutinizer ignore-call */ path_parse($route->getPath());

        foreach ($attributes as $attribute) {
            $parameter = new Parameter();
            $parameter->in = 'path';
            $parameter->name = $attribute['name'];
            $parameter->required = $attribute['isOptional'];

            $operation->parameters[] = $parameter;
        }

        return $operation;
    }

    /**
     * @return void
     */
    private function handleComponentSchemas() : void
    {
        array_walk_recursive($this->description, function (&$value, $key) {
            if (!('$ref' === $key && null !== $value && class_exists($value))) {
                return;
            }

            // the schema already exists...
            if (isset($this->description['components']['schemas'][$value])) {
                return;
            }

            $schema = $this->annotationReader->getClassAnnotation(new ReflectionClass($value), Schema::class);

            if (!$schema) {
                return;
            }

            $this->description['components']['schemas'][$value]['type'] = 'object';
            $this->description['components']['schemas'][$value] += $schema->toArray();

            $value = '#/components/schemas/' . $value;
        });
    }
}


sunrise-php / http-router

Pull Request — master (#34)

OpenApi::createPatternedPathFromRoute() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like