geostrapy
A python CLI to share data related to physical activities over an API (geo-localized or not).
💡 Idea
- Use services like Strava to follow my physical activities (any other service is welcome)
- Keep control over the data I share: just what I need (proportionality & relevance)
- Respect python scripting guidelines proposed by Vincent Bernat ( 🇫🇷 | 🇬🇧 ).
✨ Features
These are imagined with Strava in mind, but any other service will be nice too :
- Create activity
- From a GPX track: get characteristics
- Sanitize a GPX track:
- Post modified GPX file as activity
- Process GPX multi-track file
- and maybe more…
🚀 Quickstart
git clone git@lab.frogg.it:fcode/geostrapy.git && cd geostrapy
/<path>/<to>/python3.9 -m venv ~/.venvs/geostrapy
source ~/.venvs/geostrapy/bin/activate
pip install -r requirements.txt
python cli/run.py --help
🚧 Development
- Follow our
git
conventions (🇫🇷 only) - Built with
Python 3.9
- Code linting with
flake8
,pylint
,black
& pydocstyle. - Install development tools:
pip install -r requirements-dev.txt
- A
Makefile
with tools : runmake help
to have a look - Use the
pre-commit
git hook, CI will run itecho "make --no-print-directory lint" > .git/hooks/pre-commit
chmod u+x .git/hooks/pre-commit
📌 Dependences
Details in requirements.txt
& requirements-dev.txt
-
gpxpy
: GPX file manipulation -
strava-cli
: Use Strava's API on command line
🤝 Contributing
- Roadmap ➡️ project kanban
- Question, suggestion, issue ➡️ project issues
- Code submission ➡️ project merge request