Python Type annotation example[.]py

example.py

import datetime
import requests
from typing import Final, TypedDict

MAX_VALUE: Final = 10_000
"""
Special typing construct to indicate final names to type checkers.
A final name cannot be re-assigned or overridden in a subclass.
"""

class Coordinates(TypedDict):
    """
    when you want to define a structured type for nested dictionaries, 
    it's a good practice to define each nested structure as its own TypedDict class. 
    This makes your types more explicit, reusable, and maintainable.
    """
    latitude: float
    longitude: float
    asset_on_scale: bool
    editable: bool
    timestamp: datetime
    battery_history: list[float]

class APIResponse(TypedDict):
    status: str
    message: str
    data: Coordinates



try:
    fetch_data  = requests.get("", headers={"authorization":  "Bearer XXXY"})
    fetch_data : APIResponse = fetch_data.json()
      
    # Calcuations
    # ...
    
except Exception as e:
    # LOG
    print(f"Error with request: {e}")

lgtm