sgraaf/gpx

A python package that brings support for reading, writing and converting GPX files.

Machine Learning 🤖 and Data Science 🧮 Engineer with a focus on NLP. Full-stack Pythonista 🐍. He/him.

gpx's Issues

Add an I/O interface / module

Add an I/O interface / module similar to that of pandas.

Make PyGPX fully compatible with the GPX 1.1 specification

Make PyGPX fully compatible with the the GPX 1.1 specification

This involves introducing new type and element classes and using these where applicable, according to the specification.

Import/Export of kml

Hello,
Would it be possible to add support for exporting/importing KML files?
Regards,
Jacques-D:

Format docstrings

Automatically format docstrings with docformatter, possibly via a pre-commit hook.

Add additional statistics

Add additional statistics (beside the current distance and total duration), such as:

• "Time in motion" / moving type
• Speed (average and profile)
• Elevation (ascent & descent and profile)

Mutable default values shared by class instances

Some classes have fields with mutable value (e.g. lists), which are assigned a default value (e.g. empty list). If you have several instances of such a class, they each share the default values.

See the following example for illustration:

my_track_seg = TrackSegement()

my_track_a = Track()
my_track_b = Track()

# Add track segment to track A.
my_track_a.trksegs.append(my_track_seg)

# Because all instances of Track share the same mutable default value for `trksegs`,
# the previous statement adds the track segment also to track B.
assert my_track_a.trksegs[0] == my_track_seg
assert my_track_b.trksegs[0] == my_track_seg

I assume this was an oversight and not a deliberate design decision. For a detailed explanation and possible solutions, see this section in the Python documentation.

Add conversion methods for other file formats

Add conversion methods (to and from) for other file formats, such as:

• GeoJSON
• Keyhole Markup Language (KML), possibly including KMZ

Drop support for Python 3.7

Python 3.7 has gone end-of-life (EOL) on 27 June 2023 (https://endoflife.date/python).

Dependency Issue: LXML has no M1 Mac Support

Just an FYI for other who end up here ...
https://bugs.launchpad.net/lxml/+bug/1913032

Refactor using `cookiecutter-python-package`

Refactor the PyGPX repository using my cookiecutter-python-package project template.

When fully implemented, this will bring about the following improvements:

• Linting with autofix (i.e. removing unused imports, formatting and Python syntax upgrades) with ruff
• Code formatting with Black and Prettier
• Static type-checking with mypy
• Testing with pytest
• Continuous Integration with GitHub Actions
• Documentation with Sphinx, MyST, and Read the Docs using the Furo theme
• Automated release builds and uploads to PyPI

Add tests

Add tests to the project (using the excellent pytest framework).