bump to version 0.7.15

docsrc/source/cli.rst

@@ -105,7 +105,11 @@ Remove blacklisted tokens expired for more than provided number of days.
 .. versionadded:: 0.7.15
 
 Create a user account.
-**Note**: the newly created account is active.
+
+.. note::
+  - the newly created account is already active.
+  - the CLI allows to create users when registration is disabled.
+
 
 .. cssclass:: table-bordered
 .. list-table::

docsrc/source/conf.py

@@ -22,7 +22,7 @@ sys.path.insert(0, os.path.abspath('../../fittrackee'))
 # -- Project information -----------------------------------------------------
 
 project = 'FitTrackee'
-copyright = '2018 - 2022, SamR1'
+copyright = '2018 - 2023, SamR1'
 author = 'SamR1'
 
 # The full version, including alpha/beta/rc tags.

docsrc/source/features.rst

@@ -38,13 +38,18 @@ Workouts
   It can be overridden in user preferences.
 
 - Dashboard with month calendar displaying workouts and record. The week can start on Sunday or Monday (which can be changed in the user preferences). The calendar displays up to 100 workouts.
-- Workout creation by uploading a gpx file (related data are stored in database with metric system).
+- Workout creation by uploading a gpx file (related data are stored in database in metric system).
+
+.. note::
+  | Only gpx files with time are supported.
+  | Calculated values may differ from values calculated by the application that originally generated the gpx files, in particular the maximum speed.
+
 - | A workout can even be created without gpx (the user must enter date, time, duration and distance).
   | Ascent and descent can also be provided (*new in 0.7.10*).
 - | A workout with a gpx file can be displayed with map and charts (speed and elevation).
   | Controls allow full screen view and position reset (*new in 0.5.5*).
-- | If **DarkSky API** or **Visual Crossing** (*new in 0.7.11*) API key is provided, weather is displayed in workout detail. Data source is displayed in About page.
-  | Wind is displayed, with arrow indicating direction (a tooltip can be displayed with the direction that the wind is coming **from**) (*new in 0.5.5*).
+- | If **Visual Crossing** (*new in 0.7.11*) API key is provided, weather is displayed in workout detail. Data source is displayed in **About** page.
+  | Wind is displayed, with an arrow indicating the direction (a tooltip can be displayed with the direction that the wind is coming **from**) (*new in 0.5.5*).
 - Segments can be displayed.
 - Workout gpx file can be downloaded (*new in 0.5.1*)
 - Workout edition and deletion. User can add a note.
@@ -65,7 +70,20 @@ Workouts
 .. note::
   Records may differ from records displayed by the application that originally generated the gpx files.
 
-- Workouts list and filter. Only sports with workouts are displayed in sport dropdown.
+- Workouts list.
+    - The user can filter workouts on:
+        - date
+        - sports (only sports with workouts are displayed in sport dropdown)
+        - title (*new in 0.7.15*)
+        - distance
+        - duration
+        - average speed
+        - maximum speed
+    - Workouts can be sorted by:
+        - date
+        - distance
+        - duration
+        - average speed
 
 .. note::
     For now, only the owner of the workout can see it.
@@ -88,6 +106,7 @@ Account & preferences
 - A user can choose between metric system and imperial system for distance, elevation and speed display (*new in 0.5.0*)
 - A user can choose to display or hide ascent records and total on Dashboard (*new in 0.6.11*)
 - A user can choose format used to display dates (*new in 0.7.3*)
+- A user can choose elevation chart axis start: zero or minimum altitude (*new in 0.7.15*)
 - A user can set sport preferences (*new in 0.5.0*):
      - change sport color (used for sport image and charts)
      - can override stopped speed threshold (for next uploaded gpx files)
