hyundai-kia-connect-api 3.17.6__py2.py3-none-any.whl → 3.32.0__py2.py3-none-any.whl

hyundai_kia_connect_api/utils.py

@@ -1,16 +1,19 @@
-# pylint:disable=bare-except,missing-function-docstring,invalid-name
+# pylint:disable=bare-except,missing-function-docstring,invalid-name,broad-exception-caught
 """utils.py"""
 
+import datetime
+import re
+
 
 def get_child_value(data, key):
     value = data
     for x in key.split("."):
         try:
             value = value[x]
-        except:
+        except Exception:
             try:
                 value = value[int(x)]
-            except:
+            except Exception:
                 value = None
     return value
 
@@ -47,3 +50,27 @@ def get_index_into_hex_temp(value):
         return value
     else:
         return None
+
+
+def parse_datetime(value, timezone) -> datetime.datetime:
+    if value is None:
+        return datetime.datetime(2000, 1, 1, tzinfo=timezone)
+
+    value = value.replace("-", "").replace("T", "").replace(":", "").replace("Z", "")
+    m = re.match(r"(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})", value)
+    return datetime.datetime(
+        year=int(m.group(1)),
+        month=int(m.group(2)),
+        day=int(m.group(3)),
+        hour=int(m.group(4)),
+        minute=int(m.group(5)),
+        second=int(m.group(6)),
+        tzinfo=timezone,
+    )
+
+
+def get_safe_local_datetime(date: datetime) -> datetime:
+    """get safe local datetime"""
+    if date is not None and hasattr(date, "tzinfo") and date.tzinfo is not None:
+        date = date.astimezone()
+    return date

{hyundai_kia_connect_api-3.17.6.dist-info → hyundai_kia_connect_api-3.32.0.dist-info}/LICENSE

@@ -19,4 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-

{hyundai_kia_connect_api-3.17.6.dist-info → hyundai_kia_connect_api-3.32.0.dist-info}/METADATA

@@ -1,8 +1,8 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: hyundai_kia_connect_api
-Version: 3.17.6
+Version: 3.32.0
 Summary: Python Boilerplate contains all the boilerplate you need to create a Python package.
-Home-page: https://github.com/fuatakgun/hyundai_kia_connect_api
+Home-page: https://github.com/Hyundai-Kia-Connect/hyundai_kia_connect_api
 Author: Fuat Akgun
 Author-email: fuatakgun@gmail.com
 License: MIT license
@@ -11,27 +11,48 @@ Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.9
-Requires-Python: >=3.6
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
 License-File: LICENSE
 License-File: AUTHORS.rst
-Requires-Dist: beautifulsoup4 >=4.10.0
-Requires-Dist: curlify >=2.2.1
+Requires-Dist: beautifulsoup4>=4.10.0
+Requires-Dist: curlify>=2.2.1
 Requires-Dist: python-dateutil
-Requires-Dist: pytz >=2021.3
+Requires-Dist: pytz>=2021.3
+Requires-Dist: certifi>=2024.6.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+Code Maintainers Wanted
+=======================
+
+I no longer have a Kia or Hyundai so don't maintain this like I used to.  Others who are interested in jumping in are welcome to join the project!   Even just pull requests are appreciated!
 
 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/fuatakgun/kia_uvo.  Much of this base code came from reading 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.
 
+Chat on discord:: |Discord|
 
-Usage
-=====
+.. |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.
 
-Python 3.9 or newer is required to use this package. Vehicle manager is the key class that is called to manage the vehicle lists.  One vehicle manager should be used per login. Key data points required to instantiate vehicle manager are::
+Python 3.10 or newer is required to use this package. Vehicle manager is the key class that is called to manage the vehicle lists.  One vehicle manager should be used per login. Key data points required to instantiate vehicle manager are::
 
     region: int
     brand: int,
