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_status
first 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 install
poetry shell
pre-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.
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 toyota_na-2.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 673dad3502b4b718620daa7dad0ab98ed73478eb242def352c6088e8249c6099 |
|
MD5 | ee4008d8980dfd4682b90d70b5394f96 |
|
BLAKE2b-256 | 24f127cf3348e1f1ad3a0687c5093e12e0d531ad7b864cd613d4811d2915d85e |