PHPackages                             gracerpro/convert-sport-activity - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. gracerpro/convert-sport-activity

ActiveLibrary[Utility & Helpers](/categories/utility)

gracerpro/convert-sport-activity
================================

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

v1.0.3(7mo ago)02MITPHPPHP ~8.4CI passing

Since Mar 25Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/gracerpro/convert-sport-activity)[ Packagist](https://packagist.org/packages/gracerpro/convert-sport-activity)[ Docs](https://github.com/gracerpro/convert-sport-activity)[ RSS](/packages/gracerpro-convert-sport-activity/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

Convert sport activity
======================

[](#convert-sport-activity)

[![PHP Composer](../../actions/workflows/php.yml/badge.svg)](../../actions/workflows/php.yml/badge.svg)

This library can to read ZIP-archive of sport activities

1. Strava
2. Adidas running

[![Main image](https://repository-images.githubusercontent.com/954733681/dd7f4e8f-d193-48d0-b9b9-6a7f46658dcb)](https://repository-images.githubusercontent.com/954733681/dd7f4e8f-d193-48d0-b9b9-6a7f46658dcb)

Installation
------------

[](#installation)

Via composer

```
composer require gracerpro/convert-sport-activity
```

Documentation
-------------

[](#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
-----------

[](#development)

### Docker

[](#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

[](#php-cs-fixer)

Check project

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

### phpstan

[](#phpstan)

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

### phpunit

[](#phpunit)

Run unit tests

```
./vendor/bin/phpunit tests
```

Show code coverage

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

License
-------

[](#license)

See [LICENSE](LICENSE).

Update version
--------------

[](#update-version)

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

TODO
----

[](#todo)

- unit tests

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance64

Regular maintenance activity

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~196 days

Total

2

Last Release

216d ago

PHP version history (2 changes)1.0.0PHP ~8.3

v1.0.3PHP ~8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/57b7f3ce35562bb2854623b0c0648f0cc89a59f68518861a634ce6342728bcdd?d=identicon)[gracerpro](/maintainers/gracerpro)

---

Top Contributors

[![gracerpro](https://avatars.githubusercontent.com/u/2216790?v=4)](https://github.com/gracerpro "gracerpro (16 commits)")

---

Tags

activitystravasportadidas running

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gracerpro-convert-sport-activity/health.svg)

```
[![Health](https://phpackages.com/badges/gracerpro-convert-sport-activity/health.svg)](https://phpackages.com/packages/gracerpro-convert-sport-activity)
```

###  Alternatives

[purplepixie/phpdns

PHP DNS Direct Query Module

731.3M5](/packages/purplepixie-phpdns)[nzta/silverstripe-sitebanner

Site-wide banners activated through the CMS

1035.2k](/packages/nzta-silverstripe-sitebanner)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)