tesla-fleet-api 0.6.1__py3-none-any.whl → 0.7.0__py3-none-any.whl

tesla_fleet_api/__init__.py

@@ -1,5 +1,6 @@
 from .teslafleetapi import TeslaFleetApi
 from .teslafleetoauth import TeslaFleetOAuth
+from .teslafleetopensource import TeslaFleetOpenSource
 from .teslemetry import Teslemetry
 from .tessie import Tessie
 from .charging import Charging

tesla_fleet_api/const.py

@@ -3,7 +3,7 @@
 from enum import Enum
 import logging
 
-VERSION = "0.6.1"
+VERSION = "0.7.0"
 LOGGER = logging.getLogger(__package__)
 SERVERS = {
     "na": "https://fleet-api.prd.na.vn.cloud.tesla.com",

tesla_fleet_api/teslafleetapi.py

@@ -46,8 +46,6 @@ class TeslaFleetApi:
             if region not in SERVERS:
                 raise ValueError(f"Region must be one of {', '.join(SERVERS.keys())}")
             self.server = SERVERS.get(region)
-        else:
-            raise ValueError("Either server or region must be provided.")
 
         LOGGER.debug("Using server %s", self.server)
 
@@ -114,6 +112,8 @@ class TeslaFleetApi:
             params=params,
         ) as resp:
             LOGGER.debug("Response Status: %s", resp.status)
+            if "x-txid" in resp.headers:
+                LOGGER.debug("Response TXID: %s", resp.headers["x-txid"])
             if not resp.ok:
                 await raise_for_status(resp)
             if not resp.content_type.lower().startswith("application/json"):

tesla_fleet_api/teslafleetoauth.py

@@ -11,11 +11,16 @@ class TeslaFleetOAuth(TeslaFleetApi):
     """Tesla Fleet OAuth API."""
 
     expires: int
+    refresh_token: str
+    redirect_uri: str | None
+    _client_secret: str | None
 
     def __init__(
         self,
         session: aiohttp.ClientSession,
         client_id: str,
+        client_secret: str | None = None,
+        redirect_uri: str | None = None,
         access_token: str | None = None,
         refresh_token: str | None = None,
         expires: int = 0,
@@ -23,6 +28,8 @@ class TeslaFleetOAuth(TeslaFleetApi):
         server: str | None = None,
     ):
         self.client_id = client_id
+        self._client_secret = client_secret
+        self.redirect_uri = redirect_uri
         self.access_token = access_token
         self.refresh_token = refresh_token
         self.expires = expires
@@ -34,25 +41,34 @@ class TeslaFleetOAuth(TeslaFleetApi):
             server=server,
         )
 
-    def get_login_url(
-        self, redirect_uri: str, scopes: list[Scope], state: str = "login"
-    ) -> str:
+    def get_login_url(self, scopes: list[Scope], state: str = "login") -> str:
         """Get the login URL."""
-        return f"https://auth.tesla.com/oauth2/v3/authorize?response_type=code&client_id={self.client_id}&redirect_uri={redirect_uri}&scope={' '.join(scopes)}&state={state}"
+        if self.redirect_uri is None:
+            raise ValueError("Redirect URI is missing")
+        return f"https://auth.tesla.com/oauth2/v3/authorize?response_type=code&prompt=login&client_id={self.client_id}&redirect_uri={self.redirect_uri}&scope={' '.join(scopes)}&state={state}"
 
-    async def get_refresh_token(
-        self, client_secret: str, code: str, redirect_uri: str
-    ) -> None:
+    async def get_refresh_token(self, code: str) -> None:
         """Get the refresh token."""
+
+        if self._client_secret is None:
+            raise ValueError("Client secret is missing")
+
+        if self.redirect_uri is None:
+            raise ValueError("Redirect URI is missing")
+
+        if self.server is None:
+            self.region = code.split("_")[0].lower()
+            self.server = SERVERS.get(self.region)
+
         async with self.session.post(
             "https://auth.tesla.com/oauth2/v3/token",
             data={
                 "grant_type": "authorization_code",
                 "client_id": self.client_id,
-                "client_secret": client_secret,
+                "client_secret": self._client_secret,
                 "code": code,
                 "audience": self.server,
-                "redirect_uri": redirect_uri,
+                "redirect_uri": self.redirect_uri,
             },
         ) as resp:
             if resp.ok:

