gracerpro/convert-sport-activity

This library can to read ZIP-archive of sport activities. Support two services, Strava and Adidas running.

v1.0.3 2025-10-08 11:08 UTC

Requires

• php: ~8.4
• ext-json: *
• ext-zip: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.73
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.0

MIT

• Vyacheslav

• sport
• activity
• strava
• adidas running

README

This library can to read ZIP-archive of sport activities

1. Strava
2. Adidas running

Installation

Via composer

composer require gracerpro/convert-sport-activity

Documentation

For Strava service

use Gracerpro\ConvertSportActivity\Strava\StravaArchive;
use Gracerpro\ConvertSportActivity\Strava\StravaObserver;
use Gracerpro\ConvertSportActivity\Strava\Activity;
use Gracerpro\ConvertSportActivity\GpsPoint;

class EchoStravaObserver implements StravaObserver
{
    /**
     * @param GpsPoint[] $points
     */
    public function onNewActivity(Activity $activity, array $points, int $index): void
    {
        echo $index . " " . $activity->id . "\n";
    }
}

$archive = new StravaArchive();
$observer = new EchoStravaObserver();

$archive->convert($zipFilePath, $observer);

For Adidas running service

use Gracerpro\ConvertSportActivity\Adidas\AdidasArchive;
use Gracerpro\ConvertSportActivity\Adidas\AdidasObserver;
use Gracerpro\ConvertSportActivity\Adidas\Activity;
use Gracerpro\ConvertSportActivity\GpsPoint;

class FileAdidasObserver implements AdidasObserver
{
    public function __construct(
        /** @var resource */
        private $stream,
    ){
    }

    /**
     * @param GpsPoint[] $points
     */
    public function onNewActivity(Activity $activity, array $points, int $index): void
    {
        $text = $index . " " . $activity->id . "\n";
        fwrite($this->stream, $text . "\n");
    }
}

$stream = fopen("...");

$archive = new AdidasArchive();
$observer = new FileAdidasObserver($stream);

$archive->convert($zipFilePath, $observer);

fclose($stream);

Development

Docker

Use docker and log in to container

docker compose up --detach
docker exec -it --user "$(id -u):$(id -g)" convert-sport-activity__php-cli bash

composer install

php-cs-fixer

Check project

php ./vendor/bin/php-cs-fixer fix

phpstan

php ./vendor/bin/phpstan analyse
# or
php -d memory_limit=1G ./vendor/bin/phpstan analyse

phpunit

Run unit tests

./vendor/bin/phpunit tests

Show code coverage

XDEBUG_MODE=coverage vendor/bin/phpunit tests --coverage-text

License

See LICENSE.

Update version

# main branch
git tag v1.0.3
git push --tags

TODO

• unit tests