mirror of
https://github.com/jpawlowski/hass.tibber_prices.git
synced 2026-03-29 21:03:40 +00:00
981fb08a69
- Introduced `get_intervals_for_day_offsets` helper to streamline access to price intervals for yesterday, today, and tomorrow. - Updated various components to replace direct access to `priceInfo` with the new helper, ensuring a flat structure for price intervals. - Adjusted calculations and data processing methods to accommodate the new data structure. - Enhanced documentation to reflect changes in caching strategy and data structure.
37 lines
1.4 KiB
Python
37 lines
1.4 KiB
Python
"""GraphQL queries and query types for Tibber API."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import Enum
|
|
|
|
|
|
class TibberPricesQueryType(Enum):
|
|
"""
|
|
Types of queries that can be made to the API.
|
|
|
|
CRITICAL: Query type selection is dictated by Tibber's API design and caching strategy.
|
|
|
|
PRICE_INFO:
|
|
- Used for current day-relative data (day before yesterday/yesterday/today/tomorrow)
|
|
- API automatically determines "today" and "tomorrow" based on current time
|
|
- MUST be used when querying any data from these 4 days, even if you only need
|
|
specific intervals, because Tibber's API requires this endpoint for current data
|
|
- Provides the core dataset needed for live data, recent historical context
|
|
(important until tomorrow's data arrives), and tomorrow's forecast
|
|
- Tibber likely has optimized caching for this frequently-accessed data range
|
|
|
|
PRICE_INFO_RANGE:
|
|
- Used for historical data older than day before yesterday
|
|
- Allows flexible date range queries with cursor-based pagination
|
|
- Required for any intervals beyond the 4-day window of PRICE_INFO
|
|
- Use this for historical analysis, comparisons, or trend calculations
|
|
|
|
USER:
|
|
- Fetches user account data and home metadata
|
|
- Separate from price data queries
|
|
|
|
"""
|
|
|
|
PRICE_INFO = "price_info"
|
|
PRICE_INFO_RANGE = "price_info_range"
|
|
USER = "user"
|