seregazhuk\PinterestBot\Api\Providers\Pinners

Complexity

Total Complexity

16

Size/Duplication

Total Lines	169
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	9

Importance

Changes	13
Bugs	2	Features	1

12 Methods

Rating	Name	Duplication	Size	Complexity
A	checkCredentials()	0	6	3
A	getScope()	0	4	1
A	getEntityIdName()	0	4	1
A	getFollowUrl()	0	4	1
A	getUnfFollowUrl()	0	4	1
A	login()	0	20	3
A	info()	0	4	1
A	followers()	0	6	1
A	following()	0	6	1
A	pins()	0	6	1
A	logout()	0	4	1
A	paginate()	0	9	1

<?php

namespace seregazhuk\PinterestBot\Api\Providers;

use Iterator;
use LogicException;
use seregazhuk\PinterestBot\Helpers\UrlHelper;
use seregazhuk\PinterestBot\Helpers\Pagination;
use seregazhuk\PinterestBot\Exceptions\AuthException;
use seregazhuk\PinterestBot\Helpers\Requests\PinnerHelper;
use seregazhuk\PinterestBot\Helpers\Providers\Traits\Followable;
use seregazhuk\PinterestBot\Helpers\Providers\Traits\Searchable;
use seregazhuk\PinterestBot\Helpers\Providers\Traits\HasFollowers;

class Pinners extends Provider
{
    use Searchable, Followable, HasFollowers;

    protected $loginRequired = [
        'follow',
        'unFollow',
    ];

    /**
     * Get user info.
     * If username param is not specified, will
     * return info for logged user.
     *
     * @param string $username
     *
     * @return null|array
     */
    public function info($username)
    {
        return $this->execGetRequest(['username' => $username], UrlHelper::RESOURCE_USER_INFO);
    }

    /**
     * Get pinner followers.
     *
     * @param string $username
     * @param int    $batchesLimit
     *
     * @return Iterator
     */
    public function followers($username, $batchesLimit = 0)
    {
        return $this->paginate(
            $username, UrlHelper::RESOURCE_USER_FOLLOWERS, $batchesLimit
        );
    }

    /**
     * Get pinner following other pinners.
     *
     * @param string $username
     * @param int    $batchesLimit
     *
     * @return Iterator
     */
    public function following($username, $batchesLimit = 0)
    {
        return $this->paginate(
            $username, UrlHelper::RESOURCE_USER_FOLLOWING, $batchesLimit
        );
    }

    /**
     * Get pinner pins.
     *
     * @param string $username
     * @param int    $batchesLimit
     *
     * @return Iterator
     */
    public function pins($username, $batchesLimit = 0)
    {
        return $this->paginate(
            $username, UrlHelper::RESOURCE_USER_PINS, $batchesLimit
        );
    }

    /**
     * Login as pinner.
     *
     * @param string $username
     * @param string $password
     *
     * @throws AuthException
     *
     * @return bool
     */
    public function login($username, $password)
    {
        if ($this->request->isLoggedIn()) {
            return true;
        }

        $this->checkCredentials($username, $password);

        $postString = PinnerHelper::createLoginQuery($username, $password);
        $this->request->clearToken();

        $response = $this->request->exec(UrlHelper::RESOURCE_LOGIN, $postString);
        $result = $this->response->hasErrors($response);
        if (!$result) {
            throw new AuthException($this->response->getLastError()['message']);
        }
        $this->request->login();

        return $result;
    }

    public function logout()
    {
        $this->request->logout();
    }

    /**
     * Validates password and login.
     *
     * @param string $username
     * @param string $password
     */
    protected function checkCredentials($username, $password)
    {
        if (!$username || !$password) {
            throw new LogicException('You must set username and password to login.');
        }
    }

    /**
     * Search scope.
     *
     * @return string
     */
    protected function getScope()
    {
        return 'people';
    }

    protected function getEntityIdName()
    {
        return 'user_id';
    }

    /**
     * Follow resource.
     *
     * @return string
     */
    protected function getFollowUrl()
    {
        return UrlHelper::RESOURCE_FOLLOW_USER;
    }

    /**
     * UnFollow resource.
     *
     * @return string
     */
    protected function getUnfFollowUrl()
    {
        return UrlHelper::RESOURCE_UNFOLLOW_USER;
    }

    /**
     * @param string $username
     * @param string $url
     * @param int    $batchesLimit
     *
     * @return Iterator
     */
    public function paginate($username, $url, $batchesLimit)
    {
        $params = [
            'data' => ['username' => $username],
            'url'  => $url,
        ];

        return (new Pagination($this))->paginate('getPaginatedData', $params, $batchesLimit);
    }
}