tesla-fleet-api 1.0.11__tar.gz → 1.0.13__tar.gz

tesla_fleet_api-1.0.13/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.2
+Name: tesla_fleet_api
+Version: 1.0.13
+Summary: Tesla Fleet API library for Python
+Home-page: https://github.com/Teslemetry/python-tesla-fleet-api
+Author: Brett Adams
+Author-email: hello@teslemetry.com
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: aiofiles
+Requires-Dist: aiolimiter
+Requires-Dist: cryptography
+Requires-Dist: protobuf
+Requires-Dist: bleak
+Requires-Dist: bleak-retry-connector
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Tesla Fleet API
+
+Tesla Fleet API is a Python library that provides an interface to interact with Tesla's Fleet API, including signed commands and encrypted local Bluetooth (BLE) communication. It also supports interactions with Teslemetry and Tessie services.
+
+## Features
+
+- Fleet API for vehicles
+- Fleet API for energy sites
+- Fleet API with signed vehicle commands
+- Bluetooth for vehicles
+- Teslemetry integration
+- Tessie integration
+
+## Installation
+
+You can install the library using pip:
+
+```bash
+pip install tesla-fleet-api
+```
+
+## Usage
+
+### Authentication
+
+The `TeslaFleetOAuth` class provides methods that help with authenticating to the Tesla Fleet API. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetOAuth
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        oauth = TeslaFleetOAuth(
+            session=session,
+            client_id="<client_id>",
+            client_secret="<client_secret>",
+            redirect_uri="<redirect_uri>",
+        )
+
+        # Get the login URL and navigate the user to it
+        login_url = oauth.get_login_url(scopes=["openid", "email", "offline_access"])
+        print(f"Please go to {login_url} and authorize access.")
+
+        # After the user authorizes access, they will be redirected to the redirect_uri with a code
+        code = input("Enter the code you received: ")
+
+        # Exchange the code for a refresh token
+        await oauth.get_refresh_token(code)
+        print(f"Access token: {oauth.access_token}")
+        print(f"Refresh token: {oauth.refresh_token}")
+        # Dont forget to store the refresh token so you can use it again later
+
+asyncio.run(main())
+```
+
+### Fleet API for Vehicles
+
+The `TeslaFleetApi` class provides methods to interact with the Fleet API for vehicles. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetApi
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = TeslaFleetApi(
+            access_token="<access_token>",
+            session=session,
+            region="na",
+        )
+
+        try:
+            data = await api.vehicles.list()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Fleet API for Vehicles](docs/fleet_api_vehicles.md).
+
+### Fleet API for Energy Sites
+
+The `EnergySites` class provides methods to interact with the Fleet API for energy sites. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetApi
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = TeslaFleetApi(
+            access_token="<access_token>",
+            session=session,
+            region="na",
+        )
+
+        try:
+            energy_sites = await api.energySites.list()
+            print(energy_sites)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Fleet API for Energy Sites](docs/fleet_api_energy_sites.md).
+
+### Fleet API with Signed Vehicle Commands
+
+The `VehicleSigned` class provides methods to interact with the Fleet API using signed vehicle commands. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetApi
+from tesla_fleet_api.tesla.vehicle.signed import VehicleSigned
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = TeslaFleetApi(
+            access_token="<access_token>",
+            session=session,
+            region="na",
+        )
+
+        try:
+            vehicle = VehicleSigned(api, "<vin>")
+            await vehicle.handshake()
+            data = await vehicle.wake_up()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Fleet API with Signed Vehicle Commands](docs/fleet_api_signed_commands.md).
+
+### Bluetooth for Vehicles
+
+The `TeslaBluetooth` class provides methods to interact with Tesla vehicles using Bluetooth. Here's a basic example:
+
+```python
+import asyncio
+from bleak import BleakScanner
+from tesla_fleet_api import TeslaBluetooth
+
+async def main():
+    scanner = BleakScanner()
+    devices = await scanner.discover()
+    for device in devices:
+        if TeslaBluetooth().valid_name(device.name):
+            print(f"Found Tesla vehicle: {device.name}")
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Bluetooth for Vehicles](docs/bluetooth_vehicles.md).
+
+### Teslemetry
+
+The `Teslemetry` class provides methods to interact with the Teslemetry service. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import Teslemetry
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = Teslemetry(
+            access_token="<access_token>",
+            session=session,
+        )
+
+        try:
+            data = await api.vehicles.list()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Teslemetry](docs/teslemetry.md).
+
+### Tessie
+
+The `Tessie` class provides methods to interact with the Tessie service. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import Tessie
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = Tessie(
+            access_token="<access_token>",
+            session=session,
+        )
+
+        try:
+            data = await api.vehicles.list()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Tessie](docs/tessie.md).