tesla_fleet_api/teslafleetopensource.py

@@ -0,0 +1,61 @@
+import aiohttp
+import time
+import secrets
+import hashlib
+import base64
+
+from .teslafleetoauth import TeslaFleetOAuth
+from .const import Scope, SERVERS
+
+
+class TeslaFleetOpenSource(TeslaFleetOAuth):
+    """Tesla Fleet Open Source OAuth API."""
+
+    code_verifier: str
+    code_challenge: str
+
+    def __init__(
+        self,
+        session: aiohttp.ClientSession,
+        client_id: str,
+        redirect_uri: str,
+    ):
+        self.code_verifier = secrets.token_urlsafe(32)
+
+        # Hash the code_verifier using SHA-256
+        hashed_verifier = hashlib.sha256(self.code_verifier.encode()).digest()
+        # Encode the hash using URL-safe Base64 encoding, without padding
+        self.code_challenge = (
+            base64.urlsafe_b64encode(hashed_verifier).decode().replace("=", "")
+        )
+
+        super().__init__(session, client_id, redirect_uri=redirect_uri)
+
+    def get_login_url(self, scopes: list[Scope], state: str = "login") -> str:
+        """Get the login URL without a client secret."""
+
+        return (
+            super().get_login_url(scopes, state)
+            + f"&code_challenge={self.code_challenge}"
+        )
+
+    async def get_refresh_token(self, code: str) -> None:
+        """Get the refresh token."""
+        async with self.session.post(
+            "https://auth.tesla.com/oauth2/v3/token",
+            data={
+                "grant_type": "authorization_code",
+                "client_id": self.client_id,
+                "code": code,
+                "audience": self.server,
+                "redirect_uri": self.redirect_uri,
+                "code_verifier": self.code_verifier,
+            },
+        ) as resp:
+            if resp.ok:
+                data = await resp.json()
+                self.refresh_token = data["refresh_token"]
+                self.access_token = data["access_token"]
+                self.expires = int(time.time()) + data["expires_in"]
+                region = code.split("_")[0].lower()
+                self.server = SERVERS.get(region)

tesla_fleet_api/teslemetry.py

@@ -2,7 +2,7 @@ import aiohttp
 from aiolimiter import AsyncLimiter
 from typing import Any
 from .teslafleetapi import TeslaFleetApi
-from .const import Method, LOGGER
+from .const import Method, LOGGER, Scope
 
 # Rate limit should be global, even if multiple instances are created
 rate_limit = AsyncLimiter(5, 10)
@@ -39,7 +39,7 @@ class Teslemetry(TeslaFleetApi):
         )
 
     async def metadata(self, update_region=True) -> dict[str, Any]:
-        """Test API Authentication."""
+        """Get user metadata including scopes."""
         resp = await self._request(
             Method.GET,
             "api/metadata",
@@ -49,6 +49,11 @@ class Teslemetry(TeslaFleetApi):
             self.server = f"https://{self.region}.teslemetry.com"
             LOGGER.debug("Using server %s", self.server)
         return resp
+    
+    async def scopes(self) -> list[str]:
+        """Get user scopes."""
+        resp = await self.metadata(False)
+        return resp["scopes"]
 
     async def find_server(self) -> str:
         """Find the server URL for the Tesla Fleet API."""

tesla_fleet_api/tessie.py

@@ -19,6 +19,14 @@ class Tessie(TeslaFleetApi):
             user_scope=False,
         )
 
+    async def scopes(self) -> list[str]:
+        """Get user scopes."""
+        resp = await self._request(
+            Method.GET,
+            "auth/tesla_scopes",
+        )
+        return resp["scopes"]
+
     async def find_server(self) -> str:
         """Find the server URL for the Tesla Fleet API."""
         raise NotImplementedError("Do not use this function for Tessie.")

