BaseApi::orderBy() - Code Metrics - Inspection of "- .scrutinizer.yml re-added" - igorsgm/laravel-ghost - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Branch — develop (1d1e3b)

by Igor
created 2022-06-05 08:47 UTC
BaseApi::orderBy() A

↳ Parent: BaseApi
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	2
CRAP Score	1
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	1
eloc	1
c	1
b	0
f	0
nc	1
nop	2
dl	0
loc	3
ccs	2
cts	2
cp	1
crap	1
rs	10
<?php

namespace Igorsgm\Ghost\Apis;

use Igorsgm\Ghost\Models\Resources\BaseResource;
use Igorsgm\Ghost\Responses\ErrorResponse;
use Igorsgm\Ghost\Responses\SuccessResponse;
use Illuminate\Support\Collection;

abstract class BaseApi
{
    /**
     * @var string
     */
    protected $baseUrl;

    /**
     * @var BaseResource
     */
    protected $resource;

    /**
     * @var string
     */
    public string $resourceId = "";

    /**
     * @var string
     */
    public string $resourceSlug = "";

    /**
     * @var string
     */
    public string $include = "";

    /**
     * @var string
     */
    public string $fields = "";

    /**
     * @var string
     */
    public string $formats = "";

    /**
     * @var string
     */
    protected $source = "";

    /**
     * @var string
     */
    public string $limit = "";

    /**
     * @var string
     */
    public string $filter = "";

    /**
     * @var string
     */
    public string $page = "";

    /**
     * @var string
     */
    public string $order = "";

    /**
     * @var string
     */
    protected string $key;

    /**
     * @var string
     */
    protected string $domain;

    /**
     * @var string
     */
    protected string $version;

    /**
     * @return string
     */
    protected function buildEndpoint(): string
    {
        $endpoint = $this->resource->getResourceName();

        if (!empty($this->resourceId)) {
            $endpoint .= "/$this->resourceId";
        } elseif (!empty($this->resourceSlug)) {
            $endpoint .= "/slug/$this->resourceSlug";
        }

        return $endpoint;
    }

    /**
     * @param string $suffix
     * @return string
     */
    protected function makeApiUrl($suffix = ''): string
    {
        return sprintf("%s/%s/?%s", $this->baseUrl, $this->buildEndpoint().$suffix, $this->buildParams());
    }

    /**
     * @return string
     */
    protected function buildParams(): string
    {
        $params = ['include', 'fields', 'formats', 'source', 'filter', 'limit', 'page', 'order', 'key'];

        $queryParams = [];
        foreach ($params as $param) {
            $queryParams[$param] = $this->{$param} ?: null;
        }

        return http_build_query($queryParams);
    }

    /**
     * @param $response
     * @return ErrorResponse|SuccessResponse
     */
    protected function handleResponse($response)
    {
        if ($response->failed()) {
            return new ErrorResponse($response);
        }

        return new SuccessResponse($this, $this->resource, $response);
    }

    /**
     * Return resource from slug
     *
     * @param  string  $slug
     *
     * @return array|ErrorResponse|mixed
     */
    public function fromSlug(string $slug)
    {
        $this->resourceSlug = $slug;
        $response = $this->get();
        $response = $this->get();

        if ($response instanceof ErrorResponse) {
            return $response;
        }

        return data_get($response->data, 0, []);
    }

    /**
     * @return Collection|array[]
     */
    public function all()
    {
        return $this->limit('all')->get();
    }

    /**
     * @return BaseResource|ErrorResponse
     */
    public function first()
    {
        $response = $this->limit(1)->get();
        return $response->data->first();
    }

    /**
     * @param $limit
     * @return array
     */
    public function paginate($limit = null)
    {
        if (isset($limit)) {
            $this->limit = $limit;
        }

        return $this->get();
    }

    /**
     * Return resource from ID
     *
     * @param  string  $id
     *
     * @return BaseResource|ErrorResponse
     */
    public function find(string $id)
    {
        $this->resourceId = $id;
        $response = $this->get();

        if ($response instanceof ErrorResponse) {
            return $response;
        }

        return data_get($response->data, 0, []);
    }

    /**
     * Apply fine-grained filters to target specific data.
     *
     * @param  string  $filter
     *
     * @return $this
     * @see https://ghost.org/docs/content-api/#filtering
     * @see https://gist.github.com/ErisDS/f516a859355d515aa6ad
     */
    public function filter($filter): BaseApi
    {
        $this->filter = $filter;

        return $this;
    }

    /**
     * Limit how many records are returned at once
     *
     * @param  int|string  $limit
     *
     * @return $this
     * @see https://ghost.org/docs/content-api/#limit
     */
    public function limit($limit): BaseApi
    {
        $this->limit = strval($limit);

        return $this;
    }

    /**
     * @param  string  $resourceClass
     * @return $this
     */
    public function setResource(string $resourceClass): BaseApi
    {
        $this->resource = resolve($resourceClass);
class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}

        return $this;
    }

    /**
     * @return BaseResource
     */
    public function getResource()
    {
        return $this->resource;
    }

    /**
     * Alias for Ghost's include.
     *
     * The following includes are available:
     * Posts & Pages: authors, tags
     * Authors: count.posts
     * Tags: count.posts
     * Tiers: monthly_price, yearly_price, benefits
     *
     * @param  string|array  ...$includes
     * @return $this
     * @see https://ghost.org/docs/content-api/#include
     *
     */
    public function include(...$includes): BaseApi
    {
        $this->include = collect($includes)->flatten()->implode(',');

        return $this;
    }

    /**
     * Alias for include method
     *
     * @param ...$includes
     * @return $this
     */
    public function with(...$includes): BaseApi
    {
        return $this->include(...$includes);
    }

    /**
     * Limit the fields returned to the response object
     *
     * @param  string|array  ...$fields
     *
     * @return $this
     * @see https://ghost.org/docs/content-api/#fields
     */
    public function fields(...$fields): BaseApi
    {
        $this->fields = collect($fields)->flatten()->implode(',');

        return $this;
    }

    /**
     * Optionally request different format for posts and pages
     * By default, Admin API expects and returns content in the mobiledoc format only.
     * To include html in the response use this parameter.
     *
     * Possible formats: html, plaintext, mobiledoc.
     *
     *
     * @param  string  $format
     *
     * @return $this
     */
    public function formats(string $format): BaseApi
    {
        $this->formats = $format;

        return $this;
    }

    /**
     * @param  int  $page
     * @return $this
     * @see https://ghost.org/docs/content-api/#page
     */
    public function page(int $page): BaseApi
    {
        $this->page = strval($page);

        return $this;
    }

    /**
     * @param  string  $attr
     * @param  string  $order
     *
     * @return $this
     * @see https://ghost.org/docs/content-api/#order
     */
    public function order(string $attr, string $order = "DESC"): BaseApi
    {
        $this->order = $attr." ".strtolower($order);

        return $this;
    }

    /**
     * Alias for order method
     *
     * @param  string  $attr
     * @param  string  $order
     * @return $this
     */
    public function orderBy(string $attr, string $order = "DESC"): BaseApi
    {
        return $this->order($attr, $order);
    }
}

igorsgm / laravel-ghost

Branch — develop (1d1e3b)

BaseApi::orderBy() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
