tesla-fleet-api 0.3.2__py3-none-any.whl → 0.4.0__py3-none-any.whl

tesla_fleet_api/charging.py

@@ -1,7 +1,5 @@
 from typing import Any
-from .const import (
-    Methods,
-)
+from .const import Method
 
 
 class Charging:
@@ -22,7 +20,7 @@ class Charging:
     ) -> dict[str, Any]:
         """Returns the paginated charging history."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             "api/1/dx/charging/history",
             {
                 "vin": vin,
@@ -45,7 +43,7 @@ class Charging:
     ) -> dict[str, Any]:
         """Returns the charging session information including pricing and energy data. This endpoint is only available for business accounts that own a fleet of vehicles."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             "api/1/dx/charging/sessions",
             {
                 "vin": vin,

tesla_fleet_api/const.py

@@ -3,22 +3,22 @@ from enum import Enum
 
 
 class IntEnum(int, Enum):
-    pass
+    """Integer Enum."""
 
 
 class StrEnum(str, Enum):
-    pass
+    """String Enum."""
 
 
-class Methods(StrEnum):
-    """HTTP methods."""
+class Method(StrEnum):
+    """HTTP Methods."""
 
     GET = "GET"
     POST = "POST"
     DELETE = "DELETE"
 
 
-class Errors(StrEnum):
+class Error(StrEnum):
     """Tesla Fleet API error codes."""
 
     INVALID_COMMAND = "invalid_command"
@@ -39,13 +39,32 @@ SERVERS = {
 }
 
 
-class Trunks(StrEnum):
+class Trunk(StrEnum):
     """Trunk options"""
 
     FRONT: "front"
     REAR: "rear"
 
 
+class Seat(IntEnum):
+    """Seat positions"""
+
+    FRONT_LEFT = 0
+    FRONT_RIGHT = 1
+    REAR_LEFT = 2
+    REAR_CENTER = 4
+    REAR_RIGHT = 5
+
+
+class Level(IntEnum):
+    """Level options"""
+
+    OFF = 0
+    LOW = 1
+    MEDIUM = 2
+    HIGH = 3
+
+
 class ClimateKeeperMode(IntEnum):
     """Climate Keeper Mode options"""
 
@@ -55,7 +74,7 @@ class ClimateKeeperMode(IntEnum):
     CAMP_MODE = 3
 
 
-class CabinOverheatProtectionTemps(IntEnum):
+class CabinOverheatProtectionTemp(IntEnum):
     """COP Temp options"""
 
     LOW = 0  # 30C 90F
@@ -63,7 +82,7 @@ class CabinOverheatProtectionTemps(IntEnum):
     HIGH = 2  # 40C 100F
 
 
-class VehicleDataEndpoints(StrEnum):
+class VehicleDataEndpoint(StrEnum):
     """Endpoints options"""
 
     CHARGE_STATE = "charge_state"
@@ -77,7 +96,7 @@ class VehicleDataEndpoints(StrEnum):
     VEHICLE_DATA_COMBO = "vehicle_data_combo"
 
 
-class SunRoofCommands(StrEnum):
+class SunRoofCommand(StrEnum):
     """Sunroof options"""
 
     STOP = "stop"
@@ -85,14 +104,14 @@ class SunRoofCommands(StrEnum):
     VENT = "vent"
 
 
-class WindowCommands(StrEnum):
+class WindowCommand(StrEnum):
     """Window Control options"""
 
     VENT = "vent"
     CLOSE = "close"
 
 
-class DeviceTypes(StrEnum):
+class DeviceType(StrEnum):
     """Device Type options"""
 
     ANDROID = "android"
@@ -102,8 +121,8 @@ class DeviceTypes(StrEnum):
     IOS_PRODUCTION = "ios-production"
 
 
-class Scopes(StrEnum):
-    """Fleet API Scopes"""
+class Scope(StrEnum):
+    """Fleet API Scope"""
 
     OPENID = "openid"
     OFFLINE_ACCESS = "offline_access"
@@ -115,7 +134,7 @@ class Scopes(StrEnum):
     ENERGY_CMDS = "energy_cmds"
 
 
-class TelemetryFields(StrEnum):
+class TelemetryField(StrEnum):
     """Fields available in telemetry streams"""
 
     AC_CHARGING_ENERGY_IN = "ACChargingEnergyIn"
@@ -270,7 +289,7 @@ class TelemetryFields(StrEnum):
     VERSION = "Version"
 
 
-class TelemetryAlerts(StrEnum):
+class TelemetryAlert(StrEnum):
     """Alerts available in telemetry streams"""
 
     CUSTOMER = "Customer"

tesla_fleet_api/energy.py

@@ -1,5 +1,5 @@
 from typing import Any
-from .const import Methods
+from .const import Method
 from .energyspecific import EnergySpecific
 
 
@@ -18,7 +18,7 @@ class Energy:
     ) -> dict[str, Any]:
         """Adjust the site's backup reserve."""
         return await self._request(
-            Methods.POST,
+            Method.POST,
             f"api/1/energy_sites/{energy_site_id}/backup",
             json={"backup_reserve_percent": backup_reserve_percent},
         )
