changelog & deps updates for v0.28.0

Signed-off-by: Nicolas Höning <nicolas@seita.nl>

Author: nhoening

documentation/api/change_log.rst

@@ -5,16 +5,12 @@ API change log
 
 .. note:: The FlexMeasures API follows its own versioning scheme. This is also reflected in the URL (e.g. `/api/v3_0`), allowing developers to upgrade at their own pace.
 
-v3.0-26 | 2025-09-02
-""""""""""""""""""""
-- Added endpoints `GET /sensors/<id>/data` and `POST /sensors/<id>/data`.
-- Moved endpoints `GET /sensors/data` and `POST /sensors/data` into deprecation. Their URL does not align with the style of other endpoints, and they rely on entity addresses instead of IDs, which has been confusing users (a concept we are fading out).
-
-
 v3.0-26 | 2025-09-10
 """"""""""""""""""""
 - Added endpoint `POST /users`.
 - Added endpoint `GET /assets/types`.
+- Added endpoints `GET /sensors/<id>/data` and `POST /sensors/<id>/data`.
+- Moved endpoints `GET /sensors/data` and `POST /sensors/data` into deprecation. Their URL does not align with the style of other endpoints, and they rely on entity addresses instead of IDs, which has been confusing users (a concept we are fading out).
 
 
 v3.0-25 | 2025-07-24

documentation/changelog.rst

@@ -3,11 +3,13 @@
 FlexMeasures Changelog
 **********************
 
-v0.28.0 | September XX, 2025
+v0.28.0 | September 10, 2025
 ============================
 
-.. warning:: Upgrading to this version requires running ``flexmeasures db upgrade`` (you can create a backup first with ``flexmeasures db-ops dump``).
+.. note:: Read more on these features on `the FlexMeasures blog <https://flexmeasures.io/v028-daily-kpis/>`_.
 
+.. warning:: Upgrading to this version requires running ``flexmeasures db upgrade`` (you can create a backup first with ``flexmeasures db-ops dump``).
+             This upgrade may take a few minutes, depending on how much time series data you have in your database (the data will be reindexed).
 
 New features
 -------------

documentation/cli/change_log.rst

@@ -4,11 +4,10 @@
 FlexMeasures CLI Changelog
 **********************
 
-since v0.27.0 | September XX, 2025
+since v0.28.0 | September 10, 2025
 =================================
 * Removed command ``flexmeasures db-ops save`` and ``flexmeasures db-ops load`` for folder&file - base backup management.
 
-
 since v0.27.0 | July 20, 2025
 =================================
 * Add ``flexmeasures show assets`` CLI command for listing public assets and option ``--account <account-id>`` to list assets owned by a specific account.
@@ -26,35 +25,29 @@ since v0.25.0 | April 01, 2025
 
 since v0.24.0 | January 6, 2025
 =================================
-
 * ``flexmeasures show beliefs`` shows datetime values on x-axis labels.
 * ``flexmeasures add sensor`` no longer requires the ``capacity_in_mw`` attribute to be set for power sensors.
 
 since v0.22.0 | June 29, 2024
 =================================
-
 * Add ``--resolution`` option to ``flexmeasures show chart`` to produce charts in different time resolutions.
 
 since v0.21.0 | April 16, 2024
 =================================
-
 * Include started, deferred and scheduled jobs in the overview printed by the CLI command ``flexmeasures jobs show-queues``.
 
 since v.0.20.0 | March 26, 2024
 =================================
-
 * Add command ``flexmeasures edit transfer-ownership`` to transfer the ownership of an asset and its children.
 * Add ``--offspring`` option to ``flexmeasures delete beliefs`` command, allowing to delete beliefs of children, as well.
 * Add support for providing a sensor definition to the ``--site-power-capacity``, ``--site-consumption-capacity`` and ``--site-production-capacity`` options of the ``flexmeasures add schedule for-storage`` command.
 
 since v0.19.1 | February 26, 2024
 =======================================