@@ -39,7 +60,7 @@ Python 3.9 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/fuatakgun/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}
@@ -67,7 +88,6 @@ Once this is done you can now make the following calls against the vehicle manag
  Force refreshes a single car:
  force_refresh_vehicles_states(self, vehicle_id)
 
-
 An example call would be::
 
     from hyundai_kia_connect_api import *
@@ -107,16 +127,17 @@ For a list of language codes, see here: https://www.science.co.il/language/Codes
 - "fi" Finnish
 - "pt" Portuguese
 
-In Europe also trip info can be retrieved. For a month you can ask the days with trips. And you can ask for a specific day for all the trips of that specific day.::
-- First call vm.update_month_trip_info(vehicle.id, yyymm) before getting vehicle.month_trip_info for that month
+
+In Europe and some other regions also trip info can be retrieved. For a month you can ask the days with trips. And you can ask for a specific day for all the trips of that specific day.::
+- First call vm.update_month_trip_info(vehicle.id, yyyymm) before getting vehicle.month_trip_info for that month
 - First call vm.update_day_trip_info(vehicle.id, day.yyyymmdd) before getting vehicle.day_trip_info for that day
 
 Example of getting trip info of the current month and day (vm is VehicleManager instance)::
 
     now = datetime.now()
-    yyymm = now.strftime("%Y%m")
+    yyyymm = now.strftime("%Y%m")
     yyyymmdd = now.strftime("%Y%m%d")
-    vm.update_month_trip_info(vehicle.id, yyymm)
+    vm.update_month_trip_info(vehicle.id, yyyymm)
     if vehicle.month_trip_info is not None:
         for day in vehicle.month_trip_info.day_list:  # ordered on day
             if yyyymmdd == day.yyyymmdd:  # in example only interested in current day
@@ -124,3 +145,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.32.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+hyundai_kia_connect_api/ApiImpl.py,sha256=eCEQEz6L-7EN2eKnrYiHrYC0pPV-ngGFcayF0tFdPxA,7569
+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=QXs7Gk3uvv1719B8E-Gqe1H0hBh_jQflBJtPZZxvz2g,31460
+hyundai_kia_connect_api/KiaUvoApiCN.py,sha256=cwIPZ0dU6HolKdooUQeQKlLAic6YU8dQmNs0VQDBgpQ,47035
+hyundai_kia_connect_api/KiaUvoApiEU.py,sha256=FiRPb_anGRDiNP41U0pFWLZ9uoLDCMAzmKWqEO_zXZU,71414
+hyundai_kia_connect_api/KiaUvoApiUSA.py,sha256=G2sGtv88sBZuAz8qKYq_3_JNXIkxEjOBAzwM6R8GUi0,30548
+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=I0HDOsbXDen-26vyD7YR-RUgdaofOZrv_H_PPPuWjHg,11087
+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.32.0.dist-info/AUTHORS.rst,sha256=T77OE1hrQF6YyDE6NbdMKyL66inHt7dnjHAzblwuk2A,155
+hyundai_kia_connect_api-3.32.0.dist-info/LICENSE,sha256=49hmc755oyMwKdZ-2epiorjStRB0PfcZR1w5_NXZPgs,1068
+hyundai_kia_connect_api-3.32.0.dist-info/METADATA,sha256=f624MFz_orTUhgUm4jS7JLn-lL1Udvylkb68LszHt3A,6872
+hyundai_kia_connect_api-3.32.0.dist-info/WHEEL,sha256=9Hm2OB-j1QcCUq9Jguht7ayGIIZBRTdOXD1qg9cCgPM,109
+hyundai_kia_connect_api-3.32.0.dist-info/entry_points.txt,sha256=XfrroRdyC_9q9VXjEZe5SdRPhkQyCCE4S7ZK6XSKelA,67
+hyundai_kia_connect_api-3.32.0.dist-info/top_level.txt,sha256=otZ7J_fN-s3EW4jD-kAearIo2OIzhQLR8DNEHIaFfds,24
+hyundai_kia_connect_api-3.32.0.dist-info/RECORD,,