@@ -34,7 +34,7 @@ class Energy:
     ) -> dict[str, Any]:
         """Returns the backup (off-grid) event history of the site in duration of seconds."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             f"api/1/energy_sites/{energy_site_id}/calendar_history",
             json={
                 "kind": kind,
@@ -55,7 +55,7 @@ class Energy:
     ) -> dict[str, Any]:
         """Returns the charging history of a wall connector."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             f"api/1/energy_sites/{energy_site_id}/telemetry_history",
             query={
                 "kind": kind,
@@ -76,7 +76,7 @@ class Energy:
     ) -> dict[str, Any]:
         """Returns the energy measurements of the site, aggregated to the requested period."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             f"api/1/energy_sites/{energy_site_id}/calendar_history",
             query={
                 "kind": kind,
@@ -106,7 +106,7 @@ class Energy:
                 "At least one of disallow_charge_from_grid_with_solar_installed or customer_preferred_export_rule must be set."
             )
         return await self._request(
-            Methods.POST,
+            Method.POST,
             f"api/1/energy_sites/{energy_site_id}/grid_import_export",
             json=data,
         )
@@ -114,7 +114,7 @@ class Energy:
     async def live_status(self, energy_site_id: int) -> dict[str, Any]:
         """Returns the live status of the site (power, state of energy, grid status, storm mode)."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             f"api/1/energy_sites/{energy_site_id}/live_status",
         )
 
