Add Documentation 2 (#334)

Add documentation that covers:

- configuration
- prediction

Add Python scripts that support automatic documentation generation for
configuration data defined with pydantic.

Adapt EOS configuration to provide more methods for REST API and
automatic documentation generation.

Adapt REST API to allow for EOS configuration file load and save.
Sort REST API on generation of openapi markdown for docs.

Move logutil to core/logging to allow configuration of logging by standard config.

Make Akkudoktor predictions always start extraction of prediction data at start of day.
Previously extraction started at actual hour. This is to support the code that assumes
prediction data to start at start of day.

Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>

src/akkudoktoreos/prediction/elecpriceakkudoktor.py

@@ -13,11 +13,11 @@ import requests
 from numpydantic import NDArray, Shape
 from pydantic import Field, ValidationError
 
+from akkudoktoreos.core.logging import get_logger
 from akkudoktoreos.core.pydantic import PydanticBaseModel
 from akkudoktoreos.prediction.elecpriceabc import ElecPriceDataRecord, ElecPriceProvider
 from akkudoktoreos.utils.cacheutil import CacheFileStore, cache_in_file
 from akkudoktoreos.utils.datetimeutil import compare_datetimes, to_datetime, to_duration
-from akkudoktoreos.utils.logutil import get_logger
 
 logger = get_logger(__name__)
 
@@ -218,17 +218,14 @@ class ElecPriceAkkudoktor(ElecPriceProvider):
                 akkudoktor_value.marketpriceEurocentPerKWh / (100 * 1000) + charges_kwh / 1000
             )
 
-            if compare_datetimes(dt, self.start_datetime).lt:
-                # forecast data is too old
+            # We provide prediction starting at start of day, to be compatible to old system.
+            if compare_datetimes(dt, self.start_datetime.start_of("day")).lt:
+                # forecast data is too old - older than start_datetime with time set to 00:00:00
                 self.elecprice_8days[dt.hour, dt.day_of_week] = price_wh
                 continue
             self.elecprice_8days[dt.hour, 7] = price_wh
 
-            record = ElecPriceDataRecord(
-                date_time=dt,
-                elecprice_marketprice_wh=price_wh,
-            )
-            self.append(record)
+            self.update_value(dt, "elecprice_marketprice_wh", price_wh)
 
         # Update 8day cache
         elecprice_cache_file.seek(0)