@@ -174,8 +193,11 @@ FitTrackee is available in the following languages (which can be saved in the us
 - German (*new in 0.6.9*)
 - Dutch (*new in 0.7.8*)
 - Italian (*new in 0.7.10*)
+- Galician (*new in 0.7.15*)
+- Spanish (*new in 0.7.15*)
+- Norwegian Bokmål (*new in 0.7.15*)
 
-Translations status on `Weblate <https://hosted.weblate.org/engage/fittrackee/>`__:
+Translations status on `Weblate <https://hosted.weblate.org/engage/fittrackee/>`__ (may differ from the released version):
 
 .. figure:: https://hosted.weblate.org/widgets/fittrackee/-/multi-auto.svg
 

docsrc/source/index.rst

@@ -33,9 +33,10 @@ Table of contents
    :maxdepth: 1
 
    features
-   apps
+   oauth
    installation
    cli
+   third_party_tools
    api/index
    troubleshooting/index
    changelog

docsrc/source/installation.rst

@@ -7,7 +7,6 @@ This application is written in Python (API) and Typescript (client):
     - Flask
     - `gpxpy <https://github.com/tkrajina/gpxpy>`_ to parse gpx files
     - `staticmap <https://github.com/komoot/staticmap>`_ to generate a static map image from gpx coordinates
-    - `python-forecast.io <https://github.com/ZeevG/python-forecast.io>`_ to fetch weather data from `Dark Sky <https://darksky.net>`__ (former forecast.io)
     - `dramatiq <https://flask-dramatiq.readthedocs.io/en/latest/>`_ for task queue
     - `Authlib <https://docs.authlib.org/en/latest/>`_ for OAuth 2.0 Authorization support
     - `Flask-Limiter <https://flask-limiter.readthedocs.io/en/stable>`_ for API rate limits
@@ -356,15 +355,18 @@ Weather data
 
 The following weather data providers are supported by **FitTrackee**:
 
-- `Dark Sky <https://darksky.net>`__ (deprecated, will stop on March 31st, 2023)
 - `Visual Crossing <https://www.visualcrossing.com>`__ (**note**: historical data are provided on hourly period)
 
 To configure a weather provider, set the following environment variables:
 
-- ``WEATHER_API_PROVIDER``: ``darksky`` for **Dark Sky** or ``visualcrossing`` for **Visual Crossing**
 - ``WEATHER_API_KEY``: the key to the corresponding weather provider
 
 
+.. versionchanged:: 0.7.15
+
+**DarkSky** support is discontinued, since the service shut down on March 31, 2023.
+
+
 Installation
 ~~~~~~~~~~~~
 
@@ -507,13 +509,13 @@ Production environment
 .. warning::
     | Note that FitTrackee is under heavy development, some features may be unstable.
 
--  Download the last release (for now, it is the release v0.7.14):
+-  Download the last release (for now, it is the release v0.7.15):
 
 .. code:: bash
 
-   $ wget https://github.com/SamR1/FitTrackee/archive/v0.7.14.tar.gz
-   $ tar -xzf v0.7.14.tar.gz
-   $ mv FitTrackee-0.7.14 FitTrackee
+   $ wget https://github.com/SamR1/FitTrackee/archive/v0.7.15.tar.gz
+   $ tar -xzf v0.7.15.tar.gz
+   $ mv FitTrackee-0.7.15 FitTrackee
    $ cd FitTrackee
 
 -  Create **.env** from example and update it
@@ -633,13 +635,13 @@ Prod environment
 
 - Change to the directory where FitTrackee directory is located
 
-- Download the last release (for now, it is the release v0.7.14) and overwrite existing files:
+- Download the last release (for now, it is the release v0.7.15) and overwrite existing files:
 
 .. code:: bash
 
-   $ wget https://github.com/SamR1/FitTrackee/archive/v0.7.14.tar.gz
-   $ tar -xzf v0.7.14.tar.gz
-   $ cp -R FitTrackee-0.7.14/* FitTrackee/
+   $ wget https://github.com/SamR1/FitTrackee/archive/v0.7.15.tar.gz
+   $ tar -xzf v0.7.15.tar.gz
+   $ cp -R FitTrackee-0.7.15/* FitTrackee/
    $ cd FitTrackee
 
 - Update **.env** if needed (see `Environment variables <installation.html#environment-variables>`__).
@@ -882,4 +884,10 @@ Open http://localhost:3000
     $ make docker-lint-client  # run lint on javascript files
     $ make docker-test-client  # run unit tests on Client
     $ make docker-lint-python  # run type check and lint on python files
-    $ make docker-test-python  # run unit tests on API
+    $ make docker-test-python  # run unit tests on API
+
+
+Yunohost
+~~~~~~~~
+
+A package is available, see https://github.com/YunoHost-Apps/fittrackee_ynh.

docsrc/source/oauth.rst

@@ -1,5 +1,5 @@
-Third-party applications
-########################
+OAuth 2.0
+#########
 (*new in 0.7.0*)
 
 FitTrackee provides a REST API (see `documentation <api/index.html>`__) whose

docsrc/source/third_party_tools.rst

@@ -0,0 +1,7 @@
+Third-party tools
+#################
+
+Thanks to the contributors, the following tools are available:
+
+- `strava-to-fittrackee <https://github.com/jat255/strava-to-fittrackee>`_ (import workouts from a Strava account)
+- `FitTrackee Uploader <https://github.com/ebrithiljonas/fittrackee-uploader>`_ (upload .gpx and .fit files)