tesla_fleet_api/vehicle.py

@@ -752,7 +752,7 @@ class Vehicle:
     async def fleet_status(self, vins: List[str]) -> dict[str, Any]:
         """Checks whether vehicles can accept Tesla commands protocol for the partner's public key"""
         return await self._request(
-            Method.GET, "api/1/vehicles/fleet_status", json={"vins": vins}
+            Method.POST, "api/1/vehicles/fleet_status", json={"vins": vins}
         )
 
     async def fleet_telemetry_config_create(

tesla_fleet_api/vehiclespecific.py

@@ -436,6 +436,14 @@ class VehicleSpecific:
         """Checks whether vehicles can accept Tesla commands protocol for the partner's public key"""
         return await self._parent.fleet_status([self.vin])
 
+    async def fleet_telemetry_config_create(
+        self, config: dict[str, Any]
+    ) -> dict[str, Any]:
+        """Configures fleet telemetry."""
+        return await self._parent.fleet_telemetry_config_create(
+            {"vins": [self.vin], "config": config}
+        )
+
     async def fleet_telemetry_config_get(self) -> dict[str, Any]:
         """Configures fleet telemetry."""
         return await self._parent.fleet_telemetry_config_get(self.vin)

{tesla_fleet_api-0.6.1.dist-info → tesla_fleet_api-0.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tesla_fleet_api
-Version: 0.6.1
+Version: 0.7.0
 Summary: Tesla Fleet API library for Python
 Home-page: https://github.com/Teslemetry/tesla_fleet_api
 Author: Brett Adams

tesla_fleet_api-0.7.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+tesla_fleet_api/__init__.py,sha256=-OhrvoMVLeo13dDCjsltCacLxPqe2UODvSgHFdjyteA,639
+tesla_fleet_api/charging.py,sha256=N_mc8axrXj3iduqLj_jCt4Vx86tHqe3xqQT4R1R7HvU,1689
+tesla_fleet_api/const.py,sha256=oHOrKlioHra7rwxN0vNjw-ogFxmwuluUduYbX2aEbM8,9277
+tesla_fleet_api/energy.py,sha256=yOKNPyXWKMT7Z9a5RqdNksHokLRo657SWjly1bP2_Qs,5827
+tesla_fleet_api/energyspecific.py,sha256=zggN-q0tf6EH_57bM4EuQ-IdcemKP0o-xv__LArRNnA,4147
+tesla_fleet_api/exceptions.py,sha256=BcvJyjY4qM2-Rf7ZMA94xPIN6ebKit89E7qattMmbr8,11018
+tesla_fleet_api/partner.py,sha256=1vIBUaxKLIfqcC0X6VXZN0dMAzj_CLNPUMjA6QVqZ1k,1223
+tesla_fleet_api/teslafleetapi.py,sha256=S-7TH47aTuCi1LV4fLCxtvcCxuA0vyGC04XYBKHYG_4,4853
+tesla_fleet_api/teslafleetoauth.py,sha256=OY9yRQuokYo3ts0C8Qb6Z-o9NNAGHbX9F5mHfAh50fo,4121
+tesla_fleet_api/teslafleetopensource.py,sha256=TJfVPcqJlA1b3kMoGuLr-g5Gn8UDyYsTZhjvGY1MtIk,2007
+tesla_fleet_api/teslemetry.py,sha256=kcZG7O9tsBt0BoUyCUSU9j9yCbN1qJDL1iUUo4DFESs,2167
+tesla_fleet_api/tessie.py,sha256=4dBYxe1G2v9JvJGRbb01wXrAmvWT4jOfV4f_VQE_vkE,2302
+tesla_fleet_api/user.py,sha256=TZE2oh-n5zrhKXmGRuiNL9voKVODD7rBhGE_IObYVGA,1179
+tesla_fleet_api/vehicle.py,sha256=KFFotHSmzaC4MhIlU8hoG7SVvPiV3_FC__uJf8BG_G0,31412
+tesla_fleet_api/vehiclespecific.py,sha256=Nr4zZzfmIuw3RFYjQEX6c_xtYZgztMsN5ohVn-YEH0I,20600
+tesla_fleet_api-0.7.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+tesla_fleet_api-0.7.0.dist-info/METADATA,sha256=xJ4Byt3bVHwF_50-6-_WmqP9Z3OkTtiGKwS46UHltog,3821
+tesla_fleet_api-0.7.0.dist-info/WHEEL,sha256=Z4pYXqR_rTB7OWNDYFOm1qRk0RX6GFP2o8LgvP453Hk,91
+tesla_fleet_api-0.7.0.dist-info/top_level.txt,sha256=jeNbog_1saXBFrGpom9WyPWmilxsyP3szL_G7JLWQfM,16
+tesla_fleet_api-0.7.0.dist-info/RECORD,,

{tesla_fleet_api-0.6.1.dist-info → tesla_fleet_api-0.7.0.dist-info}/WHEEL

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

tesla_fleet_api-0.6.1.dist-info/RECORD

@@ -1,19 +0,0 @@
-tesla_fleet_api/__init__.py,sha256=0MON9vh3AShIiX16FZ6NU3yZ7kyXFh5GxA0rY8CzVRM,584
-tesla_fleet_api/charging.py,sha256=N_mc8axrXj3iduqLj_jCt4Vx86tHqe3xqQT4R1R7HvU,1689
-tesla_fleet_api/const.py,sha256=LjJDHWvu3SJL5weMizfTKIZ9bbQtAHPjPz-EkhrtuVU,9277
-tesla_fleet_api/energy.py,sha256=yOKNPyXWKMT7Z9a5RqdNksHokLRo657SWjly1bP2_Qs,5827
-tesla_fleet_api/energyspecific.py,sha256=zggN-q0tf6EH_57bM4EuQ-IdcemKP0o-xv__LArRNnA,4147
-tesla_fleet_api/exceptions.py,sha256=BcvJyjY4qM2-Rf7ZMA94xPIN6ebKit89E7qattMmbr8,11018
-tesla_fleet_api/partner.py,sha256=1vIBUaxKLIfqcC0X6VXZN0dMAzj_CLNPUMjA6QVqZ1k,1223
-tesla_fleet_api/teslafleetapi.py,sha256=-hiZfEEdS8Sfj_yqW-woiD5XD5_Q2IcMubmkh7wdtdE,4826
-tesla_fleet_api/teslafleetoauth.py,sha256=OC6djQw2ieZR_rWK5HoInLScZOu5T5aMClbg5gqbnDg,3502
-tesla_fleet_api/teslemetry.py,sha256=07vY6y56slUXvyaQDGQSGW_VF98fQUgEh-xXrG_phw8,2000
-tesla_fleet_api/tessie.py,sha256=dZs85N2uVlqkjxB3ICRVnPyyJkl4tWDAb3CQqV4MqQc,2096
-tesla_fleet_api/user.py,sha256=TZE2oh-n5zrhKXmGRuiNL9voKVODD7rBhGE_IObYVGA,1179
-tesla_fleet_api/vehicle.py,sha256=EE8ZgL1QdOVfwPsShGeI9DZtsKcLKG7EcfBCnEugfH0,31411
-tesla_fleet_api/vehiclespecific.py,sha256=BhWaQGsNhg06gSLGqNEs2JQgolY3mNGtOWz478lofFE,20324
-tesla_fleet_api-0.6.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-tesla_fleet_api-0.6.1.dist-info/METADATA,sha256=cmPk7ahou15PI_wS_E1yfkXDxhpZtcBGYdbFklJREUk,3821
-tesla_fleet_api-0.6.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-tesla_fleet_api-0.6.1.dist-info/top_level.txt,sha256=jeNbog_1saXBFrGpom9WyPWmilxsyP3szL_G7JLWQfM,16
-tesla_fleet_api-0.6.1.dist-info/RECORD,,