Executor - Code Metrics - Inspection of "[WIP] Enable error formatting customization" - overblog/GraphQLBundle - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#264)

by Jérémiah

created 2017-12-24 19:52 UTC

Executor A

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	214
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	7

Test Coverage

Coverage

100%

Importance

Changes

Metric	Value
wmc	27
lcom	1
cbo	7
dl	0
loc	214
ccs	84
cts	84
cp	1
rs	10
c	0
b	0
f	0

13 Methods

Rating	Name	Size	Complexity
A	addSchema()	6	1
A	__construct()	11	1
A	setExecutor()	6	1
A	setPromiseAdapter()	6	1
A	getSchema()	17	4
A	setMaxQueryDepth()	6	1
A	setMaxQueryComplexity()	6	1
B	execute()	24	3
A	preExecute()	21	2
A	postExecute()	15	2
A	checkPromiseAdapter()	12	4
A	checkExecutionResult()	8	3
A	createArrayObject()	10	3

<?php

namespace Overblog\GraphQLBundle\Request;

use GraphQL\Executor\ExecutionResult;
use GraphQL\Executor\Promise\Promise;
use GraphQL\Executor\Promise\PromiseAdapter;
use GraphQL\Type\Schema;
use GraphQL\Validator\DocumentValidator;
use GraphQL\Validator\Rules\QueryComplexity;
use GraphQL\Validator\Rules\QueryDepth;
use Overblog\GraphQLBundle\Event\Events;
use Overblog\GraphQLBundle\Event\ExecutorContextEvent;
use Overblog\GraphQLBundle\Event\ExecutorEvent;
use Overblog\GraphQLBundle\Event\ExecutorResultEvent;
use Overblog\GraphQLBundle\Executor\ExecutorInterface;
use Overblog\GraphQLBundle\Executor\Promise\PromiseAdapterInterface;
use Symfony\Component\EventDispatcher\EventDispatcherInterface;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class Executor
{
    const PROMISE_ADAPTER_SERVICE_ID = 'overblog_graphql.promise_adapter';

    /** @var Schema[] */
    private $schemas;

    /** @var EventDispatcherInterface|null */
    private $dispatcher;

    /** @var ExecutorInterface */
    private $executor;

    /** @var PromiseAdapter */
    private $promiseAdapter;

    /** @var callable|null */
    private $defaultFieldResolver;

    public function __construct(
        ExecutorInterface $executor,
        EventDispatcherInterface $dispatcher,
        PromiseAdapter $promiseAdapter = null,
        callable $defaultFieldResolver = null
    ) {
        $this->executor = $executor;
        $this->dispatcher = $dispatcher;
        $this->promiseAdapter = $promiseAdapter;
        $this->defaultFieldResolver = $defaultFieldResolver;
    }

    public function setExecutor(ExecutorInterface $executor)
    {
        $this->executor = $executor;

        return $this;
    }

    public function setPromiseAdapter(PromiseAdapter $promiseAdapter = null)
    {
        $this->promiseAdapter = $promiseAdapter;

        return $this;
    }

    /**
     * @param string $name
     * @param Schema $schema
     *
     * @return $this
     */
    public function addSchema($name, Schema $schema)
    {
        $this->schemas[$name] = $schema;

        return $this;
    }

    /**
     * @param string|null $name
     *
     * @return Schema
     */
    public function getSchema($name = null)
    {
        if (empty($this->schemas)) {
            throw new \RuntimeException('At least one schema should be declare.');
        }

        if (null === $name) {
            $schema = array_values($this->schemas)[0];
        } else {
            if (!isset($this->schemas[$name])) {
                throw new NotFoundHttpException(sprintf('Could not found "%s" schema.', $name));
            }
            $schema = $this->schemas[$name];
        }

        return $schema;
    }

    public function setMaxQueryDepth($maxQueryDepth)
    {
        /** @var QueryDepth $queryDepth */
        $queryDepth = DocumentValidator::getRule('QueryDepth');
        $queryDepth->setMaxQueryDepth($maxQueryDepth);
    }

    public function setMaxQueryComplexity($maxQueryComplexity)
    {
        /** @var QueryComplexity $queryComplexity */
        $queryComplexity = DocumentValidator::getRule('QueryComplexity');
        $queryComplexity->setMaxQueryComplexity($maxQueryComplexity);
    }

    /**
     * @param null|string                    $schemaName
     * @param array                          $request
     * @param null|array|\ArrayObject|object $rootValue
     * @param null|array|\ArrayObject|object $contextValue
     *
     * @return ExecutionResult
     */
    public function execute($schemaName, array $request, $rootValue = null, $contextValue = null)
    {
        $executorEvent = $this->preExecute(
            $this->getSchema($schemaName),
            isset($request[ParserInterface::PARAM_QUERY]) ? $request[ParserInterface::PARAM_QUERY] : null,
            self::createArrayObject($rootValue),
            self::createArrayObject($contextValue),
            $request[ParserInterface::PARAM_VARIABLES],
            isset($request[ParserInterface::PARAM_OPERATION_NAME]) ? $request[ParserInterface::PARAM_OPERATION_NAME] : null
        );

        $result = $this->executor->execute(
            $executorEvent->getSchema(),
            $executorEvent->getRequestString(),
            $executorEvent->getRootValue(),
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            $executorEvent->getContextValue(),
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            $executorEvent->getVariableValue(),
            $executorEvent->getOperationName()
        );

        $result = $this->postExecute($result);

        return $result;
    }

    /**
     * @param Schema       $schema
     * @param string       $requestString
     * @param \ArrayObject $rootValue
     * @param \ArrayObject $contextValue
     * @param array|null   $variableValue
     * @param string|null  $operationName
     *
     * @return ExecutorEvent
     */
    private function preExecute(
        Schema $schema, $requestString,
        \ArrayObject $rootValue,
        \ArrayObject $contextValue,
        array $variableValue = null,
        $operationName = null
    ) {
        $this->checkPromiseAdapter();

        $this->executor->setPromiseAdapter($this->promiseAdapter);
        // this is needed when not using only generated types
        if ($this->defaultFieldResolver) {
            $this->executor->setDefaultFieldResolver($this->defaultFieldResolver);
        }
        $this->dispatcher->dispatch(Events::EXECUTOR_CONTEXT, new ExecutorContextEvent($contextValue));

        return $this->dispatcher->dispatch(
            Events::PRE_EXECUTOR,
            new ExecutorEvent($schema, $requestString, $rootValue, $contextValue, $variableValue, $operationName)
        );
    }

    /**
     * @param ExecutionResult|Promise $result
     *
     * @return ExecutionResult
     */
    private function postExecute($result)
    {
        if ($this->promiseAdapter) {
            $result = $this->promiseAdapter->wait($result);
interface User
{
    /** @return string */
    public function getPassword();
}

class MyUser implements User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}
        }

        $this->checkExecutionResult($result);

        $event = $this->dispatcher->dispatch(
            Events::POST_EXECUTOR,
            new ExecutorResultEvent($result)
        );

        return $event->getResult();
    }

    private function checkPromiseAdapter()
    {
        if ($this->promiseAdapter && !$this->promiseAdapter instanceof PromiseAdapterInterface && !is_callable([$this->promiseAdapter, 'wait'])) {
            throw new \RuntimeException(
                sprintf(
                    'PromiseAdapter should be an object instantiating "%s" or "%s" with a "wait" method.',
                    PromiseAdapterInterface::class,
                    PromiseAdapter::class
                )
            );
        }
    }

    private function checkExecutionResult($result)
    {
        if (!is_object($result) || !$result instanceof ExecutionResult) {
            throw new \RuntimeException(
                sprintf('Execution result should be an object instantiating "%s".', ExecutionResult::class)
            );
        }
    }

    private static function createArrayObject($data)
    {
        if (is_array($data) || is_object($data)) {
            $object = new \ArrayObject($data);
        } else {
            $object = new \ArrayObject();
        }

        return $object;
    }
}


