Teslemetry Streaming API library for Python
Project description
Teslemetry Stream Library
This is an asynchronous Python 3 library that connects to the Teslemetry Stream server and provides Tesla Fleet Telemetry using server side events.
Installation
pip install teslemetry-stream
Usage
The TeslemetryStream class requires:
- session: an aiohttp.ClientSession
- access_token: an access token from the Teslemetry console
- One or both:
- vin: your Tesla's Vehicle Identification Number
- server: The Teslemetry server to connect to
The full list of possible values are provided in TeslemetryStream.Fields
and TeslemetryStream.Alerts
To connect, either use async with
on the instance, call connect()
, or register an callback with async_add_listener
, which will connect when added and disconnect when removed.
Using connect()
or listen()
will require you to close the session manually using close()
.
Example
The following example puts the listening loop in the background, then stopping after 20 seconds.
async def main():
async with aiohttp.ClientSession() as session:
stream = TeslemetryStream(
access_token="<token>",
vin="<vin>",
session=session,
)
await stream.connect()
def callback(event):
print(event["data"])
remove = stream.async_add_listener(callback)
print("Running")
await asyncio.sleep(60)
remove()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for teslemetry_stream-0.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35e3aeb1f648acdfefa02578056f7e17196b003522011d3650b654fff9e32135 |
|
MD5 | 33f048537780a5b3800802347663e1bd |
|
BLAKE2b-256 | 3aeb84ae959bfb180310191858300e67ec19012f8e3910a9a70f763c3652607b |