Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

A uniform interface to GPX services like mapmytracks or gpsies

Project description

Gpxity is a Python - library making it easy to move activities between different backends.
In this context, a backend is a place where activities can be stored.

Gpxity is work in progress. If you want to save yourself time, please wait
a few weeks.

Implemented backends are:

* :class:`~gpxity.backends.directory`: Directory for .gpx files on an accessible file system
* :class:`~gpxity.backends.mmt`: For activities on http://mapmytracks.com

Some backends do not support everything we would like to have, you might get the
exception NotImplementedError(). Some backends simply do not offer everything we
want.

Sometimes you might just change a harmless thing like the description but
the backend does not allow changing this separately, so we have to re-upload
the whole activity. If it is is big and the remote server slow, this might
take 10 minutes or more. Right now this library has no asynchronous interface,
so it can really take some time until your program continues.

Sometimes Gpxity uses undocumented ways to access a backend - this is done
when there is no documented way or when the official API implementation is
buggy or too slow for real-life use.

Backends might change their behaviour, and Gpxity will have to be updated.

There is no installer yet. If you want to read the documentation, download
from here, go into Gpxity/doc, say "make html" and browse Gpxity/doc/build/html/index.html.

This documentation is meant for the user of this library. If you want to add
a new backend, you will need to know more - please read the source code or
remove the lines like :literal:`:exclude-members:` in :literal:`doc/source/*.rst` and
rebuild the documentation.

Todo: Write all class references in the shortest form how an application could
import them.

Project details


Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page