Skip to main content

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

  1. 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 check 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:

  • Clone the repo
  • pip3 install black isort pre-commit
  • pre-commit install

Samples

Sample responses from API calls are stored in samples folder. The data is from 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

toyota-na-2.0.2.dev1.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

toyota_na-2.0.2.dev1-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

File details

Details for the file toyota-na-2.0.2.dev1.tar.gz.

File metadata

  • Download URL: toyota-na-2.0.2.dev1.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for toyota-na-2.0.2.dev1.tar.gz
Algorithm Hash digest
SHA256 59cf9dfd382e94ab3aeb5fc5775214363a449993eefb5b9c43753afdf2640daa
MD5 86cde51d4e6f929d444ca72f568656fb
BLAKE2b-256 59d9c47c1a6153e0e0720ed684b3e49437f8b5e8d2a03333c3261d73d704ed26

See more details on using hashes here.

File details

Details for the file toyota_na-2.0.2.dev1-py3-none-any.whl.

File metadata

File hashes

Hashes for toyota_na-2.0.2.dev1-py3-none-any.whl
Algorithm Hash digest
SHA256 946acde611b0432fce6d24cedc8a5c247719cf22ac34766295b9e38bc64583fb
MD5 110477b1153c27baa70cbdc67890beb7
BLAKE2b-256 aa8924c8ed662cb9233271d91aa80d4c97e9a44be3e19fdcffc2d5c3222edb66

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page