mirror of
https://github.com/Akkudoktor-EOS/EOS.git
synced 2026-09-11 10:26:38 +00:00
1abdd345c4
The isolated pre-commit mypy hook previously omitted runtime type information that make mypy used, hiding errors involving dependencies such as Pydantic and Pendulum. Makefile, pre-commit and CI now run the same full-project typing policy in the development environment defined by uv.lock. - Use uv run --locked --exact --extra dev and the same mypy arguments for Makefile and the local hook. Check all of src and tests, including on configuration-only changes. - Pin Python 3.13 for local development and the pre-commit CI job, and install the locked pre-commit version in CI. - Disable incremental analysis because existing Pendulum cache state changes mypy 2.3.1 diagnostics. Document the policy, the performance tradeoff and the existing typing debt. - Add a regression test that exercises Makefile, the hook and the CI command in a temporary project, accepting valid dependency types and detecting deliberate Pydantic/Pendulum assignment errors. Resolve the newly detected mypy diagnostics. - Enable the numpydantic and Pydantic mypy plugins, retaining strict Pydantic constructor typing with init_typed = true. Validate raw/coercible payloads through model_validate. - Propagate concrete record, provider and time-window types through generic collections, factories and lookup methods. Preserve runtime field inspection and generated time-window documentation. - Align Pendulum annotations with actual factory/arithmetic results while retaining Pydantic validation adapters at runtime. Correct optional values, array boundaries, REST handlers and plotting interfaces. - Add pinned scipy-stubs and types-psutil, update uv.lock, and supply the plugins' dependencies. - Add runtime regression coverage for validated path defaults, normalized time-series metadata, generic field inspection, invalid timestamps and unsupported provider imports. Runtime and compatibility details: - Validate path defaults as Path objects while retaining raw string defaults needed by migration serialization with exclude_defaults. - Normalize feed-in tariff lists and default charge rates to NumPy arrays; reject missing timestamps/uninitialized values explicitly. Importing into a provider without import support returns HTTP 400. - Public JSON schemas and OpenAPI structure match main (excluding the generated version). Signed-off-by: dr-dimitry Signed-off-by: dr-dimitry Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com> Co-authored-by: dr-dimitri <87113560+dr-dimitri@users.noreply.github.com> Co-authored-by: Normann <github@koldrack.com>
339 lines
9.9 KiB
Markdown
339 lines
9.9 KiB
Markdown
## Full example Config
|
|
|
|
<!-- pyml disable line-length -->
|
|
```json
|
|
{
|
|
"adapter": {
|
|
"provider": [
|
|
"HomeAssistant"
|
|
],
|
|
"homeassistant": {
|
|
"config_entity_ids": null,
|
|
"load_emr_entity_ids": null,
|
|
"grid_export_emr_entity_ids": null,
|
|
"grid_import_emr_entity_ids": null,
|
|
"pv_production_emr_entity_ids": null,
|
|
"device_measurement_entity_ids": null,
|
|
"device_instruction_entity_ids": null,
|
|
"solution_entity_ids": null
|
|
},
|
|
"nodered": {
|
|
"host": "127.0.0.1",
|
|
"port": 1880
|
|
}
|
|
},
|
|
"cache": {
|
|
"subpath": "cache",
|
|
"cleanup_interval": 300.0
|
|
},
|
|
"database": {
|
|
"provider": "LMDB",
|
|
"compression_level": 0,
|
|
"initial_load_window_h": 48,
|
|
"keep_duration_h": 48,
|
|
"autosave_interval_sec": 5,
|
|
"compaction_interval_sec": 3600,
|
|
"batch_size": 100
|
|
},
|
|
"devices": {
|
|
"batteries": [
|
|
{
|
|
"device_id": "battery1",
|
|
"capacity_wh": 8000,
|
|
"charging_efficiency": 0.88,
|
|
"discharging_efficiency": 0.88,
|
|
"levelized_cost_of_storage_kwh": 0.0,
|
|
"max_charge_power_w": 5000,
|
|
"min_charge_power_w": 50,
|
|
"charge_rates": [
|
|
0.0,
|
|
0.1,
|
|
0.2,
|
|
0.3,
|
|
0.4,
|
|
0.5,
|
|
0.6,
|
|
0.7,
|
|
0.8,
|
|
0.9,
|
|
1.0
|
|
],
|
|
"min_soc_percentage": 0,
|
|
"max_soc_percentage": 100
|
|
}
|
|
],
|
|
"max_batteries": 1,
|
|
"electric_vehicles": [
|
|
{
|
|
"device_id": "battery1",
|
|
"capacity_wh": 8000,
|
|
"charging_efficiency": 0.88,
|
|
"discharging_efficiency": 0.88,
|
|
"levelized_cost_of_storage_kwh": 0.0,
|
|
"max_charge_power_w": 5000,
|
|
"min_charge_power_w": 50,
|
|
"charge_rates": [
|
|
0.0,
|
|
0.1,
|
|
0.2,
|
|
0.3,
|
|
0.4,
|
|
0.5,
|
|
0.6,
|
|
0.7,
|
|
0.8,
|
|
0.9,
|
|
1.0
|
|
],
|
|
"min_soc_percentage": 0,
|
|
"max_soc_percentage": 100
|
|
}
|
|
],
|
|
"max_electric_vehicles": 1,
|
|
"inverters": [],
|
|
"max_inverters": 1,
|
|
"home_appliances": [],
|
|
"max_home_appliances": 1
|
|
},
|
|
"elecfee": {
|
|
"provider": "ElecFeeFixed",
|
|
"elecfeefixed": {
|
|
"consumption_amt_kwh": {
|
|
"windows": []
|
|
},
|
|
"consumption_percent_amt": {
|
|
"windows": []
|
|
},
|
|
"feedin_amt_kwh": {
|
|
"windows": []
|
|
},
|
|
"feedin_percent_amt": {
|
|
"windows": []
|
|
}
|
|
},
|
|
"elecfeeimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
}
|
|
},
|
|
"elecprice": {
|
|
"provider": "ElecPriceAkkudoktor",
|
|
"akkudoktor": {},
|
|
"elecpricefixed": {
|
|
"elecprice_marketprice_amt_kwh": {
|
|
"windows": []
|
|
}
|
|
},
|
|
"elecpriceimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"energycharts": {
|
|
"bidding_zone": "DE-LU"
|
|
},
|
|
"smard": {
|
|
"filter_id": 4169,
|
|
"region": "DE"
|
|
},
|
|
"tibber": {
|
|
"access_token": null,
|
|
"home_id": null
|
|
}
|
|
},
|
|
"ems": {
|
|
"startup_delay": 5.0,
|
|
"interval": 300.0,
|
|
"mode": "OPTIMIZATION"
|
|
},
|
|
"feedintariff": {
|
|
"provider": "FeedInTariffFixed",
|
|
"feedintarifffixed": {
|
|
"feed_in_tariff_amt_kwh": {
|
|
"windows": []
|
|
}
|
|
},
|
|
"feedintariffimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"dvhubonline": {
|
|
"base_url": "https://dvhub.online",
|
|
"zone": "DE-LU"
|
|
},
|
|
"energycharts": {
|
|
"bidding_zone": "DE-LU"
|
|
},
|
|
"smard": {}
|
|
},
|
|
"general": {
|
|
"config_save_mode": "AUTOMATIC",
|
|
"config_save_interval_sec": 60,
|
|
"version": "0.0.0",
|
|
"data_folder_path": "/home/user/.local/share/net.akkudoktoreos.net",
|
|
"data_output_subpath": "output",
|
|
"latitude": 52.52,
|
|
"longitude": 13.405
|
|
},
|
|
"load": {
|
|
"provider": "LoadAkkudoktor",
|
|
"loadakkudoktor": {
|
|
"loadakkudoktor_year_energy_kwh": null
|
|
},
|
|
"loadimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"vrm": {
|
|
"token": "your-token",
|
|
"site_id": 12345
|
|
}
|
|
},
|
|
"logging": {
|
|
"api_level": "TRACE",
|
|
"console_level": "TRACE",
|
|
"file_level": "TRACE"
|
|
},
|
|
"measurement": {
|
|
"historic_hours": 17520,
|
|
"load_emr_keys": [
|
|
"load0_emr"
|
|
],
|
|
"grid_export_emr_keys": [
|
|
"grid_export_emr"
|
|
],
|
|
"grid_import_emr_keys": [
|
|
"grid_import_emr"
|
|
],
|
|
"pv_production_emr_keys": [
|
|
"pv1_emr"
|
|
]
|
|
},
|
|
"optimization": {
|
|
"algorithm": "GENETIC",
|
|
"genetic": {
|
|
"interval_sec": 3600,
|
|
"horizon_hours": 24,
|
|
"individuals": 400,
|
|
"generations": 400,
|
|
"seed": null,
|
|
"penalties": {
|
|
"ev_soc_miss": 10
|
|
}
|
|
},
|
|
"genetic0": {
|
|
"horizon_hours": 24,
|
|
"individuals": 400,
|
|
"generations": 400,
|
|
"seed": null,
|
|
"penalties": {
|
|
"ev_soc_miss": 10
|
|
}
|
|
}
|
|
},
|
|
"prediction": {
|
|
"hours": 48,
|
|
"historic_hours": 48
|
|
},
|
|
"pvforecast": {
|
|
"provider": "PVForecastAkkudoktor",
|
|
"pvforecastimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"vrm": {
|
|
"token": "your-token",
|
|
"site_id": 12345
|
|
},
|
|
"homeassistant": {
|
|
"entity_id": "sensor.pv_forecast",
|
|
"attribute": "forecast",
|
|
"datetime_key": "datetime",
|
|
"value_key": "watts",
|
|
"value_unit": "W",
|
|
"base_url": null,
|
|
"token": null
|
|
},
|
|
"pvlib": {},
|
|
"pvnode": {
|
|
"api_key": "",
|
|
"site_id": null,
|
|
"forecast_days": 2
|
|
},
|
|
"forecastsolar": {
|
|
"api_key": null
|
|
},
|
|
"solcast": {
|
|
"api_key": "",
|
|
"site_id": ""
|
|
},
|
|
"planes": [
|
|
{
|
|
"surface_tilt": 10.0,
|
|
"surface_azimuth": 180.0,
|
|
"userhorizon": [
|
|
10.0,
|
|
20.0,
|
|
30.0
|
|
],
|
|
"peakpower": 5.0,
|
|
"pvtechchoice": "crystSi",
|
|
"mountingplace": "free",
|
|
"loss": 14.0,
|
|
"trackingtype": 0,
|
|
"optimal_surface_tilt": false,
|
|
"optimalangles": false,
|
|
"albedo": null,
|
|
"module_model": null,
|
|
"inverter_model": null,
|
|
"inverter_paco": 6000,
|
|
"modules_per_string": 20,
|
|
"strings_per_inverter": 2
|
|
},
|
|
{
|
|
"surface_tilt": 20.0,
|
|
"surface_azimuth": 90.0,
|
|
"userhorizon": [
|
|
5.0,
|
|
15.0,
|
|
25.0
|
|
],
|
|
"peakpower": 3.5,
|
|
"pvtechchoice": "crystSi",
|
|
"mountingplace": "free",
|
|
"loss": 14.0,
|
|
"trackingtype": 1,
|
|
"optimal_surface_tilt": false,
|
|
"optimalangles": false,
|
|
"albedo": null,
|
|
"module_model": null,
|
|
"inverter_model": null,
|
|
"inverter_paco": 4000,
|
|
"modules_per_string": 20,
|
|
"strings_per_inverter": 2
|
|
}
|
|
],
|
|
"max_planes": 1
|
|
},
|
|
"server": {
|
|
"host": "127.0.0.1",
|
|
"port": 8503,
|
|
"verbose": false,
|
|
"startup_eosdash": true,
|
|
"eosdash_host": "127.0.0.1",
|
|
"eosdash_port": 8504,
|
|
"eosdash_supervise_interval_sec": 10,
|
|
"run_as_user": null,
|
|
"reload": true
|
|
},
|
|
"utils": {},
|
|
"weather": {
|
|
"provider": "WeatherImport",
|
|
"weatherimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
}
|
|
}
|
|
}
|
|
```
|
|
<!-- pyml enable line-length -->
|