hyundai-kia-connect-api 3.27.0__py2.py3-none-any.whl → 3.29.1__py2.py3-none-any.whl

hyundai_kia_connect_api/{HyundaiBlueLinkAPIUSA.py → HyundaiBlueLinkApiUSA.py}

@@ -62,8 +62,8 @@ class cipherAdapter(HTTPAdapter):
         return super().proxy_manager_for(*args, **kwargs)
 
 
-class HyundaiBlueLinkAPIUSA(ApiImpl):
-    """HyundaiBlueLinkAPIUSA"""
+class HyundaiBlueLinkApiUSA(ApiImpl):
+    """HyundaiBlueLinkApiUSA"""
 
     # initialize with a timestamp which will allow the first fetch to occur
     last_loc_timestamp = dt.datetime.now(pytz.utc) - dt.timedelta(hours=3)
@@ -386,8 +386,8 @@ class HyundaiBlueLinkAPIUSA(ApiImpl):
         vehicle.ev_battery_is_plugged_in = get_child_value(
             state, "vehicleStatus.evStatus.batteryPlugin"
         )
-        vehicle.ev_charging_current = get_child_value(
-            state, "vehicleStatus.evStatus.batteryStndChrgPower"
+        vehicle.ev_charging_power = get_child_value(
+            state, "vehicleStatus.evStatus.batteryPower.batteryStndChrgPower"
         )
         ChargeDict = get_child_value(
             state, "vehicleStatus.evStatus.reservChargeInfos.targetSOClist"

hyundai_kia_connect_api/KiaUvoApiEU.py

@@ -520,6 +520,11 @@ class KiaUvoApiEU(ApiImplType1):
             vehicle.ev_charge_port_door_is_open = True
         elif ev_charge_port_door_is_open == 2:
             vehicle.ev_charge_port_door_is_open = False
+
+        vehicle.ev_charging_power = get_child_value(
+            state, "vehicleStatus.evStatus.batteryPower.batteryStndChrgPower"
+        )
+
         if (
             get_child_value(
                 state,

hyundai_kia_connect_api/{KiaUvoAPIUSA.py → KiaUvoApiUSA.py}

@@ -106,8 +106,8 @@ def request_with_logging(func):
     return request_with_logging_wrapper
 
 
-class KiaUvoAPIUSA(ApiImpl):
-    """KiaUvoAPIUSA"""
+class KiaUvoApiUSA(ApiImpl):
+    """KiaUvoApiUSA"""
 
     def __init__(self, region: int, brand: int, language) -> None:
         self.LANGUAGE: str = language

hyundai_kia_connect_api/Vehicle.py

@@ -156,11 +156,12 @@ class Vehicle:
     # EV fields (EV/PHEV)
 
     ev_charge_port_door_is_open: typing.Union[bool, None] = None
+    ev_charging_power: typing.Union[float, None] = None  # Charging power in kW
 
     ev_charge_limits_dc: typing.Union[int, None] = None
     ev_charge_limits_ac: typing.Union[int, None] = None
     ev_charging_current: typing.Union[int, None] = (
-        None  # Only supported in some regions
+        None  # Europe feature only, ac charging current limit
     )
     ev_v2l_discharge_limit: typing.Union[int, None] = None
 
@@ -424,7 +425,7 @@ class Vehicle:
     def air_temperature(self, value):
         self._air_temperature_value = value[0]
         self._air_temperature_unit = value[1]
-        self._air_temperature = value[0]
+        self._air_temperature = value[0] if value[0] != "OFF" else None
 
     @property
     def ev_driving_range(self):

hyundai_kia_connect_api/VehicleManager.py

@@ -14,8 +14,8 @@ from .ApiImpl import (
     WindowRequestOptions,
     ScheduleChargingClimateRequestOptions,
 )
-from .HyundaiBlueLinkAPIUSA import HyundaiBlueLinkAPIUSA
-from .KiaUvoAPIUSA import KiaUvoAPIUSA
+from .HyundaiBlueLinkApiUSA import HyundaiBlueLinkApiUSA
+from .KiaUvoApiUSA import KiaUvoApiUSA
 from .KiaUvoApiCA import KiaUvoApiCA
 from .KiaUvoApiEU import KiaUvoApiEU
 from .KiaUvoApiCN import KiaUvoApiCN
@@ -284,9 +284,9 @@ class VehicleManager:
         elif REGIONS[region] == REGION_USA and (
             BRANDS[brand] == BRAND_HYUNDAI or BRANDS[brand] == BRAND_GENESIS
         ):
-            return HyundaiBlueLinkAPIUSA(region, brand, language)
+            return HyundaiBlueLinkApiUSA(region, brand, language)
         elif REGIONS[region] == REGION_USA and BRANDS[brand] == BRAND_KIA:
-            return KiaUvoAPIUSA(region, brand, language)
+            return KiaUvoApiUSA(region, brand, language)
         elif REGIONS[region] == REGION_CHINA:
             return KiaUvoApiCN(region, brand, language)
         elif REGIONS[region] == REGION_AUSTRALIA:

hyundai_kia_connect_api/bluelink.py

@@ -0,0 +1,457 @@
+#!/usr/bin/env python3
+
+"""Connects to the Bluelink API and query the vehicle."""
+
+import argparse
+import datetime
+import json
+import logging
+import os
+import sys
+import textwrap
+
+import hyundai_kia_connect_api
+from hyundai_kia_connect_api import const
+
+
+def print_vehicle(vehicle):
+    print("Identification")
+    print("  id:", vehicle.id)
+    print("  name:", vehicle.name)
+    print("  model:", vehicle.model)
+    print("  registration_date:", vehicle.registration_date)
+    print("  year:", vehicle.year)
+    print("  VIN:", vehicle.VIN)
+    print("  key:", vehicle.key)
+    print("General")
+    print("  engine_type:", vehicle.engine_type)
+    print("  ccu_ccs2_protocol_support:", vehicle.ccu_ccs2_protocol_support)
+    print(
+        "  total_driving_range:",
+        vehicle.total_driving_range,
+        vehicle.total_driving_range_unit,
+    )
+    print("  odometer:", vehicle.odometer, vehicle.odometer_unit)
+    print("  geocode:", vehicle.geocode)
+    print("  car_battery_percentage:", vehicle.car_battery_percentage)
+    print("  engine_is_running:", vehicle.engine_is_running)
+    print("  last_updated_at:", vehicle.last_updated_at)
+    print("  timezone:", vehicle.timezone)
+    print("  dtc_count:", vehicle.dtc_count)
+    print("  dtc_descriptions:", vehicle.dtc_descriptions)
+    print("  smart_key_battery_warning_is_on:", vehicle.smart_key_battery_warning_is_on)
+    print("  washer_fluid_warning_is_on:", vehicle.washer_fluid_warning_is_on)
+    print("  brake_fluid_warning_is_on:", vehicle.brake_fluid_warning_is_on)
+    print("Climate")
+    print("  air_temperature:", vehicle.air_temperature, vehicle._air_temperature_unit)
+    print("  air_control_is_on:", vehicle.air_control_is_on)
+    print("  defrost_is_on:", vehicle.defrost_is_on)
+    print("  steering_wheel_heater_is_on:", vehicle.steering_wheel_heater_is_on)
+    print("  back_window_heater_is_on:", vehicle.back_window_heater_is_on)
+    print("  side_mirror_heater_is_on:", vehicle.side_mirror_heater_is_on)
+    print("  front_left_seat_status:", vehicle.front_left_seat_status)
+    print("  front_right_seat_status:", vehicle.front_right_seat_status)
+    print("  rear_left_seat_status:", vehicle.rear_left_seat_status)
+    print("  rear_right_seat_status:", vehicle.rear_right_seat_status)
+    print("Doors")
+    print("  is_locked:", vehicle.is_locked)
+    print("  front_left_door_is_open:", vehicle.front_left_door_is_open)
+    print("  front_right_door_is_open:", vehicle.front_right_door_is_open)
+    print("  back_left_door_is_open:", vehicle.back_left_door_is_open)
+    print("  back_right_door_is_open:", vehicle.back_right_door_is_open)
+    print("  trunk_is_open:", vehicle.trunk_is_open)
+    print("  hood_is_open:", vehicle.hood_is_open)
+    print("Windows")
+    print("  front_left_window_is_open:", vehicle.front_left_window_is_open)
+    print("  front_right_window_is_open:", vehicle.front_right_window_is_open)
+    print("  back_left_window_is_open:", vehicle.back_left_window_is_open)
+    print("  back_right_window_is_open:", vehicle.back_right_window_is_open)
+    print("Tire Pressure")
+    print("  tire_pressure_all_warning_is_on:", vehicle.tire_pressure_all_warning_is_on)
+    print(
+        "  tire_pressure_rear_left_warning_is_on:",
+        vehicle.tire_pressure_rear_left_warning_is_on,
+    )
+    print(
+        "  tire_pressure_front_left_warning_is_on:",
+        vehicle.tire_pressure_front_left_warning_is_on,
+    )
+    print(
+        "  tire_pressure_front_right_warning_is_on:",
+        vehicle.tire_pressure_front_right_warning_is_on,
+    )
+    print(
+        "  tire_pressure_rear_right_warning_is_on:",
+        vehicle.tire_pressure_rear_right_warning_is_on,
+    )
+    print("Service")
+    print(
+        "  next_service_distance:",
+        vehicle.next_service_distance,
+        vehicle._next_service_distance_unit,
+    )
+    print(
+        "  last_service_distance:",
+        vehicle.last_service_distance,
+        vehicle._last_service_distance_unit,
+    )
+    print("Location")
+    print("  location:", vehicle.location)
+    print("  location_last_updated_at:", vehicle.location_last_updated_at)
+    print("EV/PHEV")
+    print("  charge_port_door_is_open:", vehicle.ev_charge_port_door_is_open)
+    print("  charging_power:", vehicle.ev_charging_power)
+    print("  charge_limits_dc:", vehicle.ev_charge_limits_dc)
+    print("  charge_limits_ac:", vehicle.ev_charge_limits_ac)
+    print("  charging_current:", vehicle.ev_charging_current)
+    print("  v2l_discharge_limit:", vehicle.ev_v2l_discharge_limit)
+    print("  total_power_consumed:", vehicle.total_power_consumed, "Wh")
+    print("  total_power_regenerated:", vehicle.total_power_regenerated, "Wh")
+    print("  power_consumption_30d:", vehicle.power_consumption_30d, "Wh")
+    print("  battery_percentage:", vehicle.ev_battery_percentage)
+    print("  battery_soh_percentage:", vehicle.ev_battery_soh_percentage)
+    print("  battery_remain:", vehicle.ev_battery_remain)
+    print("  battery_capacity:", vehicle.ev_battery_capacity)
+    print("  battery_is_charging:", vehicle.ev_battery_is_charging)
+    print("  battery_is_plugged_in:", vehicle.ev_battery_is_plugged_in)
+    print("  driving_range:", vehicle.ev_driving_range, vehicle._ev_driving_range_unit)
+    print(
+        "  estimated_current_charge_duration:",
+        vehicle.ev_estimated_current_charge_duration,
+        vehicle._ev_estimated_current_charge_duration_unit,
+    )
+    print(
+        "  estimated_fast_charge_duration:",
+        vehicle.ev_estimated_fast_charge_duration,
+        vehicle._ev_estimated_fast_charge_duration_unit,
+    )
+    print(
+        "  estimated_portable_charge_duration:",
+        vehicle.ev_estimated_portable_charge_duration,
+        vehicle._ev_estimated_portable_charge_duration_unit,
+    )
+    print(
+        "  estimated_station_charge_duration:",
+        vehicle.ev_estimated_station_charge_duration,
+        vehicle._ev_estimated_station_charge_duration_unit,
+    )
+    print(
+        "  target_range_charge_AC:",
+        vehicle.ev_target_range_charge_AC,
+        vehicle._ev_target_range_charge_AC_unit,
+    )
+    print(
+        "  target_range_charge_DC:",
+        vehicle.ev_target_range_charge_DC,
+        vehicle._ev_target_range_charge_DC_unit,
+    )
+
+    print("  first_departure_enabled:", vehicle.ev_first_departure_enabled)
+    print(
+        "  first_departure_climate_temperature:",
+        vehicle.ev_first_departure_climate_temperature,
+        vehicle._ev_first_departure_climate_temperature_unit,
+    )
+    print("  first_departure_days:", vehicle.ev_first_departure_days)
+    print("  first_departure_time:", vehicle.ev_first_departure_time)
+    print(
+        "  first_departure_climate_enabled:", vehicle.ev_first_departure_climate_enabled
+    )
+    print(
+        "  first_departure_climate_defrost:", vehicle.ev_first_departure_climate_defrost
+    )
+    print("  second_departure_enabled:", vehicle.ev_second_departure_enabled)
+    print(
+        "  second_departure_climate_temperature:",
+        vehicle.ev_second_departure_climate_temperature,
+        vehicle._ev_second_departure_climate_temperature_unit,
+    )
+    print("  second_departure_days:", vehicle.ev_second_departure_days)
+    print("  second_departure_time:", vehicle.ev_second_departure_time)
+    print(
+        "  second_departure_climate_enabled:",
+        vehicle.ev_second_departure_climate_enabled,
+    )
+    print(
+        "  second_departure_climate_defrost:",
+        vehicle.ev_second_departure_climate_defrost,
+    )
+    print("  off_peak_start_time:", vehicle.ev_off_peak_start_time)
+    print("  off_peak_end_time:", vehicle.ev_off_peak_end_time)
+    print("  off_peak_charge_only_enabled:", vehicle.ev_off_peak_charge_only_enabled)
+    print("  schedule_charge_enabled:", vehicle.ev_schedule_charge_enabled)
+    print("PHEV/HEV/IC")
+    print(
+        "  fuel_driving_range:",
+        vehicle.fuel_driving_range,
+        vehicle._fuel_driving_range_unit,
+    )
+    print("  fuel_level:", vehicle.fuel_level)
+    print("  fuel_level_is_low:", vehicle.fuel_level_is_low)
+    print("Trips")
+    print("  daily_stats:", vehicle.daily_stats)
+    print("  month_trip_info:", vehicle.month_trip_info)
+    print("  day_trip_info:", vehicle.day_trip_info)
+    print("Debug")
+    print(textwrap.indent(json.dumps(vehicle.data, indent=2, sort_keys=True), " "))
+
+
+def vehicle_to_dict(vehicle):
+    return {
+        "identification": {
+            "id": vehicle.id,
+            "name": vehicle.name,
+            "model": vehicle.model,
+            "registration_date": vehicle.registration_date,
+            "year": vehicle.year,
+            "VIN": vehicle.VIN,
+            "key": vehicle.key,
+        },
+        "general": {
+            "engine_type": str(vehicle.engine_type),
+            "ccu_ccs2_protocol_support": vehicle.ccu_ccs2_protocol_support,
+            "total_driving_range": [
+                vehicle.total_driving_range,
+                vehicle.total_driving_range_unit,
+            ],
+            "odometer": [vehicle.odometer, vehicle.odometer_unit],
+            "geocode": vehicle.geocode,
+            "car_battery_percentage": vehicle.car_battery_percentage,
+            "engine_is_running": vehicle.engine_is_running,
+            "last_updated_at": vehicle.last_updated_at,
+            "timezone": vehicle.timezone,
+            "dtc_count": vehicle.dtc_count,
+            "dtc_descriptions": vehicle.dtc_descriptions,
+            "smart_key_battery_warning_is_on": vehicle.smart_key_battery_warning_is_on,
+            "washer_fluid_warning_is_on": vehicle.washer_fluid_warning_is_on,
+            "brake_fluid_warning_is_on": vehicle.brake_fluid_warning_is_on,
+        },
+        "climate": {
+            "air_temperature": [
+                vehicle.air_temperature,
+                vehicle._air_temperature_unit,
+            ],
+            "air_control_is_on": vehicle.air_control_is_on,
+            "defrost_is_on": vehicle.defrost_is_on,
+            "steering_wheel_heater_is_on": vehicle.steering_wheel_heater_is_on,
+            "back_window_heater_is_on": vehicle.back_window_heater_is_on,
+            "side_mirror_heater_is_on": vehicle.side_mirror_heater_is_on,
+            "front_left_seat_status": vehicle.front_left_seat_status,
+            "front_right_seat_status": vehicle.front_right_seat_status,
+            "rear_left_seat_status": vehicle.rear_left_seat_status,
+            "rear_right_seat_status": vehicle.rear_right_seat_status,
+        },
+        "doors": {
+            "is_locked": vehicle.is_locked,
+            "front_left_door_is_open": vehicle.front_left_door_is_open,
+            "front_right_door_is_open": vehicle.front_right_door_is_open,
+            "back_left_door_is_open": vehicle.back_left_door_is_open,
+            "back_right_door_is_open": vehicle.back_right_door_is_open,
+            "trunk_is_open": vehicle.trunk_is_open,
+            "hood_is_open": vehicle.hood_is_open,
+        },
+        "windows": {
+            "front_left_window_is_open": vehicle.front_left_window_is_open,
+            "front_right_window_is_open": vehicle.front_right_window_is_open,
+            "back_left_window_is_open": vehicle.back_left_window_is_open,
+            "back_right_window_is_open": vehicle.back_right_window_is_open,
+        },
+        "tires": {
+            "tire_pressure_all_warning_is_on": vehicle.tire_pressure_all_warning_is_on,
+            "tire_pressure_rear_left_warning_is_on": vehicle.tire_pressure_rear_left_warning_is_on,
+            "tire_pressure_front_left_warning_is_on": vehicle.tire_pressure_front_left_warning_is_on,
+            "tire_pressure_front_right_warning_is_on": vehicle.tire_pressure_front_right_warning_is_on,
+            "tire_pressure_rear_right_warning_is_on": vehicle.tire_pressure_rear_right_warning_is_on,
+        },
+        "service": {
+            "next_service_distance": [
+                vehicle.next_service_distance,
+                vehicle._next_service_distance_unit,
+            ],
+            "last_service_distance": [
+                vehicle.last_service_distance,
+                vehicle._last_service_distance_unit,
+            ],
+        },
+        "location": {
+            "location": vehicle.location,
+            "location_last_updated_at": vehicle.location_last_updated_at,
+        },
+        "electric": {
+            "charge_port_door_is_open": vehicle.ev_charge_port_door_is_open,
+            "charging_power": vehicle.ev_charging_power,
+            "charge_limits_dc": vehicle.ev_charge_limits_dc,
+            "charge_limits_ac": vehicle.ev_charge_limits_ac,
+            "charging_current": vehicle.ev_charging_current,
+            "v2l_discharge_limit": vehicle.ev_v2l_discharge_limit,
+            "total_power_consumed": [vehicle.total_power_consumed, "Wh"],
+            "total_power_regenerated": [vehicle.total_power_regenerated, "Wh"],
+            "power_consumption_30d": [vehicle.power_consumption_30d, "Wh"],
+            "battery_percentage": vehicle.ev_battery_percentage,
+            "battery_soh_percentage": vehicle.ev_battery_soh_percentage,
+            "battery_remain": vehicle.ev_battery_remain,
+            "battery_capacity": vehicle.ev_battery_capacity,
+            "battery_is_charging": vehicle.ev_battery_is_charging,
+            "battery_is_plugged_in": vehicle.ev_battery_is_plugged_in,
+            "driving_range": [
+                vehicle.ev_driving_range,
+                vehicle._ev_driving_range_unit,
+            ],
+            "estimated_current_charge_duration": [
+                vehicle.ev_estimated_current_charge_duration,
+                vehicle._ev_estimated_current_charge_duration_unit,
+            ],
+            "estimated_fast_charge_duration": [
+                vehicle.ev_estimated_fast_charge_duration,
+                vehicle._ev_estimated_fast_charge_duration_unit,
+            ],
+            "estimated_portable_charge_duration": [
+                vehicle.ev_estimated_portable_charge_duration,
+                vehicle._ev_estimated_portable_charge_duration_unit,
+            ],
+            "estimated_station_charge_duration": [
+                vehicle.ev_estimated_station_charge_duration,
+                vehicle._ev_estimated_station_charge_duration_unit,
+            ],
+            "target_range_charge_AC": [
+                vehicle.ev_target_range_charge_AC,
+                vehicle._ev_target_range_charge_AC_unit,
+            ],
+            "target_range_charge_DC": [
+                vehicle.ev_target_range_charge_DC,
+                vehicle._ev_target_range_charge_DC_unit,
+            ],
+            "first_departure_enabled": vehicle.ev_first_departure_enabled,
+            "first_departure_climate_temperature": [
+                vehicle.ev_first_departure_climate_temperature,
+                vehicle._ev_first_departure_climate_temperature_unit,
+            ],
+            "first_departure_days": vehicle.ev_first_departure_days,
+            "first_departure_time": vehicle.ev_first_departure_time,
+            "first_departure_climate_enabled": vehicle.ev_first_departure_climate_enabled,
+            "first_departure_climate_defrost": vehicle.ev_first_departure_climate_defrost,
+            "second_departure_enabled": vehicle.ev_second_departure_enabled,
+            "second_departure_climate_temperature": [
+                vehicle.ev_second_departure_climate_temperature,
+                vehicle._ev_second_departure_climate_temperature_unit,
+            ],
+            "second_departure_days": vehicle.ev_second_departure_days,
+            "second_departure_time": vehicle.ev_second_departure_time,
+            "second_departure_climate_enabled": vehicle.ev_second_departure_climate_enabled,
+            "second_departure_climate_defrost": vehicle.ev_second_departure_climate_defrost,
+            "off_peak_start_time": vehicle.ev_off_peak_start_time,
+            "off_peak_end_time": vehicle.ev_off_peak_end_time,
+            "off_peak_charge_only_enabled": vehicle.ev_off_peak_charge_only_enabled,
+            "schedule_charge_enabled": vehicle.ev_schedule_charge_enabled,
+        },
+        "ic": {
+            "fuel_driving_range": [
+                vehicle.fuel_driving_range,
+                vehicle._fuel_driving_range_unit,
+            ],
+            "fuel_level": vehicle.fuel_level,
+            "fuel_level_is_low": vehicle.fuel_level_is_low,
+        },
+        "trips": {
+            "daily_stats": vehicle.daily_stats,
+            "month_trip_info": vehicle.month_trip_info,
+            "day_trip_info": vehicle.day_trip_info,
+        },
+        "debug": vehicle.data,
+    }
+
+
+class DateTimeEncoder(json.JSONEncoder):
+    def default(self, obj):
+        if isinstance(obj, (datetime.date, datetime.datetime)):
+            return obj.isoformat()
+
+
+def cmd_info(vm, args):
+    for vehicle_id, vehicle in vm.vehicles.items():
+        print_vehicle(vehicle)
+    if args.json:
+        data = {id: vehicle_to_dict(v) for id, v in vm.vehicles.items()}
+        json.dump(data, args.json, separators=(",", ":"), cls=DateTimeEncoder)
+    return 0
+
+
+def main():
+    default_username = os.environ.get("BLUELINK_USERNAME", "")
+    default_password = os.environ.get("BLUELINK_PASSWORD", "")
+    default_pin = None
+    if os.environ.get("BLUELINK_PIN", ""):
+        try:
+            default_pin = int(os.environ["BLUELINK_PIN"])
+        except ValueError:
+            print("Invalid BLUELINK_PIN environment variable", file=sys.stderr)
+            return 1
+
+    parser = argparse.ArgumentParser(description=sys.modules[__name__].__doc__)
+    parser.add_argument(
+        "--region",
+        default=os.environ.get("BLUELINK_REGION", const.REGION_CANADA),
+        choices=sorted(const.REGIONS.values()),
+        help="Car's region, use env var BLUELINK_REGION",
+    )
+    parser.add_argument(
+        "--brand",
+        default=os.environ.get("BLUELINK_BRAND", const.BRAND_HYUNDAI),
+        choices=sorted(const.BRANDS.values()),
+        help="Car's brand, use env var BLUELINK_BRAND",
+    )
+    parser.add_argument(
+        "--username",
+        default=default_username,
+        help="Bluelink account username, use env var BLUELINK_USERNAME",
+        required=not default_username,
+    )
+    parser.add_argument(
+        "--password",
+        default=default_password,
+        help="Bluelink account password, use env var BLUELINK_PASSWORD",
+        required=not default_password,
+    )
+    parser.add_argument(
+        "--pin",
+        type=int,
+        default=default_pin,
+        help="Bluelink account pin, use env var BLUELINK_PIN",
+        required=not default_pin,
+    )
+    parser.add_argument("-v", "--verbose", action=argparse.BooleanOptionalAction)
+    subparsers = parser.add_subparsers(help="Commands", required=True)
+    parser_info = subparsers.add_parser(
+        "info", help="Prints infos about the cars found"
+    )
+    parser_info.set_defaults(func=cmd_info)
+    parser_info.add_argument(
+        "--json",
+        type=argparse.FileType("w", encoding="UTF-8"),
+        help="Save data to file as JSON",
+    )
+
+    args = parser.parse_args()
+    logging.basicConfig(level=logging.DEBUG if args.verbose else logging.ERROR)
+
+    # Reverse lookup.
+    region = [k for k, v in const.REGIONS.items() if v == args.region][0]
+    brand = [k for k, v in const.BRANDS.items() if v == args.brand][0]
+
+    vm = hyundai_kia_connect_api.VehicleManager(
+        region=region,
+        brand=brand,
+        username=args.username,
+        password=args.password,
+        pin=args.pin,
+        geocode_api_enable=True,
+        geocode_api_use_email=True,
+    )
+    # TODO: Cache token.
+    vm.check_and_refresh_token()
+    vm.update_all_vehicles_with_cached_state()
+    return args.func(vm, args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{hyundai_kia_connect_api-3.27.0.dist-info → hyundai_kia_connect_api-3.29.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hyundai_kia_connect_api
-Version: 3.27.0
+Version: 3.29.1
 Summary: Python Boilerplate contains all the boilerplate you need to create a Python package.
 Home-page: https://github.com/Hyundai-Kia-Connect/hyundai_kia_connect_api
 Author: Fuat Akgun
@@ -29,10 +29,16 @@ I no longer have a Kia or Hyundai so don't maintain this like I used to.  Others
 Introduction
 ============
 
-This is a Kia UVO, Hyundai Bluelink, Genesis Connect(Canada Only) written in python.  It is primary consumed by home assistant.  If you are looking for a home assistant Kia / Hyundai implementation please look here: https://github.com/Hyundai-Kia-Connect/kia_uvo.  Much of this base code came from reading bluelinky (https://github.com/Hacksore/bluelinky) and contributions to the kia_uvo home assistant project.
+This is a Kia UVO, Hyundai Bluelink, Genesis Connect(Canada Only) written in python.  It is primary consumed by home assistant.  If you are looking for a home assistant Kia / Hyundai implementation please look here: https://github.com/Hyundai-Kia-Connect/kia_uvo.  Much of this base code came from reading `bluelinky <https://github.com/Hacksore/bluelinky>`_ and contributions to the kia_uvo home assistant project.
 
-Usage
-=====
+Chat on discord:: |Discord|
+
+.. |Discord| image:: https://img.shields.io/discord/652755205041029120
+   :target: https://discord.gg/HwnG8sY
+   :alt: Discord
+
+API Usage
+=========
 
 This package is designed to simplify the complexity of using multiple regions.  It attempts to standardize the usage regardless of what brand or region the car is in.  That isn't always possible though, in particular some features differ from one to the next.
 
@@ -44,7 +50,7 @@ Python 3.10 or newer is required to use this package. Vehicle manager is the key
     password: str
     pin: str (required for CA, and potentially USA, otherwise pass a blank string)
 
-Key values for the int exist in the constant(https://github.com/Hyundai-Kia-Connect/hyundai_kia_connect_api/blob/master/hyundai_kia_connect_api/const.py) file as::
+Key values for the int exist in the `const.py <https://github.com/Hyundai-Kia-Connect/hyundai_kia_connect_api/blob/master/hyundai_kia_connect_api/const.py>`_ file as::
 
     REGIONS = {1: REGION_EUROPE, 2: REGION_CANADA, 3: REGION_USA, 4: REGION_CHINA, 5: REGION_AUSTRALIA}
     BRANDS = {1: BRAND_KIA, 2: BRAND_HYUNDAI, 3: BRAND_GENESIS}
@@ -129,3 +135,17 @@ Example of getting trip info of the current month and day (vm is VehicleManager
                 if vehicle.day_trip_info is not None:
                     for trip in reversed(vehicle.day_trip_info.trip_list):  # show oldest first
                         print(f"{day.yyyymmdd},{trip.hhmmss},{trip.drive_time},{trip.idle_time},{trip.distance},{trip.avg_speed},{trip.max_speed}")
+
+
+CLI Usage
+=========
+
+A tool `bluelink` is provided that enable querying the vehicles and save the
+state to a JSON file. Example usage:
+
+::
+
+    bluelink --region Canada --brand Hyundai --username FOO --password BAR --pin 1234 info --json infos.json
+
+Environment variables BLUELINK_XXX can be used to provide a default value for
+the corresponding --xxx argument.

hyundai_kia_connect_api-3.29.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+hyundai_kia_connect_api/ApiImpl.py,sha256=9DoAtk8-pE0WaLzRTM7uydkUoxS_Almcooeonp7vTQE,7538
+hyundai_kia_connect_api/ApiImplType1.py,sha256=PnKwpbCoYGOXBWzBLIlDSrC6daIYeW9qlfW7TM4HCU0,12184
+hyundai_kia_connect_api/HyundaiBlueLinkApiUSA.py,sha256=Tx-L4ZWiPhq-uHcjWSUzjLEsfunV6nzyzqQpjPTYuIo,36831
+hyundai_kia_connect_api/KiaUvoApiAU.py,sha256=tslh0gzvPBwYJmcWlf9B0l7PyYZdy2e7GqpRkl8_Svk,48471
+hyundai_kia_connect_api/KiaUvoApiCA.py,sha256=B3Lks_ONr3l01QLl-GQBPdktXj9PZWKuQKRLYmJ7kP4,30763
+hyundai_kia_connect_api/KiaUvoApiCN.py,sha256=cwIPZ0dU6HolKdooUQeQKlLAic6YU8dQmNs0VQDBgpQ,47035
+hyundai_kia_connect_api/KiaUvoApiEU.py,sha256=wNHMuyANzunMzp6DtjJmA1k4DbkXcHvebA-bS107ueA,70416
+hyundai_kia_connect_api/KiaUvoApiUSA.py,sha256=J7bDKgPqXnwMcG8aaw8gfwKs8XO-D0mTxC41vOpDlgw,31338
+hyundai_kia_connect_api/Token.py,sha256=ZsPvXh1ID7FUTGHAqhZUZyrKT7xVbOtIn6FRJn4Ygf0,370
+hyundai_kia_connect_api/Vehicle.py,sha256=raCMzJsLuJnVHlFJ16VKdKat55L0uivbbcZRDCGWTxI,18793
+hyundai_kia_connect_api/VehicleManager.py,sha256=X_m8H9Jsg-P1x0QmD5wZOVLMppZ4I__ZMi7rOLSTRuE,10940
+hyundai_kia_connect_api/__init__.py,sha256=IkyVeIMbcFJZgLaiiNnUVA1Ferxvrm1bXHKVg01cxvc,319
+hyundai_kia_connect_api/bluelink.py,sha256=sBU7hlElie21GU4Ma-i4a5vdztGc2jtmlVBbbgUqmTE,19720
+hyundai_kia_connect_api/const.py,sha256=HE0_1_be4ERB73vsekWxv6TDWd8cvAgY1oPZojUrcwM,2096
+hyundai_kia_connect_api/exceptions.py,sha256=m7gyDnvA5OVAK4EXSP_ZwE0s0uV8HsGUV0tiYwqofK0,1343
+hyundai_kia_connect_api/utils.py,sha256=J0aXUX-nKIoS3XbelatNh-DZlHRU2_DYz_Mg_ZUKQJU,1957
+hyundai_kia_connect_api-3.29.1.dist-info/AUTHORS.rst,sha256=T77OE1hrQF6YyDE6NbdMKyL66inHt7dnjHAzblwuk2A,155
+hyundai_kia_connect_api-3.29.1.dist-info/LICENSE,sha256=49hmc755oyMwKdZ-2epiorjStRB0PfcZR1w5_NXZPgs,1068
+hyundai_kia_connect_api-3.29.1.dist-info/METADATA,sha256=5ivYJSNh7jK42y37I5LzQSDdjL4Zhx2HG-Qc1DKXxDE,6678
+hyundai_kia_connect_api-3.29.1.dist-info/WHEEL,sha256=0VNUDWQJzfRahYI3neAhz2UVbRCtztpN5dPHAGvmGXc,109
+hyundai_kia_connect_api-3.29.1.dist-info/entry_points.txt,sha256=XfrroRdyC_9q9VXjEZe5SdRPhkQyCCE4S7ZK6XSKelA,67
+hyundai_kia_connect_api-3.29.1.dist-info/top_level.txt,sha256=otZ7J_fN-s3EW4jD-kAearIo2OIzhQLR8DNEHIaFfds,24
+hyundai_kia_connect_api-3.29.1.dist-info/RECORD,,

{hyundai_kia_connect_api-3.27.0.dist-info → hyundai_kia_connect_api-3.29.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.3.0)
+Generator: setuptools (75.5.0)
 Root-Is-Purelib: true
 Tag: py2-none-any
 Tag: py3-none-any

hyundai_kia_connect_api-3.29.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bluelink = hyundai_kia_connect_api.bluelink:main

hyundai_kia_connect_api-3.27.0.dist-info/RECORD

@@ -1,21 +0,0 @@
-hyundai_kia_connect_api/ApiImpl.py,sha256=9DoAtk8-pE0WaLzRTM7uydkUoxS_Almcooeonp7vTQE,7538
-hyundai_kia_connect_api/ApiImplType1.py,sha256=PnKwpbCoYGOXBWzBLIlDSrC6daIYeW9qlfW7TM4HCU0,12184
-hyundai_kia_connect_api/HyundaiBlueLinkAPIUSA.py,sha256=FqsU3R938nK-jVDkajs_niutXW_eoGNCLdsLhdNbx8c,36820
-hyundai_kia_connect_api/KiaUvoAPIUSA.py,sha256=LbEh7EM19kpvhwPSMpEYIHVNUSOJsuvNjcXJzyc_P8A,31338
-hyundai_kia_connect_api/KiaUvoApiAU.py,sha256=tslh0gzvPBwYJmcWlf9B0l7PyYZdy2e7GqpRkl8_Svk,48471
-hyundai_kia_connect_api/KiaUvoApiCA.py,sha256=B3Lks_ONr3l01QLl-GQBPdktXj9PZWKuQKRLYmJ7kP4,30763
-hyundai_kia_connect_api/KiaUvoApiCN.py,sha256=cwIPZ0dU6HolKdooUQeQKlLAic6YU8dQmNs0VQDBgpQ,47035
-hyundai_kia_connect_api/KiaUvoApiEU.py,sha256=9KFtTYfBi7fyWABhFCVcKhqV6pWD7p-Wg9lvdfJso4E,70273
-hyundai_kia_connect_api/Token.py,sha256=ZsPvXh1ID7FUTGHAqhZUZyrKT7xVbOtIn6FRJn4Ygf0,370
-hyundai_kia_connect_api/Vehicle.py,sha256=rJOob5q79hxAXx3IByPYkS0gS86NR5oQG8P4oW6LWQI,18666
-hyundai_kia_connect_api/VehicleManager.py,sha256=BfDdfLVSw04FvCv_sQweqOg_kPO6xD884XwAuPGKmTY,10940
-hyundai_kia_connect_api/__init__.py,sha256=IkyVeIMbcFJZgLaiiNnUVA1Ferxvrm1bXHKVg01cxvc,319
-hyundai_kia_connect_api/const.py,sha256=HE0_1_be4ERB73vsekWxv6TDWd8cvAgY1oPZojUrcwM,2096
-hyundai_kia_connect_api/exceptions.py,sha256=m7gyDnvA5OVAK4EXSP_ZwE0s0uV8HsGUV0tiYwqofK0,1343
-hyundai_kia_connect_api/utils.py,sha256=J0aXUX-nKIoS3XbelatNh-DZlHRU2_DYz_Mg_ZUKQJU,1957
-hyundai_kia_connect_api-3.27.0.dist-info/AUTHORS.rst,sha256=T77OE1hrQF6YyDE6NbdMKyL66inHt7dnjHAzblwuk2A,155
-hyundai_kia_connect_api-3.27.0.dist-info/LICENSE,sha256=49hmc755oyMwKdZ-2epiorjStRB0PfcZR1w5_NXZPgs,1068
-hyundai_kia_connect_api-3.27.0.dist-info/METADATA,sha256=b8GAEqB4qSC-K3WLRl5FtWbN4Tyze_p3CtUKWXJgY-Q,6142
-hyundai_kia_connect_api-3.27.0.dist-info/WHEEL,sha256=OpXWERl2xLPRHTvd2ZXo_iluPEQd8uSbYkJ53NAER_Y,109
-hyundai_kia_connect_api-3.27.0.dist-info/top_level.txt,sha256=otZ7J_fN-s3EW4jD-kAearIo2OIzhQLR8DNEHIaFfds,24
-hyundai_kia_connect_api-3.27.0.dist-info/RECORD,,