tesla_fleet_api-1.0.13/README.md

@@ -0,0 +1,223 @@
+# Tesla Fleet API
+
+Tesla Fleet API is a Python library that provides an interface to interact with Tesla's Fleet API, including signed commands and encrypted local Bluetooth (BLE) communication. It also supports interactions with Teslemetry and Tessie services.
+
+## Features
+
+- Fleet API for vehicles
+- Fleet API for energy sites
+- Fleet API with signed vehicle commands
+- Bluetooth for vehicles
+- Teslemetry integration
+- Tessie integration
+
+## Installation
+
+You can install the library using pip:
+
+```bash
+pip install tesla-fleet-api
+```
+
+## Usage
+
+### Authentication
+
+The `TeslaFleetOAuth` class provides methods that help with authenticating to the Tesla Fleet API. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetOAuth
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        oauth = TeslaFleetOAuth(
+            session=session,
+            client_id="<client_id>",
+            client_secret="<client_secret>",
+            redirect_uri="<redirect_uri>",
+        )
+
+        # Get the login URL and navigate the user to it
+        login_url = oauth.get_login_url(scopes=["openid", "email", "offline_access"])
+        print(f"Please go to {login_url} and authorize access.")
+
+        # After the user authorizes access, they will be redirected to the redirect_uri with a code
+        code = input("Enter the code you received: ")
+
+        # Exchange the code for a refresh token
+        await oauth.get_refresh_token(code)
+        print(f"Access token: {oauth.access_token}")
+        print(f"Refresh token: {oauth.refresh_token}")
+        # Dont forget to store the refresh token so you can use it again later
+
+asyncio.run(main())
+```
+
+### Fleet API for Vehicles
+
+The `TeslaFleetApi` class provides methods to interact with the Fleet API for vehicles. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetApi
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = TeslaFleetApi(
+            access_token="<access_token>",
+            session=session,
+            region="na",
+        )
+
+        try:
+            data = await api.vehicles.list()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Fleet API for Vehicles](docs/fleet_api_vehicles.md).
+
+### Fleet API for Energy Sites
+
+The `EnergySites` class provides methods to interact with the Fleet API for energy sites. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetApi
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = TeslaFleetApi(
+            access_token="<access_token>",
+            session=session,
+            region="na",
+        )
+
+        try:
+            energy_sites = await api.energySites.list()
+            print(energy_sites)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Fleet API for Energy Sites](docs/fleet_api_energy_sites.md).
+
+### Fleet API with Signed Vehicle Commands
+
+The `VehicleSigned` class provides methods to interact with the Fleet API using signed vehicle commands. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import TeslaFleetApi
+from tesla_fleet_api.tesla.vehicle.signed import VehicleSigned
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = TeslaFleetApi(
+            access_token="<access_token>",
+            session=session,
+            region="na",
+        )
+
+        try:
+            vehicle = VehicleSigned(api, "<vin>")
+            await vehicle.handshake()
+            data = await vehicle.wake_up()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Fleet API with Signed Vehicle Commands](docs/fleet_api_signed_commands.md).
+
+### Bluetooth for Vehicles
+
+The `TeslaBluetooth` class provides methods to interact with Tesla vehicles using Bluetooth. Here's a basic example:
+
+```python
+import asyncio
+from bleak import BleakScanner
+from tesla_fleet_api import TeslaBluetooth
+
+async def main():
+    scanner = BleakScanner()
+    devices = await scanner.discover()
+    for device in devices:
+        if TeslaBluetooth().valid_name(device.name):
+            print(f"Found Tesla vehicle: {device.name}")
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Bluetooth for Vehicles](docs/bluetooth_vehicles.md).
+
+### Teslemetry
+
+The `Teslemetry` class provides methods to interact with the Teslemetry service. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import Teslemetry
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = Teslemetry(
+            access_token="<access_token>",
+            session=session,
+        )
+
+        try:
+            data = await api.vehicles.list()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Teslemetry](docs/teslemetry.md).
+
+### Tessie
+
+The `Tessie` class provides methods to interact with the Tessie service. Here's a basic example:
+
+```python
+import asyncio
+import aiohttp
+from tesla_fleet_api import Tessie
+from tesla_fleet_api.exceptions import TeslaFleetError
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = Tessie(
+            access_token="<access_token>",
+            session=session,
+        )
+
+        try:
+            data = await api.vehicles.list()
+            print(data)
+        except TeslaFleetError as e:
+            print(e)
+
+asyncio.run(main())
+```
+
+For more detailed examples, see [Tessie](docs/tessie.md).

