AbstractResourceCest::checkSelfLink() - Code Metrics - Inspection of "[WIP] Psr12" - ROAResearch/yii2-roa - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#2)

by Angel

created 2019-11-12 22:51 UTC

AbstractResourceCest::checkSelfLink() A

↳ Parent: AbstractResourceCest

Complexity

Conditions	2
Paths	2

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	8
rs	10
c	0
b	0
f	0
cc	2
nc	2
nop	2

<?php

namespace roaresearch\yii2\roa\test;

use Codeception\{Example, Util\HttpCode};
use roaresearch\yii2\roa\urlRules\Resource as ResourceUrlRule;
use yii\web\UrlManager;

abstract class AbstractResourceCest
{
    /**
     * @var UrlManager url manager used to parse Route's for the services.
     */
    protected $urlManager;

    /**
     * Initializes the `$urlManager` object
     */
    public function __construct()
    {
        $this->urlManager = new UrlManager([
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'cache' => false,
            'rules' => [
                $this->getRoutePattern() . '/<id:\d+>'=> 'test/action',
                $this->getRoutePattern() => 'test/action',
            ],
        ]);
    }

    /**
     * Authenticates a user identified by 'authUser' index in the `$example`.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - tokenName: (optional) string name of the token used to authenticate.
     */
    protected function authUser(Tester $I, Example $example)
    {
        if (!empty($example['tokenName'])) {
            $I->amAuthByToken($example['tokenName']);
        }
    }

    /**
     * Parses the Route for the test using `$urlManager` and `getRoutePattern()`
     *
     * @param Example $example data used for the testing. It uses the keys

     * - url: (optional) string if provided it will be used directly.
     * - urlParams: (optional) string[] GET params to parse the url rule with
     *   `getRoutePattern()`.
     * @return string the url which will be used for the service.
     */
    protected function parseUrl(Example $example): string
    {
        if (isset($example['url'])) {
            return $example['url'];
        }
        $params = isset($example['urlParams']) ? $example['urlParams'] : [];
        $params[0] = 'test/action';

        return $this->urlManager->createUrl($params);
    }

    /**
     * Handles the internal logic when running a test on a collection resource.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - tokenName: (optional) string name of the token used to authenticate.
     * - url: (optional) string if provided it will be used directly.
     * - urlParams: (optional) string[] GET params to parse the url rule with
     *   `getRoutePattern()`.
     * - headers: (optional) string[] pairs of header => value expected in the
     *   response.
     */
    protected function internalIndex(Tester $I, Example $example)

    {
        // Authenticates configured user.
        $this->authUser($I, $example);

        // Send request
        $I->sendGET($this->parseUrl($example));


        // Checks the response has the required headers and body.
        $this->checkResponse([
            HttpCode::OK => 'checkSuccessIndexResponse',
            HttpCode::UNPROCESSABLE_ENTITY => 'checkValidationResponse',
        ], $I, $example);
    }

    /**
     * Handles the internal logic when running a test on a creating a record.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - tokenName: (optional) string name of the token used to authenticate.
     * - url: (optional) string if provided it will be used directly.
     * - urlParams: (optional) string[] GET params to parse the url rule with
     *   `getRoutePattern()`.
     * - data: (optional) POST data sent on the request.
     * - headers: (optional) string[] pairs of header => value expected in the
     *   response.
     */
    protected function internalCreate(Tester $I, Example $example)
    {
        // Authenticates configured user.
        $this->authUser($I, $example);

        // Send request
        $I->sendPOST(

            $this->parseUrl($example),
            isset($example['data']) ? $example['data'] : []
        );

        // Checks the response has the required headers and body.
        $this->checkResponse([
            HttpCode::CREATED => 'checkSuccessCreateResponse',
            HttpCode::UNPROCESSABLE_ENTITY => 'checkValidationResponse',
        ], $I, $example);
    }