{hyundai_kia_connect_api-3.17.6.dist-info → hyundai_kia_connect_api-3.32.0.dist-info}/WHEEL

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

hyundai_kia_connect_api-3.32.0.dist-info/entry_points.txt

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

hyundai_kia_connect_api-3.17.6.dist-info/RECORD

@@ -1,20 +0,0 @@
-hyundai_kia_connect_api/ApiImpl.py,sha256=1j5FRTQIILrSzQU6oE5i4J_l8cVvYuMGBmQn-kL7zyg,5018
-hyundai_kia_connect_api/HyundaiBlueLinkAPIUSA.py,sha256=FVWDzmkO_jsc_r4WzufgxaJkeVYhf9UAw9A6r37b-Dc,26750
-hyundai_kia_connect_api/KiaUvoAPIUSA.py,sha256=kQo3PA_FktsAHhdugZi0lrpMcp96WNXcvBJPbIJIcfY,31217
-hyundai_kia_connect_api/KiaUvoApiAU.py,sha256=ncAUEWqepHwYTZqu7JDNAozguucqqIg-HKPvpN_54CE,48738
-hyundai_kia_connect_api/KiaUvoApiCA.py,sha256=7bcDLcJ3JLLoWldPy514eKhWUAo1Gb1mu_3SaXno4v8,30358
-hyundai_kia_connect_api/KiaUvoApiCN.py,sha256=MjXdDdm1wDVvFZhgg8AjAF6X2SB-AIFMTE5iRmr80QM,47384
-hyundai_kia_connect_api/KiaUvoApiEU.py,sha256=jKIJ6B9BBfz6UyzlTH-RuWjuAr1ljrhOGsLwYGRXjlE,68960
-hyundai_kia_connect_api/Token.py,sha256=ZsPvXh1ID7FUTGHAqhZUZyrKT7xVbOtIn6FRJn4Ygf0,370
-hyundai_kia_connect_api/Vehicle.py,sha256=jx8m3z9QRg9BvLLMT8wL0yD6jCnsA_w1nYE19Pm0bUo,13644
-hyundai_kia_connect_api/VehicleManager.py,sha256=JdJ8tUCVGciVC1SJubmMQqEZ7KXp6DlI_UiOQPkDeN4,9654
-hyundai_kia_connect_api/__init__.py,sha256=6UwXW6Lj5VnRtWNOt_0dLFdOYlcbysHCc6ol_XAC5YM,479
-hyundai_kia_connect_api/const.py,sha256=C25jgV79u7SZF5xDy96gol_CekIkyI4h3goTyDEmng0,1967
-hyundai_kia_connect_api/exceptions.py,sha256=m7gyDnvA5OVAK4EXSP_ZwE0s0uV8HsGUV0tiYwqofK0,1343
-hyundai_kia_connect_api/utils.py,sha256=rfhERPXkzqelsaieLtiAyN9xDDTheNyKX5aBPRLrHf4,1117
-hyundai_kia_connect_api-3.17.6.dist-info/AUTHORS.rst,sha256=T77OE1hrQF6YyDE6NbdMKyL66inHt7dnjHAzblwuk2A,155
-hyundai_kia_connect_api-3.17.6.dist-info/LICENSE,sha256=AsZwIRViAze7ObwO6V6IB0q4caXv6DJS2-3dsU1FWy8,1069
-hyundai_kia_connect_api-3.17.6.dist-info/METADATA,sha256=ckastDAh9Lnhzjiy0Y9ypxkXay-UxVslXFlpEZ9JIMA,5770
-hyundai_kia_connect_api-3.17.6.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
-hyundai_kia_connect_api-3.17.6.dist-info/top_level.txt,sha256=otZ7J_fN-s3EW4jD-kAearIo2OIzhQLR8DNEHIaFfds,24
-hyundai_kia_connect_api-3.17.6.dist-info/RECORD,,