{tesla_fleet_api-1.0.11 → tesla_fleet_api-1.0.13}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setuptools.setup(
     name="tesla_fleet_api",
-    version="1.0.11",
+    version="1.0.13",
     author="Brett Adams",
     author_email="hello@teslemetry.com",
     description="Tesla Fleet API library for Python",

{tesla_fleet_api-1.0.11 → tesla_fleet_api-1.0.13}/tesla_fleet_api/const.py

@@ -3,7 +3,7 @@
 from enum import Enum
 import logging
 
-VERSION = "1.0.11"
+VERSION = "1.0.13"
 LOGGER = logging.getLogger(__package__)
 SERVERS = {
     "na": "https://fleet-api.prd.na.vn.cloud.tesla.com",
@@ -47,10 +47,18 @@ class Seat(IntEnum):
     FRONT_LEFT = 0
     FRONT_RIGHT = 1
     REAR_LEFT = 2
+    REAT_LEFT_BACK = 3
     REAR_CENTER = 4
     REAR_RIGHT = 5
-    THIRD_LEFT = 6
-    THIRD_RIGHT = 7
+    REAR_RIGHT_BACK = 6
+    THIRD_LEFT = 7
+    THIRD_RIGHT = 8
+
+class AutoSeat(IntEnum):
+    """Auto Climate Seat positions"""
+
+    FRONT_LEFT = 1
+    FRONT_RIGHT = 2
 
 
 class Level(IntEnum):

tesla_fleet_api-1.0.13/tesla_fleet_api/tesla/__init__.py

@@ -0,0 +1,25 @@
+"""Tesla Fleet API classes."""
+
+from tesla_fleet_api.tesla.fleet import TeslaFleetApi
+from tesla_fleet_api.tesla.bluetooth import TeslaBluetooth
+from tesla_fleet_api.tesla.oauth import TeslaFleetOAuth
+from tesla_fleet_api.tesla.charging import Charging
+from tesla_fleet_api.tesla.energysite import EnergySites
+from tesla_fleet_api.tesla.partner import Partner
+from tesla_fleet_api.tesla.user import User
+from tesla_fleet_api.tesla.vehicle import Vehicles, VehiclesBluetooth, VehicleFleet, VehicleSigned, VehicleBluetooth
+
+__all__ = [
+    "TeslaFleetApi",
+    "TeslaBluetooth",
+    "TeslaFleetOAuth",
+    "Charging",
+    "EnergySites",
+    "Partner",
+    "User",
+    "Vehicles",
+    "VehiclesBluetooth",
+    "VehicleFleet",
+    "VehicleSigned",
+    "VehicleBluetooth"
+]

{tesla_fleet_api-1.0.11 → tesla_fleet_api-1.0.13}/tesla_fleet_api/tesla/fleet.py

@@ -115,8 +115,7 @@ class TeslaFleetApi(Tesla):
             json=json,
             params=params,
         ) as resp:
-            LOGGER.debug("Requested: %s", resp.url)
-            LOGGER.debug("Response Status: %s", resp.status)
+            LOGGER.debug("Status %s from %s", resp.status, resp.url)
             if "x-txid" in resp.headers:
                 LOGGER.debug("Response TXID: %s", resp.headers["x-txid"])
             if "RateLimit-Reset" in resp.headers:

{tesla_fleet_api-1.0.11 → tesla_fleet_api-1.0.13}/tesla_fleet_api/tesla/vehicle/__init__.py

@@ -1,12 +1,13 @@
 """Tesla Fleet API classes."""
 
-from tesla_fleet_api.tesla.vehicle.vehicles import Vehicles
+from tesla_fleet_api.tesla.vehicle.vehicles import Vehicles, VehiclesBluetooth
 from tesla_fleet_api.tesla.vehicle.fleet import VehicleFleet
 from tesla_fleet_api.tesla.vehicle.bluetooth import VehicleBluetooth
 from tesla_fleet_api.tesla.vehicle.signed import VehicleSigned
 
 __all__ = [
     "Vehicles",
+    "VehiclesBluetooth",
     "VehicleFleet",
     "VehicleBluetooth",
     "VehicleSigned",