@@ -123,7 +123,7 @@ class Energy:
     ) -> dict[str, Any]:
         """Adjust the site's off-grid vehicle charging backup reserve."""
         return await self._request(
-            Methods.POST,
+            Method.POST,
             f"api/1/energy_sites/{energy_site_id}/off_grid_vehicle_charging_reserve",
             json={
                 "off_grid_vehicle_charging_reserve_percent": off_grid_vehicle_charging_reserve_percent
@@ -135,7 +135,7 @@ class Energy:
     ) -> dict[str, Any]:
         """Set the site's mode."""
         return await self._request(
-            Methods.POST,
+            Method.POST,
             f"api/1/energy_sites/{energy_site_id}/operation",
             json={"default_real_mode": default_real_mode},
         )
@@ -143,14 +143,14 @@ class Energy:
     async def site_info(self, energy_site_id: int) -> dict[str, Any]:
         """Returns information about the site. Things like assets (has solar, etc), settings (backup reserve, etc), and features (storm_mode_capable, etc)."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             f"api/1/energy_sites/{energy_site_id}/site_info",
         )
 
     async def storm_mode(self, energy_site_id: int, enabled: bool) -> dict[str, Any]:
         """Update storm watch participation."""
         return await self._request(
-            Methods.POST,
+            Method.POST,
             f"api/1/energy_sites/{energy_site_id}/storm_mode",
             json={"enabled": enabled},
         )

tesla_fleet_api/exceptions.py

@@ -1,5 +1,5 @@
 import aiohttp
-from .const import Errors
+from .const import Error
 
 
 class TeslaFleetError(BaseException):
@@ -87,9 +87,9 @@ class PaymentRequired(TeslaFleetError):
 
 
 class Forbidden(TeslaFleetError):
-    """Access to this resource is not authorized, developers should check required scopes."""
+    """Access to this resource is not authorized, developers should check required Scope."""
 
-    message = "Access to this resource is not authorized, developers should check required scopes."
+    message = "Access to this resource is not authorized, developers should check required Scope."
     status = 403
 
 
@@ -232,25 +232,25 @@ async def raise_for_status(resp: aiohttp.ClientResponse) -> None:
     except aiohttp.ClientResponseError as e:
         if resp.status == 400:
             error = data.get("error")
-            if error == Errors.INVALID_COMMAND:
+            if error == Error.INVALID_COMMAND:
                 raise InvalidCommand(data) from e
-            elif error == Errors.INVALID_FIELD:
+            elif error == Error.INVALID_FIELD:
                 raise InvalidField(data) from e
-            elif error == Errors.INVALID_REQUEST:
+            elif error == Error.INVALID_REQUEST:
                 raise InvalidRequest(data) from e
-            elif error == Errors.INVALID_AUTH_CODE:
+            elif error == Error.INVALID_AUTH_CODE:
                 raise InvalidAuthCode(data) from e
-            elif error == Errors.INVALID_REDIRECT_URL:
+            elif error == Error.INVALID_REDIRECT_URL:
                 raise InvalidRedirectUrl(data) from e
-            elif error == Errors.UNAUTHORIZED_CLIENT:
+            elif error == Error.UNAUTHORIZED_CLIENT:
                 raise UnauthorizedClient(data) from e
             else:
                 raise TeslaFleetError(data) from e
         elif resp.status == 401:
             error = data.get("error")
-            if error == Errors.TOKEN_EXPIRED:
+            if error == Error.TOKEN_EXPIRED:
                 raise OAuthExpired(data) from e
-            elif error == Errors.MOBILE_ACCESS_DISABLED:
+            elif error == Error.MOBILE_ACCESS_DISABLED:
                 raise MobileAccessDisabled(data) from e
             else:
                 raise InvalidToken(data) from e

tesla_fleet_api/partner.py

@@ -1,5 +1,5 @@
 from typing import Any
-from .const import Methods
+from .const import Method
 
 
 class Partner:
@@ -11,17 +11,17 @@ class Partner:
     async def public_key(self, domain: str | None = None) -> dict[str, Any]:
         """Returns the public key associated with a domain. It can be used to ensure the registration was successful."""
         return await self._request(
-            Methods.GET, "api/1/partner_accounts/public_key", params={"domain": domain}
+            Method.GET, "api/1/partner_accounts/public_key", params={"domain": domain}
         )
 
     async def register(self, domain: str) -> dict[str, Any]:
         """Registers an existing account before it can be used for general API access. Each application from developer.tesla.com must complete this step."""
         return await self._request(
-            Methods.POST, "api/1/partner_accounts", json={"domain": domain}
+            Method.POST, "api/1/partner_accounts", json={"domain": domain}
         )
 
     async def fleet_telemetry_errors(self) -> dict[str, Any]:
         """Returns recent fleet telemetry errors reported by vehicles after receiving the config."""
         return await self._request(
-            Methods.GET, "api/1/fleet_telemetry/fleet_telemetry_errors"
+            Method.GET, "api/1/fleet_telemetry/fleet_telemetry_errors"
         )

tesla_fleet_api/teslafleetapi.py

@@ -1,7 +1,7 @@
 import aiohttp
 from .exceptions import raise_for_status, InvalidRegion, LibraryError
 from typing import Any
-from .const import SERVERS, Methods, Errors
+from .const import SERVERS, Method, Error
 from .charging import Charging
 from .energy import Energy
 from .partner import Partner
@@ -67,7 +67,7 @@ class TeslaFleetApi:
 
     async def _request(
         self,
-        method: Methods,
+        method: Method,
         path: str,
         params: dict[str:Any] | None = None,
         json: dict[str:Any] | None = None,
@@ -77,7 +77,7 @@ class TeslaFleetApi:
         if not self.server:
             raise ValueError("Server was not set at init. Call find_server() first.")
 
-        if method == Methods.GET and json is not None:
+        if method == Method.GET and json is not None:
             raise ValueError("GET requests cannot have a body.")
 
         if params:
@@ -101,7 +101,7 @@ class TeslaFleetApi:
                 # Manufacture a response since Tesla doesn't provide a body for token expiration.
                 return {
                     "response": None,
-                    "error": Errors.INVALID_TOKEN,
+                    "error": Error.INVALID_TOKEN,
                     "error_message": "The OAuth token has expired.",
                 }
             if resp.content_type == "application/json":
@@ -118,6 +118,6 @@ class TeslaFleetApi:
     async def products(self) -> dict[str, Any]:
         """Returns products mapped to user."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             "api/1/products",
         )

