OpenApi::setVersion() - 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:42 UTC
OpenApi::setVersion() A

↳ Parent: OpenApi
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	0
CRAP Score	2
Importance

Changes
Metric	Value
eloc	1
c	0
b	0
f	0
dl	0
loc	3
ccs	0
cts	3
cp	0
rs	10
cc	1
nc	1
nop	1
crap	2
<?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\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
{

    /**
     * Version of OpenAPI specification
     *
     * @var string
     */
    public const VERSION = '3.0.2';

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

    /**
     * @var RouteInterface[]
     */
    private $routes = [];

    /**
     * @var string
     */
    private $title = 'REST API';

    /**
     * @var string
     */
    private $version = '0.0.1';

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

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

    /**
     * Constructor of the class
     */
    public function __construct()
    {
        $this->annotationReader = new SimpleAnnotationReader();
        $this->annotationReader->addNamespace('Sunrise\Http\Router\Annotation');
    }

    /**
     * @param RouteInterface ...$routes
     *
     * @return void
     */
    public function addRoute(RouteInterface ...$routes) : void
    {
        foreach ($routes as $route) {
            $this->routes[] = $route;
        }
    }

    /**
     * @param string $title
     *
     * @return void
     */
    public function setTitle(string $title) : void
    {
        $this->title = $title;
    }

    /**
     * @param string $version
     *
     * @return void
     */
    public function setVersion(string $version) : void
    {
        $this->version = $version;
    }

    /**
     * @return void
     */
    public function describe() : void
    {
        $this->description['openapi'] = self::VERSION;

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

        foreach ($this->routes 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();
    }

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

    /**
     * @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])) {
                $value = $this->schemasMap[$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();

            $this->schemasMap[$value] = '#/components/schemas/' . $value;
            $value = $this->schemasMap[$value];
        });
    }
}

sunrise-php / http-router

Pull Request — master (#34)

OpenApi::setVersion() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
