Strava\API\Service\REST

Complexity

Total Complexity

60

Size/Duplication

Total Lines	517
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

98.68%

Importance

Changes

0

46 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	8	3
A	getToken()	0	4	1
A	getResult()	0	15	4
A	getResponse()	0	10	2
A	getAthlete()	0	9	3
A	getAthleteStats()	0	6	1
A	getAthleteRoutes()	0	12	1
A	getAthleteClubs()	0	6	1
A	getAthleteActivities()	0	12	1
A	getAthleteFriends()	0	13	3
A	getAthleteFollowers()	0	13	3
A	getAthleteBothFollowing()	0	10	1
A	getAthleteKom()	0	10	1
A	getAthleteZones()	0	6	1
A	getAthleteStarredSegments()	0	14	3
A	updateAthlete()	0	13	1
A	getActivity()	0	9	1
A	getActivityComments()	0	11	1
A	getActivityKudos()	0	10	1
A	getActivityPhotos()	0	10	1
A	getActivityZones()	0	6	1
A	getActivityLaps()	0	6	1
A	getActivityUploadStatus()	0	6	1
A	createActivity()	0	16	1
A	uploadActivity()	0	18	1
A	updateActivity()	0	15	1
A	deleteActivity()	0	6	1
A	getGear()	0	6	1
A	getClub()	0	6	1
A	getClubMembers()	0	10	1
A	getClubActivities()	0	10	1
A	getClubAnnouncements()	0	6	1
A	getClubGroupEvents()	0	6	1
A	joinClub()	0	6	1
A	leaveClub()	0	6	1
A	getRoute()	0	6	1
A	getRouteAsGPX()	0	6	1
A	getRouteAsTCX()	0	6	1
A	getSegment()	0	6	1
A	getSegmentLeaderboard()	0	17	1
A	getSegmentExplorer()	0	12	1
A	getSegmentEffort()	0	13	1
A	getStreamsActivity()	0	10	1
A	getStreamsEffort()	0	10	1
A	getStreamsSegment()	0	10	1
A	getStreamsRoute()	0	6	1

<?php

namespace Strava\API\Service;

use GuzzleHttp\Client;
use GuzzleHttp\Psr7\Response;

/**
 * Strava REST Service
 *
 * @author Bas van Dorst
 * @package StravaPHP
 */
class REST implements ServiceInterface
{
    /**
     * REST adapter
     * @var Client
     */
    protected $adapter;

    /**
     * Application token
     * @var string
     */
    protected $token;

    /**
     * Initiate this REST service with the application token and a instance
     * of the REST adapter (Guzzle).
     *
     * @param string $token
     * @param Client $adapter
     */
    public function __construct($token, Client $adapter)
    {
        if (is_object($token) && method_exists($token, 'getToken')) {
            $token = $token->getToken();
        }
        $this->token = $token;
        $this->adapter = $adapter;
    }

    protected function getToken()
    {
        return $this->token;
    }

    /**
     * Get a request result.
     * Returns an array with a response body or and error code => reason.
     * @param Response $response
     * @return array|mixed
     */
    protected function getResult($response)
    {
        // Workaround for export methods getRouteAsGPX, getRouteAsTCX:
        if (is_string($response)) {
            return $response;
        }

        $status = $response->getStatusCode();

        if ($status == 200 || $status == 201) {
            return json_decode($response->getBody(), JSON_PRETTY_PRINT);
        } else {
            return [$status => $response->getReasonPhrase()];
        }
    }

    /**
     * Get an API request response and handle possible exceptions.
     *
     * @param string $method
     * @param string $path
     * @param array $parameters
     *
     * @return array|mixed|string
     * @throws \GuzzleHttp\Exception\GuzzleException
     * @throws \GuzzleHttp\Exception\GuzzleException
     */
    protected function getResponse($method, $path, $parameters)
    {
        try {
            $response = $this->adapter->request($method, $path, $parameters);
            return $this->getResult($response);

$response of type object<Psr\Http\Message\ResponseInterface> is not a sub-type of object<GuzzleHttp\Psr7\Response>. It seems like you assume a concrete implementation of the interface Psr\Http\Message\ResponseInterface to be always present.

        }
        catch (\Exception $e) {
            return $e->getMessage();
        }
    }