Scrutinizer GitHub App not installed

Pull Request — master (#264)

Executor A

Complexity

Size/Duplication

Coupling/Cohesion

Test Coverage

Importance

13 Methods

Available Fixes

1		<?php
2
3		namespace Overblog\GraphQLBundle\Request;
4
5		use GraphQL\Executor\ExecutionResult;
6		use GraphQL\Executor\Promise\Promise;
7		use GraphQL\Executor\Promise\PromiseAdapter;
8		use GraphQL\Type\Schema;
9		use GraphQL\Validator\DocumentValidator;
10		use GraphQL\Validator\Rules\QueryComplexity;
11		use GraphQL\Validator\Rules\QueryDepth;
12		use Overblog\GraphQLBundle\Event\Events;
13		use Overblog\GraphQLBundle\Event\ExecutorContextEvent;
14		use Overblog\GraphQLBundle\Event\ExecutorEvent;
15		use Overblog\GraphQLBundle\Event\ExecutorResultEvent;
16		use Overblog\GraphQLBundle\Executor\ExecutorInterface;
17		use Overblog\GraphQLBundle\Executor\Promise\PromiseAdapterInterface;
18		use Symfony\Component\EventDispatcher\EventDispatcherInterface;
19		use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
20
21		class Executor
22		{
23		const PROMISE_ADAPTER_SERVICE_ID = 'overblog_graphql.promise_adapter';
24
25		/** @var Schema[] */
26		private $schemas;
27
28		/** @var EventDispatcherInterface\|null */
29		private $dispatcher;
30
31		/** @var ExecutorInterface */
32		private $executor;
33
34		/** @var PromiseAdapter */
35		private $promiseAdapter;
36
37		/** @var callable\|null */
38		private $defaultFieldResolver;
39
40	77	public function __construct(
41		ExecutorInterface $executor,
42		EventDispatcherInterface $dispatcher,
43		PromiseAdapter $promiseAdapter = null,
44		callable $defaultFieldResolver = null
45		) {
46	77	$this->executor = $executor;
47	77	$this->dispatcher = $dispatcher;
48	77	$this->promiseAdapter = $promiseAdapter;
49	77	$this->defaultFieldResolver = $defaultFieldResolver;
50	77	}
51
52	2	public function setExecutor(ExecutorInterface $executor)
53		{
54	2	$this->executor = $executor;
55
56	2	return $this;
57		}
58
59	1	public function setPromiseAdapter(PromiseAdapter $promiseAdapter = null)
60		{
61	1	$this->promiseAdapter = $promiseAdapter;
62
63	1	return $this;
64		}
65
66		/**
67		* @param string $name
68		* @param Schema $schema
69		*
70		* @return $this
71		*/
72	69	public function addSchema($name, Schema $schema)
73		{
74	69	$this->schemas[$name] = $schema;
75
76	69	return $this;
77		}
78
79		/**
80		* @param string\|null $name
81		*
82		* @return Schema
83		*/
84	65	public function getSchema($name = null)
85		{
86	65	if (empty($this->schemas)) {
87	1	throw new \RuntimeException('At least one schema should be declare.');
88		}
89
90	64	if (null === $name) {
91	61	$schema = array_values($this->schemas)[0];
92		} else {
93	3	if (!isset($this->schemas[$name])) {
94	1	throw new NotFoundHttpException(sprintf('Could not found "%s" schema.', $name));
95		}
96	2	$schema = $this->schemas[$name];
97		}
98
99	63	return $schema;
100		}
101
102	73	public function setMaxQueryDepth($maxQueryDepth)
103		{
104		/** @var QueryDepth $queryDepth */
105	73	$queryDepth = DocumentValidator::getRule('QueryDepth');
106	73	$queryDepth->setMaxQueryDepth($maxQueryDepth);
107	73	}
108
109	73	public function setMaxQueryComplexity($maxQueryComplexity)
110		{
111		/** @var QueryComplexity $queryComplexity */
112	73	$queryComplexity = DocumentValidator::getRule('QueryComplexity');
113	73	$queryComplexity->setMaxQueryComplexity($maxQueryComplexity);
114	73	}
115
116		/**
117		* @param null\|string $schemaName
118		* @param array $request
119		* @param null\|array\|\ArrayObject\|object $rootValue
120		* @param null\|array\|\ArrayObject\|object $contextValue
121		*
122		* @return ExecutionResult
123		*/
124	63	public function execute($schemaName, array $request, $rootValue = null, $contextValue = null)
125		{
126	63	$executorEvent = $this->preExecute(
127	63	$this->getSchema($schemaName),
128	62	isset($request[ParserInterface::PARAM_QUERY]) ? $request[ParserInterface::PARAM_QUERY] : null,
129	62	self::createArrayObject($rootValue),
130	62	self::createArrayObject($contextValue),
131	62	$request[ParserInterface::PARAM_VARIABLES],
132	62	isset($request[ParserInterface::PARAM_OPERATION_NAME]) ? $request[ParserInterface::PARAM_OPERATION_NAME] : null
133		);
134
135	61	$result = $this->executor->execute(
136	61	$executorEvent->getSchema(),
137	61	$executorEvent->getRequestString(),
138	61	$executorEvent->getRootValue(),
		0 ignored issues – show Documentation introduced 2017-11-30 08:02 UTC by Report Bug Copy Issue Report `$executorEvent->getRootValue()` is of type `object<ArrayObject>`, but the function expects a `null\|array`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
139	61	$executorEvent->getContextValue(),
		0 ignored issues – show Documentation introduced 2017-11-30 08:02 UTC by Report Bug Copy Issue Report `$executorEvent->getContextValue()` is of type `object<ArrayObject>`, but the function expects a `null\|array`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
140	61	$executorEvent->getVariableValue(),
141	61	$executorEvent->getOperationName()
142		);
143
144	61	$result = $this->postExecute($result);
145
146	59	return $result;
147		}
148
149		/**
150		* @param Schema $schema
151		* @param string $requestString
152		* @param \ArrayObject $rootValue
153		* @param \ArrayObject $contextValue
154		* @param array\|null $variableValue
155		* @param string\|null $operationName
156		*
157		* @return ExecutorEvent
158		*/
159	62	private function preExecute(
160		Schema $schema, $requestString,
161		\ArrayObject $rootValue,
162		\ArrayObject $contextValue,
163		array $variableValue = null,
164		$operationName = null
165		) {
166	62	$this->checkPromiseAdapter();
167
168	61	$this->executor->setPromiseAdapter($this->promiseAdapter);
169		// this is needed when not using only generated types
170	61	if ($this->defaultFieldResolver) {
171	59	$this->executor->setDefaultFieldResolver($this->defaultFieldResolver);
172		}
173	61	$this->dispatcher->dispatch(Events::EXECUTOR_CONTEXT, new ExecutorContextEvent($contextValue));
174
175	61	return $this->dispatcher->dispatch(
176	61	Events::PRE_EXECUTOR,
177	61	new ExecutorEvent($schema, $requestString, $rootValue, $contextValue, $variableValue, $operationName)
178		);
179		}
180
181		/**
182		* @param ExecutionResult\|Promise $result
183		*
184		* @return ExecutionResult
185		*/
186	61	private function postExecute($result)
187		{
188	61	if ($this->promiseAdapter) {
189	59	$result = $this->promiseAdapter->wait($result);
		0 ignored issues – show Bug introduced 2017-02-10 16:24 UTC by Report Bug Copy Issue Report It seems like you code against a concrete implementation and not the interface `GraphQL\Executor\Promise\PromiseAdapter` as the method `wait()` does only exist in the following implementations of said interface: `GraphQL\Executor\Promise...pter\SyncPromiseAdapter`, `Overblog\GraphQLBundle\E...ter\ReactPromiseAdapter`. Let’s take a look at an example: interface User { /** @return string / public function getPassword(); } class MyUser implements User { public function getPassword() { // return something } public function getDisplayName() { // return some name. } } class AuthSystem { public function authenticate(User $user) { $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName())); // do something. } } In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different implementation of User which does not have a getDisplayName() method, the code will break. Available Fixes Change the type-hint for the parameter: class AuthSystem { public function authenticate(MyUser $user) { / ... / } } Add an additional type-check: class AuthSystem { public function authenticate(User $user) { if ($user instanceof MyUser) { $this->logger->info(/* ... /); } // or alternatively if ( ! $user instanceof MyUser) { throw new \LogicException( '$user must be an instance of MyUser, ' .'other instances are not supported.' ); } } } Note:* PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case. Add the method to the interface: interface User { /** @return string / public function getPassword(); /* @return string */ public function getDisplayName(); } Loading history...
190		}
191
192	61	$this->checkExecutionResult($result);
193
194	59	$event = $this->dispatcher->dispatch(
195	59	Events::POST_EXECUTOR,
196	59	new ExecutorResultEvent($result)
197		);
198
199	59	return $event->getResult();
200		}
201
202	62	private function checkPromiseAdapter()
203		{
204	62	if ($this->promiseAdapter && !$this->promiseAdapter instanceof PromiseAdapterInterface && !is_callable([$this->promiseAdapter, 'wait'])) {
205	1	throw new \RuntimeException(
206	1	sprintf(
207	1	'PromiseAdapter should be an object instantiating "%s" or "%s" with a "wait" method.',
208	1	PromiseAdapterInterface::class,
209	1	PromiseAdapter::class
210		)
211		);
212		}
213	61	}
214
215	61	private function checkExecutionResult($result)
216		{
217	61	if (!is_object($result) \|\| !$result instanceof ExecutionResult) {
218	2	throw new \RuntimeException(
219	2	sprintf('Execution result should be an object instantiating "%s".', ExecutionResult::class)
220		);
221		}
222	59	}
223
224	62	private static function createArrayObject($data)
225		{
226	62	if (is_array($data) \|\| is_object($data)) {
227	28	$object = new \ArrayObject($data);
228		} else {
229	62	$object = new \ArrayObject();
230		}
231
232	62	return $object;
233		}
234		}
235

overblog / GraphQLBundle

Scrutinizer GitHub App not installed

Pull Request — master (#264)

Executor A

Complexity

Size/Duplication

Coupling/Cohesion

Test Coverage

Importance

13 Methods

Available Fixes

Duplication Side-by-Side

Filter issues like