Metadata-Version: 2.1
Name: eppconvert
Version: 0.9.3
Summary: Parse and convert Daum Ergo Bike EPP files
Home-page: https://github.com/ra1fh/eppconvert
Author: Ralf Horstmann
Author-email: ralf@ackstorm.de
License: ISC
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Healthcare Industry
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
License-File: LICENSE

.. image:: https://github.com/ra1fh/eppconvert/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/ra1fh/eppconvert/actions/workflows/ci.yml

eppconvert
==========

Tools to parse and convert Daum Ergo Bike EPP files. This contains a
mostly complete specification of the EPP/EUP file format, using
python-construct.

Requirements
------------

* `python <https://www.python.org>`_ (version 3.8, 3.9)

* `python-construct <https://pypi.python.org/pypi/construct>`_ (version 2.8)

* `docopt <https://pypi.python.org/pypi/docopt>`_ (version 0.6.2)

* Tested operating systems: Linux, OS X, OpenBSD, Windows


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

The installation can be done with pip/pypi or from source.  In both
cases the scripts `gpx2epp` and `eppread` will be made available as
command line tools.

To install with pip from pypi:

::

    sudo python -m pip install eppconvert

Alternatively install from source:

::

    sudo python ./setup.py install

Usage
-----

gpx2epp
'''''''

Convert GPX to Daum EPP elevation profile. Writes a version 7 EPP file.

::

    Usage:
        gpx2epp [-i FILE] [-o FILE] [-s STEPSIZE]

    Options:
        -h, --help               Show this.
            --version            Show version.
        -i, --input FILE         Input GPX file (default: stdin).
        -o, --output FILE        Output EPP file (default: stdout).
        -s, --stepsize STEPSIZE  Stepsize in meters.


Here is an example that reads a GPX file and writes an EPP file to
stdout with a stepsize of 200 meters between data points:

::

    gpx2epp --input track.gpx --stepsize 200 > track.epp


Only the first track of the GPX file is converted, including all track
segments. Please note that arbitrary stepsize values can be used and
do usually work, but only files with a stepsize of 200 meters can be
modified with the control console editor.

eppread
'''''''

Read and print Daum Ergo Bike EPP/EUP files. Prints textual representation
to stdout.

::

    Usage:
        eppread [-i FILE] [-o FILE] [-l LIMIT]

    Options:
        -h, --help               Show this.
            --version            Show version.
        -i, --input FILE         Input EPP/EUP file (default: stdin).
        -o, --output FILE        Output text file (default: stdout).
        -l, --limit LIMIT        Limit of data points to print.

Example usage that reads an EPP file and prints the header and 5 data
points at most:

::

    eppread --input track.epp --limit 5