    public function getAthlete($id = null)
    {
        $path = 'athlete';
        if (isset($id) && $id !== null) {
            $path = 'athletes/' . $id;
        }
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteStats($id)
    {
        $path = 'athletes/' . $id . '/stats';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteRoutes($id, $type = null, $after = null, $page = null, $per_page = null)
    {
        $path = 'athletes/' . $id . '/routes';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'type' => $type,
            'after' => $after,
            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteClubs()
    {
        $path = 'athlete/clubs';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteActivities($before = null, $after = null, $page = null, $per_page = null)
    {
        $path = 'athlete/activities';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'before' => $before,
            'after' => $after,
            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteFriends($id = null, $page = null, $per_page = null)
    {
        $path = 'athlete/friends';
        if (isset($id) && $id !== null) {
            $path = 'athletes/' . $id . '/friends';
        }
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteFollowers($id = null, $page = null, $per_page = null)
    {
        $path = 'athlete/followers';
        if (isset($id) && $id !== null) {
            $path = 'athletes/' . $id . '/followers';
        }
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteBothFollowing($id, $page = null, $per_page = null)
    {
        $path = 'athletes/' . $id . '/both-following';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteKom($id, $page = null, $per_page = null)
    {
        $path = 'athletes/' . $id . '/koms';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteZones()
    {
        $path = 'athlete/zones';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getAthleteStarredSegments($id = null, $page = null, $per_page = null)
    {
        $path = 'segments/starred';
        if (isset($id) && $id !== null) {
            $path = 'athletes/' . $id . '/segments/starred';
            // ...wrong in Strava documentation
        }
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function updateAthlete($city, $state, $country, $sex, $weight)
    {
        $path = 'athlete';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'city' => $city,
            'state' => $state,
            'country' => $country,
            'sex' => $sex,
            'weight' => $weight,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('PUT', $path, $parameters);
    }

    public function getActivity($id, $include_all_efforts = null)
    {
        $path = 'activities/' . $id;
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'include_all_efforts' => $include_all_efforts,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getActivityComments($id, $markdown = null, $page = null, $per_page = null)
    {
        $path = 'activities/' . $id . '/comments';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'markdown' => $markdown,
            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getActivityKudos($id, $page = null, $per_page = null)
    {
        $path = 'activities/' . $id . '/kudos';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getActivityPhotos($id, $size = 2048, $photo_sources = 'true')
    {
        $path = 'activities/' . $id . '/photos';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'size' => $size,
            'photo_sources' => $photo_sources,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getActivityZones($id)
    {
        $path = 'activities/' . $id . '/zones';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getActivityLaps($id)
    {
        $path = 'activities/' . $id . '/laps';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getActivityUploadStatus($id)
    {
        $path = 'uploads/' . $id;
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function createActivity($name, $type, $start_date_local, $elapsed_time, $description = null, $distance = null, $private = null, $trainer = null)
    {
        $path = 'activities';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'name' => $name,
            'type' => $type,
            'start_date_local' => $start_date_local,
            'elapsed_time' => $elapsed_time,
            'description' => $description,
            'distance' => $distance,
            'private' => $private,
            'trainer' => $trainer,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('POST', $path, $parameters);
    }

    public function uploadActivity($file, $activity_type = null, $name = null, $description = null, $private = null, $trainer = null, $commute = null, $data_type = null, $external_id = null)
    {
        $path = 'uploads';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'activity_type' => $activity_type,
            'name' => $name,
            'description' => $description,
            'private' => $private,
            'trainer' => $trainer,
            'commute' => $commute,
            'data_type' => $data_type,
            'external_id' => $external_id,
            'file' => curl_file_create($file),
            'file_hack' => '@' . ltrim($file, '@'),
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('POST', $path, $parameters);
    }

    public function updateActivity($id, $name = null, $type = null, $private = false, $commute = false, $trainer = false, $gear_id = null, $description = null)
    {
        $path = 'activities/' . $id;
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'name' => $name,
            'type' => $type,
            'private' => $private,
            'commute' => $commute,
            'trainer' => $trainer,
            'gear_id' => $gear_id,
            'description' => $description,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('PUT', $path, $parameters);
    }

    public function deleteActivity($id)
    {
        $path = 'activities/' . $id;
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('DELETE', $path, $parameters);
    }

    public function getGear($id)
    {
        $path = 'gear/' . $id;
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getClub($id)
    {
        $path = 'clubs/' . $id;
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getClubMembers($id, $page = null, $per_page = null)
    {
        $path = 'clubs/' . $id . '/members';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getClubActivities($id, $page = null, $per_page = null)
    {
        $path = 'clubs/' . $id . '/activities';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getClubAnnouncements($id)
    {
        $path = 'clubs/' . $id . '/announcements';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getClubGroupEvents($id)
    {
        $path = 'clubs/' . $id . '/group_events';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function joinClub($id)
    {
        $path = 'clubs/' . $id . '/join';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('POST', $path, $parameters);
    }

    public function leaveClub($id)
    {
        $path = 'clubs/' . $id . '/leave';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('POST', $path, $parameters);
    }

    public function getRoute($id)
    {
        $path = 'routes/' . $id;
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getRouteAsGPX($id)
    {
        $path = 'routes/' . $id . '/export_gpx';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getRouteAsTCX($id)
    {
        $path = 'routes/' . $id . '/export_tcx';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getSegment($id)
    {
        $path = 'segments/' . $id;
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

    public function getSegmentLeaderboard($id, $gender = null, $age_group = null, $weight_class = null, $following = null, $club_id = null, $date_range = null, $context_entries = null, $page = null, $per_page = null)
    {
        $path = 'segments/' . $id . '/leaderboard';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'gender' => $gender,
            'age_group' => $age_group,
            'weight_class' => $weight_class,
            'following' => $following,
            'club_id' => $club_id,
            'date_range' => $date_range,
            'context_entries' => $context_entries,
            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getSegmentExplorer($bounds, $activity_type = 'riding', $min_cat = null, $max_cat = null)
    {
        $path = 'segments/explore';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'bounds' => $bounds,
            'activity_type' => $activity_type,
            'min_cat' => $min_cat,
            'max_cat' => $max_cat,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getSegmentEffort($id, $athlete_id = null, $start_date_local = null, $end_date_local = null, $page = null, $per_page = null)
    {
        $path = 'segments/' . $id . '/all_efforts';
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'athlete_id' => $athlete_id,
            'start_date_local' => $start_date_local,
            'end_date_local' => $end_date_local,
            'page' => $page,
            'per_page' => $per_page,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getStreamsActivity($id, $types, $resolution = null, $series_type = 'distance')
    {
        $path = 'activities/' . $id . '/streams/' . $types;
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'resolution' => $resolution,
            'series_type' => $series_type,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getStreamsEffort($id, $types, $resolution = null, $series_type = 'distance')
    {
        $path = 'segment_efforts/' . $id . '/streams/' . $types;
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'resolution' => $resolution,
            'series_type' => $series_type,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getStreamsSegment($id, $types, $resolution = null, $series_type = 'distance')
    {
        $path = 'segments/' . $id . '/streams/' . $types;
        $parameters['query'] = [

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

            'resolution' => $resolution,
            'series_type' => $series_type,
            'access_token' => $this->getToken(),
        ];
        return $this->getResponse('GET', $path, $parameters);
    }

    public function getStreamsRoute($id)
    {
        $path = 'routes/' . $id . '/streams';
        $parameters['query'] = ['access_token' => $this->getToken()];

$parameters was never initialized. Although not strictly required by PHP, it is generally a good practice to add $parameters = array(); before regardless.

        return $this->getResponse('GET', $path, $parameters);
    }

}