    /**
     * Handles the internal logic when running a test on a record resource.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - tokenName: (optional) string name of the token used to authenticate.
     * - url: string if provided it will be used directly.
     * - urlParams: string[] GET params to parse the url rule with
     *   `getRoutePattern()`.
     * - httpCode: integer expected Http Code response. If the httpCode is
     *   a key in `$responses` parameter then the method defined there will be
     *   used to analyze the response. Otherwise `checkErrorResponse()` will be
     *   used.
     * - error: string|string[] expected json being contained in the response.
     * - headers: (optional) string[] pairs of header => value expected in the
     *   response.
     */
    protected function internalView(Tester $I, Example $example)

    {
        // Authenticates configured user.
        $this->authUser($I, $example);

        // Send request
        $I->sendGET($this->parseUrl($example));


        // Checks the response has the required headers and body.
        $this->checkResponse([
            HttpCode::OK => 'checkSuccessViewResponse',
        ], $I, $example);
    }

    /**
     * Handles the internal logic when running a test on a updating a record.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - tokenName: (optional) string name of the token used to authenticate.
     * - url: (optional) string if provided it will be used directly.
     * - urlParams: (optional) string[] GET params to parse the url rule with
     *   `getRoutePattern()`.
     * - data: (optional) POST data sent on the request.
     * - expected: (optional) expected in the JSON response body.
     * - headers: (optional) string[] pairs of header => value expected in the
     *   response.
     */
    protected function internalUpdate(Tester $I, Example $example)
    {
        // Authenticates configured user.
        $this->authUser($I, $example);

        // Send request
        $I->sendPATCH($this->parseUrl($example), $example['data']);


        // Checks the response has the required headers and body.
        $this->checkResponse([
            HttpCode::OK => 'checkSuccessViewResponse',
            HttpCode::UNPROCESSABLE_ENTITY => 'checkValidationResponse',
        ], $I, $example);

        if (isset($example['expected'])) {
            $I->seeResponseContainsJson($example['expected']);

        }
    }

    /**
     * Handles the internal logic when running a test on a updating a record.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - tokenName: (optional) string name of the token used to authenticate.
     * - url: (optional) string if provided it will be used directly.
     * - urlParams: (optional) string[] GET params to parse the url rule with
     *   `getRoutePattern()`.
     * - httpCode: integer expected Http Code response.
     */
    protected function internalDelete(Tester $I, Example $example)
    {
        // Authenticates configured user.
        $this->authUser($I, $example);

        // Send request
        $I->sendDELETE($this->parseUrl($example));


        // Check response code.
        $I->seeResponseCodeIs($example['httpCode']);

    }

    /**
     * Checks the response Http code and the response based on the Http code and
     * a list of pairs 'httpCode' => 'responseMethod' provided in the
     * `$responses` parameter.
     *
     * If the Http Code in the response doesn't match any of the keys in
     * `$responses` then `checkErrorResponse` will be used instead.
     *
     * @param array $responses pairs of 'httpCode' => 'responseMethod' which
     * will determine how to check the response.
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - httpCode: integer expected Http Code response. If the httpCode is
     *   a key in `$responses` parameter then the method defined there will be
     *   used to analyze the response. Otherwise `checkErrorResponse()` will be
     *   used.
     * - error: (optional) mixed expected json being contained in the response.
     * - headers: (optional) string[] pairs of header => value expected in the
     *   response.
     */
    protected function checkResponse(
        array $responses,
        Tester $I,
        Example $example
    ) {
        $I->seeResponseCodeIs($example['httpCode']);

        if (isset($responses[$example['httpCode']])) {
            $responseMethod = $responses[$example['httpCode']];
            $this->$responseMethod($I, $example);
        } else {
            $this->checkErrorResponse($I, $example);
        }
        if (isset($example['headers'])) {
            foreach ($example['headers'] as $header => $value) {
                $I->seeHttpHeader($header, $value);

            }
        }
    }

    /**
     * Checks an expected success collection response.
     *
     * @param Tester $I
     * @param Example $example

     */
    protected function checkSuccessIndexResponse(Tester $I, Example $example)

    {
        $I->seeResponseMatchesJsonType($this->recordJsonType());

        $I->seeContentTypeHttpHeader();
        $I->seePaginationHttpHeaders();
    }

    /**
     * Checks an expected success record response.
     *
     * @param Tester $I
     * @param Example $example

     */
    protected function checkSuccessViewResponse(Tester $I, Example $example)

