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>
3.2 KiB
3.2 KiB
Configuration model for database settings
Attributes: provider: Optional provider identifier (e.g. "LMDB"). max_records_in_memory: Maximum records kept in memory before auto-save. auto_save: Whether to auto-save when threshold exceeded. batch_size: Batch size for batch operations.
:::{table} database :widths: 10 20 10 5 5 30 :align: left
| Name | Environment Variable | Type | Read-Only | Default | Description |
|---|---|---|---|---|---|
| autosave_interval_sec | EOS_DATABASE__AUTOSAVE_INTERVAL_SEC |
Optional[int] |
rw |
10 |
Automatic saving interval [seconds]. |
| Set to None to disable automatic saving. | |||||
| batch_size | EOS_DATABASE__BATCH_SIZE |
int |
rw |
100 |
Number of records to process in batch operations. |
| compaction_interval_sec | EOS_DATABASE__COMPACTION_INTERVAL_SEC |
Optional[int] |
rw |
3600 |
Interval in between automatic tiered compaction runs [seconds]. |
| Compaction downsamples old records to reduce storage while retaining coverage. Set to None to disable automatic compaction. | |||||
| compression_level | EOS_DATABASE__COMPRESSION_LEVEL |
int |
rw |
9 |
Compression level for database record data. |
| initial_load_window_h | EOS_DATABASE__INITIAL_LOAD_WINDOW_H |
Optional[int] |
rw |
None |
Specifies the default duration of the initial load window when loading records from the database, in hours. If set to None, the full available range is loaded. The window is centered around the current time by default, unless a different center time is specified. Different database namespaces may define their own default windows. |
| keep_duration_h | EOS_DATABASE__KEEP_DURATION_H |
Optional[int] |
rw |
None |
Default maximum duration records shall be kept in database [hours, none]. |
| None indicates forever. Database namespaces may have diverging definitions. | |||||
| provider | EOS_DATABASE__PROVIDER |
Optional[str] |
rw |
None |
Database provider id of provider to be used. |
| providers | List[str] |
ro |
N/A |
Return available database provider ids. | |
| ::: |
Example Input
{
"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
}
}
Example Output
{
"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,
"providers": [
"LMDB",
"SQLite",
"NoDB"
]
}
}