Python client for Toyota North America service API
Project description
toyota-na
Python client for Toyota North America service API
Install
pip install toyota-na
Usage
python -m toyota_na.app -h # Get help
python -m toyota_na.app authorize <username> <passworde>
python -m toyota_na.app get_user_vehicle_list # List vehicle
python -m toyota_na.app get_vehicle_status <vin> # Get vehcicle status
...
Known Issues
- Door/window status not always up-to-date unless you call
send_refresh_statusfirst and wait for it to complete (there is no notification that it completed successfully).
Developer Guide
Quick Start
from toyota_na.client import ToyotaOneClient
async def main():
cli = ToyotaOneClient()
await cli.auth.login(USERNAME, PASSWORD)
vehicle_list = await cli.get_user_vehicle_list()
vehicle_status = await cli.get_vehicle_status(vehicle_list[0]["vin"])
...
Abstracted Interface Example
from toyota_na.client import ToyotaOneClient
from toyota_na.vehicle.vehicle import get_vehicles
async def main():
cli = ToyotaOneClient()
Contributing
We use black and isort for opinionated formatting to ensure a consistent look and feel throughout the codebase no matter the contributor. Pre-commit is used to guarantee the files being checked-in to the repo are formatted correctly.
For convenience a vscode project settings file is included as well. Editors other than vscode will require some setup if you wish to have formatting take place while working.
Getting started:
- Install poetry - https://python-poetry.org/docs/#osx--linux--bashonwindows-install-instructions
- Clone the repo
poetry installpoetry shellpre-commit install
Samples
Sample responses from API calls are stored in samples folder. The data is sourced from real users and from the Toyota app's "Demo Mode"
Credits:
Thanks @DurgNomis-drol for making the original Toyota module and bring up the discussing of Toyota North America.
Thanks @visualage for finding the way to authenticate headlessly.
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
File details
Details for the file toyota-na-2.1.1.tar.gz.
File metadata
- Download URL: toyota-na-2.1.1.tar.gz
- Upload date:
- Size: 13.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.9.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a9c5b922ae9f9ea0a4f4ddff7f76ad181120965648a7346a4c427517c8caa772 |
|
| MD5 | 38fa53414b74fc8ac896400e57b2b52b |
|
| BLAKE2b-256 | 0c5745e0db16e4f8d2f1fe864205ee90adcc8a9b8451eec045f69f9a4b42acf3 |
File details
Details for the file toyota_na-2.1.1-py3-none-any.whl.
File metadata
- Download URL: toyota_na-2.1.1-py3-none-any.whl
- Upload date:
- Size: 17.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.9.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 673dad3502b4b718620daa7dad0ab98ed73478eb242def352c6088e8249c6099 |
|
| MD5 | ee4008d8980dfd4682b90d70b5394f96 |
|
| BLAKE2b-256 | 24f127cf3348e1f1ad3a0687c5093e12e0d531ad7b864cd613d4811d2915d85e |