    {
        $I->seeResponseMatchesJsonType($this->recordJsonType());

        $I->seeContentTypeHttpHeader();
    }

    /**
     * Checks an expected success record creation response.
     *
     * @param Tester $I
     * @param Example $example

     */
    protected function checkSuccessCreateResponse(Tester $I, Example $example)
    {
        $this->checkSuccessViewResponse($I, $example);
        $I->seeHttpHeaderOnce('Location');

        $this->checkSelfLink($I, $I->grabHttpHeader('Location'));

    }

    /**
     * Checks an expected response containing validation errors.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - validationErrors: string[] (optional) pairs of field => message
     *   validation errors.
     */
    protected function checkValidationResponse(Tester $I, Example $example)
    {
        $I->seeResponseMatchesJsonType([

            'field' => 'string',
            'message' => 'string',
        ]);
        if (empty($example['validationErrors'])) {
            return;
        }
        $expected = [];
        foreach ($example['validationErrors'] as $field => $message) {
            $expected[] = [
                'field' => $field,
                'message' => $message,
            ];
        }
        $I->seeResponseContainsJson($expected);


    }

    /**
     * Checks an expected error response from user input.
     *
     * @param Tester $I
     * @param Example $example data used for the testing. It uses the keys

     * - error: (optional) mixed expected json being contained in the response.
     */
    protected function checkErrorResponse(Tester $I, Example $example)
    {
        $I->seeResponseMatchesJsonType([

            'name' => 'string',
            'message' => 'string',
            'code' => 'integer',
        ]);
        if (isset($example['error'])) {
            $I->seeResponseContainsJson($example['error']);

        }
    }

    /**
     * @param Tester $I
     * @param string $expected the expected self link.
     */
    protected function checkSelfLink(Tester $I, string $expected)
    {
        if ('' == $path = $this->selfLinkPath()) {
            return;
        }
        verify($I->grabDataFromResponseByJsonPath($path))

            ->contains($expected);
    }

    /**
     * @return string the path which will be used to obtain the self link of a
     * record. Return empty string to skip that check.
     */
    protected function selfLinkPath(): string
    {
        return '$._links.self.href';
    }

    /**
     * Expected Json Type for each resource.
     *
     * @return array
     * @see http://codeception.com/docs/modules/REST#seeResponseMatchesJsonType
     */
    abstract protected function recordJsonType(): array;

    /**
     * @return string route pattern to create the
     */
    abstract protected function getRoutePattern(): string;
}


1			<?php
2
3			namespace roaresearch\yii2\roa\test;
4
5			use Codeception\{Example, Util\HttpCode};
6			use roaresearch\yii2\roa\urlRules\Resource as ResourceUrlRule;
7			use yii\web\UrlManager;
8
9			abstract class AbstractResourceCest
10			{
11			/**
12			* @var UrlManager url manager used to parse Route's for the services.
13			*/
14			protected $urlManager;
15
16			/**
17			* Initializes the `$urlManager` object
18			*/
19			public function __construct()
20			{
21			$this->urlManager = new UrlManager([
22			'enablePrettyUrl' => true,
23			'showScriptName' => false,
24			'cache' => false,
25			'rules' => [
26			$this->getRoutePattern() . '/<id:\d+>'=> 'test/action',
27			$this->getRoutePattern() => 'test/action',
28			],
29			]);
30			}
31
32			/**
33			* Authenticates a user identified by 'authUser' index in the `$example`.
34			*
35			* @param Tester $I
36			* @param Example $example data used for the testing. It uses the keys
			0 ignored issues – show Documentation introduced 2019-11-09 03:27 UTC by Report Bug Copy Issue Report Should the type for parameter `$example` not be `\Codeception\Example`? This check looks for `@param` annotations where the type inferred by our type inference engine differs from the declared type. It makes a suggestion as to what type it considers more descriptive. Most often this is a case of a parameter that can be null in addition to its declared types. Loading history...
37			* - tokenName: (optional) string name of the token used to authenticate.
38			*/
39			protected function authUser(Tester $I, Example $example)

ROAResearch / yii2-roa

Pull Request — master (#2)

AbstractResourceCest::checkSelfLink() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like