Skip to main content

A Python wrapper for Komoot APIs

Project description

Kompy

example workflow

Overview

Kompy is a wrapper for Komoot APIs that allows you to download and upload your activities from Komoot.

A documentation can be found here.

Features

  • Download Activities from Komoot: Download your activities from Komoot to GPX, FIT or Custom Object format.
  • Upload Activities to Komoot: Upload your activities to Komoot from GPX, FIT files.
  • Download Tours from Komoot: Download your tours from Komoot

Installation

To get started with the Kompy, follow these steps:

  1. Ensure you have Python installed on your system. This app is compatible with Python 3.11 and above.

  2. pip the package:

    pip install kompy
    
  3. Import the package to your project:

    import kompy as kp
    

Usage

For a more detailed usage example, please check this notebook.

The most basic usage is:

  1. Create a connector:
    from kompy import KomootConnector
    connector = KomootConnector(password=..., email=...)
    
  2. Fetch your activities:
    tours_list = connector.get_tours(user_identifier=None)
    

Run the tests

To run the tests (locally), run:

  pytest .

or

  python -m unittest

Contributing

Contributions to Kompy are welcome! If you have a suggestion that would make this app better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Acknowledgements

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Kompy-0.0.7.tar.gz (17.6 kB view hashes)

Uploaded Source

Built Distribution

Kompy-0.0.7-py3-none-any.whl (21.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page