-
 * Fix support for providing a sensor definition to the ``--storage-power-capacity`` option of the ``flexmeasures add schedule for-storage`` command.
 
 since v0.19.0 | February 18, 2024
 =======================================
-
 * Enable the use of QuantityOrSensor fields for the ``flexmeasures add schedule for-storage`` CLI command:
 
     * ``charging-efficiency``
@@ -73,21 +66,18 @@ since v0.19.0 | February 18, 2024
     * ``--asset-type-id`` -> ``--asset-type``
     * ``--sensor-id`` -> ``--sensor``
     * ``--source-id`` -> ``--source``
-    * ``--user-id`` -> ``--user`
+    * ``--user-id`` -> ``--user``
 
 since v0.18.1 | January 15, 2024
 =======================================
-
 * Fix the validation of the option ``--parent-asset`` of command ``flexmeasures add asset``.
 
 since v0.17.0 | November 8, 2023
 =======================================
-
 * Add ``--consultancy`` option to ``flexmeasures add account`` to create a consultancy relationship with another account.
 
 since v0.16.0 | September 29, 2023
 =======================================
-
 * Add command ``flexmeasures add sources`` to add the base `DataSources` for the `DataGenerators`.
 * Add command ``flexmeasures show chart`` to export sensor and asset charts in PNG or SVG formats.
 * Add ``--kind reporter`` option to ``flexmeasures add toy-account`` to create the asset and sensors for the reporter tutorial.
@@ -103,13 +93,11 @@ since v0.15.0 | August 9, 2023
 
 since v0.14.1 | June 20, 2023
 =================================
-
 * Avoid saving any :abbr:`NaN (not a number)` values to the database, when calling ``flexmeasures add report``.
 * Fix defaults for the ``--start-offset`` and ``--end-offset` options to ``flexmeasures add report``, which weren't being interpreted in the local timezone of the reporting sensor.
 
 since v0.14.0 | June 15, 2023
 =================================
-
 * Allow setting a storage efficiency using the new ``--storage-efficiency`` option to the ``flexmeasures add schedule for-storage`` CLI command.
 * Add CLI command ``flexmeasures add report`` to calculate a custom report from sensor data and save the results to the database, with the option to export them to a CSV or Excel file.
 * Add CLI command ``flexmeasures show reporters`` to list available reporters, including any defined in registered plugins.
@@ -118,13 +106,11 @@ since v0.14.0 | June 15, 2023
 
 since v0.13.0 | May 1, 2023
 =================================
-
 * Add ``flexmeasures add source`` CLI command for adding a new data source.
 * Add ``--inflexible-device-sensor`` option to ``flexmeasures add schedule``.
 
 since v0.12.0 | January 04, 2023
 =================================
-
 * Add ``--resolution``, ``--timezone`` and ``--to-file`` options to ``flexmeasures show beliefs``, to show beliefs data in a custom resolution and/or timezone, and also to save shown beliefs data to a CSV file.
 * Add options to ``flexmeasures add beliefs`` to 1) read CSV data with timezone naive datetimes (use ``--timezone`` to localize the data), 2) read CSV data with datetime/timedelta units (use ``--unit datetime`` or ``--unit timedelta``, 3) remove rows with NaN values, and 4) add filter to read-in data by matching values in specific columns (use ``--filter-column`` and ``--filter-value`` together).
 * Fix ``flexmeasures db-ops dump`` and ``flexmeasures db-ops restore`` incorrectly reporting a success when `pg_dump` and `pg_restore` are not installed.
@@ -135,7 +121,6 @@ since v0.12.0 | January 04, 2023
 
 since v0.11.0 | August 28, 2022
 ==============================
-
 * Add ``flexmeasures jobs show-queues`` to show contents of computation job queues.
 * ``--name`` parameter in ``flexmeasures jobs run-worker`` is now optional.
 * Add ``--custom-message`` param to ``flexmeasures monitor tasks``.

