Metadata-Version: 1.1
Name: python-tcxparser
Version: 2.0.0
Summary: Simple parser for Garmin TCX files
Home-page: https://github.com/vkurup/python-tcxparser/
Author: Vinod Kurup
Author-email: vinod@kurup.com
License: BSD
Description: python-tcxparser
        ================
        
        .. sidebar:: Build Status
        
           :master: |master-status|
        
        .. image:: https://pyup.io/repos/github/vkurup/python-tcxparser/shield.svg
           :target: https://pyup.io/repos/github/vkurup/python-tcxparser/
           :alt: Requirement Updates
        
        .. |master-status| image::
            https://github.com/vkurup/python-tcxparser/workflows/lint-test/badge.svg?branch=master
            :alt: Build Status
            :target: https://github.com/vkurup/python-tcxparser/actions?query=branch%3Amaster
        
        python-tcxparser is a minimal parser for Garmin's TCX file format. It
        is not in any way exhaustive. It extracts just enough data to allow me
        to post data from my Garmin ForeRunner 410 watch to
        `DailyMile's <http://dailymile.com>`_ API.
        
        Data extracted:
         - latitude & longitude of start point of workout
         - type of workout (running, walking, etc)
         - time of completion of workout (in ISO UTC)
         - distance of workout (in meters)
         - duration of workout (in seconds)
         - calories burned during workout (as estimated by device)
         - average, max and min heart rate during workout
         - average pace during workout
         - average altitude during workout
         - ascent and descent of workout
         - max and min altitude
         - time stamp of each data point (in ISO UTC)
         - average and max cadence (cycling activities)
        
        Installation
        ------------
        
        Install it from PyPI::
        
           pip install python-tcxparser
        
        Usage
        -----
        
        Basic usage example::
        
            >>> import tcxparser
            >>> tcx = tcxparser.TCXParser('/home/vinod/Downloads/20121226-212953.tcx')
            >>> # Duration of workout in seconds
            ... tcx.duration
            1992.78
            >>> # latitude/longitude at start of workout
            ... tcx.latitude
            35.951880198
            >>> tcx.longitude
            -79.0931872185
            >>> tcx.activity_type
            'running'
            >>> # ISO UTC timestamp when workout completed
            ... tcx.completed_at
            '2012-12-26T22:03:05Z'
            >>> # distance of workout in meters
            ... tcx.distance
            4686.31103516
            >>> tcx.distance_units
            'meters'
            >>> # calories burned (as reported by device)
            ... tcx.calories
            379
        
        Compatibility
        -------------
        
        * Python 3.6+, see `tox.ini`_.
        
        .. _tox.ini: tox.ini
        
        License
        -------
        
        * BSD
        
        
        Maintainer Information
        ----------------------
        
        We use Github Actions to lint (using pre-commit, black, isort, and flake8),
        test (using tox and tox-gh-actions), and calculate coverage (using coverage).
        
        We have a local script to do these actions locally, named ``maintain.sh``::
        
          $ ./maintain.sh
        
        A Github Action workflow also builds and pushes a new package to PyPI whenever a new
        Release is created in Github. This uses a project-specific PyPI token, as described in
        the `PyPI documentation here <https://pypi.org/help/#apitoken>`_. That token has been
        saved in the ``PYPI_PASSWORD`` settings for this repo, but has not been saved anywhere
        else so if it is needed for any reason, the current one should be deleted and a new one
        generated.
        
        As always, be sure to bump the version in ``setup.py`` before creating a Release, so
        that the proper version gets pushed to PyPI.
        
        
        Contact
        -------
        
        Please contact me with any questions: Vinod Kurup (vinod@kurup.com)
        
Keywords: tcx
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
