Metadata-Version: 2.1
Name: stravaio
Version: 0.0.1
Summary: Python client for Strava API with a focus on fluent data handling
Home-page: https://github.com/sladkovm/stravaio
Author: Maksym Sladkov
Author-email: sladkovm@gmail.com
License: MIT
Description: 
        # stravaio
        Python client for Strava API with a focus on fluent data handling
        
        ## Install
        ```bash
        git clone https://github.com/sladkovm/stravaio.git
        ```
        
        ## Before use
        You need `STRAVA_ACCESS_TOKEN` with activity level permissions to make use of this package. Head to the [strava-oauth](https://github.com/sladkovm/strava-oauth) library for help.
        
        When the token is fetched it is handy to store it as a environment variable
        
        ```bash
        export STRAVA_ACCESS_TOKEN=<strava_access_token>
        ```
        
        ## Use
        
        ```python
        from stravaio import StravaIO
        
        # If the token is stored as an environment varible it is not neccessary
        # to pass it as an input parameters
        client = StravaIO(access_token=STRAVA_ACCESS_TOKEN)
        ```
        
        ### Athlete
        ```python
        # Get logged in athlete (e.g. the owner of the token)
        # Returns a stravaio.Athlete object that wraps the
        # [Strava DetailedAthlete](https://developers.strava.com/docs/reference/#api-models-DetailedAthlete)
        # with few added data-handling methods
        athlete = client.get_logged_in_athlete()
        
        # Dump athlete into a JSON friendly dict (e.g. all datetimes are converted into iso8601)
        athlete_dict = athlete.to_dict()
        
        # Store athlete infor as a JSON locally (~/.stravadata/athlete_<id>.json)
        athlete.store_locally()
        ```
        
        ### Activities
        ```python
        # Returns a stravaio.Activity object that wraps the 
        # [Strava DetailedActivity](https://developers.strava.com/docs/reference/#api-models-DetailedActivity)
        activity = client.get_activity_by_id(2033203247)
        
        # Dump activity into a JSON friendly dict
        activity_dict = activity.to_dict()
        
        # Store activity locally (~/.stravadata/activities_<athlete_id>/activity_<id>.json)
        activity.store_locally()
        
        # Get list of athletes activities since a given date (after) given in a human friendly format.
        # Kudos to [Maya: Datetimes for Humans(TM)](https://github.com/kennethreitz/maya)
        # Returns a list of [Strava SummaryActivity](https://developers.strava.com/docs/reference/#api-models-SummaryActivity) objects
        list_activities = client.get_logged_in_athlete_activities(after='last week')
        
        # Obvious use - store all activities locally
        for a in list_activities:
            activity = client.get_activity_by_id(a.id)
            activity.store_locally()
        ```
        
        ### Streams
        ```python
        # Returns a stravaio.Streams object that wraps the 
        # [Strava StreamSet](https://developers.strava.com/docs/reference/#api-models-StreamSet)
        streams = client.get_activity_streams(2033203247)
        
        # Dump streams into a JSON friendly dict
        streams_dict = streams.to_dict()
        
        # Store streams locally (~/.stravadata/streams_<athlete_id>/streams_<id>.json) as a .parquet file, that can be loaded later using the
        # pandas.read_parquet()
        streams.store_locally()
        
        ```
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering
Description-Content-Type: text/markdown