requirements/3.10/app.txt

@@ -65,6 +65,8 @@ cryptography==45.0.5
     #   webauthn
 cycler==0.12.1
     # via matplotlib
+dictdiffer==0.9.0
+    # via -r requirements/app.in
 dill==0.4.0
     # via openturns
 dnspython==2.7.0
@@ -185,7 +187,7 @@ markupsafe==3.0.2
     #   sentry-sdk
     #   werkzeug
     #   wtforms
-marshmallow==3.26.1
+marshmallow==3.26.1 ; python_version < "3.11"
     # via
     #   -r requirements/app.in
     #   flask-marshmallow
@@ -424,4 +426,3 @@ zipp==3.23.0
 
 # The following packages are considered to be unsafe in a requirements file:
 # setuptools
-dictdiffer>=0.9.0

requirements/3.10/dev.txt

@@ -15,6 +15,10 @@ click==8.1.8
     #   -c requirements/3.10/app.txt
     #   -c requirements/3.10/test.txt
     #   black
+dictdiffer==0.9.0
+    # via
+    #   -c requirements/3.10/app.txt
+    #   -r requirements/dev.in
 distlib==0.4.0
     # via virtualenv
 filelock==3.18.0

requirements/3.10/test.txt

@@ -125,4 +125,4 @@ werkzeug==3.1.3
     # via
     #   -c requirements/3.10/app.txt
     #   flask
-    #   pytest-flask
+    #   pytest-flask

requirements/3.11/app.txt

@@ -65,6 +65,8 @@ cryptography==45.0.6
     #   webauthn
 cycler==0.12.1
     # via matplotlib
+dictdiffer==0.9.0
+    # via -r requirements/app.in
 dill==0.4.0
     # via openturns
 dnspython==2.7.0
@@ -111,7 +113,9 @@ flask-migrate==4.1.0
 flask-principal==0.4.0
     # via flask-security-too
 flask-security-too[fsqla,mfa]==5.6.2
-    # via -r requirements/app.in
+    # via
+    #   -r requirements/app.in
+    #   flask-security-too
 flask-sqlalchemy==3.1.1
     # via
     #   -r requirements/app.in
@@ -221,7 +225,6 @@ openturns==1.25
 packaging==25.0
     # via
     #   altair
-    #   marshmallow
     #   matplotlib
     #   sktime
     #   statsmodels
@@ -424,4 +427,3 @@ zipp==3.23.0
 
 # The following packages are considered to be unsafe in a requirements file:
 # setuptools
-dictdiffer>=0.9.0

requirements/3.11/dev.txt

@@ -15,6 +15,10 @@ click==8.1.8
     #   -c requirements/3.11/app.txt
     #   -c requirements/3.11/test.txt
     #   black
+dictdiffer==0.9.0
+    # via
+    #   -c requirements/3.11/app.txt
+    #   -r requirements/dev.in
 distlib==0.4.0
     # via virtualenv
 filelock==3.19.1
@@ -84,4 +88,3 @@ watchdog==6.0.0
 
 # The following packages are considered to be unsafe in a requirements file:
 # setuptools
-dictdiffer>=0.9.0

requirements/3.11/test.txt

@@ -108,4 +108,4 @@ werkzeug==3.1.3
     # via
     #   -c requirements/3.11/app.txt
     #   flask
-    #   pytest-flask
+    #   pytest-flask

requirements/3.12/app.txt

@@ -65,6 +65,8 @@ cryptography==45.0.6
     #   webauthn
 cycler==0.12.1
     # via matplotlib
+dictdiffer==0.9.0
+    # via -r requirements/app.in
 dill==0.4.0
     # via openturns
 dnspython==2.7.0
@@ -223,7 +225,6 @@ openturns==1.25
 packaging==25.0
     # via
     #   altair
-    #   marshmallow
     #   matplotlib
     #   sktime
     #   statsmodels