tesla_fleet_api/teslafleetoauth.py

@@ -2,9 +2,9 @@ from typing import Any
 import aiohttp
 import time
 
-from tesla_fleet_api.const import Methods
+from tesla_fleet_api.const import Method
 from .teslafleetapi import TeslaFleetApi
-from .const import Scopes, SERVERS
+from .const import Scope, SERVERS
 
 
 class TeslaFleetOAuth(TeslaFleetApi):
@@ -37,10 +37,10 @@ class TeslaFleetOAuth(TeslaFleetApi):
         )
 
     def get_login_url(
-        self, redirect_uri: str, scopes: [Scopes], state: str = "login"
+        self, redirect_uri: str, Scope: [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}"
+        return f"https://auth.tesla.com/oauth2/v3/authorize?response_type=code&client_id={self.client_id}&redirect_uri={redirect_uri}&scope={' '.join(Scope)}&state={state}"
 
     async def get_refresh_token(self, client_secret: str, code: str, redirect_uri: str):
         """Get the refresh token."""
@@ -91,7 +91,7 @@ class TeslaFleetOAuth(TeslaFleetApi):
 
     async def _request(
         self,
-        method: Methods,
+        method: Method,
         path: str,
         params: dict | None = None,
         data: dict | None = None,

tesla_fleet_api/teslemetry.py

@@ -1,6 +1,6 @@
 import aiohttp
 from .teslafleetapi import TeslaFleetApi
-from .const import Methods
+from .const import Method
 
 
 class Teslemetry(TeslaFleetApi):
@@ -23,21 +23,21 @@ class Teslemetry(TeslaFleetApi):
     async def ping(self) -> bool:
         """Send a ping."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             "api/ping",
         )
 
     async def test(self) -> bool:
         """Test API Authentication."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             "api/test",
         )
 
     async def metadata(self) -> bool:
         """Test API Authentication."""
         return await self._request(
-            Methods.GET,
+            Method.GET,
             "api/metadata",
         )
 

tesla_fleet_api/user.py

@@ -1,5 +1,5 @@
 from typing import Any
-from .const import Methods
+from .const import Method
 
 
 class User:
@@ -10,20 +10,20 @@ class User:
 
     async def backup_key(self) -> dict[str, Any]:
         """Returns the public key associated with the user."""
-        return await self._request(Methods.GET, "api/1/users/backup_key")
+        return await self._request(Method.GET, "api/1/users/backup_key")
 
     async def feature_config(self) -> dict[str, Any]:
         """Returns any custom feature flag applied to a user."""
-        return await self._request(Methods.GET, "api/1/users/feature_config")
+        return await self._request(Method.GET, "api/1/users/feature_config")
 
     async def me(self) -> dict[str, Any]:
         """Returns a summary of a user's account."""
-        return await self._request(Methods.GET, "api/1/users/me")
+        return await self._request(Method.GET, "api/1/users/me")
 
     async def orders(self) -> dict[str, Any]:
         """Returns the active orders for a user."""
-        return await self._request(Methods.GET, "api/1/users/orders")
+        return await self._request(Method.GET, "api/1/users/orders")
 
     async def region(self) -> dict[str, Any]:
         """Returns a user's region and appropriate fleet-api base URL. Accepts no parameters, response is based on the authentication token subject."""
-        return await self._request(Methods.GET, "api/1/users/region")
+        return await self._request(Method.GET, "api/1/users/region")